Limitations and known issues

This section includes known issues or limitations that affect functionality or usability and ways that you can work around these limitations.

Affecting encoding

  • Limitation: When Pearl Nexus is overloaded, video frames or audio samples can be dropped causing variable frame rate and audio cracks.
    Workaround: Pearl Nexus is a powerful system capable of many simultaneous tasks, but like any other computing device, it has finite resources. If this problem is observed, check the CPU load from your system's Info page.
  • To reduce system load, do any of the following: disconnect unused video displays from Pearl Nexus's video output ports, delete unused channels and unused layouts, or reduce the complexity of layouts by scaling at the source instead of having the system scale, or reduce the number of sources in layouts, or reduce the frame size or frame rate for channels displayed on the video output ports. Note that actions performed in the Admin panel and Epiphan Live can increase overhead (such as adding channels/sources to Epiphan Live's Dashboard preview panels).

  • Configuring very low frame rates such as 1 fps encoding with a high bitrate setting (e.g. 7000 kbps) results in poor video quality.
    Workaround: Allow Pearl Nexus to automatically select the best bitrate setting. For 1 fps, this results in a bitrate of about 1180 kbps.
  • Some audio distortion is heard on the video output port when the channel encoding is set to1 fps.
    Workaround: For best results, encode the channel at 5 fps or higher.
  • The GoPro camera model HERO7 and some Evertz video distribution systems can suddenly stop working with Pearl Nexus.
    Workaround: Reset the EDID for the Pearl Nexus input. You can also use a device such as an HDMI splitter to isolate and filter the video signal before the signal is sent to Pearl Nexus.

Affecting streaming and recording

  • Interlaced SDI capture is sometimes shifted downwards, resulting in a small green line at the top of the video.
    Workaround: This issue varies with different sources. If it is affecting your capture, the best solution is to crop out the green line in your layout.
  • AFU to Amazon Web Services S3 Simple Cloud Storage transfer sometimes does not recover after the network connection is cut. The expected behavior is that the file transfer would restart, but there is sometimes a time desync that results in a failed transfer.
    Workaround: If the network connection is severed during a AFU transfer, the process must be restarted from the beginning, and the transfer must proceed without interruptions to the network.
  • Occasionally, tracks won't extract from a 64 GB .AVI multi-track recording using the Admin UI.
    Workaround: Perform the extraction again.

Affecting the Admin panel

  • It is possible to name two or more channels with the same value. Use of automatic file transfer to Content Management Systems is unpredictable if this occurs.
    Workaround: Ensure each channel has a unique name.
  • Cropping a video source to 16:9 using the layout editor may not scale correctly and can appear as a thin line in the layout editor. This happens when the device or web browser you're using with the admin interface has a different approach to composing layout. Recording and streaming are not affected.
    Workaround: Due to color space limitations (YUV with 2x2 subsampling), the cropped region's dimensions must be set to even values.
  • NDI connections aren't currently listed on the channel's status page under Connections.

Affecting Epiphan Live

  • Very fast, repeated switching between layouts using the Switcher interface can sometimes cause the monitoring panels and the preview in the Admin Panel to display an blank screen until the video image finishes loading.
    Workaround: Avoid repeated fast switching between layouts.
  • The green and red borders around the "Preview" and "Live" areas in the Channel section are offset from the video by a few pixels.
    Workaround: The offset is cosmetic and does not affect your Live stream, so no workaround is required.
  • When a output assigned to a Dashboard preview panel has its source changed, the preview panel does not automatically update to reflect the change.
    Workaround: Refresh the Epiphan Live Dashboard in your web browser to update any changes in your preview panels.

Affecting video output ports

  • When setting up the video output ports on Pearl Nexus, the video input source's frame rate as set for the channel is used by default for the video at the output. The Frame rate field in the video output port settings does not change the frame rate of the video at the output port or change the frame rate of the connected display device. Workaround: Ignore the Frame rate field in the video output port settings.

Affecting CMS integrations

  • When configuring the primary channel and audio sources for a Pearl Nexus remote recorder in Panopto, choosing a Pearl Nexus channel that has no audio as the primary video source without choosing a primary audio source from another channel can cause the remote recorder's preview to not display properly in Panopto.
    Workaround: Choose a primary audio source from one of the other channels.
  • If no Pearl Nexus channels are selected when setting up the Pearl Nexus remote recorder in Panopto, you can still create an ad hoc event using Pearl's Admin panel; however, the ad hoc event isn't actually created on Pearl Nexus or recorded.
    Workaround: Enable the channels for the Pearl Nexus remote recorder in Panopto.
  • In multi-view recordings, different Kaltura players (such as the KMC and MediaSpace ) can playback audio differently, where the KMC plays audio from the channel selected as the "main entry".
  • If you modify a particular recurring lecture capture plus live webcasting event (e.g. a VOD + Live Stream event in a recurring series), Kaltura excludes that event from the recurring series and the webcast doesn't stream. That's because the RMTP URLs for the modified event looses it's mandatory tokens. However, the recurring Kaltura event does record as scheduled and other events in the series are not affected.
    Workarounds: To regenerate the RTMP tokens for a live event, go to MediaSpace, find the modified live event entry and uncheck the Live event checkbox - and save. Then re-check it and save the event again. Alternatively, you can go to the Kaltura Management Console (KMC), find the modified live event entry and then, in the Live stream tab, click Re-generate Stream Token.
  • On the create new ad hoc event screen, the keyboard shortcut shift+Tab does not move to the previous input field or control, but moves to the next input field or control.
    Workaround: Press Tab repeatedly until the field you want is highlighted.
  • If a Panopto VOD event is left on pause until the scheduled end time of the event or the event is manually stopped while on pause, a recording of the full duration of the event is uploaded to Panopto instead of only the recording up to the point when the event was paused or stopped. Workaround: Unpause the event and then manually Stop the event.