User Guide

Epiphan Pearl Nano

Release 4.23.0
June 12, 2024
UG128-03© and ™ 2024, Epiphan Systems, IncThank you for choosing Epiphan!
At Epiphan Video (“Epiphan”), building reliable video systems with pro features that perform above yourexpectations is our mission.
We value your feedback! Email us your suggestions and let us know how you think we're doing and where you'd
like to see our products improve: info@epiphan.com

Warranty
All Epiphan Video systems have a 100% return to depot warranty for one year from the date of purchase.

Technical support
Epiphan’s products are backed by our professional support team. You can reach our team several ways:l

Email support@epiphan.com

lLive chat from our support site https://www.epiphan.com/support/lPhone toll free at 1-877-599-6581 or call +1-613-599-6581

Gather as much information about your problem as you can before you contact us so we can help you better,
including:l

A description of the probleml

Details about your video or audio source (type, connection, resolution, refresh rate, etc.)l

Product serial numberlProduct firmware version (using the admin interface)l

Product LED lights

ii

Table of contents
Thank you for choosing Epiphan!

Start here
Release notes
Product overview

ii

1
2
6

Pearl Nano overview

6

Front and back view of Pearl Nano

8

Monitoring audio

10

About 4K on Pearl devices

11

Pearl Nano AV inputs

12

Pearl Nano Tech specs

13

Pearl Nano Power adapter specifications

20

Optimum System Load

20

International character support

22

Quick start

22

Next Steps

23

Pearl Nano sample recording

24

Setup

26

Access network IP address and Admin panel
Vesa mounting the device
User interfaces and remote access

26
27
28

Pearl Nano's front panel control interface

28

About the front screen and control key interface

29

The front screen Channel view

32

The front screen menu and control keys

33

Record and stream using the control keys

34

Dim the front screen and control interface

35

Set the Pearl device screen timeout

36

Set a PIN security code37

One Touch streaming and recording control

37

The Admin panel

40

About the Admin panel

41

Connect to the Admin panel

43

Enable local console access to the Admin panel

44

Connect using a DNS-based service discovery

47

Connect using persistent static IP address

48

Cloud-based device management

49

iii

About Epiphan Edge

49

Enable or disable Epiphan Edge access

50

Pair and unpair from Epiphan Edge

51

Remote login to the Admin panel and Epiphan Live53

Configure network settings

55

Network ports used by Pearl Nano

55

Verify IP address and MAC address

56

Configure a static IP address

58

Configure DHCP

61

Configure DHCP Option 81

64

Configure Dynamic DNS

65Change the HTTP/HTTPS port values

68

Perform network diagnostics

68

Disable the network discovery port

70

Configure network security

70

Configure 802.1x network security and manage user certificates

71

Manage CA and self-signed certificates73

Configure HTTPS

73

Configure HTTP Keep Alive Settings

75

Configure system settings

76

Configure date and time77

View the current date and time settings

77

Configure a time server

78

Manually set the date, time, and time zone

79

Configure device info, name, description, and location

79

SD card and SATA M.2 2280 SSD storage

80

Install and format an SD card for the Pearl Mini and Pearl Nano

81

Install and format a SATA M.2 2280 SSD for Pearl Nano

83

Format the SD card

85

Audio input ports

86

Selecting an audio source

87

Connecting microphones to the XLR line level inputs

89

Configure audio ports for stereo or mono

89

Assign audio sources to an input

91

Adjust audio gain and delay

93

Mute audio

96

Video output ports

98

About video output ports

99

Video output port resolution100

Set up the video output port using the Admin panel

101

iv

Set up and enable MultiViewer

103

MultiViewer system information

105

Select the video output source using the device screen

106

Preview the video output port

108

Disable the video output port

108

Disable or enable audio and output port volume

109

Display and reposition the audio VU meter

111

Rename a video output port

112

Mirror the video output port display

112

Connect external devices

113

Connect an external keyboard

114

Connect a USB status light

115

Feature add-ons

117

Add-ons overview

117

About 4K on Pearl devices

119

User administration

120

User types and privileges

120

Change user passwords

125

Overcome lost passwords

126

Remove user password

126

Log in using a different user account127

Assign administrator privileges to operators

127

Configure LDAP user authentication

129

Restrict viewers by IP address

131

Configuration presets

135

About configuration presets

135

Configuration preset considerations

137

Configuration preset considerations

138

Recording and streaming states

138

Recorded files in a channel or recorder

139

Configuration groups

139

The Factory default configuration preset and Factory reset

140

Create a configuration preset

141

Apply a configuration preset using the Admin panel

142

Apply a configuration preset using the front screen menu

143

Export and import configuration presets

145

Update a configuration preset

146

Delete a configuration preset

147

Status and monitoring
Monitoring audio and VU sensitivity

147
147

v

Confidence monitoring using the front screen

148

View system status using the front screen menu

150

View system information using the Admin panel

152

View network status

152

View 802.1x network connection status

153

View channel status and stream information

153

View the video output port status

154

View AFU and file transfer progress

155

View scheduled CMS events and history

158

CaptureWhat is a channel?

161
162

Channel layout examples

162

About automatic channels

164

Channel configuration

166

Configure an auto channel

167

Add video sources

168

Add an audio source to a layout

171

Rename a channel

172

Preview a channel173

Add or remove channel metadata

174

Configure encoding

175

Codecs and file format compatibility

176

Configure video encoding

178

Configure audio encoding

181

Custom layout configuration

183

About the custom layout editor

183

Resize and position items using percents or pixels

186

Open the custom layout editor for a channel

191

Configure a custom layout for a channel

192

Rename a layout193

Set the background color

193

Add an image to a layout

194

Upload or remove an image using the Media page

196

Add a text overlay

197

Custom system variables for text overlays

200

Crop a video source

201

Video and audio input sources
About connecting video and audio sources

204
204

vi

Tested RTSP-based IP cameras

205

Connect an RTSP source

207

Connect an SRT stream as an input

208

Preview a video source using the Admin Panel

210

Rename an input port

211

Configure a video input source211

Add a custom No Signal image

212

StreamWhat is streaming?

214
215

Streaming to a CDN, multicasting, and streaming to multiple destinations

216

Directly sharing channel stream URLs with viewers

217

About streaming using SRT

218

Secure streaming

220

Suggested stream settings

221

Streaming a channel direct to viewers

223

Share a live broadcast stream (HTTP, HTTPS, or RTSP)

224

Enable HLS (pull)

225

Restrict viewer access to channel streams

226

Restrict viewers by IP address

227

Change HTTP and RTSP streaming port values

231

Disable and enable direct channel streaming

232

Viewing a channel's live broadcast stream

233

View the live broadcast URL using a web browser

235

View the streaming URL using a media player

236

Streaming to servers, CDNs, and other devices

238

Set up an RTMP or RTMPS (push) stream

238

Set up an SRT stream using rendezvous mode239

Set up an SRT stream using caller and listener modes

242

Adjust latency and view the SRT stream status

245

Set AES encryption and a passphrase for SRT

248

Set up an HLS (push) stream

248

Set up an RTSP announce stream

250

Set up a stream to the CDN using an XML profile

251

Start and stop streaming to a CDN

252

Multicast streaming

253

MPEG-TS streams using RTP/UDP push254

MPEG-TS streams using UDP push

256

Multicast streaming using RTP/UDP

258

vii

Set up traffic shaping

258

Viewing with Session Announcement Protocol (SAP)

260

Streaming to a media player or smart TV

Record262

263

About recording
Pearl Mini and Pearl Nano recording storage information
Record a channel
Configure recording settings, file size, and type
Restart recording to a new file
Manage recorded files
Join recorded files together
Automatic file transfers

263
265
266
268
269
271
272
273

About Automatic File Upload (AFU)273

Set channels and recorders to include in AFU

274

Enable AFU, schedule, and set options

275

Configure AFU to FTP server parameters

277

Configure AFU to SFTP server parameters

278

Configure AFU to RSync server parameters

280

Configure AFU to CIFS server parameters

281

Configure AFU to SCP client parameters

283

Configure AFU to AWS S3 parameters

285

Configure AFU to WebDav server parameters

287

AFU or copy to USB

288

Automatic File Upload to a USB storage device

296

Manually copy recordings to USB

296

One-time copy all recordings to USB storage device

300

Manually copy recordings to USB

302

Manage USB file transfer queue

306

Manage USB drive308

Add recordings to an AFU queue

309

View the AFU log

309

Manage the AFU queue

310

Integration
Kaltura registration

311
311

Enable CMS and register with Kaltura

311

Disable or deregister from Kaltura

314

Change the resource name used for Kaltura

315

Reassign a registered resource

315

Kaltura recording and webcasting setup

316

viii

About Kaltura recording and webcasting

317

Kaltura settings

319

Set up channel for Kaltura VOD events on Pearl Nano

321

Set up channel and URLs for Kaltura webcasting events321

Set Kaltura ad hoc event parameters322

Set the extend Kaltura CMS event interval

324

Change the events schedule refresh interval

324

Use RTMPS for a Kaltura webcasting event

325

Panopto registration

325

Enable CMS and register with Panopto

326

Disable CMS and disconnect from Panopto

327

Panopto recording and webcasting setup

328

About Panopto recording and webcasting328

Set up Panopto authentication for ad hoc events330

Set Panopto ad hoc event parameters333

Set the extend Panopto CMS event interval

334

Enable mute and display image on pause

335

Disable low disk space Panopto alerts

337

YuJa setup

340

YuJa known issues

340

YuJa registration

340

YuJa settings

342

Creating, modifying, and deleting YuJa events

343

Accessing YuJa recordings

343

Set the extend YuJa CMS event interval

344

View YuJa events

344

Opencast registration

345

Disable CMS and disconnect from Opencast

345

Enable CMS and register with Opencast

345

Opencast recording setup

346

About Opencast recording

347

Set the extend Opencast CMS event interval

348

Set Opencast ad hoc event parameters

348

CMS recording and webcasting control

349

Set up a CMS start screen

350

Start/stop scheduled CMS events using the Admin panel

351

Stop/start scheduled CMS events using Pearl Nano's front screen menu

352

Extend or pause CMS recordings and webcasts

354

Create ad hoc events using the Admin panel357

Log out of an ad hoc session

361

ix

Schedule when CMS event recordings upload

361

Upload the local Panopto webcast recording

362

Recover channel backup recordings

363

MaintenancePower down and system restart
Back up your Pearl device setup
Perform a factory reset
Firmware upgrade
BIOS update
Register your device
SupportStorage capacity and maintenance

366
366
368
369
370
374
376
377
380

Troubleshooting

384

Diagnostic tools

384

Connectivity status results

385

Run diagnostic tests using the Admin panel
Run diagnostic tests using the device screen
Troubleshooting Quick Reference

387
388
390

Remove black bars (matte) from the video

393

Use a specific EDID for the video input port

396

External keyboard shortcuts

399

Limitations and known issues

401

Software licenseThank you for choosing Epiphan!

405

412

x

Pearl Nano User Guide

Start here

Start here
Welcome, and thank you for buying an Epiphan Pearl device.
See the Quick start for basic steps to get a single video source (and optional audio) set up so you can stream andrecord some output right away. The rest of the guide shows you how to tweak the system exactly how you want it
so you can take advantage of the many advanced features.
l

For a product description of the Pearl Nano, see Pearl Nano overview.

Pearl devices are fully integrated with Kaltura, Panopto, and YuJa Content Management Systems (CMSs) and iseasily setup using the Admin panel. The Integration section of this guide details how to register and set up the
Pearl device as a remote recording and streaming device with these CMSs.
For information about using the Pearl device's RS-232 API, HTTP API, and HTTPS API with third-party
applications, refer to the Pearl System API Guide.

About this Guide
After the introductory section, the next section describes the setup and main user interfaces that are used tooperate and configure the Pearl device. You'll find everything that you need to use and setup these interfaces :lFront screen menu and control key interface for Pearl NanolAdmin Panel

The rest of the user guide covers setting up and operating your Pearl system for a successful experience. The
sections are organized into these main categories: Setup, Capture, Stream, Record, Integration, Maintenance,
and Troubleshooting.

This guide assumes that all feature add-ons for Pearl-2 and Pearl Nano are activated. If a documented feature ortask is only available when a specific feature add-on is activated, it is indicated by a link to the activation page forthat feature add-on. For the 4K add-on, the link is 4K .

1

Pearl Nano User Guide

Release notes

Release notes
Release 4.23.1
lImplemented a new functionality that enables administrators to personalize the color settings of a multicolored, USB-connected 'on-air' status LED indicator.

lImplemented a functionality that allows users to pause and resume recordings with Panopto, Opencast, or
YuJa platforms with the convenience of a programmable Delcom USB button.

l

Resolved an issue with LDAP where certain characters in user credentials, specifically backslashes (\\),
double quotes ("), and hash symbols (#), were not being properly escaped.

Previous releases and features
This section lists features and updates introduced in previous product releases.

Release 4.23.0
lAdded support for Opencast Content Management System.

l

For ad hoc or unscheduled Panopto events, added support to upload recordings directly into the device's
default folder.

lWith this release, should a reboot occur during a Panopto event, the recording will not only continue
seamlessly but also, upon the event's conclusion at the predetermined time, it will autonomously upload toPanopto for processing, eliminating the need for any manual input.

Release 4.21.0
lAdded support to schedule the start and stop times for recording and streaming using the premium
version of Epiphan Edge. This requires a subscription to Epiphan Edge.

l

Added file transfer progress indicator to the video preview screens as well as the Single-Touch screen on
Pearl Mini and Pearl-2. This feature will help users monitor the progress of their uploads and avoid
removing the storage in the middle of the transfer.

l

Added option to require user to enter a PIN to user Pearl Nano to factory reset the device.

l

Added option to require user to enter a PIN in order to apply built-in configuration presets using the front
screen.

l

New built-in Configuration presets for Pearl-2 and Pearl Mini to transform routine meetings and events
into captivating TV broadcast-like experiences.

l

Added a new counter to the SRT statistics called Reconnections to show the number of times a SRT
connection disconnected and was successfully re-established.

2

Pearl Nano User Guide

Release notesl

Added support to encode MP3 and AAC audio formats at 192 Kbps.

l

Resolved a bug that caused recording failure when Pearl is configured to record a scheduled Panopto
webcast event and at the scheduled start time, connection to Panopto is established but either Panopto
does not respond in a timely manner or does not respond at all.

Release 4.20.0
lAdded ability to apply a Pearl Configuration preset from an attached USB drive.

lRe-branded Epiphan Cloud to Epiphan Edge on web admin interface and front screen.

lResolved an issue that leads to loss of input video signal when the name of a video source on Pearl web
UI is changed to reserved key words.

lProvided better handling of HTTP error code 401 from YuJa Enterprise Video Platform.

Release 4.19.0
lAdded support to lock the Record and Stream control keys on Pearl Nano's front panel using a PIN.

l

Implemented a fix for an issue that prevented the upload of recorded files to Panopto. This problem is
encountered when Pearl is rebooted while in the middle of uploading a recorded file to Panopto.

lImplemented a solution to identify and restore the XLR analog audio input capture when it fails due togrounding and/or external environmental issues.

lResolved an issue that prevented Pearl from uploading files to existing subdirectories in an S3 bucket
using AFU.

Release 4.18.0
lAdded support for NDI|HX inputslPerformance improvements to NDI|HX functionalityl

Added support for quickly connecting SRT inputs to Epiphan ConnectlEnhanced SRT inputs and outputs with buttons to quickly copy information to clipboardlEnhancements made to Panopto integration; Pearls configured to record webcast events will now begin
recording to local storage if Panopto cannot be reached at the scheduled start time.

lImproved discoverability of the Epiphan Live dashboardlResolved an issue in which some scheduled back to back events with Panopto, Kaltura, or YuJa CMS
may not get recorded3

Pearl Nano User Guidel

Bug fixeslMPEG-DASH is no longer supported on Pearl devicesl

UPnP is no longer supported on Pearl devices

Release notes

Release 4.17.3
l

An issue has been resolved wherein configuration presets that contained Epiphan Cloud data from one
Pearl were applied to another Pearl which then caused a hard lock of that Pearl upon reboot. A better
handling of this information has been implemented in this release to prevent the hard locking of thesePearls on reboot.

l

An issue has been resolved wherein occasionally Epiphan Cloud team members were not able to accessthe Admin interface of a paired Pearl unitlBug fixes

Release 4.17.2
l

Bug fix for the full frame rate preview in Epiphan Cloud Pro. HLS preview stream from Pearl to Cloud was
not closing properly when preview was stopped, this has been resolved

Release 4.17lFirmware version 4.17 is the last version to support connections to UPnP enabled devicesl

SRT timestamp synchronization: When using SRT to connect a Pearl to another Pearl, or a Unify
instance, it is now possible to enable automatic syncing of SRT streams. The Pearl acting as sendertimestamps the packets, and the receiving Pearl can sync using those timestamps. This feature is
activated on the receiving Pearl through a check boxlSupport for Kuando BusyLight Alpha and Omega model 2lSupport for starting and stopping scheduled YuJa events early using Pearll

Support for pausing and resuming YuJa events in progress using Pearll

Support for extending a YuJa event in progress using Pearl management interfacelAddition of brute force password attack prevention. If the same IP address tries and fails to log in to Pearl
50 times in a row within 60 seconds, Pearl will block further attempts to log in from that IP address for 60
secondslSecurity vulnerability fixesl

Bug fixeslPearl Nano devices with a serial number starting with GSAB or newer will be unable to downgrade below
firmware version 4.17. An error will occur if this is attempted and the firmware upgrade will be blocked

4

Pearl Nano User Guide

Release notes

Release 4.16 (Pearl Nano only)l

4K add-on now available for purchaselH.265 encoding now available

Release 4.15
lDirect integration with the YuJa content management system lets you streamline your YuJa workflows foreven more efficiency. Pearl can automatically start recording or streaming based on your schedule in
YuJa and push files to the right folder on the platforml

Kaltura updates including Improved ad hoc events and My Dashboard integrationlMultiViewer onscreen options including on-air status, audio meters, channel status, and CMS event statusl

SRT support upgraded to version 1.4.3 (better stability, more accurate statistics, and other improvements)lSupport for automatic file uploading via secure SMB2 and SMB3, improving compatibility with Windowsbased systemslPreset optimizations allow you to select which aspects of a created preset to apply to a Pearl devicelLockable front screen on Pearl Nano for CMS applications

Release 4.14.3 (Pearl Nano only)l

Firmware 14.4.3 allows Pearl Nano users to dynamically scale the input source in the custom layout
builder.

l

The color range of the HDMI and SDI video inputs now includes black (0.0.0). As such, the color black(0.0.0) in the video signal is now accurately encoded as black instead of near-black

Release 4.14.2
lMultiViewer displays a custom mix of up to video sources including channels on the HDMI output port in aconvenient grid for confidence monitoring with minimal impact to the system's processor.

lMultiViewer displays a custom mix of up to two video sources including the channel on the HDMI output
port in a side-by-side grid for confidence monitoring with minimal impact to the system's processorlPause and extend CMS eventslPanopto device templateslLive channel RTSP stream transport optionl

NDI version 4.6.2 supportl

Keyboard shortcutslPearl as FTP server functionality removed.

5

Pearl Nano User Guide

Product overview

Release 4.14.1
l

One Touch control of streaming and recordingl

Upload local webcast recordings to PanoptolLocking the CMS start screenlPre-configured stream URLs for Kaltura webcastslSchedule CMS event uploads

lAdjustable fan speedlRotate the touch screen display 180 degrees without affecting the video at the output port

Release 4.14.0lInaugural release of Pearl Nano

Product overview
Learn about your Pearl device and get familiar with the various connectors and features.
Topics include:l

Pearl Nano overviewlFront and back view of Pearl NanolMonitoring audiolAbout 4K on Pearl deviceslPearl Nano AV inputslPearl Nano Tech specsl

Pearl Nano Power adapter specificationslOptimum System LoadlInternational character support

Pearl Nano overview
Pearl Nano is a versatile and easy to use, single channel video recording and streaming hardware encoder that's
great for lecture capture, corporate communications, and remote video contribution applications using live SRT
feeds.

6

Pearl Nano User Guide

Pearl Nano overview

With Pearl Nano, you can capture, record and stream computer monitors and other video sources, including:
l

SDI

l

HDMI™

l

HDMI 4K4K

l

DVI-I (single link)l

SRT and RTSP

Simultaneously capture up to two audiovisual sources and arrange them in a custom layout with transparent
images and backgrounds.
Capture audio from dedicated XLR, USB, and RCA audio ports, as well as from SDI, HDMI, and network video
sources (SRT and RTSP).
Stream to Content Distribution Networks (CDNs) worldwide using modern protocols like SRT and HLS. At thesame time, you can stream to other destinations using RTMP/RTMPS or RTSP. Even multicast directly toviewers on your LAN so they can watch the live channel broadcast using a web browser or media player on smart
devices connected to the same private network as Pearl Nano.

Download recordings using your web browser, or set Pearl Nano to automatically upload recorded files directly toa network server using FTP, RSYNC, CIFS, WebDav, and more. Pearl Nano is also fully integrated with Kaltura,
Panopto, and YuJa Content Management Systems (CMSs) and can be registered as a video remote recorderresource for seamless lecture capture.
Network security compliance with 802.1x protocols, passwords, and certificate authentication means an easier
setup for IT friendly live streaming over enterprise networks. Pearl Nano is HTTPS enabled for secure

7Pearl Nano User Guide

Front and back view of Pearl Nanoadministration and control over the LAN, and supports secure live streaming protocols like SRT with AES
encryption and RTMPS.
Pearl Nano does not capture from HDCP encrypted sources.

Front and back view of Pearl Nano

Table 1 Pearl Nano front panel descriptions
Label

Name

Description

3.5 mm audio output jackFor audio confidence monitoring. Plays the audio for the currently
visible channel.
Used to store up to 512 GB of recordings and user uploaded media
files. For recommendations, see Pearl Nano Tech specs.

SD card slot and LED
indicator

A small LED lights when Pearl Nano is powered on and an SD card isinstalled. If a SATA M.2 SSD is installed, the SD card slot is no longer
detected and the LED indicator does not light.

Front screen display

Used for confidence monitoring and for displaying the front screen
menu system and device information.

Control keys

Used to navigate the front screen menu system and select options
when configuring system parameters using the front screen menu
system.

Recording control key

Glows red when the device is recording. Flashing means that user
action is required and recording has either stopped or won't start.
Color is white when the system is powered on and not recording.

Streaming control key

Glows blue when the device is streaming. Flashing means that user
action is required and streaming has either stopped or won't start.
Color is white when the system is powered on and not streaming.

8

Pearl Nano User Guide

Front and back view of Pearl Nano

Table 2 Pearl Nano back panel descriptions
Label

Name

Description

12V DC power jackConnect the power supply here to power on the device. The port
requires a 12 V DC power source (center-positive). Always use theprovided power adapter and tighten the screw lock securely onto thesocket. To power down the unit, disconnect the power adapter fromthe device.

Cable lock

Allows Pearl Nano to be locked to a desk or surface using a laptop
cable lock.
A USB 3.0 (UAC) port for connection of external hard drives, flash
drives, USB microphones, or supported USB status light indicators.

USB
Can be used to connect a USB mouse or keyboard when the local
console feature is enabled. USB (UVC) devices are not supported.
HDMI OUT

An HDMI video output port, see Video output ports for details.

PoE+ (RJ-45 Ethernet)

Auto-sensing gigabit Ethernet 10/100/1000 Base-T network port withsupport for RTSP and SRT networked video inputs and PoE+ network
power. See Configure network settings for setup instructions.

SDI

An SDI video input port that supports 12G SDI.

HDMI PASS-THROUGH

An HDMI pass-through port that outputs the HDMI IN signal with noadded latency.

HDMI IN

An HDMI video input port that supports HDMI and DVI signals (using
an adapter) up to 4K with the optional 4K add-on, and up to
1920x1080 without the add-on. For more information, see About 4K on
Pearl devices.

9

Pearl Nano User Guide

Label

Monitoring audio

Name

Description

RCA

RCA consumer line-level stereo pair (left/right) audio inputs. See Pearl
Nano AV inputs.

XLR

Two XLR professional line-level, +4 dBu (balanced/unbalanced) jacks
that can function as a stereo pair (left/right) or as two mono inputs. See
Pearl Nano AV inputs.

Monitoring audio
The front panel includes a 3.5 mm headphones audio jack for monitoring audio. To monitor the audio for achannel, just select the channel using the device screen . The audio you hear depends on the audio source
configured in the live channel layout.
Increasing the volume to 100% may cause you to hear distortion that is not actually present in theaudio signal being recorded and streamed.

Adjust the volume on Pearl Nano
From the Channel view or when one of the video sources is displayed on the front screen, press the up and downarrow keys on the control key interface to adjust the volume. Each press changes the volume by 10% to a
maximum volume of 100%. Turn the volume all the way down to mute.

You can also adjust the volume using the front screen menu when you select System > Controls > Headphonevolume.

1. Login to the Admin panel as admin

Audio VU meter
A VU meter on the device screen shows the audio levels for the channel you are monitoring. The value isdisplayed in dBFS (decibels relative to full scale). Colored bars represent the audio level.

10Pearl Nano User Guide

About 4K on Pearl devices

Channels that have stereo audio display two bars. The top bar is the left audio channel and the bottom bar is theright audio channel.

VU meter (mono)

Pearl Nano

VU meter (stereo)

Table 3 Audio VU meter levels
Color

Decibel range

Red

0 to -9 dBFS

Yellow-9 to -18 dBFS

Green

-18 dBFS and lower

The VU meter appears in several different places so you can visually check audio levels:l

Pearl Nano Front screen: On the channel view and on each of the video input screens.

lAdmin Panel: On the audio input source's configuration page when you select the input source from the
Inputs menu. You can also add the VU meter to appear on the video output ports, see Disable or enableaudio and output port volume.

About 4K on Pearl devices
Pearl-2 and Pearl Nano support resolutions from low-res SD to 4K, which means that you can use them tocapture DCI 4K (Pearl-2 only) and 4K UHD digital signals. You need the 4K feature add-on to access this feature,
see Add-ons overview.

4K feature add-on
The 4K feature provides Pearl-2 or Pearl Nano with the following 4K features:
Specification

Pearl-2

Pearl Nano

4K video inputs

4 (2 HDMI and 2 SDI)

2 (1 HDMI and 1 SDI)

4K Hardware scaling (4K down to full HD)

4

2

4K video outputs (HDMI)

2

1 pass through port

4K video encoding

1

1

11

Pearl Nano User Guide

Pearl Nano AV inputs

You can find more details on the add-on, along with installation instructions and the add-on itself, atwww.epiphan.com/add-ons.

4K UHD vs. DCI 4K
DCI 4K and 4K UHD are just different definitions of a 4K resolution. 4K UHD (3840×2160) is the standard 4K
resolution available on televisions and other common display screens. The 4K resolution of 4096×2160 (Pearl-2
only) referred to as Digital Cinema Initiatives (DCI) 4K, and is the resolution used almost exclusively for cinemascale film production. It is rare to find this resolution outside of a cinematic context. Pearl-2 and Pearl Nanocapable of supporting input and output at either definition with the Feature add-ons.

Pearl Nano AV inputs
We recommend having up to two video sources added to the custom layout in Pearl Nano's single, full HD
channel.
One of the video sources can be either an SRT or an RTSP networked source; however, you cannot connect
more than one networked source at the same time. Pearl Nano supports use of common signal converters andinput adapters.
Table 4 Pearl Nano Input Ports
Input port
SDI1

4K HDMI2

Qty

Details1

Linear PCM audio/video input. Supports 12G SDI video input.

1

Linear PMC audio/video input, non-HDCP protected. DVI-I (using
an adapter) is single link. Supports up to 4K with the optional
4K add-on. Supports 1920×1080 full HD video input without the 4K
add-on. For more information, see About 4K on Pearl devices.

12

Pearl Nano User Guide

Input port

Pearl Nano Tech specs

Qty

Details

USB 3.02

Linear PCM audio inputs on the rear panel accept non-HDCP
protected content. Use to connect a single UAC device, such as a
USB microphone. Can also connect to external hard drives, flash
drives, and control interfaces. USB (UVC) devices are notsupported.

RJ-45

1

One SRT source over Ethernet at 1920×1080@30 fps.
One RTSP source over Ethernet at 1920×1080@30 fps.
RCA consumer line-level audio inputs function as a stereo pair (-10
dBV).

RCA3

2

l

White = leftl

Red = right

Two XLR audio inputs operate as a stereo pair (left/right) by default.

XLR3

2

l

XLR 1 = rightl

XLR 2 = left

You can configure the ports to operate as independent mono inputs
using the Admin panel, see Configure audio ports for stereo or
mono.
XLR inputs accept balanced and unbalanced, professional line levelsignals with a maximum of up to 12.3 VRMS, +24 dBu.

1 SD-SDI audio is not supported.
2 Requires 4K feature add on
3 In the Admin panel, XLR/RCA includes audio signals from the XLR audio pair and the RCA audio pair bydefault. You can disable one or the other using the Admin panel, see Assign audio sources to an input.
Only content that is not HDCP-protected is captured from HDMI and SDI sources. HDCP-protected content may
appear as a green screen on Pearl Nano.
If you are using DVI2PCIe cards with your Pearl Nano, DVI2PCIe cards do not support audio over
HDMI.

Pearl Nano Tech specs
The input and output connectors are listed for Pearl Nano.
For the most up-to-date product specifications and information, go to www.epiphan.com/pearl-nano.

13

Pearl Nano User Guide

Pearl Nano Tech specs

Table 5 Specifications for Pearl Nano
(1) 12G SDI
Local video inputs

Video over Ethernet3(1) 4K HDMI1 and 2(1) RTSP(1) SRT (push)(1) BNC (female)(1) HDMI type A (female)Connectors(1) USB-A (female)(1) RJ-45 (female)
Aspect ratios

3:2, 4:3, 16:9, 16:10, and custom aspect ratios

Standard resolutions

PAL, PAL wide, NTSC, NTSC wide

Resolution range

640×480 to 4K

Frame rate

Up to 60 fps

Video inputs

Input color spaces

HDMI: RGB 4:4:4, YCRCB 4:2:2, YCRCB 4:4:4
SDI: YCRCB 4:2:2

Interlacing

Yes

Maximum cable length for SDI

300 ftMaximum cable length for
USB 3.0

6 ft

Analog audio inputs(2) XLR pro line level (+4.0 dBu) up to 12.3 VRMS,+24 dBu (balanced/unbalanced, mono or L/R
stereo pair)(1) RCA consumer line level - 10 dBV (L/R stereopair)(2) XLR (female)Connectors(2) RCA (female)

Audio inputs(1) SDI5(1) HDMI
Digital audio inputs4(1) USB(1) RTSP (embedded over Ethernet)(1) SRT (embedded over Ethernet)

14

Pearl Nano User Guide

Pearl Nano Tech specs(1) BNC (female)(1) HDMI type A (female)Connectors(1) USB-A (female)(1) RJ-45 (female)Gain control

0 dB to +30 dB

Mute

Yes
-300 ms to +300 ms

Configurable audio delay
Video output color space

4:2:0, 8 bits per color
H.264/AVC (ITU H.264, ISO/IEC 14496-10) 4:2:0,
8 bit colorl

Encoding profile: High, Main, BaselinelProfile levels: 3.0, 3.1,3.2,4.0,4.1, 5.1

Video codec
H.265/HEVC (ITU H.265, ISO/IEC 23008-2:2013)
4:2:0, 8 bit color
Video processingl

Encoding profile: Mainl

Profile level: 5.1

Bitrate1 to 50 Mbps (selectable)

Bitrate control

Constant

Video scaling

Software and hardware

Key frames

1/2 s, and 1 s up to 5 s in 1 second intervals

Compression

MP3, AAC, and PCM
MP3: 22 kHz, 44 kHz, 48 kHz

Audio processing

Sampling rate

AAC: 16 kHz, 22 kHz, 44 kHz, 48 kHz
PCM: 22 kHz, 44 kHz, 48 kHz

Bitrate64 to 320 kbps (MP3 and AAC)
(1) HDMI 2.0 (port 1)(1) HDMI 2.0a pass-through (port 2)

Video output

Signal types(1) H.264/AVC digital video over Ethernet(1) RTSP(1) SRT (push)15

Pearl Nano User Guide

Pearl Nano Tech specs(1) HLS (push)(2) HDMI
Connectors(1) RJ-45 (female)

Encoded channels

One 1080p channel at 60 fps with up to two fullHD video sources, or one 4K channel at 30 fps
with up 4K video sources (recommended)
MPEG-TS, and FLV
RTSP over TCP/UDP
RTMP/RTMPS

Streaming protocols

SRT (push) over UDP
HLS (push) over HTTP/HTTPSHLS (pull) - Native Apple HTTP/HTTPS stream for
iPad, iPhone and iPod Touch

Stream encryption andauthentication

SRT: 128 bits, 192 bits, or 256 bits AES
encryption (negotiated) and configurable
passphrase
HLS (push): MD5, SHA-256, and SHA-512
RTMPS: encryption plus CA certificate negotiation
Recorded: 480p to 4K
Streamed: 480p to 4K

Resolution ranges
HDMI output ports: 480p to 1080p
HDMI passthrough: 480p to 4K
Frame rate

Up to 60 fps
H.264/AVC (ITU H.264, ISO/IEC 14496-10) 4:2:0,
8 bit color

Formats

Analog audio outputl

Encoding profile: High, Main, BaselinelProfile levels: 3.0, 3.1,3.2,4.0,4.1(1) 3.5 mm stereo headphone jack
RTSP and SRT audio over Ethernet

Audio output
Digital audio outputs

HLS audio over HTTP/HTTPSHDMI audio (embedded)

Monitor and control

Front screen

2.2 inch screen monitor (built in) resolution:
320x24016

Pearl Nano User Guide

Pearl Nano Tech specs

Control key interface

Front panel control keys and multi-function keys

USB keyboard

Connect a standard USB keyboard (optional)
Connect a single USB status light (optional),
supported models:

USB status light-Kuando BusyLight models: UC Alpha and UC
Omega-Delcom Products USB HID single color and multicolor signal indicators

Record formats

AVI, MOV, MP4, and MPEG-TS

File upload formats

JPEG, PNG

SD card

Up to 512 GB7,8

File system for SD card

EXT4Internal storage

SATA M.2 2280 SSD storage7 (M Key connector)

File transfer protocols

FTP, SFTP, SCP, AWS S3 client, and WebDAV
client RSync

Network file share protocols

CIFS/SMB2+

File system for USB storage

FAT16, FAT32, XFS, EXT2, EXT3, EXT4, NTFS

External USB port

(1) USB 3.0 (UAC)

BitrateUp to 50 Mbps

Recording and storage

USB 1.1, USB 2.0, and USB 3.0
USB standards

Serial port

HDCP compliant. Only content that is not HDCPprotected is captured.
(1) Bidirectional RS-232 (via a USB to serial
adapter)
Data bits: 7 or 8 (default)

Communication

Stop bits: 1
Serial protocols
Parity: None
Flow control: None, Hardware or Software
Serial port baud rate

19200 bps

Ethernet host port

(1) RJ-45 (female)

Ethernet data rate

10/100/1000 Base-T, half/full duplex with17

Pearl Nano User Guide

Pearl Nano Tech specs

autodetect

Network security

Maximum Transmission Unit

68 to 1500 MTU (configurable)

Protocols

DHCP Option 81, TLS 1.2, LDAP, mDNS, DDNS,
SAP, RTP, MPEG-TS & RTP and MPEGTS/UDP, 802.1x, EAPOL, EAP-TTLS, EAP-TLS,
PEAP, HTTP, HTTPS, NTP, PTP, FTP, SFTP,SCP AWS S3

Network discovery/Announce

SAP

802.1x EAP methods

PEAP, EAP-TLS, EAP-TTLS
Local web UI for full administration. On-screen
display and mobile UI for confidence monitoring,administration, and control.

Admin panel

Local Admin panel access using an externalmonitor and a USB mouse or keyboard connected
directly to Pearl Nano plus front screen monitor
support.

Epiphan Edge

Cloud-based platform to remotely manage andcontrol Pearl Nano devices. Start and stop
recording/streaming, monitor sources and alert
dashboard, remotely login to Admin panel for
rescue troubleshooting, update firmware andmore from the Internet.

Secure accessMultiple user accounts and passwords. HTTPS for
secure Admin panel access, as well as local
network access to the live channel broadcast.

Remote access:Remote login9 to the cloud version of the Admin
panel.

API

Yes (HTTP/HTTPS or RS-232)

Administration andcontrol

Yes
Crestron driverSee
https://applicationmarket.crestron.com/epiphan/
KalturaIntegrations

Content Management
Systems

PanoptoYuJa
Opencast

Cloud access andEpiphan Edge

18

Pearl Nano User Guide

Pearl Nano Tech specs

management

AC/DC power adapter

Model

SYS1588-3012

Input power rating

90 to 240 VAC, 1.5 ARMS, 47 to 63 Hz

Output power rating

12 VDC, 2.5 A, 30 W

Active efficiency (average):

87.7%

Efficiency (10% load):

86.5%

No load consumption:

0.1 W
Sunny Computer Technology Europe, s.r.oPower adapter manufacturer

Trnkova 156, 628 00 Brno
Czech Republic

GeneralOperating temperature

32° to 104° F (0° to 40° Celsius)

Cooling

Fan air flow: Left to right

Enclosure

Metal

Form factor

Portable desktop model, VESA mountable

Dimensions (W × D × H)

1.13" × 5.91" × 1.69" (206 mm × 150 mm × 43
mm)

Weight2.0 lbs (907 kg)

Power supply

External AC/DC power adapter: 90 to 240 VAC/12
VDC, 2.5 A, 47 to 63 Hz
PoE+ (802.3at)

Input power rating

External AC/DC power adapter: 12 VDC, 1.5
ARMS, 34 W
PoE+ (802.3at): 44 to 57 VDC, 25.5 to 30 W

FCC compliance: Part 15
CE compliance:
Regulatory complianceDirective 2014/30/EU - Electromagnetic Compatibility
Directive 2014/35/EU - Low Voltage Directive
Directive 2011/65/EU - RoHS

Time synchronization

NTP, TIME (RFC 868), PTP v1 (IEEE-1588-2002 V1)Country of origin

Made in Malaysia.

19

Pearl Nano User Guide

Pearl Nano Power adapter specifications

1 Requires 4K feature add on.
2HDCP compliant. Only content that is not HDCP-protected is captured from HDMI
3One of the video sources you connect can be either an RTSP or an SRT source; however, you cannot connect

more than one of these sources at the same time.
4Digital audio is de-embedded from the digital source.
5SD-SDI audio is not supported.
7User supplied.
8SD card is reserved for system use and cannot be used to transfer files to other devices like a laptop. Use a
USB memory device to manually transfer files instead.
9Requires an Epiphan Edge Pro account.

Pearl Nano Power adapter specifications
An AC to DC power adapter model SYS1588-3012 comes with your Pearl Nano.
Table 6 AC to DC power adapter SYS1588-3012 specifications
Parameter

Value

Input voltage

90-240 VAC

Input AC frequency

47 to 63 Hz

Output voltage

12 VDC

Output current

2.5 A

Output power

30 W

Active efficiency (average)

87.7 %

Efficiency (10 % load)

86.5 %

No-load consumption

0.1 W
Sunny Computer Technology Europe, s.r.o

Manufacturer
Trnkova 156, 628 00 Brno, Czech Republic

Optimum System Load
While Pearl Nano is powerful, there is a limit to the number of concurrent tasks the onboard CPU can perform
efficiently.
The number of concurrent tasks depends on many factors, such as:lthe number of video sourceslwhat frame rate and bitrate is used for a channellif the video output ports are used20

Pearl Nano User Guidel

Optimum System Load

if a live monitor is connected to the HDMI output port (about the equivalent of an encoded 1920×1080@30
fps channel)

For best results, we recommend keeping System load usage under 70%.

Check CPU usage on Pearl Nano's front screen
To check the CPU usage from the front screen menu, repeatedly press the left arrow key on the control interface
until the Menu screen displays.

Use the arrow and check mark keys to select System, and then select Device information to display the Device
information screen.

Recommendations
If the system load is higher than recommended, you can:lDisable the video output port (if unused).

l

Stop channel(s) that are streaming or recording.

lEnsure video sources come in at the right resolution so that Pearl Nano doesn't have to up scale or down
scale the video source.

21

Pearl Nano User Guide

International character support

International character support
You can include certain international characters in the channel name, layout name, video and audio input
names, text overlays, and in the name of recorded files. Common character sets for the following languages areapproved:lWestern European/Nordic languages: Danish, Dutch, English, French, German, Icelandic, Italian,
Norwegian, Portuguese, Spanish, and Swedish.

lCentral/Eastern European languages: Bosnian, Croatian, Czech, Hungarian, Polish, Romanian, Slovak,
and Russian.

Important considerationsl

Use only alphanumeric and diacritic characters in metadata descriptions. The whole metadata string isrefused if any special currency or mathematical symbol appears in the description. You must remove theoffending characters before Pearl Nano will accept the description, see Add or remove channel metadata.

l

Do not include any special currency, mathematical symbols, and other special characters such as slashes
or spaces in the channel name. Pearl Nano replaces special characters with an underscore.

Quick start
After you've unpacked your Pearl device, you're ready to get started. This quick start uses the default settings
where possible so you can quickly start using your Pearl device.

Before you begin, make sure you have:l

A video source such as a camera or computer and cables to connect them to Pearl device. For HDMI, thevideo source must not be HDCP protected.

l

An audio source coming from either your SDI or HDMI video source (must not be encrypted). Optionally,
audio from a different source such as an audio mixer that you connect to the audio input ports can beused.
l

The Pearl Mini, Pearl Nexus and Pearl 2 can use USB for video input.

l

The Pearl Nano can use the USB input for audio input.

lLocal area network that uses Dynamic Host Configuration Protocol (DHCP) is preferable.

lComputer with a web browser connected to the same network. We'll call it the “admin” computer.

lEthernet cables to connect Pearl device and the admin computer to the network.

l

To record video using Pearl Nano or Pearl Mini, you need to install a storage medium. Pearl Nano andPearl Mini have a standard SD card slot on the front panel that you can use.
l

We recommend an SD card that is at least a class 10 with up to 512 GB of capacity.

l

Pearl Nano and Pearl Mini (bought after June 1st 2024) also has a SATA M.2 2280 SSD storage
expansion slot that's accessible from the underside.

22

Pearl Nano User Guide

Next StepsYour Pearl device comes shipped with an AC/DC power adapter and a registration card that contains brief
instructions to connect the Pearl device to the network, login to the Admin panel, and format an SD card. The
instructions in this quick start provide more details.

Start up the Pearl device for the first time
1. Turn on your camera or video source and connect the output to the back panel of Pearl device.

2. Connect the Ethernet cable to the Pearl device and to your network. Pearl Nano can power up using thepower from the Ethernet cable if your network supports PoE+ power. If you are using PoE+ power with a
Pearl Nano, you can skip the next step.

3. Attach the power cable and plug it into a power source.
If you are using a Pearl Nano and your network supplies PoE+ power, then you can skip thisstep.
4. Turn on the system:l

Pearl Nano - will automatically turn on when connected to power. Wait for the power-up cycle tocomplete and the Auto channel to appear on the front screen. If your video source has a signal, thevideo displays on the front screen. If you don't see the Auto channel displayed on the front screen,press the left arrow key on the control key interface to cycle through the different views.

5. (Required for recording on Pearl Mini and Pearl Nano) Install and format a storage solution. For more
information, see Install and format an SD card for the Pearl Mini and Pearl Nano orInstall and format a
SATA M.2 2280 SSD for Pearl Nano .
6. (Optional) Plug headphones into the 3.5 mm headphone jack at the front of the Pearl device to monitor thevideo signal's embedded audio. For more about monitoring audio, see Monitoring audio.
7. (Optional) Start recording:a. Pearl Nano - press the Record key on the front panel to start and stop recording the channel.
Recordings are saved to the SD card on Pearl Mini and Pearl Nano by default. When the SD card is full,new recordings overwrite the oldest recordings. Do not eject the SD card while recording is in progress asthat may corrupt the SD card.

Next Steps
Now that you have a video source connected (and an SD card installed and formatted for Pearl Mini and Nano),
you can fine-tune Pearl device to your exact requirements. Take a look at topics such as:23

Pearl Nano User Guidel

Register your devicelWhat is a channel?

lCustom layout configurationlWhat is streaming?

l

Selecting an audio sourcelVideo output portslAutomatic file transfers

Pearl Nano sample recording

When you're done setting up your Pearl device, make sure to back up the system configuration using theprocedure described in Create a configuration preset.

Pearl Nano sample recording
When you power up Pearl Nano, you can start recording as soon as you connect a video source to one of thevideo input ports and have a formatted SD card installed.

Record the default Auto channel using the Record control key
To record the default Auto channel using the control key on the front panel of Pearl Nano, simply press the
Record key. When you're done, press the Record key again to stop. The Record key is lit red while
recording is in progress.

Record the default Auto channel and download the file using the Admin panel
The SD card uses the EXT4 format and you cannot manually transfer recordings off the SD card directly to iOS orWindows systems. Instead, download your recording using the Admin panel .
1. Open a web browser on the admin computer and go to the IP address of your Pearl Nano and log in, see
Access network IP address and Admin panel.
2. From the Channel menu in the Admin panel, select your channel (i.e. Auto) and select Recording. The
Recording page for the channel opens.

24

Pearl Nano User Guide

Pearl Nano sample recording

3. Select Start to start recording the channel and click Stop when you're done.

4. Refresh the page to see the newly recorded file appear in the Recorded Files list.
5. Select the file in the list and download that recording to your admin computer.

Register Pearl Nano to get firmware updates
Keep Pearl Nano up-to-date and get all the latest features and firmware updates. Registering your Pearl Nano isfree and only needs to be done once. You can register anytime from the Firmware update page using the Admin
panel, see Register your device

25

Pearl Nano User Guide

Setup

Setup
This section contains tasks that are needed to get Pearl Nano configured.
Topics include:lUser interfaces and remote accessl

Configure network settingslConfigure network securitylConfigure date and timelConfigure device info, name, description, and locationl

Audio input portslVideo output portslFeature add-onslConnect an external keyboardlConnect a USB status lightlConfiguration presetslUser administrationlStatus and monitoring

For information about integrating with Content Management Systems (CMSs) like Panopto and related
administrator tasks, see Integration.

Access network IP address and Admin panel
You can get the network IP address of your Pearl device from the front screen menu. With the device IP address,
you can access the Admin panel to do things like configure the Pearl device, start/stop recording, and more.
Make sure that your admin computer is connected to the same network as Pearl device and that the network
uses DHCP.
If your network requires you to assign the Pearl device a static IP address instead of using DHCP to
obtain one, contact your network administrator and see Connect using persistent static IP address.

Obtain the IP address of the Pearl device and access the Admin panel
1. Press the left arrow on the interface until the System status screen appears. On the Pearl 2 and Pearl
Mini, you will have to press the gears icon first.

26

Pearl Nano User Guide

Vesa mounting the device

2. Using a browser on the admin computer, enter the URL for your Pearl device and include /admin toaccess the Admin panel.
http://<IP Address for Pearl device>/admin
For example: http://192.1.10.100/admin
3. When prompted, log in using the default user name admin and the administrator account password. If you
don't know the password, contact your Pearl system administrator.
For a first-time set up, you're prompted to assign passwords to the admin, operator, andviewer accounts. Record the passwords for future reference.
4. (Optional) Open a new tab in your browser and enter the URL to preview a channel.
http://<IP Address for Pearl device>/preview.cgi?channel=1
For example: http://192.1.10.100/preview.cgi?channel=1
For more details about accessing the Admin panel, see Connect to the Admin panel. For more information aboutuser accounts and passwords, see User types and privileges.

Vesa mounting the device
The rear panel of the Pearl Mini and Pearl Nano has vesa mounting holes to fit a standard, 75mm × 75mm vesa
mount. Use four M4 screws with a maximum length of 5mm to mount the plate to the rear panel of the Pearldevice.

27

Pearl Nano User Guide

User interfaces and remote access

Do not insert screws longer than the recommended 5mm. Using longer screws can damage thedevice.

User interfaces and remote access
Pearl devices have several user interfaces:lFront screen and control keys: Easily accessible on the front panel of Pearl Nano, the front screen andcontrol key interface are primarily used for easy device setup, confidence monitoring, and One Touch
streaming and recording control, see About the front screen and control key interface.

lAdmin Panel: A web-based user interface that's primarily used to perform system set up andadministrative tasks for your Pearl device. You can access the Admin Panel using an internet browser on
a computer or tablet that's connected to the same local Ethernet network as your Pearl device, or locallyusing a USB mouse, keyboard, and monitor connected directly to the Pearl device. See About the Admin
panel.

Start and stop recording/streaming, monitor video sources, view status and alerts, remote rescue
troubleshooting and more over the Internet using Epiphan Edge, see Cloud-based device management. For
remote login access to your Pearl device, see Remote login to the Admin panel and Epiphan Live.

Pearl Nano's front panel control interface
The front screen and control key interface on Pearl Nano have many functions, including confidence monitoring,
starting and stopping recording and streaming, configuring settings using the front screen menu, loading
configuration presets, viewing system information, and more.
Topics include:lAbout the front screen and control key interfacel

The front screen Channel viewl

The front screen menu and control keyslRecord and stream using the control keys

28

Pearl Nano User Guide

About the front screen and control key interfacel

Dim the front screen and control interfacel

Set the Pearl device screen timeoutl

Set a PIN security codel

One Touch streaming and recording control

To view system information using the front screen, see View system status using the front screen menu
To select the video source for the output port using the front screen when local console is enabled, see Selectthe video output source using the device screen.
To start and stop scheduled and ad hoc events for Kaltura and Panopto using the front panel control interface,see Stop/start scheduled CMS events using Pearl Nano's front screen menu.

About the front screen and control key interface
Pearl Nano's front screen and control key interface has multiple uses, including confidence monitoring, basic
configuration, diagnostics, plus quick access streaming and recording control.
When you power on , the Channel view displays the Auto channel by default. In this example, the auto channelshows a video source that is connected. Dashes in the footer indicate there is no record medium installed yet (i.e.
no SD card or SATA M.2 SSD installed) and no streams are configured for the channel. Otherwise, the recordand stream timers would appear at the bottom of the screen.

If no video sources are connected or your sources aren't sending a signal, the Channel view shows
the no signal image.
If you don't see the Channel view displayed on the front screen, press the left arrow key (or the right arrow key)on the control key interface to cycle through the different views. You can use the control keys to change views on
the front screen and navigate the front screen menu. Pressing the check mark key selects a highlighted menu
option.

29

Pearl Nano User Guide

About the front screen and control key interface

The Record and Stream control keys on the front panel are used to start and stop recording or streaming,
respectively. Their color and brightness change under different conditions.
Table 7 Front panel record and stream control key conditions
Icon

Description
Record control key used to stop and start recording the channel.
lGlows solid white when an SD card (or SATA M.2 SSD) is installed and formatted.

lGlows solid red when the channel is actively recording.

lFlashes red on/off if there is an error while recording.

lSolid off (white) when no storage medium is installed and formatted, or when Pearl
Nano is powered off.

Stream control key used to stop and start streaming the channel.
lGlows solid white when a stream is configured for the channel.

lGlows solid blue when the channel is actively streaming.

lFlashes blue on/off if there is an error while streaming.

l

Solid off (white) when no stream is configured for the channel or when Pearl Nano is
powered off.

A default No Signal screen appears if no video sources are connect to Pearl Nano for the Auto channel to pickup. The No Signal screen also appears if the channel's layout does not include the video source when the Autochannel has been renamed and is no longer functioning as an automatic channel.

30

Pearl Nano User Guide

About the front screen and control key interface

By default, full access to the front screen and control interface is enabled. To control access to the front screen
and control interface, you can set a PIN using the Admin panel. When a PIN is set, the front panel controls arelocked. Users must unlock the screen to access the different views on the front screen and to start/stop
streaming or recording using the Record and Stream control keys.

A virtual keyboard for entering the PIN appears on the front screen; however, you can connect an external USB
keyboard if Pearl Nano is configured to allow that.

Related links
The front screen Channel view
The front screen menu and control keys
Record and stream using the control keys
Dim the front screen and control interface
Connect an external keyboard

31

Pearl Nano User Guide

The front screen Channel view

The front screen Channel viewAfter you power on the Pearl Nano, the Channel view displays automatically. If you don't see the Channel view
displayed on the front screen, press the left arrow key on the control key interface to cycle through the different
views.

You can hide the header and footer bars on the Channel view by pressing the check mark key.
Press the check mark key again to show the header and footer bars.
Table 8 Parts of the front screen for the Channel view
Item

Description

1

Channel resolution and frame rate.

2

Channel name.

3

Preview of the channel video source used for confidence
monitoring. If no video source is connected or there is no video
signal, the default No Signal screen displays.

4

Recording indicator and timer. The recording timer shows thelength of time that recording has been in progress. If dashes
appear in place of the timer, there is no SD card or SATA M.2
SSD installed and formatted.

5Streaming indicator and timer. The streaming timer shows thelength of time that streaming has been in progress. If dashes
appear in place of the timer, there are no streams configured
for the channel.

6

Audio VU meter using quasi-peak ballistics with samples
averaged every 10 ms. The maximum average audio level ineach 100 ms period is displayed using colored bars.

32

Pearl Nano User Guide

Item

The front screen menu and control keys

Descriptionl

RED = 0 to -9 dBFSlYellow = -9 to -18 dBFSlGreen = -18 dBFS and lower

The front screen menu and control keys
The front screen menu lets you view Pearl Nano settings and do basic configuration, like setting a static
IP address and choosing which video source appears on the HDMI OUT port. The control key interface on thefront panel lets you change views on the front screen and navigate the front screen menu.

If you don't see the front screen menu displayed on the front screen, press the left arrow key (or the right arrowkey) on the control key interface to cycle through the different views. Pressing the left arrow key is mentioned
throughout the user guide, but you could use either key to navigate.
Pressing the check mark key selects a highlighted option. In this example, pressing the check mark key while
Channel is highlighted on the Menu screen opens the Channel screen. The small arrow head at the end of a row
indicates more options.

The check mark key also toggles a switch on and off.

33

Pearl Nano User Guide

Record and stream using the control keys

Darkened rows are not selectable and the fields are read only. In the example DHCP enabled screen, the IP
address, Network mask, and Network gateway are all read only fields.
There are many functions you can perform using the front screen menu, like temporarily dimming the front
screen and control keys when you select System > Controls > Front screen. Just press any key on the front
panel of Pearl Nano to restore the screen and key luminance.

Record and stream using the control keys
Simply press the Record control key on Pearl Nano's front panel to easily start and stop recording a channel.
The Record control key glows solid red and the recording timer on the Channel view increments while recording
is in progress. When you're done, press the Record control key again to stop recording.

A formatted SD card (or SATA M.2 2280 SSD) must be installed and formatted before you can record video, see
SD card and SATA M.2 2280 SSD storage. If no record medium is available, dashes display in place of therecording timer and the Record control key does not light.
To start and stop streaming, simply press the Stream control key on Pearl Nano's front panel to easily start andstop streaming a channel. The Stream control key glows solid blue and the streaming timer on the Channel view
increments while streaming is in progress. When you're done, press the Stream control key again to stop
streaming. If multiple streams are configured for the channel, pressing the Stream control key starts and stops all
streams at the same time.

34

Pearl Nano User Guide

Dim the front screen and control interface

A stream must already be configured for the channel. If no stream is configured, dashes display in place of thestreaming timer and the Stream control key does not light. To configure a live stream, see Streaming to a CDN,
multicasting, and streaming to multiple destinations.
Pearl Nano also features One Touch control, which lets you start/stop streaming and recording at the same timewith the touch of a button. For more information, see About One Touch streaming and recording.

Dim the front screen and control interface
You can temporarily dim the front screen and control keys using the front screen menu. Just press any key on thefront panel of Pearl Nano to restore the screen and key luminance. Alternatively, you could set an inactivity
timeout and automatically dim the screen and control keys using the Admin panel, see Set the Pearl device
screen timeout.

Dim the front screen and control interface using the front screen menu
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Controls toopen the Controls screen.

35

Pearl Nano User Guide

Set the Pearl device screen timeout

3. From the Controls screen, press the check mark key to select Front screen.

4. Press the check mark key to Turn off front screen or press the left arrow key to return to the previous
screen without dimming the front screen and control key interface.

Set the Pearl device screen timeout
Initially, the Pearl device screen is always on for easy monitoring. However, you can set the screen to shut off
after a given amount of time. To re-enable the screen after it times out and shuts off:lPress any key on the front panel of Pearl Nano.

Set the screen timeout using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Touch Screen (Front Screen for Pearl Nano). The Touch
screen/Front screen configuration page opens.
3. Enter the number of seconds before the screen automatically shuts off in the Timeout field. A value of 0
keeps the screen on at all times when the system is on.
4. Click Apply.

36

Pearl Nano User Guide

Set a PIN security code

Set a PIN security code
You can set a PIN code to protect the Pearl device screen from unauthorized access. By default, the PIN is not
set.
If a PIN is configured, users are prompted to enter the PIN code whenever:l

You power on or restart the Pearl device.

l

The Pearl device recovers from timeout mode, see Set the Pearl device screen timeout.

If you set a PIN when the start screen is in locked mode, a lock appears in the top right of the start screen. You
must enter the PIN to unlock the start screen, access other screens, and use the Record and Stream Control
keys to start and/or stop recording or streaming. When you return to the Single Touch control or CMS start
screen, the Pearl device automatically locks itself and you must re-enter the PIN to unlock the screen.
If no PIN is set when the start screen is in locked mode, you can access the configured start screen right away.
Anyone can quickly start/stop streaming and recording if the Single Touch control start screen is configured, or
start/stop an event if the start screen is configured for Content Management System (CMS). However, no otherscreens are accessible using the Pearl device screen.

Set a device screen PIN security code using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Touch Screen (Front screen for Pearl Nano) . The Touch
screen/Front screen configuration page opens.
3. Enter a 4 to 12-digit PIN code in the PIN field, then click Apply. The Pearl Nano can only accept 4 digits.
Record the PIN code in a safe location for future reference. You need this PIN to access thePearl device screen.

One Touch streaming and recording control
You can easily control both streaming and recording with the press of a single button on the front panel of Pearl
Nano.
Topics include:lAbout One Touch streaming and recordinglEnable One Touch control

About One Touch streaming and recording
The One Touch feature lets you control both streaming and recording at the same time with the press of a single
button. Once enabled, simply press either the Stream control key or the Record control key on the front panel of
Pearl Nano to start/stop streaming and recording the channel.
The Record control key glows solid white when an SD card (or SATA M.2 2280 SSD) is installed and the Stream
control key glows solid white if there are streams configured for the channel.

37

Pearl Nano User Guide

One Touch streaming and recording control

The colors of the control keys change when the channel is actively streaming and recording. A flashing control
key means there's a problem with the settings for that particular function and the stream (or the recording) did notstart.

You can enable and disable One Touch control using the Admin panel when you select Configuration > Front
screen or using the front screen menu when you select System > Controls. See Enable One Touch control for
details.
The following table describes the One Touch control state changes when you press the Record and Stream
buttons on the front panel of Pearl Nano.
Table 9 Button control when One Touch streaming and recording is enabled
Condition

Button action

ResultStreaming and recording are Off.

Press Stream or
Record.

Streaming and recording starts.

Streaming and recording are On.

Press Stream or
Record.

Streaming and recording stops.

Streaming is started using the Admin
panel and recording is Off.

Press Stream.

Streaming stops.

Streaming is started using the Admin
panel and recording is Off.

Press Record.

Recording starts and streaming
continues.

Recording is started using the Admin
panel and streaming is Off.

Press Stream.

Streaming starts and recording
continues.

38

Pearl Nano User Guide

Condition

One Touch streaming and recording control

Button action

ResultRecording is started using the Admin
panel and streaming is Off.

Press Record.

Recording stops.

While streaming and recording are On,
stop recording using the Admin panel.

Press Record.

Recording restarts and streaming
continues.

While streaming and recording are On,
stop streaming using the Admin panel.

Press Record.

Recording stops (the stream remains
stopped)While streaming and recording are On,
stop streaming using the Admin panel.

Press Stream.

Streaming restarts and recording
continues.

A storage medium must be installed in Pearl Nano before you can record any content using One Touch control
and streaming destinations must already be configured for the channel. For details, see SD card and SATA M.2
2280 SSD storage and Streaming to servers, CDNs, and other devices.

Enable One Touch control
One Touch streaming and recording control is disabled by default. You can enable and disable One Touchcontrol using the Admin panel or from the front screen menu on Pearl Nano.

Enable or disable One Touch control using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Front screen. The Front screen configuration page opens.
3. Check One Touch control and click Apply.

39

Pearl Nano User Guide

The Admin panel

Enable One Touch control using the front screen menu
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Controls toopen the Controls screen.

3. From the Controls screen, use the arrow keys to highlight One Touch control and press the check markkey to toggle the switch on or off.

The Admin panel
The Admin panel is used primarily to set up Pearl Nano and perform administrative tasks. Most tasks in this user
guide are performed using the Admin panel. This section contains what you need to get started using the Admin
panel.
Topics include:lAbout the Admin panellConnect to the Admin panellEnable local console access to the Admin panellConnect using a DNS-based service discoverylConnect using persistent static IP address

40

Pearl Nano User Guide

About the Admin panel

For information about remote access to the cloud version of the Admin panel, see Remote login to the Admin
panel and Epiphan Live.
For information about integrating Pearl Nano with Content Management Systems (CMSs) and related
administrator tasks, see Integration.

About the Admin panel
The Admin panel is a web-based user interface that's used primarily to set up your Pearl device and perform
administrative tasks.

41

Pearl Nano User Guide

About the Admin panel

Table 10 The Admin panel
Label

1

Name

Description

Channels menu

The channels that are available for the current configuration of yourPearl device are listed. Select a channel to access the drop down listof options that are available to configure channel encoding, add video
and audio sources, create layouts, perform confidence monitoring,record the channel, and more.

(Channel menu on Pearl
Nano)

The Pearl Nano has a single channel.

Multitrack recorders menu
(Pearl Mini, Pearl-2 andPearl Nexus only)

Recorders you add to your Pearl device are listed. Select a recorder toopen the status page and list of related recordings for that recorder.
You can start and stop recording, as well as configure the recorder
settings from this page.

3

Inputs menu

The available video and audio input ports on your Pearl device arelisted. Select a port to open the configuration and status page for that
port.

4

Output ports menu

The output ports available on your Pearl device are listed. Select a
port to open the configuration and status page for that port.

5

Events menu

Access the Content Management System (CMS) events list containing
up to three months of scheduled CMS events, in progress events, andcompleted ah hoc and scheduled events.

6

Configuration menu

A list of all the available configuration options.

7Internal storage andsystem information menu

System details are displayed in this area, such as the total amount ofinternal storage, how much space is currently used, and how muchfree space is available.

8

Main panel

The main panel is where the selected menu information displays.
What's displayed depends on which menu item you select.

9

Link to Epiphan Live
(Pearl-2, Pearl Mini, andPearl Nexus only)

Click to open Epiphan Live in a new tab.

Log out

Click to log out of the Pearl admin panel. Click icon again to display thelog in window. The role of the currently logged in user displays besidethe icon.

2

10

You can access the Admin panel using these methods:

42

Pearl Nano User Guide

Connect to the Admin panell

Any web browser, see Connect to the Admin panel.

lUsing a connected USB mouse, keyboard, and monitor, see Enable local console access to the Admin
panel.

lRemotely using Epiphan Edge, see Remote login to the Admin panel and Epiphan Live.

Connect to the Admin panel
You can access the Admin panel several ways. The most common way is using an internet browser on acomputer or tablet that's connected to the same local Ethernet network as Pearl device. All you need is the IP
address of the device, which you can get from the settings using the Pearl device's front screen.
Another way to access the Admin panel is to remotely login over the Internet. An Epiphan Edge premium plan isrequired for remote login, see Remote login to the Admin panel and Epiphan Live.

Get the IP address of Pearl Nano
To get the IP address of Pearl Nano, press the left arrow key repeatedly on the control key interface until the
System status screen displays.

You can also find the IP address of Pearl Nano from the front screen menu when you selectSystem > Network.

Access the Pearl Admin panel
1. When you have the IP address of the Pearl device, enter the URL for your Pearl device into a web browser
and include /admin to access the Admin panel.
http://<IP Address of Pearl device>/admin

If HTTPS is enabled on the Pearl device, replace http with https in the URL.

43

Pearl Nano User Guide

Enable local console access to the Admin panel

2. When prompted, log in using the default user name admin and the administrator account password, thenclick OK. If you don't know the password, contact your Pearl system administrator.
For a first-time log in as an administrator-level user, you're prompted to assign passwords to theadmin, operator, and viewer accounts. Record the passwords for future reference.
Optionally, you can connect to your Pearl device using the following methods:l

For networks with DHCP, you can Connect using a DNS-based service discoverylFor networks without DHCP, you can Connect using persistent static IP address

Enable local console access to the Admin panel
Operators and administrators can access the Admin panel locally to reconfigure the Pearl device without
needing a laptop. With the local console feature, you can connect a USB mouse, keyboard, and a monitor
directly to Pearl device. Or you can connect a touch screen monitor. The Pearl device also supports connectionof a USB wireless RF receiver for local console. Pearl Nano also supports the connection of a USB hub.
A built-in virtual keyboard is readily available, but you can also connect an external USB keyboard. When you
enable local console, you must also enable the External keyboard option.
Use the Admin panel or the Pearl device screen to enable local console and the external USB keyboard. Onceenabled, simply connect your USB mouse, USB keyboard, and an HDMI monitor to the HDMI OUT port that has
local console enabled. You cannot use the HDMI pass-through port for local console.
Optionally, you can disable whether or not users must login to the Admin panel when they access the local
console. Login is enabled by default.
You can also change the layout of the built-in and external keyboards to any of the supported languages. If you
select multiple languages, you can toggle between languages using Ctrl+Shift (or Ctrl+Alt).
l

American English

l

Dutch

l

FrenchlGermanl

ItalianlNetherlandslPortuguese (European)l

Spanish (Spain)

l

Swiss

l

Norwegian (Bokmal)l

Russian44

Pearl Nano User Guide

Enable local console access to the Admin panel

Important considerationsl

The live preview link is not accessible from the Channel Status page using the local console.

lViewing recordings from the Recording section of a Channel is not possible.

l

You cannot upload/download the following types of media using the local console:lImagesl

Channel recordingsl

EDID fileslConfiguration fileslFirmware update files

Use the web-based Admin panel from your administration computer for full access to all Admin
panel functions.

Enable local console and the external keyboard option using the Admin panel
1. Login to the Admin panel as admin, see Enable local console access to the Admin panel.
2. From the Configuration menu, select External keyboard. The External keyboard configuration pageopens.
3. Select Local console as the Keyboard application and click Apply.
4. (Optional) Check a different keyboard language layout or multiple language layouts. The default layout isAmerican English.
5. (Optional) Choose the keyboard key combination to toggle between keyboard layouts if multiple
languages are selected: Ctrl+Shift or Alt+Shift.
6. From the Output ports menu, select the output port (HDMI). The video output port configuration pageopens.
7. Under Settings, select Local console in the Source drop-down menu and click Apply.
If you skipped the steps to configure the external keyboard for local console, an error message appears.
Click the link to fix it.
8. (Optional) Check Disable authentication if you don't want users to have to use their credentials to log in
before using the local console to access the Admin panel on the Pearl device.
9. Under Settings, select Local console in the Source drop-down menu.
10. Click Apply.

45

Pearl Nano User Guide

Enable local console access to the Admin panel

Enable local console using the front screen menu
1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Settings toopen the Settings screen.

3. From the Settings screen, select HDMI output to open the HDMI output screen, then press the check
mark key to select Video and display the available video sources.

4. Highlight the video source you want, then press the check mark key to select and return to the previous
screen. To return to the previous screen without making a selection, press the left arrow key.

46

Pearl Nano User Guide

Connect using a DNS-based service discovery

What's next?
Connect your USB mouse, keyboard, and connect an HDMI monitor to the output port that has local console
enabled to access the local console directly from the Pearl device.

Connect using a DNS-based service discovery
Pearl devices use DNS-based messages to advertise details about itself, including its host name. With acompatible utility installed on your computer, you can access the system simply by typing its serial number andthe suffix ".local" into the address bar of your browser.
The following table lists the compatible systems and Bonjour Print Services software needed.
Table 11 Install Bonjour Print Services
SystemAction Needed
You must install Bonjour Print Services:

Microsoft Windows

1. Use the following URL http://support.apple.com/kb/DL999
2. Click Download.
3. Follow the system prompts to download and install the application.

Mac OS X

The Bonjour software used for service discovery is built into the Mac OS. No special
actions are needed.

Linux

The Avahi implementation used for DNS-based discovery is shipped with most Linux
distributions. If necessary, check with your administrator to ensure you have the Avahi
package installed.

Access the Admin panel of the Pearl device using DNS discovery
1. Find the system’s serial number that's printed on a label attached to the device. To find the system serial
number using the device screen, do the following:lPearl Nano: Use the arrow keys and check mark to navigate the front screen menu and selectSystem > Device information.

2. Enter the following string into the address bar of your web browser on your admin computer, where<serial> is the serial number of your Pearl device:
http://<serial>.local/admin
For example: http://95dd40d5.local/admin

If HTTPS is enabled on the Pearl device, replace http with https in the URL.

47

Pearl Nano User Guide

Connect using persistent static IP address

3. Log in as an administrator using the default user name admin and the administrator account password,
then click OK to open the Admin panel. If you don't know the password, contact your Pearl systemadministrator.
For a first-time log in as an administrator-level user, you're prompted to assign passwords tothe admin, operator, and viewer accounts. Record the passwords for future reference.
4. (Optional) From the Configuration menu, click Network and note the IP address of the system from the
network configuration page.

Connect using persistent static IP addressYour Pearl device has a default persistent static IP address, also known as the recovery IP address. To set up a
Pearl device on a network that does not support DHCP, or to recover from a previous static IP address setting,use this procedure to connect directly to the device for configuration.
A workstation computer with access rights to modify your network settings is required.
Pearl device static IP address defaults are:l

IP Address: 192.168.255.250lNetmask: 255.255.255.252

lUsername: adminlPassword: your admin password (by default there is no password assigned)

Access the Admin panel using the persistent static IP address
1. Establish an Ethernet connection between Pearl device and the workstation using one of the following
methods:a. Connect the Pearl device to a local Ethernet network shared with the workstation.
b. Connect the Pearl device directly to the workstation’s Ethernet port using either a regular or acrossover Ethernet cable.
2. Record the network settings of the workstation that are used to connect to the Pearl device so that they
can be restored later.
3. Temporarily change the network configuration on the workstation to the following:l

Use Static IP assignmentl

IP address: 192.168.255.249

lSubnet mask: 255.255.255.252

4. Start a web browser on the workstation and go to: http://192.168.255.250/admin/
If HTTPS is enabled on the Pearl device, replace http with https in the URL.

48

Pearl Nano User Guide

Cloud-based device management

5. Log in as an administrator using the default user name admin and the administrator account password,
then click OK to open the Admin panel. If you don't know the password, contact your Pearl systemadministrator.
For a first-time log in as an administrator-level user, you're prompted to assign passwords tothe admin, operator, and viewer accounts. Record the passwords for future reference.
6. From the Configuration menu, click Networking.
7. Click use a static address and enter a static IP address and network settings you want for the Pearldevice. For more information, see Configure network settings.
8. Restore the previously saved network configurations on the workstation.

Cloud-based device management
Epiphan Edge is where remote teams can conveniently manage and control all Pearl devices together in one
place. An Internet connection and a free Epiphan Cloud account is all you need to get started.
When Pearl Nano is paired with your Epiphan Cloud account, you can start/stop video recording and streaming,monitor the health of Pearl Nano with status alerts and a diagnostics dashboard, monitor video feeds, update
firmware remotely, and even remotely configure channel encoding.
Topics include:lAbout Epiphan Edgel

Enable or disable Epiphan Edge accessl

Pair and unpair from Epiphan EdgelRemote login to the Admin panel and Epiphan LiveFor more information about Epiphan Edge, see the Epiphan Edge User Guide.

About Epiphan Edge
Epiphan Edge is your remote management and control center for all your Pearl devices. All you need is a free
Epiphan Cloud account.
After you pair you Pearl devices with your Epiphan Cloud account, you can access Pearl devices from anywhere
there's an Internet connection. You can even invite others to join your team for easy remote access.
Using Epiphan Edge you can:lPreview video sources and audio.

lStart/stop channel recording and streaming remotely.

lRemotely configure channel encoding.

lCreate live streams.

lMonitor performance statistics and system alerts 24/7.

49

Pearl Nano User Guide

Enable or disable Epiphan Edge accessl

Set up custom email alerts.

l

Set up remote teams and assign team members access and control levels.

lPerform updates and batch operations for efficient fleet management.

lRemotely log in to cloud versions of the Admin panel for remote rescue troubleshooting, full administration
access, and to control recording and streaming using the Admin panel.

lSchedule the start time, end time and date for Pearl systemto record and/or stream.

For more information about Epiphan Edge features and functions, see the online Epiphan EdgeUser Guide.

Important considerationsl

The following actions cause a Pearl device's entry in Epiphan Edge to permanently go offline. You mustpair Pearl devices again to remotely control, monitor, or configure Pearl devices using Epiphan Edge.
l

Unpairing Pearl devices in Epiphan Edge.

l

Using the Admin panel to disable the Epiphan Edge feature on a Pearl device while the device ispaired to Epiphan Edge.

l

If you pair a Pearl device again after you have successfully unpaired from Epiphan Edge, a new device
instance is created in Epiphan Edge. The previous instance for the Pearl device remains permanently
offline.

lSome features like batch operations and remote login require the Epiphan Edge Premium plan.

Enable or disable Epiphan Edge accessEpiphan Edge is where you go to remotely manage and control all your Pearl devices. Access is enabled on
Pearl devices by default. All you need to do is pair the Pearl device to your free Epiphan Edge account for accessto your device over the Internet. You can disable Epiphan Edge access on Pearl device from the device screen or
using the Admin panel and enable it again later. Access is enabled by default.

Important considerationslUnpair the Pearl device from Epiphan Edge before disabling Epiphan Cloud access on the Pearl device
using the Admin panel.

l

If you disable Epiphan Edge access while the Pearl device is paired, the device instance in Epiphan Edge
goes permanently offline. For more information, see Pair and unpair from Epiphan Edge.

Enable or disable Epiphan Edge access using the Admin panel
1. Log in as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance. The Maintenance page opens.
3. Uncheck Enable Epiphan Edge to disable the feature or leave it checked to allow the Pearl device toaccess Epiphan Edge. Click Apply to save your changes.

50

Pearl Nano User Guide

Pair and unpair from Epiphan Edge

Enable or disable Epiphan Edge access using the front screen menu on Pearl Nano
1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Settings toopen the Settings screen.

3. From the Settings screen, select Epiphan Edge to open the Epiphan Edge screen.

4. Highlight Enable Epiphan Edge and press the check mark key to toggle the switch on or off.

Pair and unpair from Epiphan Edge
To manage your Pearl devices from the cloud or access the Admin login feature, the Pearl devices must be
paired to your Epiphan Cloud account.
Easily pair the Pearl devices directly from the Admin panel or add a Pearl device as a new device in Epiphan
Edge using the Pearl device's device ID paring code. To manually pair a Pearl device in Epiphan Edge using thedevice's pairing code, see the Epiphan Edge online user guide.
You can unpair from Epiphan Edge using the Admin panel or directly within Epiphan Edge. Each time you unpair
the Pearl device, the device ID pairing code changes value. When you pair the Pearl device again, a new
instance of the Pearl device with a different device ID is created in Epiphan Edge.
If you unpair from Epiphan Edge using the Admin panel, the Pearl device's status in Epiphan Edge
only changes to the offline state. To completely unpair the Pearl device from Epiphan Edge, youmust use Epiphan Edge to unpair your Pearl device.

Important considerationsl

The Pearl device's entry in Epiphan Edge permanently goes offline when you unpair. You must pair the
Pearl device again to use Epiphan Edge to remotely manage or log in to the Pearl device.

51

Pearl Nano User GuidelPair and unpair from Epiphan Edge

If you pair the Pearl device again after you have successfully unpaired from Epiphan Edge, a new device
instance is created in Epiphan Edge. The previous instance for the Pearl device remains permanently
offline, which you can delete at any time.
You can still access information about permanently offline device instances in Epiphan Edge.

Pair and unpair Pearl devices using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Epiphan Edge. The Epiphan Edge status page opens. The pairing
code device ID for the Pearl device is shown, as well as a link to pair the device.
3. Select Click to pair. The Epiphan Cloud login page opens in a new tab (https://go.epiphan.cloud)
4. Log in to your existing Epiphan Cloud account or sign up for a free account.
5. After you've logged in to Epiphan Cloud, your Pearl device automatically pairs to your default Epiphan
Cloud team and the Device Details page opens in Epiphan Edge. If you have multiple teams associatedwith your account, you're prompted to select a team.
6. In the Admin panel, the status of the Pearl device updates to paired on the Epiphan Edge status page.
7. To unpair a Pearl device using the Admin panel, select Unpair on the Epiphan Edge status page.

Get the pairing code for Pearl Nano using the front screen menu
1. Press the left arrow key repeatedly on the control interface until the front screen menu displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Settings toopen the Settings screen.
3. From the Settings screen, select Epiphan Edge to open the Epiphan Edge screen.
a. If the Pearl device is not currently paired to Epiphan Edge, the pairing code displays on screen.
b. If the Pearl device is paired to Epiphan Edge, the screen changes to show the name of the team thedevice is paired to and the name assigned to the paired device.

52

Pearl Nano User Guide

Remote login to the Admin panel and Epiphan Live

Remote login to the Admin panel and Epiphan LiveYou can remotely log in to the Pearl device for full administration access to configure and operate the Pearldevice over the Internet using a cloud version of the Admin panel and Epiphan Live. You just need to pair the
Pearl device to an Epiphan Cloud account that has a Premium plan.
Epiphan Live is not available for Pearl Nano.
With an Epiphan Edge Premium plan, full administrative access to your Pearl device for setup and rescue
troubleshooting is fast and convenient. The cloud version of the Admin panel uses the same login credentials as
the locally accessed web version.
The URL of the local web version of the Admin panel is not the same as the URL of the cloudversion. An Epiphan Edge Premium plan is only required to access the cloud version.

Before you beginl

Make sure the Pearl device is paired to your Epiphan Edge account, see Pair and unpair from Epiphan
Edge.

l

Upgrade to an Epiphan Edge Premium plan.

Access the cloud version of the Admin panel
1. Log in to your Epiphan Edge account at https://go.epiphan.cloud
2. In the left navigation pane, click Edge > All Devices to open the All Devices page.

53

Pearl Nano User Guide

Remote login to the Admin panel and Epiphan Live

3. Click the device name in the list to open the details page for that device.
4. From the Device Details page, click Admin login in the header bar. A new tab with the cloud Admin panel
login opens in your browser.

See The Admin panel for instructions to use the interface or to access the local web version.

54

Pearl Nano User Guide

Configure network settings

Configure network settings
Pearl devices use DHCP to obtain an IP Address over an Ethernet-based network by default; however, you caneasily change the network settings.
Topics include:lNetwork ports used by Pearl NanolVerify IP address and MAC addresslConfigure a static IP addresslConfigure DHCPl

Configure DHCP Option 81lConfigure Dynamic DNSlChange the HTTP/HTTPS port valueslPerform network diagnostics

To monitor network status information, see View network status
To set up traffic shaping for multicast streams, see Set up traffic shaping.

Network ports used by Pearl Nano
The following table lists the default incoming and outgoing network ports.
Do not block traffic over these ports. If you want Pearl devices to operate properly, make sure that your firewall isconfigured to open these ports. Blocking a port will cause the service that uses that port to fail. It is possible touse the Admin panel to change the default ports that are used for some services.
Table 12 Default incoming network ports for Pearl devices
Port (or range)

ProtocolDescription

22

TCP

SSH for remote support. See Support.

TCP

HTTP/HTTPS for web-based access to the Admin panel and Epiphan
Live, HTTP/HTTPS API, REST API, HLS streaming (if enabled) and thelive channel preview.

80

You can change the default HTTP port value using the Admin panel, see
Configure HTTPS.
123

TCP/UDPNTP server, if enabled. See Configure a time server.

319 and 320

UDP

PTP server, if enabled. See Configure a time server.

443

TCP

HTTPS for the Admin panel and HLS streaming if enabled. Port is open
only when HTTPS is enabled. You can change the default HTTPS port
value using the Admin panel, see Configure HTTPS.

55

Pearl Nano User Guide

Port (or range)

Verify IP address and MAC address

ProtocolDescription

Checks for new firmware versions are over this port, as well as
downloading firmware files.

Pearl Mini, Pearl
Nexus, and Pearl2: 554 to 554+(x-1)

TCP

Pearl Nano: 554

For RTSP/TCP and RTSP/HTTP streaming on your network (where x is
the number of channels configured). The number of ports used depends
on how many channels you have with RTSP streaming enabled. See
Share a live broadcast stream (HTTP, HTTPS, or RTSP). Note that client
video players choose whether they are using RTSP/TCP, RTSP/HTTP
or RTSP/UDP.
Port 554 (and port 555 for Pearl Mini, Pearl Nexus, and Pearl-2) is also
used for internal communications. If streaming is disabled, these ports
remain open but refuse all external connection requests.

Random in range
32768 - 61000

UDP

If the client video player chooses RTSP/UDP, it will negotiate 4 random
UDP ports (two for audio and two for video). The port range is dependent
on the OS of the client video player and can change with updates to that
OS.

5353

UDP

For multicast DNS discovery. See Connect using a DNS-based service
discovery.

Pearl Mini, Pearl
Nexus, and Pearl2: 8000 to 8000+(x1)Pearl Nano: 8000

For Flash (FLV) live stream and MPEG-TS streaming on your network(where x is the number of channels configured). The number of ports used
depends on how many channels you have with streaming enabled. See
Share a live broadcast stream (HTTP, HTTPS, or RTSP).
TCP
Port 8000 (and port 8001 for Pearl Mini, Pearl Nexus, and Pearl-2) is also
used for internal communications. If streaming is disabled for the channel
from Channel > Streaming using the Admin panel, these ports remain
open but refuse all external connection requests.

In addition to the incoming ports, Pearl devices use some outgoing connections as follows:lPort 80 - used for firmware update checks and downloads.

lPublishing/streaming port - the actual ports used for streaming to a server depends on the server andprotocol used. See Streaming to servers, CDNs, and other devicesl

AFU file recording transfer port - the actual ports used for AFU depends on your configuration. See
Automatic file transfers.

Verify IP address and MAC address
To view the current IP address and MAC address of the Pearl device:56

Pearl Nano User Guide

Verify IP address and MAC addressl

From the Network configuration page using the Admin panel.

l

For Pearl Nano, select System > Network on the front screen. You can also see the IP address when you
navigate to the System status screen using the front panel control interface.

Table 13 Network Information
Item

Description/Options

MAC Address

A media access control address (MAC address) is a unique identifier for the
network interface. The value is read-only and cannot be changed. You may need toshare this value with your system administrator.

Current IP Address

Reflects the current internet protocol address (IP address) of the system. This value
is either obtained from the DHCP server (if using DHCP) or is the configured static
IP address. Pearl devices support IPv4 addresses. It does not support IPv6
addresses.

View network information using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Network. The network configuration page opens.

View network information using the front screen menu on Pearl Nano
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

57

Pearl Nano User Guide

Configure a static IP address

2. Use the arrow and check mark keys to select System. Then from the System screen, select Network to
open the Network screen.

3. From the Network screen, use the arrow keys to scroll down the list to see all the network parameters, likethe MAC address.

Configure a static IP address
There are two ways you can set up a Pearl device to use a static IP address:l

From the Network configuration page using the Admin panel.

l

Pearl Nano: From the front screen menu when you select System > Network. You can also see the IP
address when you navigate to the System status screen using the front panel control interface.

TIP: Using the device screen, you can choose to apply a configuration preset that contains a static network IP.
See Configuration presets.
Only IPv4 addresses are supported. Pearl devices do not support IPv6.

Configure a static IP address using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network . The Network configuration page opens.
3. Choose No from the Use DHCP drop-down and enter your networking information in to the required
fields. Click Apply when you're done.

58

Pearl Nano User Guide

Configure a static IP address

Table 14 Static IP Address Fields
Label

Description

Use DHCP

Select Yes to dynamically obtain an IP address at boot up or select No to use theconfigured static IP address.

IP Address

The internet protocol address (IP Address) to assign. Obtain this from your network
administrator. Pearl devices support IPv4 addresses. They do not support IPv6
addresses.

Network Mask

Also called the subnet mask, this value denotes a range of IP addresses. Obtain thisfrom your network administrator, from another computer on the same subnet, or
calculate the value using an online subnet calculator.

Default gateway

The network node that serves as an access point to the rest of the network. This value
cannot be blank unless you are using DCHP. Specify the system’s IP address if you
don’t have a default gateway on your network.

DNS Server

The domain name system server (DNS server) translates human-readable hostnames
into corresponding IP addresses. Specify the system’s IP address if you don’t have a
DNS server on your network. This value cannot be blank unless you are using DHCP.

MTU Size

The maximum transmission unit (MTU) specifies the maximum packet size for transfer
on the network. The default value is 1500, which is the largest value allowed by Ethernet
at the network layer. It’s best for all nodes in your network to use the same value. Onlychange the MTU value if you know that other nodes use a different value.

The default gateway and DNS Server fields cannot be left blank. If you do not have a default
gateway or a DNS server for your network, enter the static IP address in those fields.

59

Pearl Nano User Guide

Configure a static IP address

4. Reboot the Pearl device when prompted. From the Configuration menu, select Maintenance and click
Reboot Now on the Maintenance page.
5. After the system has finished rebooting, use the new IP address to log back in to the Admin panel asadmin and verify that all changes were applied.

Configure a static IP address using the front screen menu on Pearl Nano
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Network to
open the Network screen.

3. From the Network screen, use the arrow keys to highlight DHCP and press the check mark key to toggle
the switch off. The network addresses disappear from the screen.
4. Use the arrow and check mark keys to select IP address. The screen to enter a static IP address opens.

60

Pearl Nano User Guide

Configure DHCP

5. Use the arrow and check mark keys to enter a static IP address, then select Set IP address. If you leave
the IP address screen without setting the IP address, the IP address you entered is not assigned to thePearl device.
6. Reboot the Pearl device to apply the network changes. Return to the System screen and use the downarrow key to scroll down until Reboot appears. Then select Reboot using the check mark key and selectReboot now when prompted.

Configure DHCP
If you need to switch Pearl Nano from using static IP address allocation to using dynamic allocation with DHCP,
you can do this three different ways:l

Restore factory settings, which clear all your custom settings. See Perform a factory reset.

lLoad a configuration preset file that uses DHCP networking. For more information, see:llApply a configuration preset using the Admin panellPearl Nano - Apply a configuration preset using the front screen menu.

Change the network settings manually using either the device screen or the Admin panel.

Manually select DHCP as the network type using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. Choose Yes from the Use DHCP drop-down and change the MTU Size if needed, then click Apply.

61

Pearl Nano User Guide

Configure DHCP

Table 15 DHCP Fields
Label

Description/Options

Use DHCP

Select this option to dynamically obtain an IP address at boot up using DHCP

Use static
address

Only select this option if you want to use the configured static IP address instead.

MTU Size

The maximum transmission unit (MTU) specifies the maximum packet size fortransfer on the network. The default value is 1500, which is the largest value allowedby Ethernet at the network layer. It’s best for all nodes in your network to use thesame value. Only change this value if you know that other nodes use a different
value.

4. Reboot the Pearl device when prompted. From the Configuration menu, select Maintenance and click
Reboot Now on the maintenance page.
5. After the system has finished rebooting, log back in to the Admin panel as admin and verify that allchanges were applied.

62

Pearl Nano User Guide

Configure DHCP

Manually select DHCP as the network type using the front screen menu on Pearl Nano
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Network to
open the Network screen.

3. From the Network screen, use the arrow keys to highlight DHCP and press the check mark key to toggle
the switch on. The DHCP acquired network addresses appear on the screen.

4. Reboot the Pearl device to apply the network changes. Return to the System screen and use the downarrow key to scroll down until Reboot appears. Then select Reboot using the check mark key and selectReboot now when prompted.

63

Pearl Nano User Guide

Configure DHCP Option 81

Configure DHCP Option 81
Ensure your Domain Name Server (DNS) always has the Pearl device's most up-to-date IP address mapped to
the Pearl device's Fully Qualified Domain Name (FQDN). Option 81 support means you can keep using Pearl's
FQDN no matter how many times the DHCP server may change Pearl's IP address. The Pearl device
automatically asks the DHCP server to tell the Domain Name Server (DNS) to update the Pearl device's record
with any changes to the Pearl device's IP address or FQDN. DHCP Option 81 is disabled by default.

Important considerationsl

The DHCP server must support Option 81 for this feature to work.

l

DHCP should be enabled and setup before enabling DHCP Option 81, see Configure DHCP.

l

You need the FQDN of your Pearl system for this procedure. Consult your network administrator if you
don't have that information.

Configure DHCP Option 81 using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. Under Settings, check Send FQDN (DHCP Option 81).

64

Pearl Nano User Guide

Configure Dynamic DNS

4. In the DNS FQDN field, enter the FQDN of your Pearl device, for example: mypearl.mydomain.com
5. Click Apply.
6. Reboot the Pearl device when prompted.
7. After the system has finished rebooting, log back in to the Admin panel as admin and verify that allchanges were applied.

Configure Dynamic DNS
You can use Dynamic Domain Name Server (DDNS) to ensure that whenever the DHCP server changes thePearl device's IP address, the Pearl device informs the DDNS to update it's domain name records. That way, you
can keep using the Pearl device's FQDN without worry.
The DDNS feature is useful if your DHCP server doesn't support Option 81. Custom DDNS servers, dyndns.org,
and noip.com are supported.
Table 16 DDNS Fields
Label

Description/Options

ProviderChoose if the DDNS provider is dyndns.com, noip.com, or a custom DDNS
server of your choice.

DDNS server name

If you are using a custom DDNS provider, you must enter the DDNS server
name. If dyndns.com or noip.com are used, you can leave this field blank.

DDNS server path

If you are using a custom DDNS provider, you must enter the DDNS server

65Pearl Nano User Guide

Label

Configure Dynamic DNS

Description/Options
path. If dyndns.com or noip.com are used, you can leave this field blank.

Use SSL

Choose if you will use Secure Socket Layer (SSL) encryption forcommunications with the DDNS server. This is enabled by default.

Update period

Enter how often the Pearl device updates the DDNS server with the Pearldevice's new IP address when the DHCP server changes it. Enter the update
period in seconds from 30 to 864000 seconds (i.e. up to a maximum period of
10 days). The default is 600 seconds.

UsernameEnter your user name for the DDNS provider.

Password

Enter your password for the DDNS provider.

HostnameEnter the hostname to use for this Pearl device in the DDNS server records.
Pearl device's serial number is the default hostname.

External IP detection server
name

If your DDNS provider uses an external IP detection server, you must providethat server's name.

External IP detection serverpath

If your DDNS provider uses an external IP detection server, you must providethat server's path.

Use SSL for external
IP detection

Choose if you will use SSL encryption for communications with the external
IP detection. This is enabled by default.

The status of the connection to the DDNS server, the last external IP address of the Pearl device that wasreported to the DDNS server, and the time when the IP address was reported is shown.

Configure DDNS using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. Under Dynamic DNS, check Enabled and in the Provider field, choose either Custom, dyndns.com, or
noip.com in the drop-down menu.

66

Pearl Nano User Guide

Configure Dynamic DNS

4. If you selected Custom as the provider, enter the DDNS server name and DDNS server path. If
dyndns.com or noip.com were selected as the provider, you can leave those fields blank.
5. Enter the Username and Password for your DDNS server.
6. In the Hostname field, enter the hostname of your Pearl device, for example: mypearl. The default
hostname is the serial number of the Pearl device.
7. If your DDNS provider uses an external IP detection server, enter the External IP detection server nameand External IP detection server path.
8. Check User SSL for external IP detection if you want to use that feature with an external IP detection
server.
9. (Optional) Change the Update period in seconds.
10. Click Apply.
11. Reboot your Pearl device when prompted.
12. After the system has finished rebooting, log back in to the Admin panel as admin and verify that allchanges were applied.

67

Pearl Nano User Guide

Change the HTTP/HTTPS port values

Change the HTTP/HTTPS port values
On the Pearl device, the default HTTP port is 80 and the default HTTPS port is 443. If the default ports used byyour Pearl device are not available on your network, you can change them using the Admin panel. Consult yoursystem administrator for the correct port values to use for HTTP and HTTPS traffic.
Ensure that the port value you choose is unique and is not currently assigned on the Pearl device,
see Network ports used by Pearl Nano.

Change the HTTP/HTTPS port values using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Security. The Security configuration page opens.
3. Under HTTPS configuration, change the default HTTP and HTTPS port numbers. Click Apply when you're
done.

Secure connection (HTTPS) must be checked before you can change the HTTPS port.
4. Reboot the Pearl device when prompted. After the system has finished rebooting, log back in to the Admin
panel as admin and verify that all changes were applied.

Perform network diagnostics
Network diagnostic tools are available to help you troubleshoot your setup. Easily run diagnostics like traceroute,ping, and others from the touch screen on Pearl Mini or Pearl-2, or using the Admin panel. For quick
troubleshooting, you can run the Connectivity status diagnostics using the front screen menu of the Pearl Nano.
You can also run network diagnostics from Epiphan Edge, see the online Epiphan Edge User Guide.

68

Pearl Nano User Guide

Perform network diagnostics

For more information about the network diagnostic tools and test results, see Diagnostic tools.
If you are unable to resolve your networking issues using the diagnostic tools, contact your network administrator
and provide them with the IP address and MAC address of your Pearl device; otherwise, contact Epiphan Videosupport for assistance.

Perform network diagnostics using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. In the Network diagnostics section, choose a diagnostic test from the drop-down menu and select Start.

Perform connectivity status diagnostics using the front screen menu of Pearl Nano
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Network to
open the Network screen.

3. From the Network screen, press the check mark key to select Connectivity status and open theConnectivity status screen.
4. Use the arrow keys to scroll through the list of diagnostics results.

69

Pearl Nano User Guide

Disable the network discovery port

Disable the network discovery port
You can disable the network discovery port on the Pearl device using the Admin panel so that services can nolonger discover the Pearl device systems using multicast DNS (mDNS). The network discovery port on the Pearldevice is port 5557 and is enabled by default.

Important considerationsl

You cannot connect to the Admin panel using a DNS-based service discovery if you disable the network
discovery port, see Connect using a DNS-based service discovery.

Disable the network discovery port using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. Uncheck Make this device discoverable on the network as <uniqueID.local>, then click Apply.

Configure network security
Pearl devices support 802.1x network security. You can choose the authentication method, upload user
certificates and private key, as well as manage signed CA certificates using the Admin panel. You can also
configure your Pearl device to use HTTPS.
Topics include:lConfigure 802.1x network security and manage user certificateslManage CA and self-signed certificates70Pearl Nano User Guidel

Configure 802.1x network security and manage user certificates

Configure HTTPSFor higher security, we recommend setting admin, operator and viewer-level passwords on the Pearl device, see
Change user passwords.

Configure 802.1x network security and manage user
certificates
You can enable 802.1x security and configure the EAP method for the Pearl device to use for secure network
access using the Admin panel. Supported EAP methods include:l

PEAP (default)l

EAP-TLSl

EAP-TTLS

Important considerationsl

If TLS authentication is used on the network, then you need to get a user certificate and a user private key
from the network administrator and upload those to your Pearl device as part of this procedure.

l

Before you proceed with this setup, check that the network server's signed CA certificate appears in thelist of CA certificates on the Pearl device and is valid, see Manage CA and self-signed certificates.

l

If the network server's CA certificate doesn't appear in the list of signed CA certificates and you can't
obtain a valid signed CA certificate for network server authentication, do not check Verify server's identity
when performing this setup.

lSecurity certificates must be PEM encoded.

Configure 802.1x and upload the user certificate and user private key using the Admin
panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. Under IEEE 802.1x, check Enabled and select an EAP method: PEAP, EAP-TLS, or EAP-TTLS.

71

Pearl Nano User Guide

Configure 802.1x network security and manage user certificates

4. (Optional) Check Verify server's identity.
5. Choose an Authentication method if you selected EAP-TTLS as the EAP method. The authentication
method is automatically selected if PEAP or EAP-TLS is the EAP method.
Table 17 Authentication methods
EAP method

Authentication method

PEAP

EAP-MSCHAPv2

EAP-TLS

TLS
EAP-MSCHAPv2

EAP-TTLS

TLS
PAP

6. Enter the network access User name and Password to use for this device. Available fields depend on the
EAP method that is selected.
7. If TLS is chosen as the Authentication method, upload a user certificate and a user private key. You canrequest those from your network administrator.
8. Click Apply when you're done.
9. Reboot the Pearl device when prompted. After the system has finished rebooting, log back in to the Admin
panel as admin and verify that all changes were applied.

72

Pearl Nano User Guide

Manage CA and self-signed certificatesIf you need to delete the user certificate or private key, click Delete certificate.

Manage CA and self-signed certificates
You can view the list of CA and self-signed certificates that come preloaded on Pearl Nano. CA and self-signed
certificates are used for server authentication if Verify server's identity is selected when 802.1x network security
is configured, see Configure 802.1x network security and manage user certificates.
The self-signed certificate from Epiphan Video is selected by default. You can add more CA signed and selfsigned certificates using the Admin panel, as well as delete any certificates that you've uploaded. You cannot
delete any of the built-in CA certificates that came preloaded on Pearl Nano. Security certificates must be PEM
encoded.
When using the Epiphan Video self-signed certificate on Pearl devices:lYour web browser may warn of an untrusted certificate when you try to access the web-based Pearl Nano
Admin panel. You can dismiss the warning and continue to the Admin panel.

l

Certain low and medium-level results are expected when scanning the network for vulnerabilities while
Pearl Nano is connected and an active Admin panel session is in progress. Contact Epiphan Video
Support for more information.

Manage CA and self-signed certificates using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Security. The Security configuration page opens.
3. Under CA certificates, click the arrow head to expand the list of built-in CA and self-signed certificates thatcame preloaded on Pearl Nano.
4. To upload a new CA or self-signed certificate, click Choose File and select the certificate you want to
upload. Then click Apply. The uploaded certificate is added to a list of user uploaded CA certificates.
5. To delete a CA or self-signed certificate that you've uploaded, click Choose File and select the certificate
you want to delete from the list. Then click Delete. When you're done, click Apply.
6. Reboot the Pearl device when prompted. After the system has finished rebooting, log back in to the Admin
panel as admin and verify that all changes were applied.

Configure HTTPSYou can configure Pearl Nano to use HTTPS for secure, local network access to the Admin panel, as well as forviewing the live channel preview stream on the local network using the Live broadcast URL.
The default HTTP port 80 redirects traffic to the default HTTPS port 443 when HTTPS is enabled. If the default
ports used by the Pearl device are not available on your network, you can change them using the Admin panel,
see Change the HTTP/HTTPS port values.

73Pearl Nano User Guide

Configure HTTPS

Custom applications that use the Pearl device HTTP API should continue to work if you configure thePearl device for HTTPS.
A default, self-signed certificate from Epiphan Video comes preloaded on the Pearl device. You can upload anddelete your own certificate and private key. However, you cannot delete the default self-signed certificate thatcomes preloaded on the Pearl device.
If you upload your own self-signed certificate and private key, ensure they're PEM encoded. Certificates caneither include the private key or be separate files.
If you attempt to access the web-based Admin panel using a web browser and the required security certificate
isn't found in the list of certificates loaded on the Pearl device, a warning message appears stating that thedevice isn't trusted. You can choose whether to proceed and connect to the Pearl device's web-based Admin
panel without the security certificate authentication or cancel the connection.
If the Epiphan Video self-signed certificate is selected, your web browser may warn of an untrusted
certificate when you try to access Pearl's web-based Admin panel. You can dismiss the warning andcontinue to the Admin panel for your device.

Configure HTTPS and upload a self-signed certificate using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Security. The Security configuration page opens.
3. Under HTTPS configuration, check Secure connection (HTTPS).

4. (Optional) Change the default HTTP and the HTTPS port numbers. Consult your network administrator.
5. (Optional) Upload a new certificate and private key as required. You can request those from your network
administrator.

74

Pearl Nano User Guide

Configure HTTP Keep Alive Settings

If the required certificate isn't included in the list of certificates on the Pearl device
when you try and connect to the Pearl device using a web-browser, you'll receive awarning that the device isn't trusted.
6. Click Apply when you're done.
7. Reboot your Pearl device when prompted. After the system has finished rebooting, log back in to the
Admin panel as admin and verify that all changes were applied.
If you need to delete the certificate you uploaded and the private key, click Delete certificate,or click Restore default certificate.

Configure HTTP Keep Alive Settings
You can customize the HTTP Keep Alive settings that the Pearl Nano will use with third-party connections. The
values you can modify are the HTTP Keep-Alive Timeout and the HTTP Maximum Keep-Alive Requests.

HTTP Keep-Alive timeout:
Maximum amount of time Pearl Nano will keep a TCP connection to a third-party HTTP control system open

HTTP Maximum Keep-Alive requests:
The maximum number of HTTP Keep-Alive requests Pearl Nano will accept within the specified Keep-Alive
timeout

Configure HTTP Keep-Alive Timeout and HTTP Maximum Keep-Alive requests
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Security. The Security configuration page opens.
3. Under HTTPS configuration, find the HTTP Keep-Alive Timeout and HTTP Maximum Keep-Alive
Requests.
4. Modify these values as needed.
5. Click Apply when you're done.
6. Your Pearl Nano will reboot. After the system has finished rebooting, log back in to the Admin panel asadmin and verify that all changes were applied.

75

Pearl Nano User Guide

Configure system settings

Configure system settings
Pearl devices use the current date and time in naming recorded files and when synchronizing and timestamping
inputs from multiple sources (i.e. when synchronizing an audio and a video source). The Admin panel lets you
specify date and time settings to ensure they are correctly configured for your time zone and your network. You
can also add information like a unique device name, description, and location.
Topics include:lView the current date and time settingslConfigure a time serverlManually set the date, time, and time zonelConfigure device info, name, description, and location

76

Pearl Nano User Guide

Configure date and time

Configure date and time
Pearl Nano uses the current date and time in naming recorded files and when synchronizing and timestamping
inputs from multiple sources (i.e. when synchronizing an audio and a video source). The Admin panel lets you
specify date and time settings to ensure they are correctly configured for your time zone and your network.
Topics include:lView the current date and time settingslConfigure a time serverlManually set the date, time, and time zone

View the current date and time settings
There are two ways to view the current date and time settings:lFrom the Date and Time page using the Admin panel.

To manually set the date, time, and time zone using the Admin panel, see Manually set the date, time, and timezone.
To change the server used for synchronizing time, see Configure a time server. You can also set up a local
Network Time Protocol (NTP) server on all Pearls.

View the current Date and Time settings using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Date and Time. The Date and Time configuration page opens.
Table 18 Date and Time configuration options
Label

Description/Options

Time Zone

The currently selected time zone.

Enable local NTP
server

Select to enable local NTP server.

Enable timesynchronization

Whether or not a time synchronization protocol is being used for setting time. If notselected, time is set manually.

ProtocolThe time synchronization protocol.

Service IP Address

The time synchronization server address.

Set time manually

Whether or not time is set manually. If time is not being set manually, a timesynchronization protocol is used.

Date

The current date. This is the current date even if the radio button Set time manually is

77

Pearl Nano User Guide

Label

Configure a time server

Description/Options
not selected.

Time

The current time. This is the current time even if the radio button Set time manually is
not selected.

Configure a time server
Pearl Nano uses the Network Time Protocol (NTP) server from the National Research Council of Canada by
default. You can change to a different time server using the Admin panel. Contact your system administrator forthe time synchronization server settings you should use.
The following table lists the time server types that Pearl Nano supports.
Table 19 Supported time server types
Label

Description/Options
Network Time Protocol (NTP) servers are used to synchronize system time. ManyNTP servers are available on the Internet.
Pearlcan also act as a local NTP server.

NTP
All you need is the IP address of the NTP server and network access to the server to usethat as the time synchronization source for Pearl Nano. For more information about NTP
and to find NTP servers, refer to http://support.ntp.org/bin/view/Servers/WebHome.
A local Windows NTP server is not supported.
PTP v1The Precision Time Protocol (PTP) is used for clock synchronization over the Internet. It
has clock accuracy in the sub-microsecond range, making it more granular than NTP.

NTP sends UDP packets over port 123 on Pearl Nano and PTP sends UDP packets over ports 319
and 320. If the Pearl device is behind a firewall, you must open these ports to allow traffic when thePearl device is configured to use either an NTP or a PTP server to obtain its time and date
information.

Set the time synchronization method using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Date and Time . The Date and Time configuration page opens.
3. Select Enable time synchronization and choose the time synchronization protocol from the Protocols
drop down.

78

Pearl Nano User Guide

Manually set the date, time, and time zone

a. If NTP is selected, enter the IP address or server name for the NTP server in the Server IP
Address field.
b. If PTP v1 is selected, choose a multicast address for the PTP v1 server from the PTP domain field.
Table 20 PTP multicast addresses
PTP Domain

Description

Default

PTP at multicast address 224.0.1.129

Alternative 1

PTP at multicast address 224.0.1.130

Alternative 2

PTP at multicast address 224.0.1.131

Alternative 3

PTP at multicast address 224.0.1.132

4. Click Apply.

Manually set the date, time, and time zone
Pearl Nano uses NTP for time synchronization by default. You can manually set the date, time, and time zone.
Pearl Nano uses the Eastern (Canada) time zone by default.

Set the date, time, and zone manually using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Date and Time. The Date and Time configuration page opens.
3. Enter the current date in the Date field using the format yyyy-mm-dd and enter the current time in theTime field using the format hh:mm:ss.
4. Select a time zone from the Time Zone field.
5. Click Apply.

Configure device info, name, description, and location
You can assign a unique device name to the Pearl device using the Admin panel and add information such as a
description and location. Alphanumeric characters and hyphens are supported. The serial number of Pearldevice is the default device name.
For AFU and USB file transfers that are configured to create a folder upon file upload, the device name you set
for the Pearl device is used for the folder name instead of Pearl's serial number.
For CMSs, the device name you set here for the Pearl device appears as the registered name for this device.

Configure the device name, description, and location using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Info. The system information page opens.

79Pearl Nano User Guide

SD card and SATA M.2 2280 SSD storage

3. Under Device info, do any of the following and then click Apply:
a. Enter a name using alphanumeric characters including hyphens up to a maximum of 64 characters.
b. Enter a description using alphanumeric characters including hyphens up to a maximum of 50
characters.
c. Enter a location using alphanumeric characters including hyphens up to a maximum of 50
characters. alphanumerical characters and hyphens.

SD card and SATA M.2 2280 SSD storage
To record video using with Pearl Nano or Pearl Mini, you need to install a storage medium. Both devices have astandard SD card slot on the front panel that you can use. Both also has a SATA M.2 2280 SSD storage
expansion slot that's accessible from the underside.1
Adding a storage medium is not required if you are only live streaming.

The storage medium must be EXT4 formatted for the Ubuntu operating system. The Ubuntu formatted SD cardcannot be used to transfer files to iOS or Windows systems. Download recordings using the Admin panel oranother method such as Automatic File Upload (AFU) to a connected USB device.
When the storage medium is full, new recordings overwrite the oldest recordings. If you're using the Pearl device
with a Content Management System (CMS), we recommend using large capacity storage mediums such as an
SD card that's 256 GB or more, see CMS recording and webcasting control.
For important considerations when setting the maximum file size limit and recording to the storage medium, see
About recording.

80Pearl Nano User Guide

Install and format an SD card for the Pearl Mini and Pearl Nano

SD Card Storage
You can format the SD card from the front screen menu or using the Admin panel. T For detailed instructions, seeInstall and format an SD card for the Pearl Mini and Pearl Nanol

Format the SD card

For the SD card, we recommend using a minimum class 10 (C10) SD card that's at least 64 GB capacity but does
not exceed 512 GB; however, most SD cards that are at minimum a C10, a UHS class 1 (U1), or a video speed
class 10 (V10) should work.
Do not eject the SD card while recording is in progress as that may corrupt the SD card.

SSD Storage
The SATA M.2 SSD formats automatically the first time Pearl is powered on after installing the SSD. You cannot
use an SD card and the SATA M.2 SSD at the same time. For more information, see Install and format a SATA
M.2 2280 SSD for Pearl Nano

When you install a SATA M.2 SSD, Pearl Nano Pearl Mini no longer detects the SD card slot and the
SD card option is removed from the Admin panel's Configuration menu. Ensure recordings aredownloaded from the SD card before installing the SSD.
1 Only Pearl Mini devices purchased after June 1st 2024 are eligible to have SATA M.2 SSD installed by user

Install and format an SD card for the Pearl Mini and Pearl
Nano
To record video on the Pearl Mini and Pearl Nano, you must install and format a storage medium, such as an
SD card. The easiest way to do that is using the front screen menu of the Pearl device. Pearl Mini and Pearl
Nano have a standard SD card slot on the front panel. If you want to format the SD card using the Admin panel,
you need the IP address of your Pearl Nano and an admin computer connected to the same network. See Installand format an SD card for the Pearl Mini and Pearl Nano.
If you're only using the device for switching video or live streaming, then you don't need to install an
SD card.
If you're using a Pearl device with a Content Management System (CMS), we recommend using large capacity
SD cards such as 256 GB or more , see CMS recording and webcasting control.
We recommend using a minimum class 10 (C10) SD card that's at least 64 GB capacity but does not exceed 512
GB; however, most SD cards that are at minimum a C10, a UHS class 1 (U1), or a video speed class 10 (V10)81Pearl Nano User Guide

Install and format an SD card for the Pearl Mini and Pearl Nanoshould work. The SD card must be EXT4 formatted for the Ubuntu operating system. After the SD card isinstalled and formatted for the EXT4 format, you are ready to record.
Ejecting the SD card while recording is in progress may corrupt the SD card and cause loss of data.

Format the SD card using the Admin panel
1. Insert the SD card into the SD card slot on the front panel.
2. Login to the Admin panel as admin, see Connect to the Admin panel.
3. From the Configuration menu, select SD Card. The SD Card configuration page opens.

4. Select either quick disk format or the full disk format, then click Format card. A full disk format checks forbad blocks on the SD card and marks any that are found on the EXT4 partition.
You must wait for the formatting to finish before removing or recording to the SD card. The amount of time ittakes to format depends on the capacity of the SD card and if you select quick disk format or the full disk format.
If you install a SATA M.2 2280 SSD in the Pearl Nano or Pearl Mini, the device no longer detects theSD card, see Install and format a SATA M.2 2280 SSD for Pearl Nano .

Format an SD card for Pearl Nano
1. Power on the Pearl device.
2. Insert the SD card into the SD card slot.
3. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

82

Pearl Nano User Guide

Install and format a SATA M.2 2280 SSD for Pearl Nano

4. Use the arrow and check mark keys to select Storage. Then from the Storage screen, select Format SD
card to open the Format SD card screen.

5. (Optional) Highlight Quick format and press the check mark key to toggle the switch on or off.
6. Highlight Format card and press the check mark to start the process. The formatting in progress screen
appears and the LED beside the SD slot starts flashing.
7. When the screen indicates formatting is complete and the LED is solid off, press the check mark to returnto the previous screen.

Install and format a SATA M.2 2280 SSD for Pearl Nano
You can install a user-supplied SATA M.2 2280 SSD for storing recorded video. Pearl Nano automaticallyformats the SSD using the EXT4 format for the Ubuntu operating system the first time you power on. So pleasebe patient while the formatting completes.
When you install a SATA M.2 SSD, Pearl Nano no longer detects the SD card slot and the SD card option isremoved from the Admin panel's Configuration menu. For more information about using different storage
mediums and recommendations, see SD card and SATA M.2 2280 SSD storage.
Any existing content on the SSD is lost when the SSD is formatted.

Before you begin
Gather the tools you need:l#2 Phillips screwdriverl#0 Phillips jeweler's screwdriverl(Optional) a pair of tweezers

Install and format the SATA M.2 2280 SSD
1. Disconnect the power cable and ensure Pearl Nanois powered off. If Pearl Nano uses PoE+ power fromthe connected RJ-45 Ethernet cable, ensure you disconnect the Ethernet cable from Pearl Nano.

83

Pearl Nano User Guide

Install and format a SATA M.2 2280 SSD for Pearl Nano

Permanent damage to the SSD and/or Pearl Nano can occur if you install, remove, or replace
the SSD while the device is powered on.
2. On a clean and level surface, turn Pearl Nano over to expose the bottom panel.
3. Use a #2 Phillips screwdriver to remove the SSD expansion slot cover plate. Set aside to for later.

4. Use a #0 Phillips screwdriver )to remove the screw that's in the post farthest away from the M.2 socket.
Set aside for later.

5. Hold the SSD by the edges and insert firmly into the M.2 socket at approximately a 30° angle. Make sure
you align the key notch in the SSD with the notch in the M.2 socket.
6. Use one hand to gently press and hold the SSD down so that it rests atop the post. Align the notch on the
SSD with the post hole.
7. With your other hand, use a #0 Phillips screwdriver to reinstall the post screw and secure the SSD inplace.
TIP: Use the tweezers to pick up the screw if it falls behind the SSD.
8. Reinstall the SSD slot cover plate and power up Pearl Nano.
The SSD is formatted automatically the first time you power on. Please be patient while formatting completes.
The amount of time it takes to format depends on the capacity of the SSD. You must wait for the formatting tofinish before recording video to the SSD.

84

Pearl Nano User Guide

Format the SD card

Powering off Pearl Nano while the SSD is formatting could damage or corrupt the SSD.

Format the SD card
Before you can use your SD card for recording video with a Pearl device, you must format the SD card for the
Ubuntu operating system. We recommend using a minimum class 10 SD card that is EXT4 formatted. The SD
card should have at least 64 GB capacity and should not exceed 512 GB.
After an SD card is formatted using a Pearl device, do not manually change the default file folder structure on the
SD card.
Any content that's contained on the SD card is lost when the SD card is formatted. The Ubuntu
formatted SD card cannot be used to transfer files to iOS or Windows systems. Use a USB memory
device to manually transfer files instead.

Format the SD card using the Admin panel
1. Insert the SD card into the SD card slot on the front panel.
2. Login to the Admin panel as admin, see Connect to the Admin panel.
3. From the Configuration menu, select SD Card. The SD Card configuration page opens.

4. Select either quick disk format or the full disk format, then click Format card. A full disk format checks forbad blocks on the SD card and marks any that are found on the EXT4 partition.
You must wait for the formatting to finish before removing or recording to the SD card. The amount of time ittakes to format depends on the capacity of the SD card and if you select quick disk format or the full disk format.
Do not remove the SD card while it is being formatted. Very large SD cards can take a while toformat. Please be patient and wait for the formatting message to disappear.

Format the SD card using the front screen

85

Pearl Nano User Guide

Audio input ports

1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select Storage. Then from the Storage screen, select Format SD
card to open the Format SD card screen.

3. (Optional) Highlight Quick format and press the check mark key to toggle the switch on or off.
4. Highlight Format card and press the check mark key to start the process. The formatting in progress
screen appears and the LED beside the SD slot starts flashing.
5. When the screen indicates formatting is complete and the LED is solid off, press the check mark key toreturn to the previous screen.

Audio input ports
You can connect external audio devices like mixers directly to the dedicated audio input ports on Pearl devices.
Each Pearl device has a unique set of audio input ports.
Topics include:lConfigure audio ports for stereo or monolAssign audio sources to an inputlAdjust audio gain and delayl

Mute audio

86Pearl Nano User Guide

Selecting an audio source

Pearl Nanol

Two XLR professional line-level inputs + 4.0 dBu up to 12.3 V RMS, (+24 dBu) that support balanced andunbalanced signals.

l

One stereo pair RCA consumer line-level input (-10 dBV)l

One USB (UAC) audio port

The XLR audio inputs are configured as a stereo pair by default: XLR1 (left) and XLR 2 (right). The XLR audio
ports and the RCA audio ports are linked. You can configure Pearl Nano to use both or just one of the audio
sources from the front screen menu or using the Admin panel.
For details about the audio inputs, see Pearl Nano AV inputs.

Selecting an audio source
Choose different audio sources for a channel using the Admin panel .
Select your audio sources from connected video source, as well as from the dedicated analog audio input ports.
The USB port on the rear panel accepts a USB microphone (UAC).

Stereo pairs
XLR and TRS combo jacks are configured as left/right stereo pairs by default, see Configure audio ports forstereo or mono. The 3.5 mm audio ports and the RCA audio ports are linked.
see Assign audio sources to an input to configure Pearl devices to use both or just one audio source.

Linked portsl

On Pearl Nano, the XLR audio ports and the RCA audio ports are linked.

Audio gain guidelines
This table offers some guidelines for adjusting the gain of the audio input ports for common types of audio
devices. You should add the suggested gain to the audio input to get an average signal to register at a nominal
level in the VU meter (i.e. where the green bars change to yellow). The actual amount of gain needed depends
on the strength of the original audio signal.
To connect microphones to the pro line level XLR inputs on Pearl-2 and Pearl Nano, you must use
an external preamp to boost the microphone signal enough to provide the proper line level signal at
the XLR input port, see Connecting microphones to the XLR line level inputs.
Table 21 Audio gain guidelines for different audio devices
Audio source
Dynamic microphone

Input port

Gain

XLR

Pearl Mini and Pearl Nexus: Add +50 to +60 dB gain to the audio
input port.

87

Pearl Nano User Guide

Audio source

Selecting an audio source

Input port

Gain
Pearl-2 and Pearl Nano: Not recommended. See note abovetable.
Pearl Mini and Pearl Nexus: Add +18 to +40 dB gain to the audio
input port.

XLR
Pearl-2 and Pearl Nano: Not recommended. See note abovetable.

Electret microphone
3.5 mm(Pearl Mini
only)

Pearl Mini and Pearl Nexus: Add +6 to +12 dB gain to the audio
input port.
Pearl Mini and Pearl Nexus: Add +18 to +40 dB gain to the audio
input port.

XLR
Pearl-2 and Pearl Nano: Not recommended. See note abovetable.

Wireless microphonereceiver3.5 mmPearl Mini and Pearl Nexus: Add +6 to +12 dB gain to the audio
input port.
Pearl-2 and Pearl Nano: Not supported.

Condenser microphonewith phantom power(Pearl Mini only)

Mobile phone or otherconsumer line level
deviceProfessional mixer

USB microphone

XLR

Pearl Mini and Pearl Nexus: Add +40 to +60 dB gain to the audio
input port.

XLR

Pearl-2 and Pearl Nano: Add +6 to +12 dB gain to the audio input
port.

TRS
(Pearl Mini
and Pearl
Nexus only)

Add +6 to +12 dB gain to the audio input port.

RCA1

NominalXLR

Nominal

TRS (PearlMini and
Pearl Nexus
only)

Nominal

RCA1

Not recommended.

USB

Nominal

1 To avoid unwanted signal noise on the RCA ports, we recommend adding no more than 12dB of gain to the

RCA port or when XLR B/RCA is used88

Pearl Nano User Guide

Connecting microphones to the XLR line level inputs

Connecting devices that are not designed for phantom power when phantom power is enabled forthe two XLR ports can seriously damage those devices. Always check the phantom power LED
before connecting devices to the XLR ports.

Selecting an audio device for the channel:
1. Using a web browser on the admin computer, go to the IP address of your Pearl device and log in, seeConnect to the Admin panel.
2. From the Channels menu, select your channel (i.e. HDMI-A or HDMI-B) and click Layouts. The custom
channel layout editor page opens.
3. Check the audio source that you want to use for the layout and click Save.

4. (Optional) Adjust the gain for an audio input source, select the input port from the Inputs menu and adjust
the amount of gain on the configuration page for the audio input port. Click Save when you're done. For
more details, see Adjust audio gain and delay.

Connecting microphones to the XLR line level inputs
The XLR analog audio input ports on Pearl-2 and Pearl Nano are professional line level inputs rated at + 4.0 dBu
up to 12.3 V RMS, (+24 dBu). You can't connect microphones directly to the XLR ports because the microphonesignal is too low.
If you want to connect microphones to the line-level XLR ports on the Pearl-2 or Pearl Nano, you must use an
external preamp and boost the mic level signal to the appropriate line level before connecting it to the XLR port.

Configure audio ports for stereo or mono
Using the Admin panel, you can configure ports to function as a stereo pair (left/right) or as separate mono ports.

89

Pearl Nano User Guide

Configure audio ports for stereo or mono

Pearl Nano
The two XLR professional line-level inputs are configured as a stereo pair by default: XLR 1 (left) and XLR 2(right).

Configure audio ports as stereo or mono using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. Open the configuration page from the Inputs menu:lPearl Nano: click XLR/RCA Audio. The XLR/RCA Audio configuration page opens.

3. Do one of the following.
a. To make the ports function as a stereo pair, check Stereo pair and click Apply.
b. To make the ports function as separate mono ports, uncheck Stereo pair and click Apply.

When mono is selected, two sets of parameters and two audio VU meters appear in the interface one for each audio input port on the Pearl device. Parameters that are listed only once apply to both
ports.

90

Pearl Nano User Guide

Assign audio sources to an input

Configure audio ports as stereo or mono using the Pearl Nano front screen
1. Repeatedly press the left arrow key on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select Inputs. Then from the Inputs screen, select XLR/RCA Audioto open the XLR/RCA Audio screen.

3. Highlight Stereo pair and press the check mark key to toggle the switch on or off.

Assign audio sources to an input
Some audio input ports share internal audio processing resources in the Pearl device. These shared audio
sources appear in the same configuration menus in the Admin panel and appear under the same audio input
label in the user interfaces.
The audio sources that share resources are:

Pearl Nanol

XLR 1 and XLR 2 (left and right ports, respectively)l

RCA (left and right ports)

Both the XLR (left/right) and RCA (left/right) audio sources appear under the label XLR/RCA Audio. You canassign one or both audio sources to XLR/RCA Audio. Choosing one audio source for the shared input disables
the other audio source. This means that when you select XLR/RCA Audio as the audio source using the custom
layout editor, only the audio source you assign to XLR/RCA Audio is used. Both audio sources are assigned bydefault.

91

Pearl Nano User Guide

Assign audio sources to an input

To avoid unwanted signal noise on the RCA ports, we recommend adding no more than 12dB ofgain when RCA, XLR+RCA (for Pearl-2 and Pearl Nano), or XLR+3.5mm (for Pearl Mini and Pearl
Nexus) is selected.

Assign the audio source to an input using the Admin panel
1. Login to the Admin panel as admin. See Connect to the Admin panel.
2. From the Inputs menu, select the shared audio source. The audio configuration page opens.
3. From the Input menu, select the audio source and click Apply.

Assign the audio source to an input using the front screen on Pearl Nano
1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select Inputs. Then from the Inputs screen, select XLR/RCA Audioto open the XLR/RCA Audio screen.

3. From the XLR/RCA Audio screen, highlight Input and press the check mark key to display options.

92Pearl Nano User Guide

Adjust audio gain and delay

4. Highlight the option you want, then press the check mark to select and return to the previous screen. To
return to the previous screen without making a selection, press the left arrow key.

Adjust audio gain and delay
Pearl devices do not introduce audio delay and have near-zero latency when capturing. However, other external
factors can cause audio to become de-synchronized, such as the length of audio cables or the configuration ofyour equipment. The audio delay feature helps you adjust audio coming from external sources so that your video
and audio sources are synchronized when captured, streamed, and recorded.
You can apply from -300 ms to +300 ms of delay to any audio source using the Admin panel or Pearl Nano's front
screen. By default, there's 0 ms of delay applied to audio sources.
The analog audio input ports on Pearl-2 and Pearl Nano are calibrated for +4.0 dBu XLR or -10.0 dBV RCA audio
signals and provide moderate to significant signal headroom. For the analog audio inputs, you can add up to +30
dB of gain.
Microphones typically have low audio signals (less than -30 dBu) and are not supported directly as
inputs to Pearl Nano. Use an audio mixing board or preamp to amplify microphones and supply theappropriate line level input.
Adjusting the Input Gain for an analog audio source affects the volume for that audio source in recordings,
streamed output, video output ports, and in the headphone jack. Be aware that excessive amounts of gain can
increase the perception of any noise that may be present in the audio signal.
If the gain of your analog audio signal needs adjustment, connect your headphones and use the VU meters tomonitor the audio level while you add some gain. As a rule, each 10 dB of gain doubles the perceived loudness of
the audio signal.
This table offers some guidelines for adjusting the gain at the audio input port of Pearl Nano for common types ofaudio input devices. You should add the suggested gain to the audio input to get an average signal to register at
a nominal level in the VU meter (i.e. where the green bars change to yellow). The actual amount of gain needed
depends on the strength of the original audio signal.

93

Pearl Nano User Guide

Adjust audio gain and delay

Table 22 Audio input port gains guidelines
Audio source

Input port

Mobile phone or otherconsumer line level device

XLR

Add +6 to +12 dB gain to the audio input port.

RCA1

NominalXLR

Nominal

RCA1

Not recommended.

USB

NominalProfessional mixer
USB microphoneGain

Not recommended.
Dynamic, condenser, or
electret microphones

XLR

To connect microphones to the pro line level XLR inputs, you mustuse an external preamp to boost the microphone signal enough toprovide the proper line level signal at the XLR input port, seeConnecting microphones to the XLR line level inputs.

1 To avoid unwanted signal noise on the RCA ports, we recommend adding no more than 12dB of gain to the RCA port or when

XLR/RCA is used, see Assign audio sources to an input.

Ensure the audio input source is connected to an analog audio input port on Pearl Nano before proceeding.

Adjust the gain and delay for an audio source using the Admin panel
1. Login to the Admin panel as admin. See Connect to the Admin panel.
2. From the Inputs menu, select an audio source. The audio configuration page for the audio source opens.

3. In the Input Gain field, select the amount of gain to apply to the audio source.

94

Pearl Nano User Guide

Adjust audio gain and delay

4. In the Audio delay field, enter a value between 300 and -300 ms. A positive value adds delay to the audio
signal. A negative value adjusts the audio to start earlier.
5. Click Apply.

Adjust the gain and delay for an audio source using the front screen
1. Repeatedly press the left arrow key on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select Inputs. Then on the Inputs screen, select XLR/RCA Audioto open the XLR/RCA Audio screen.

3. To adjust audio delay from the XLR/RCA Audio screen, highlight Audio delay and press the check markkey to display options.

95

Pearl Nano User Guide

Mute audio

4. Highlight the amount of delay you want using the up and down arrow keys, then press the check mark key
to select and return to the previous screen. To return to the previous screen without making a selection,press the left arrow key.
5. To adjust the gain from the XLR/RCA Audio screen, highlight Gain and press the check mark key todisplay options.

6. Highlight the amount of delay you want using the up and down arrow keys, then press the check mark key
to select and return to the previous screen. To return to the previous screen without making a selection,press the left arrow key.

Mute audio
You can mute any audio input port using the Admin panel. For analog audio ports that are configured as mono
inputs, you can mute each port separately.
Some audio input ports share internal audio processing resources in the Pearl device. Muting an audio input thatshares internal resources mutes all the associated audio sources. The following table lists the audio input portsthat share internal processing and the results of applying mute.
Table 23 Muting audio inputs that share resources
DeviceAudio input(Admin panel)

Shared audio
input resources

Results
In stereo mode:
Both XLR ports (left and right) are muted.
Both RCA ports (left and right) are muted

Pearl Nano

XLR (left/right)

In mono mode (XLR/RCA audio Left muted):

RCA (left/right)

Both the XLR 1 (left) and RCA left ports are muted.

XLR/RCA Audio
The XLR 2 (right) and RCA right ports are not muted.
In mono mode (XLR/RCA audio Right muted):
Both the XLR 2 (right) and RCA right ports are muted.

96

Pearl Nano User Guide

DeviceAudio input(Admin panel)

Mute audio

Shared audio
input resources

Results
The XLR 1 (left) and RCA left ports are not muted.

Mute an audio source using the admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, select an audio source. The audio configuration page for the audio source opens.
3. Check Mute to mute the audio source or uncheck Mute if you no longer want the audio source muted,
then click Apply.

Mute an audio source using the front screen
1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select Inputs. Then from the Inputs screen, select XLR/RCA Audioto open the XLR/RCA Audio screen.

97

Pearl Nano User Guide

Video output ports

3. From the XLR/RCA Audio screen, press the down arrow key repeatedly until Mute appears on screen
and is highlighted.

4. Press the check mark key to toggle the switch on or off.

Video output ports
The HDMI video output port can send video from the Pearl device to connected devices like a display for
confidence monitoring, an in-room projector, or even a video wall. You can use the Admin panel or the Pearldevice screen menu to send any video source or channel to the video output port with (or without) the audio.
Use MultiViewer to display a custom mix of channels and video sources in a convenient grid for confidence
monitoring with minimal impact to your system's processor.
Since the Pearl Nano has one channel, MultiViewer on the Pearl Nano displays a custom mix of up
to two video sources including the channel on the HDMI output port.
Topics include:lAbout video output portslVideo output port resolutionl

Set up the video output port using the Admin panell

Set up and enable MultiViewerlMultiViewer system informationl

Select the video output source using the device screenlPreview the video output portlDisable the video output portlDisable or enable audio and output port volumelDisplay and reposition the audio VU meterl

Rename a video output portlMirror the video output port display

98

Pearl Nano User Guide

About video output ports

About video output ports
Pearl Nano
An HDMI video output port is located on the rear panel of Pearl Nano. The HDMI OUT port is set to display the
Auto channel by default, but you can change this using the Admin panel . The video output port is configured tomaintain aspect ratio, use the display's default resolution, and include audio at 100% volume. However, theaudio meter is not shown by default.

Pearl Nano also has an HDMI video pass through port that outputs the HDMI IN signal with no added latency.
The HDMI PASS-THROUGH port is not user configurable and does not modify the input video signal that ispassed through.
Using the video output port takes CPU cycles and adds to the overall load on your Pearl device. For
optimum performance, keep displays disconnected from the video output port if you're not using
them. Setups that already put a heavy load on the system's CPU may be negatively impacted if theexternal video output port is used.
You can use the Admin panel to configure the video output port parameters. If you're simply selecting a video
source or channel and enabling/disabling audio for the output port, you can use your choice of either the Admin
panel, or Epiphan Live (if you are using a Pearl Mini, Pearl Nexus, or Pearl-2). For channels that have audio, theaudio is enabled by default.

Important considerationslWhen changing encoding parameters for a channel that's displayed on the video output port, it may revert
to the display's default resolution if the output resolution is set to "Same as source". To resolve this,change the video output to a different resolution then back to "Same as source".

lWhen using the video output port for confidence monitoring, some delay can be expected. For a 1080p
video source, the average delay on the video output port is approximately 100 ms. For a 1080p channel,
the average delay on the video output port is approximately 300 ms. The actual amount can vary,depending on the setup.

l

If an SDI or HDMI video input source that is selected to display at the HDMI output port also appears in acustom layout for a channel, then the channel's encoding settings are used at the HDMI output. Changing
the channel's frame rate will change the frame rate used at the output port for that video input.

99

Pearl Nano User Guide

Video output port resolutionl

Pearl-2, Pearl Mini, and Pearl Nexus - Using the video output ports adds to the overall system load on
the Pearl device. If your system has a high system load and you're using the video outputs, monitor theframe rate of your channels on your Pearl device and adjust your setup if there's an unacceptable drop in
the frame rate. Remedial measures you can take include eliminating video scaling at the inputs, adjusting
the encoding bitrates,.

l

Use MultiViewer to preview multiple sources, including system information like channel status and audio
information, on the video output port in a grid for confidence monitoring with minimal impact to systemloading.

Numberof
Displays

Cable 1

Cable 2

Output resolution

1

passiveconvertern/aAny (1024×768, 1280×720, 1280×960, 1360×768,
1400×1050, 1920×1080)n/a

Any (1024×768, 1280×720, 1280×960, 1360×768,
1400×1050, 1920×1080)

1

2

passiveconverter

passiveconverter2

activeconverter or
DisplayPort
cable

activeconverter or
DisplayPort
cable

2

activeconverter or
DisplayPort
cable

passiveconverter

passiveconverter

activeconverter or
DisplayPort
cable

2

Displays can be set independently to any resolution up to
1080p (1024×768, 1280×720, 1280×960, 1360×768,
1400×1050, 1920×1080)

One of the two displays will fail to receive a signal.Do not
mix passive converters with active converters andDisplayPort cables.

Related links
Set up the video output port using the Admin panel
Set up and enable MultiViewer
Select the video output source using the device screen

Video output port resolution
The video output port's resolution (also known as frame size or display mode) defines the number of pixels
displayed horizontally and vertically. For example, the resolution 1920×1080 (1080p) produces an image that is100

Pearl Nano User Guide

Set up the video output port using the Admin panel

1920 pixels wide by 1080 pixels tall.
Pearl devices always assume that the output display uses square pixels.
The aspect ratio (eg. 4:3 or 16:9) describes the proportional relationship between the video output's pixel widthand height. The resolution 1920×1080 (1080p), for example, is quite a bit wider than it is tall. The ratio of its width
to height is 16 to 9, which has an aspect ratio that is 16:9.
By default, you can choose from the following output resolutions for your video output ports, but you can alsochange settings to allow a variety of other resolutions through.

Set up the video output port using the Admin panel
You can send a channel or a video source to the video output port using the Admin panel. You can also adjust
the video output resolution, aspect ratio, and choose to include audio. The video output port frame rate is set
automatically to the channel's configured frame rate for that video source.
When outputting a channel that has audio or a video source with embedded audio, you can adjust the volume
and choose to include the audio meter. The audio meter is set to a fixed size of 15% of the width (or height if
displayed horizontally) of the display.
The HDMI pass-through port only displays the identical video signal with audio that is received at the
HDMI IN port on Pearl Nano.

Important considerations
To select the video you want to appear on the output port using see About video output ports.

Set up a channel or video source to display on the video output port using the Admin
panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the output port ( ). The video output port configuration page opens.
3. In the Source field, select a channel (prefixed by the word Channel) or a video source (prefixed by theword Input).

101

Pearl Nano User Guide

Set up the video output port using the Admin panel

4. In the Resolution field, select the resolution for the video output port.
DeviceValue

Description

All

Same as source

Set the output to the same resolution as the channel or video
source. If that resolution is not supported by the display, thevideo output port will negotiate a new resolution with thedisplay (generally this ends up being the display's default
resolution).

All

Destination default

This is the default value. Each display has a preferred
resolution, and when you choose this setting, the video
output port will use the display's default resolution.

Pearl Nano

1024×768,
1280×720,
1280×960,
1360×768,
1400×1050,
1920×1080

Choose a specific resolution for the output port.

5. Do one of the following:a. Check Keep aspect ratio check to have the system maintain the correct aspect ratio. If the aspectratio is different between the source and the chosen display aspect ratio, black bars areautomatically inserted at the top and bottom or left and right sides of the video.
b. Uncheck Keep aspect ratio check to have the system stretch the source to fit the aspect ratio ofthe display.

102

Pearl Nano User Guide

Set up and enable MultiViewer

6. For a channel, do the following:a. Check Enable audio to include audio in the output. Leave this unchecked for no audio with thevideo.
b. (Optional) For a channel with audio enabled, adjust the volume. Enter a value from 0 to 100 percent
in the Audio volume field.
c. (Optional) For a channel with audio enabled, choose whether or not to display the audio meter fromthe Audio meter drop down.
d. If displaying the audio meter, select horizontal or vertical from the Audio meter orientation dropdown menu to change the orientation of the displayed audio meter.
7. For an input source, do the following:a. Select an Audio source from the drop down list.
b. (Optional) Adjust the volume. Enter a value from 0 to 100 percent in the Audio volume field.
c. (Optional) Choose whether or not to display the audio meter from the Audio meter drop down.
d. If displaying the audio meter, select horizontal or vertical from the Audio meter orientation dropdown menu to change the orientation of the displayed audio meter.
8. Click Apply.
The audio meter can be displayed even if you are not playing audio over the video output port
(i.e. even when the Enable audio check box is not checked).

Set up and enable MultiViewer
MultiViewer displays a custom mix of video sources including channels on the HDMI output port in a convenientgrid for confidence monitoring with minimal impact to the system's processors. MultiViewer features differ by
Pearl device:l

Pearl Nano - two video sources. Side-by-side grid.
The HDMI pass-through port only displays the identical video signal with audio that is received at the
HDMI IN port on Pearl Nano.

Save processing power so you can do more with your Pearl system while previewing multiple video sources on
the HDMI output port. With MultiViewer, the video output displays at a lowered frame rate to economize CPU
usage. Using MultiViewer does not lower the frame rate of channel recordings and live streams.
No audio signal present at the output port, but audio meters do display for channels and video sources that haveembedded audio signals.
Use the Admin panel to choose which video sources appear in the pre-configured MultiViewer grids and to set
the video output port resolution. You can enable MultiViewer for the output port using the Admin panel, the Pearldevice screen, and using local console.

103

Pearl Nano User Guide

Set up and enable MultiViewer

Deleted network sources or channels may appear in MultiViewer.

Set up and enable MultiViewer using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the output port (). The video output port configuration page opens.
3. In the Source field, select MultiViewer.
4. In each cell of the grid, select a channel, video source, or system information.
l

System Information > Channels : provides you with information on Channel status or Audio
Inputs status. For more information, see MultiViewer system information.

lShow information about upcoming and ongoing CMS events (optional) - Select the check box
and MultiViewer displays the name of upcoming or ongoing events, time remaining before
upcoming events, and the time remaining of an ongoing event.

l

Text size (optional) - Increase or decrease to change the size of the display text in MultiViewer.

5. In the Output Resolution field, select the resolution for the video output port and then click Apply.
Value

Description

Destination default

This is the default value. Each display has a preferred
resolution, and when you choose this setting, the video
output port will use the display's default resolution.

l

All devices: 1024×768,
1280×720, 1280×960, 1360×768,
1400×1050, 1920×1080

Choose a specific resolution for the output port.

Enable MultiViewer using Pearl Nano's front screen menu
1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Settings toopen the Settings screen.

104

Pearl Nano User Guide

MultiViewer system information

3. From the Settings screen, select HDMI output to open the HDMI output screen, then press the check
mark key to select Video. The available video sources display.

4. Highlight MultiViewer, then press the check mark key to select and return to the previous screen. To
return to the previous screen without making a selection, press the left arrow key.

MultiViewer system information
MultiViewer can display system information, including channel and audio input information. To display system
information in the MultiViewer, select Channels or Audio Inputs in the Source drop-down on the HDMI outputs
page.

Channels
If Channels is selected, the following information is displayed on the MultiViewer:lChannel - the status of the channel statusl- The are no errors or warnings, and the channel is ready to use.
l

- There is an error with either the channel's recorder or any of the channel's publishers.
l- There are publishing warnings. This is also shown if the channel is not in running state.

105

Pearl Nano User Guidel

Select the video output source using the device screen

Recording - The recording status of the channell- Currently recordingl- Recording errorllStopped - Not currently recording

Streaming - The streaming status of the channell- There are active publishers. The numbers show how many publishers are active.

l- Publishing errors, and the number of publishing errors.
lActual FPS - The current rate of frames per second

Audio Inputs
A list of the active audio inputs on the Pearl device.
l

Input name - the name of the audio inputl

Audio meter l- the audio islive and the input is being monitored

Select the video output source using the device screen
It's easy to change the video source that appears at the video output port using the front screen or touch screen.
For video sources that have audio, you can enable and disable the audio as well. Audio is enabled by default.
To configure the video output port parameters, use the Admin panel. See Video output ports.

106

Pearl Nano User Guide

Select the video output source using the device screen

Select the video output source using Pearl Nano's front screen menu
1. Press the left arrow key repeatedly on the control interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Settings toopen the Settings screen.

3. From the Settings screen, select HDMI output to open the HDMI output screen, then press the check
mark key to select Video. The available video sources display.

4. Highlight the source you want to display on the output, then press the check mark key to select and returnto the previous screen. To return to the previous screen without making a selection, press the left arrow
key.

107

Pearl Nano User Guide

Preview the video output port

Preview the video output port
You can preview the video signal that is shared over your video output port by looking at the preview window atthe bottom of the video output configuration page in the Admin panel.
The preview is updated every few seconds and always maintains the same aspect ratio as thesource it is copying. It doesn't reflect black bars, the audio meter or actual aspect ratio/resolution on
the display.

If the video output port is showing a source and that source has no signal, the source's no signal image isdisplayed.
If the video output port is showing a channel and that channel is unavailable or has no signal, a no signal
message is shown for 2.5 seconds, then the display output is changed to a black screen.

Disable the video output port
You can use the Admin panel to disable a video output port so that even if a display is connected, nothing isshown.

Disable the video output port using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the output port (). The video output port configuration page opens.
3. In the Source field, select none to disable the video output port and then click Apply.

108

Pearl Nano User Guide

Disable or enable audio and output port volume

Disable or enable audio and output port volume
If you're displaying a channel as the source for your video output port, audio for that channel is also encoded andsent over the port by default. You can disable the audio on the output port using the Admin panel. You can also
adjust the volume of the audio on the video output port using the Admin panel. Disabling the audio on the video
output port improves latency for the port.
If you're displaying a video input as the source for your video output port, you can select an audio source andadjust the volume. Audio is taken from the video input source you've selected for the video output port by default.

Disable audio for a channel on the video output port and adjust the volume using theAdmin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the output port ( ). The video output port configuration page opens.
3. For a channel, do the following:a. Check Enable audio to include audio in the output. Leave this unchecked for no audio with thevideo.
b. (Optional) For a channel with audio enabled, adjust the volume. Enter a value from 0 to 100 percent
in the Audio volume field.
c. (Optional) For a channel with audio enabled, choose whether or not to display the audio meter fromthe Audio meter drop-down menu.
d. If displaying the audio meter, select horizontal or vertical from the Audio meter orientation dropdown menu to change the orientation of the displayed audio meter.

109

Pearl Nano User Guide

Disable or enable audio and output port volume

4. For input sources, do the following:a. Select an Audio source from the drop down list.
b. (Optional) Adjust the volume. Enter a value from 0 to 100 percent in the Audio volume field.
c. (Optional) Choose whether or not to display the audio meter from the Audio meter drop down.
d. If displaying the audio meter, select horizontal or vertical from the Audio meter orientation drop
down to change the orientation of the displayed audio meter.

110Pearl Nano User Guide

Display and reposition the audio VU meter

5. Click Apply.

Display and reposition the audio VU meter
When sending a channel with audio over the video output port, you can choose whether or not to display theaudio VU meter using the Admin panel. You can also determine the position and orientation of the audio meter.
Audio pass-through, adjusting the volume, and displaying an audio meter are only supported when achannel is the selected video source.

Configure the audio meter for the video output port using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the output port (HDMI 1). The video output port configuration pageopens.
3. In the Audio meter field, choose an option.
Value

Description

do not display

No audio meter is displayed.

left top corner

Audio meter is displayed at the top left side of the display.

right top corner

Audio meter is displayed at the top right side of the display.

left bottom corner

Audio meter is displayed at the bottom left side of the display.

right bottom corner

Audio meter is displayed at the bottom right side of thedisplay.

111

Pearl Nano User Guide

Rename a video output port

4. If you've selected a location for the audio meter, you can also select an orientation (horizontal or vertical)
in the Audio meter orientation field.
5. Click Apply.

Rename a video output port
Using the Admin panel (, you can easily change the video output port default name to something more suitable.
For example, Projector Output or Confidence Monitor.

Change a video output port name using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the video output port. The video output port configuration page opens.
3. Select the video output port name at the top of the page and enter a new name using your keyboard. The
text turns red when it's selected for editing.

4. Press Enter using your keyboard to save the changes.
You must press Enter to save the new name. The Apply button does not save the source
name change.

Mirror the video output port display
You can use the Admin panel to mirror the original video source on the output port so that it appears reversed on
the connected display. If there's an on-screen image that includes text such as a custom no signal image, the text
will appear reversed.

112

Pearl Nano User Guide

Connect external devices

Mirror the video source at the video output port using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output ports menu, click the output port you want to mirror. The video output port configuration
page opens.
3. Check Mirrored to flip the video source's orientation on the display port. Uncheck Mirrored to display thevideo source in it's original orientation, then select Apply

Connect external devices
You can connect external devices to your Pearl device for control and monitoring.
Topics include:

113

Pearl Nano User Guidel

Connect an external keyboardlConnect a USB status light

Connect an external keyboard

To connect an external monitor to your Pearl device for confidence monitoring, see Video output ports.

Connect an external keyboard
Instead of using the built-in virtual keyboard on the Pearl device's screen, you can connect a USB keyboard to
Pearl device and use that. Simply enable the external keyboard feature using the Admin panel and connect yourkeyboard directly to any available USB port.
You can change the keyboard layout to any of the supported languages. When multiple languages are selected,
you can use Ctrl+Shift or Ctrl+Alt to toggle between languages.
lAmerican English (default)

l

Dutch

l

FrenchlGermanl

ItalianlNetherlandslNorwegian (Bokmal)l

Portuguese (European)l

Spanish (Spain)

l

Swiss

l

RussianWhen an external keyboard is connected to the USB port, the Lock Caps key on the external keyboard controls
both the external keyboard and the virtual keyboard.

Enable the external keyboard feature using the Admin panel
1. Login to the Admin panel as admin, see Connect an external keyboard.
2. From the Configuration menu, select External keyboard. The External keyboard configuration pageopens.
3. In the Keyboard application drop-down menu, select Touch screen(Front screen on Pearl Nano).
4. (Optional) Check a different keyboard language layout or multiple language layouts. The default layout isAmerican English.
5. (Optional) Choose the keyboard key combination to toggle between keyboard layouts if multiple
languages are selected: Ctrl+Shift or Alt+Shift.
6. Click Apply.

114

Pearl Nano User Guide

Connect a USB status light

What's next?
Learn about keyboard shortcuts, see External keyboard shortcuts.

Connect a USB status light
Pearl devices support connection of an external USB status light to visually indicate the status of recording andstreaming. You can connect a USB status light directly to a USB port on the Pearl device.
The following USB status lights are supported:lKuando BusyLight models: UC Alpha and UC OmegalDelcom Products USB HID single color and multicolor signal indicators

The status light is activated as soon as it is connected to a USB port on the Pearl device and flashes once.
Table 24 Status light indicator
Table 25 The default behavior of status lights is shown in the table below.
Light

Description

Solid off

The Pearl device is not currently recording or streaming.

Solid onRecording or streaming is in progress.
Rapid flashing (approximately five blinks per second)
commences five minutes before a scheduled event begins.

Flashing
Slow flashing (approximately two blinks per second) indicatesthat an error occurred during recording or live streaming.

Starting in firmware version 4.23.1, for each state of Pearl, you will be able to select the color and status of lightaccording to following table.

Pearl state

Selectable color

selectable light status

Idle

Red, green, yellow, or
blue

Disable (default), solid,
slow pulse, or fast pulse

Recording

Red (default), green,
yellow, or blue

Solid (default), slow pulse,
fast pulse, or disabled

Streaming

Red (default), green,
yellow, or blue

Solid (default), slow pulse,
fast pulse, or disabled

CMS event is about tostart

Red (default), green,
yellow, or blue

Solid, slow pulse (default),
fast pulse, or disabled115

Pearl Nano User Guide

Connect a USB status light

Pearl state

Selectable color

selectable light status

CMS event is running

Red (default), green,
yellow, or blue

Solid (default), slow pulse,
fast pulse, or disabled

CMS event is paused

Red (default), green,
yellow, or blue

Solid, slow pulse (default),
fast pulse, or disabled

CMS event is about toend

Red (default), green,
yellow, or blue

Solid (default), slow pulse,
fast pulse, or disabled

Error

Red (default), green,
yellow, or blue

Solid (default), slow pulse,
fast pulse, or disabled

Select color for on-air light status
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select USB Lights.
3. Select the color and light status for each state of your Pearl

116

Pearl Nano User Guide

Feature add-ons

Feature add-ons
Epiphan offers add-on features so you can do even more with your system. Pearl-2 and Pearl Nano currently
offer feature add-ons for extra functionality.
See Add-ons overview for details about the availability of add-ons for your system, as well as instructions topurchase and install add-ons.
Where you see this symbol 4K in the guide, that means the feature or function applies only if you
have activated the 4K feature add-on.

Add-ons overview
Add-ons are listed in the Admin panel when you click Firmware upgrade from the Configuration menu.

Add-ons must be purchased, installed, and activated before their features can be used. If you have alreadypurchased an add-on either on our site at epiphan.com/add-ons or have purchased the full version of Pearl-2 orPearl Nano, you can go ahead and click Install purchased add-ons to activate the feature. A system reboot isrequired. If you want to purchase an add-on, follow the process outlined below.

Purchase 4K add-on
You can go to the add-ons store page on the Epiphan website at epiphan.com/add-ons to purchase feature addons or navigate there from the Admin panel.

117

Pearl Nano User Guide

Add-ons overview

From the Firmware Upgrade page in the Admin panel, click Shop now to go to the add-ons store page to selectand purchase available add-ons.
You can also click Purchase beside any feature add-on that's listed on the Firmware Upgrade page to go to theepiphan.com website and purchase that specific feature.

Install purchased add-ons
Purchase the 4K feature add-on to enable that feature on Pearl-2 and Pearl Nano. Each purchased add-on canbe installed and activated on a single device.
To install purchased add-ons:
Click Install purchased add-ons from the Firmware Upgrade page to start the installation process. A systemreboot is necessary to activate add-ons. Click OK when prompted. If you click Cancel, the device installs the
add-on but does not reboot. The add-on is not activated until the device is rebooted.

Even if you have already purchased a feature, the Purchase button remains next to the feature until
you have activated the feature and the system is rebooted. To determine if a feature with a
Purchase button next to it has already been purchased, click Install purchased add-ons. If no addons are ready to be activated and installed, a message appears.

After you've activated your feature add-ons and the system reboots, the Purchase button beside those features
is replaced by an Activated indicator.

118

Pearl Nano User Guide

About 4K on Pearl devices

About 4K on Pearl devices
Pearl-2 and Pearl Nano support resolutions from low-res SD to 4K, which means that you can use them tocapture DCI 4K (Pearl-2 only) and 4K UHD digital signals. You need the 4K feature add-on to access this feature,
see Add-ons overview.

4K feature add-on
The 4K feature provides Pearl-2 or Pearl Nano with the following 4K features:
Specification

Pearl-2

Pearl Nano

4K video inputs

4 (2 HDMI and 2 SDI)

2 (1 HDMI and 1 SDI)

4K Hardware scaling (4K down to full HD)

4

2

4K video outputs (HDMI)

2

1 pass through port

4K video encoding1

1

You can find more details on the add-on, along with installation instructions and the add-on itself, atwww.epiphan.com/add-ons.

4K UHD vs. DCI 4K
DCI 4K and 4K UHD are just different definitions of a 4K resolution. 4K UHD (3840×2160) is the standard 4K
resolution available on televisions and other common display screens. The 4K resolution of 4096×2160 (Pearl-2
only) referred to as Digital Cinema Initiatives (DCI) 4K, and is the resolution used almost exclusively for cinemascale film production. It is rare to find this resolution outside of a cinematic context. Pearl-2 and Pearl Nanocapable of supporting input and output at either definition with the Feature add-ons.

119Pearl Nano User Guide

User administration

User administration
Pearl Nano has different types user accounts. Depending on the type of user, you will have different privileges.
Topics include:lUser types and privilegeslChange user passwordslOvercome lost passwordsl

Remove user passwordl

Log in using a different user accountlAssign administrator privileges to operatorslConfigure LDAP user authenticationl

Restrict viewers by IP address

User types and privileges
There are different types of user accounts:lAdministratorlOperatorlViewer120

Pearl Nano User Guide

User types and privileges

No password is assigned to the user accounts by default. The first time you login to the Admin panel using theadministrator-level account, you're prompted to set passwords for all three user accounts. The Pearladministrator can change passwords at any time using the Admin panel, see Change user passwords.
You cannot change the default user names or disable user levels. When you log in to the Pearl device, you must
log in as one of the three user levels. Private profiles with individually set passwords are not used.
Admin and operator-level users have access to the Admin panel to control the Pearl device. When logged in to
the Admin panel, the user level is displayed at the top right corner of the screen.

Administrator
The administrator account is used for all system configuration and has full access to all configuration featureswith full access to the web-based Admin panel, local console, and remote log in access. The default user nameused to log in to the Pearl device is admin.

Operator
The operator account allows users limited configuration control with limited access to the web-based Admin
panel, local console, and remote login access. The default user name used to log in to the Pearl device isoperator.
Operators can to do the following:lConfigure inputslControl recordings (start and stop)lRename, download and delete recordingslPerform network diagnostics

If an operator does not have the privileges to apply a particular configuration in the Admin panel, the Apply
button appears grayed-out in color and is not selectable. Administrators can grant operators permission to
perform some administrator tasks, see Assign administrator privileges to operators.

121

Pearl Nano User Guide

User types and privileges

Viewer
The global viewer account is exclusively used to view streamed channels. You're prompted to enter the default
user name viewer and password to view a channel's live broadcast.
In addition to the global viewer account, each channel can set a viewer password that overrides the global value,
see Restrict viewer access to channel streams.

User privileges
The following table outlines the default privileges for each user level. For administrator-level privileges that canbe assign to operators, see Assign administrator privileges to operators.
Table 26 User privileges in the Admin panel
Action or Menu Option
View channel output

vieweroperator

admin

ü

ü

ü

ü

ü

Channel Operations
View channel configuration
Rename a channel

üConfigure stream channel

üConfigure stream sourcesü

Start/stop recordingüüStart/stop a streamüüüConfigure channel metadata
View recorded files list

ü

ü

122

Pearl Nano User Guide

Action or Menu Option

User types and privileges

vieweroperatoradmin

Rename recorded filesüüDownload recorded filesüü

Delete recorded files

ü

ü

ü

ü

Input Source Operations
View input source configuration

üRename input
Configure inputüü

View input snapshotüüNetwork & security
üConfigure static IP address
Configure DHCP (including Option 81) andDDNSüChange HTTP/HTTPS port valuesü

Configure 802.1x

üConfigure HTTPSüCMS Operations
Start/stop scheduled events from the device
screenüüüCreate ad hoc events from the touch screen(Pearl-2 and Pearl Mini)

ü

ü

ü

Enable CMS and registerü

Disable CMS or deregisterüConfigure CMS settings and default event
parametersüStart/stop scheduled events (Admin panel)üüCreate ad hoc events (Admin panel)üüView the Events pageüüSystem Configuration Operations

123

Pearl Nano User Guide

Action or Menu Option
View system configuration

User types and privileges

vieweroperator

admin

ü

ü

Format the SD card (Pearl Mini and Pearl
Nano)

ü

Configure Automatic File Upload (AFU)ü

Select External USB drive behaviorüCancel USB file transfersüü

Configure network addressüConfigure date and time preferencesü

Set or change user passwords

üConfigure serial port flow control

üUpload and delete media

üEnable remote support

üBackup device configuration

ü

Restore device configuration

ü

Restore factory configurationü

Reboot device (Admin panel)üEnable/disable Epiphan Edge featureüUpgrade Firmwareüüü

Bandwidth testüüConnectivity statusüü

Domain name resolution

ü

ü

Ping

ü

ü

Probe

ü

ü

Trace routeüü

View System Information
Network Diagnostics

124

Pearl Nano User Guide

Change user passwords

Change user passwords
The admin, operator and viewer-level user accounts have no assigned password by default. The first time youaccess the Admin panel using the administrator-level account you're prompted to set passwords for all the threeuser accounts. Record passwords somewhere safe for future reference.

Passwords are case sensitive and can include up to 64 alphanumeric characters within the ASCII range.
Restricted characters include:lspaceslsingle quotesldouble quoteslbackslash

Contact your system administrator for your organization’s specific password requirements.
In addition to setting the viewer-level user account password, you can set access passwords and IP restrictions
on a per channel basis from the channel's Streaming page, see Restrict viewers by IP address.
If you lose the admin password, see Overcome lost passwords.
Users are automatically logged out when a password changes. Viewers may need to refresh theirbrowser window or press play in their media player.

Change the admin password when there is no live stream in progress. Changing the admin
password while live streaming disrupts the stream for viewer-level users.

Change a user account password using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.

125

Pearl Nano User Guide

Overcome lost passwords

2. From the Configuration menu, select Security. The Security configuration page opens.
3. Under the Authentication section, delete the current password for a user account and enter a new
password. Passwords are case sensitive.
4. Enter the identical password in re-type and click Apply.

You can set multiple account passwords before clicking Apply. If the passwords don't match,re-enter both passwords and try again.
If you're logged in when the password changes, you're automatically logged out and must log back in with
the new password. If you add or change the viewer user's password, all channel streams pause for people
watching the stream using the viewer account and must log back in using the new password.

Overcome lost passwords
If you have lost the password for the operator or viewer account, you can log in to the Admin panel and reset the
password using the procedure described in Change user passwords.
If you have lost the admin password and you have remote support enabled on the device, contact Epiphan
Support to request a remote password reset. If remote support is disabled, you must return the system
to Epiphan for password recovery. Contact Epiphan support.
Alternatively, you can regain access to the Pearl device if you apply the factory default configuration preset using
the device screen menu, see:lPearl Nano - Apply a configuration preset using the front screen menu.

The factory default configuration will change the current settings on the Pearl device, see The Factory default
configuration preset and Factory reset. . You can also perform a factory reset, see Perform a factory reset.

Remove user password
After passwords are assigned to the three user account levels (admin, operator, and viewer), we do notrecommend deleting them without setting a new password. To change passwords using the Admin panel, see
Change user passwords. If you don’t remember the admin password, see Overcome lost passwords .

126

Pearl Nano User Guide

Log in using a different user account

Changing the password while someone is logged into the account automatically logs out that user. If
viewers are watching a broadcast when the viewer password is changed, they are automaticallylogged out. Viewers may need to refresh their browser window or press play in their media player totrigger the log in prompt.

Log in using a different user accountAfter you log in to the Admin panel as an Administrator or Operator, your browser remembers and automaticallylogs you in using the same user account the next time you log in to the Pearl device. You must log out of the
Admin panel, then log back in using a different user account.

Log in using a different user account
1. In the Admin panel, select the logout icon at the top right corner of the screen. A new log in screen
appears.

Some browsers may require you to click twice before the you are logged out.
2. Enter the credentials that you want to use to log in to the Admin panel.

Assign administrator privileges to operators
Administrators can assign additional administrative-level privileges to operators from the Security menu in the
Admin panel. The following table lists the available options and their associated privileges.
Table 27 Options with additional operator privileges
OptionOperator admin functions
Pearl Nano - Rename a channel.
Configure channel encoder settings

Channel configuration

Pearl Nano - Configure a custom layout for a channel
Configure, remove, rename, and publish a stream for achannelConfigure channel metadata

127

Pearl Nano User Guide

OptionAssign administrator privileges to operators

Operator admin functions
Upload, download, and delete media files

Input configuration

Add and rename video and audio inputs
Configure network address
Configure 802.1x and manage CA certificates

Network configuration

Enable and disable DHCP Option 81
Configure Dynamic DNS (DDNS)
Reboot the Pearl device.

Configuration presets control1

Create, delete, and apply configuration presets
Configure the video output settings
Enable CMS and register
Disable CMS or deregister
Configure CMS settings and default event parameters
Configure Automatic File Upload (AFU)
Select external USB drive behavior

System configuration
Configure the date and time preferences
Configure the device screen
Configure the serial port flow control
Enable/disable Epiphan Edge feature for remote control andremote login
Video output configuration
Apply configuration presets2
Upgrade firmware
Enable remote support
System maintenanceReboot device (Admin panel)
Restore factory configuration
Configure the name, location, and description

128

Pearl Nano User Guide

Configure LDAP user authentication

1Only configuration presets that don't include the System group are allowed.
2Allow operators to apply configuration presets that include the System group, as well as apply the factory

default configuration preset.

Assign administrative privileges to operators using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Security. The Security configuration page opens.
3. Under Additional operator privileges, check options to assign those administrator privileges to operators,
and then click Apply.

Configure LDAP user authentication
You can use the Lightweight Directory Access Protocol (LDAP) to authenticate users. Specify user roles by usinggroup DNs for users who log in as an Administrator, Operator, or as a Viewer.
The system has only one admin user and one operator. LDAP users must log in as either an admin or an
operator and do not have their own private profiles. Any LDAP users with the name admin, operator, or viewer
are ignored and the local accounts are used instead.
When enabled, LDAP authentication is an alternative to the regular system user names and passwords. You
may still login as admin, operator or viewer using the passwords for those accounts.
LDAP replaces the local viewer account instead of working side-by-side with it when LDAP isenabled and the viewer account has no password (either there is no global viewer password
configured or the channel overrides the global password with a blank password). In this case, theviewer must authenticate with LDAP and cannot use the default viewer account with a blankpassword to log in.

For security reasons, you should configure passwords for the local accounts.
These instructions assume you have a pre-configured LDAP server. The server must support anonymous
binding or have a special bind account with search access privileges. Note that Active Directory does not support
anonymous binding. LDAP referrals, restrictions and failovers are not supported.

Configure LDAP authentication using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Security. The Security configuration page opens.
3. In the LDAP authentication section, check Enable LDAP authentication. Uncheck the check box todisable LDAP authentication.
4. In the Server address[:port] field, enter the server IP address and (optional) port for your LDAP server.
For example, 192.168.1.101:389.

129

Pearl Nano User Guide

Configure LDAP user authentication

5. In the Connection encryption drop-down, choose the type of encryption used by your LDAP server (if any
is used).
Connection encrypDescription/Default port usedtion
No Encryption

No encryption is used to connect to the LDAP server. The default port is 389.

SSL

SSL encryption is used to connect to the LDAP server. The default port is 636.

TLS/STARTTLS

The connection is initially unencrypted then upgraded to TLS encryption is used.
The default port is 389.

6. In the Bind DN and Bind password fields, specify the fully qualified DN and password for LDAP bind.
These fields are only needed if your LDAP server does not support anonymous binding.
7. In the Base DN field, specify the baseObject to search for entries. The system will search this object andthe whole subtree starting at the base DN.
8. (Optional) By default the Authentication attribute is uid, which is suitable for a unix environment. You canspecify a different value in the Authentication attribute field, if needed. For Active Directory
environments, specify userPrincipalName. The value of this attribute must be unique in the Base DN.
9. In the Administrators (group DN) field, specify the distinguished name of the group users must be part ofto be logged in as the administrator. Users must have the member or uniquemember attribute for the
specified group to be granted Administrator access.
If left blank, LDAP is not supported for Administrators (but can still be used for Operators and Viewers).
10. In the Operators (group DN) field, specify the distinguished name of the group users must be part of to belogged in as the operator. Users must have the member or uniquemember attribute for the specified group
to be granted Operator access.
If left blank, LDAP is not supported for Operators (but can still be used for Administrators and Viewers).
11. In the Viewers (group DN) field, specify the distinguished name of the group users must be part of to belogged in as a viewer. Users must have the member or uniquemember attribute for the specified group to
be granted Viewer access.
If left blank, LDAP is not supported for Viewers (but can still be used for Administrators and Operators).
12. Click Apply.
When a user of the LDAP server next visits the admin or viewer page for the system, the system prompts for use
the username and password. For ActiveDirectory servers, the user needs to enter his fully qualified username(i.e. username@domainname) in addition to his LDAP password.

To use \\, \ or " characters as part of user name or password, escape them using \5C, 5C and 22
respectively. The # character does not require to be escaped.

130

Pearl Nano User Guide

Restrict viewers by IP address

Users are required to authenticate once to the system and one time per channel they view.
Therefore users see a prompt to log in to the system (the system name is shown) and a second time
to log in to the channel (the channel name is shown).

Restrict viewers by IP address
Pearl devices permit you to restrict which computers can access broadcasts by building a list of allowed anddenied IP addresses. You can do this at a global level for the system and can also override these settings on a
per-channel basis. Both global and per-channel configuration procedures are described.
The following table describes what happens when an IP address is added to the allowed and denied IP address
lists.
Table 28 IP Based Restriction Options
Item

Description
Users connecting from addresses in this list are permitted to view broadcasts from thedevice, provided their IP address is not in the Deny IP’s list.

Allow IP's

To allow all except IP addresses in the deny list, if any, leave the field blank.
You can use the Allow list by itself, or in conjunction with the Deny IP’s list as an exception toa rule in the allow list.

Deny IP's

Users connecting from addresses in this list are not allowed to view broadcasts from thedevice, unless their IP address is in the Allow IP’s list. If a specific IP address is in both lists,
access to the stream is denied.
You can use the Deny list by itself, or in conjunction with the Allow IP’s list as an exception toa rule in the allow list.

If your viewer account has a password, your viewers must connect to the device from a computer (or gateway)with a permitted IP address and must also supply the user name (viewer) and password before they can view thebroadcast.
To restrict access by IP address, you need to know the IP addresses or range of addresses for your viewers. By
default, all IP addresses are allowed to connect to the broadcast.
If a user attempts to connect to the stream from a disallowed IP address, access is denied. If there's an attempt
to connect using a web browser, the message "IP address rejected" is displayed.
If you’re not familiar with creating allow/deny lists, see IP restriction examples.
IP address restriction is valid for the viewer only and does not affect the Admin panel or the mobile
configuration interface.

131

Pearl Nano User Guide

Restrict viewers by IP address

Restrict viewer access to watch streams on a channel by their IP address
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channels menu, select a channel and click Streaming. The channel's streaming configuration
page opens.
3. From the Stream access control drop-down, select Use these Settings to enable local password andAllow/Deny IP lists are enabled.
4. (Optional) Enter a password for the viewer in the Viewer Password field.
5. Enter the allowed IP addresses or address ranges in the Allow IP’s field and enter denied IP addresses oraddress ranges in the Deny IP's field. Separate addresses with a comma. To specify a range, use ahyphen (-). Optional spaces improve readability.
6. Click Apply.

IP restriction examples
The following table lists some sample allow lists.
Table 29 Example allow lists
ExampleDescription
The simplest allow/deny list is to use the list of known IP addresses to craft alist of allowed IP addresses. All other addresses are denied access to thebroadcast.

Allow list with distinct IP
addresses

For example if your system is accessible on your local area network (LAN) andyou want to make sure only the CEO’s specific desktop, laptop and tablet
computers (with IP Addresses 192.168.1.50, 192.168.1.51, and 192.165.1.75,
respectively) can connect to the broadcast, construct the following allow list:
Allow: 192.168.1.50, 192.168.1.51, 192.168.1.75

Allow list with a range of IP
addresses

Sometimes you’ll want a range of computer IP addresses to connect to yoursystem. This may happen when you have one range of IP addresses assigned
to desktop computers (i.e. in the range 192.168.1.1 to 192.168.1.100) andanother range assigned to boardroom computers (i.e. the range 192.168.1.200
to 192.168.1.250). If you only want the boardroom computers to connect tobroadcasts from the system you can specify the range of boardroom IP
addresses rather than needing to type in each individual address. The allow list
looks as follows:
Allow: 192.168.1.200-192.168.1.250
Note that we could have specified two of the IP addresses in the previous
example as a range.

132

Pearl Nano User Guide

ExampleAllow list with a range of IP
addresses and one or more
specific IP addresses

Restrict viewers by IP address

Description
Putting the first two examples together, we want to permit access to IP
addresses in the range of boardroom computers (192.168.1.200192.168.1.250) and also want to add the desktop, laptop and tablet computersof the CEO (IP addresses 192.168.1.50, 192.168.1.51, and 192.168.1.75,
respectively). Note the first two IP addresses are consecutive, so they can be
added as a second range. Add these IP addresses to the list as follows:
Allow: 192.168.1.200-192.168.1.250, 192.168.1.50-192.168.1.51,
192.168.1.75
Your list can have multiple ranges and multiple distinct IP addresses, provided
they are separated by commas.
Building on the previous examples, consider a situation where you want the
CEO’s computers (192.168.1.50, 192.168.1.51, 192.168.75) and all boardroom
computers (192.168.1.200-192.168.1.250) to access the broadcast, with the
exception of the public boardroom computer (192.168.1.211). Use both allow
and deny lists to create the rule as follows:

Allow list with a range ofIP addresses, distinct
IP addresses, and an
exception

Allow: 192.168.1.200-192.168.1.250, 192.168.1.50-192.168.1.51,
192.168.1.75
Deny: 192.168.1.211
Both lists can have multiple ranges and multiple distinct IP addresses, provided
they are separated by commas.

The following table lists some sample deny lists.
Table 30 Example deny lists
ExampleDescription
Another simple allow/deny list is to use the list of known IP addresses to list
specific denied IP addresses. All other addresses are allowed access to thebroadcast.

Deny list with distinct IP
addresses

For example imagine your system is accessible on your local area network(LAN) and you want to allow any computer on the LAN can access the stream
except your publicly-accessible boardroom (with IP address 192.168.1.211).
You can use the following deny list (leave the allow list empty) to permit allcomputers except the boardroom computer:
Deny: 192.168.1.211

133

Pearl Nano User Guide

ExampleRestrict viewers by IP address

Description
As with allow lists, your deny list can specify a range of IP addresses, and canspecify multiple ranges or distinct IP addresses in a comma-separated list.
Consider a situation where you want every computer on the network to accessthe broadcast, with the exception of the CEO’s desktop, laptop and tablet
computers. Additionally, boardroom computers should not be permitted withthe exception of the cafeteria computer (IP address 192.168.1.222).

Deny list with a range of IP
addresses

The deny list is an "exception" list for the allow list. So to craft the rule describedabove we need to allow all the computers in the local subnet, then deny specificsub-ranges including two groups of boardroom computers ensuring thecafeteria computer's IP address is not in the deny list:
Allow: 192.168.1.1-192.168.1.250
Deny: 192.168.1.200-192.168.1.221, 192.168.1.223-192.168.1.250,
192.168.1.50-192.168.1.51, 192.168.1.75

134Pearl Nano User Guide

Configuration presets

Configuration presets
Configuration presets are the perfect solution for backing up your system configuration so you can restore later
when needed. They are also useful if you have changing configuration requirements for Pearl Nano or are
managing multiple systems and you want them to have similar configurations.
Topics include:lAbout configuration presetslConfiguration preset considerationslConfiguration groupsl

The Factory default configuration preset and Factory resetlCreate a configuration presetl

Apply a configuration preset using the Admin panellApply a configuration preset using the front screen menulExport and import configuration presetslUpdate a configuration presetlDelete a configuration preset

About configuration presets
Configuration presets are groups of settings that get applied to the system, leaving other important settings
intact. They make it easy to manage multiple Pearl Nano setups in shared spaces, like a studio, and ensures aconsistent setup each time you go to use Pearl Nano. You can even export a configuration preset and upload it toanother Pearl Nano system.
Configuration presets are not cross compatible between different Pearl models or between Pearldevices and Unify projects.
The system's settings are divided into the following configuration groups. You can choose to include any number
and combination of configuration groups in a preset and create as many different configuration presets as you
need.

Pearlconfiguration group listlSysteml

Networkl

Inputsl

EDIDlChannel135

Pearl Nano User Guidel

Automatic File UploadlContent Management SystemlEpiphan Edgel

Front screenlOutput port

About configuration presets

You can create and apply any saved configuration preset from the Configuration menu when you selectMaintenance using the Admin panel. A special Factory default configuration preset, which cannot be erased, isincluded in the list of configuration presets. Use that to return to the factory setup without destructively erasing
any saved recordings or media files you've uploaded.
It's important to note that configuration presets are applied over existing settings. They affect only the settingsgroups included in the preset. All other settings are unaffected. Read the Configuration preset considerations
section carefully to understand caveats around using configuration presets.

Example of presets in action
You could upload custom background images to Pearl Nano in advance of a conference and create custom
channel configuration presets for several different keynote speakers, each with a different setup, and then apply
them later when you need them.
For example, you could create two configuration presets called Session 1 and Session 2. Each session could
include things like custom backgrounds, images and logos, channels and layouts, metadata, streaming settings,
and automatic file upload (AFU) locations. Then download those presets to your local computer so you can
upload them to your entire fleet of Pearl Nano systems.
Channel configuration includes any applied backgrounds and image files. If these files aren't present
when the configuration preset is saved, the save function will fail. Be careful when deletingbackground images and logo files.
At the conference, simply apply the configuration preset that you need for the appropriate session using theAdmin panel or the Pearl device screen. When applying the configuration preset, all other preset groups remainunchanged. The preset only affects channels and their configuration.
Session 1 preset

Session 1 presenter data
and background image

plus the conference IP
address

Session 2 preset

136

Pearl Nano User Guide

Configuration preset considerations

Session 2 presenter data
and background image

plus the conference IP
address

After applying a configuration preset, recorded files from the previous session remain present on the system. If
AFU is configured, the recorded files continue to upload even after the new configuration preset is applied (ifAFU is not yet complete), but the channels reflect the newly loaded session's background file name andpresenter name.

Configuration preset considerations
There are important considerations that you should know before you start using configuration presets, including:l

Access to presets and privacy considerationslRecording and streaming stateslRecorded files in a channell

The potential to lock the device screenlOrphaned Kaltura resource registrations and duplicate resourcesland more

Access to presets and privacy considerationslRecorded files are not removed when you apply a configuration preset. Any user with access to Pearl
Nano has access to all the saved recordings, custom channel layout, etc that are associated with anapplied configuration preset.

lConfiguration presets can be overwritten and deleted without a password. Users who are logged in to the
Admin panel can remove or change an existing configuration preset.

lApplying a configuration preset does not clear the settings from groups that aren't a part of the preset,
which means user information is not private.

lMedia and recorded files can be deleted, affecting more than just the currently applied configuration
preset. Users can erase uploaded media or recordings that belong to other users.

Locking out the front screen on Pearl Nano
The front screen configuration group includes the PIN security setting for the front screen. It's possible to apply apreset that effectively locks out all further use of the front screen. If this happens, use the Admin panel to reset or
disable the PIN, see Set a PIN security code.

137

Pearl Nano User Guide

Configuration preset considerations

Configuration preset considerations
There are important considerations that you should know before you start using configuration presets, including:l

Access to presets and privacy considerationslRecording and streaming stateslRecorded files in a channell

The potential to lock the device screenlOrphaned Kaltura resource registrations and duplicate resourcesland more

Access to presets and privacy considerationslRecorded files are not removed when you apply a configuration preset. Any user with access to Pearl
Nano has access to all the saved recordings, custom channel layout, etc that are associated with anapplied configuration preset.

lConfiguration presets can be overwritten and deleted without a password. Users who are logged in to the
Admin panel can remove or change an existing configuration preset.

lApplying a configuration preset does not clear the settings from groups that aren't a part of the preset,
which means user information is not private.

lMedia and recorded files can be deleted, affecting more than just the currently applied configuration
preset. Users can erase uploaded media or recordings that belong to other users.

Locking out the front screen on Pearl Nano
The front screen configuration group includes the PIN security setting for the front screen. It's possible to apply apreset that effectively locks out all further use of the front screen. If this happens, use the Admin panel to reset or
disable the PIN, see Set a PIN security code.

Recording and streaming states
The channels (single channel on Pearl Nano) configuration group includes recording and streaming states forchannels . This means that if a channel is streaming or a channel is recording at the time you create aconfiguration preset, the channel will immediately start recording (or streaming) whenever you apply that presetto the channel. Similarly, if a configuration preset is created when a channel is not recording (or streaming),
applying that preset later won't cause the channel to start recording (or streaming).
This means a channel may stop recording or streaming as a result of applying the preset if thechannel was actively recording or streaming before applying the preset.

Pearl Nano preset example
For example, when applying a preset to a channel set to record (the same example applies for streaming):

138

Pearl Nano User Guide

Recorded files in a channel or recorderl

If the channel is already recording, the file continues recording uninterrupted unless the recording file typein the applied preset is different. In that case, a new file is started and recording resumes using the new
file.

l

If the channel is not already recording, it immediately begins recording when the preset is applied.

Recorded files in a channel or recorder
A channel (and recorder) keeps a list of recordings in the Recordings section in the Admin panel. These files
remain on the system even if the channel (or recorder) configuration is changed as a result of applying a
configuration preset.

Pearl Nano example
If you delete any of the recordings, you are deleting the only instance of those files. For example, if you delete
one of five recordings from the channel after creating a configuration preset, you'll find that even after applying
the preset, the channel will still have only four recorded files.

Orphaned Kaltura resource registrations and duplicate resources
Returning the Pearl device to the factory defaults using the factory default configuration preset or performing afactory reset does not delete the registered resource instance in Kaltura CMS. In that case, you can reregister
your Pearl device using the same resource name and take over for the resource instance that is still registered in
Kaltura, see Reassign a registered resource.
If you apply a configuration preset to set up a replacement Pearl device with the settings from a Pearl device thatis currently registered with Kaltura, the replacement Pearl device assumes the identity of the registered resource.
However, you risk having two active Pearl device resources with the same identity, which can effect recording
and the content that's uploaded to Kaltura for scheduled events.
To remove the risk of having two active devices with the same registered resource identity in Kaltura, werecommend powering down one of the Pearl device resources, then disconnect it from the network and consider
performing a factory reset or applying the factory default configuration preset.

Configuration groups
The following table describes what settings are saved with each configuration group.
Table 31 Configuration group definitions
Group Name

Settings included in the configuration group

SystemDate and time settings, serial port settings, remote support settings, custom disk checkschedule, access passwords, LDAP configuration settings, and deny/allow lists.

Network

Network settings.

InputsAll audio and video source configuration settings (including no signal images) except
EDID settings, which are in their own group.

139

Pearl Nano User Guide

Group Name

The Factory default configuration preset and Factory reset

Settings included in the configuration group

EDID

EDID settings for sources. Applying configuration presets with this group automaticallyapplies the included EDIDs. This process can take a while.

Channel(s)All channel configuration data and current recording state, all layouts) images used inlayouts, streaming state, all recording configuration data and current recording state.
Automatic file upload type, parameters and schedules.

AFU

SFTP/SCP private keys are included (in encrypted format) in the automatic file upload
preset.

CMS

Include CMS settings for integrations.

Epiphan Edge

Epiphan Edge pairing and encoder selection information.

Pearl Nano Front screen

Front screen PIN settings.

Output ports

All configuration settings for the output ports.

The Factory default configuration preset and Factory reset
Administrators can apply the default factory configuration preset to Pearl devices or Unify projects, which resets
most of the settings in each of the main configuration groups. Applying the factory default configuration preset issimilar to a factory reset, but a Factory reset is more invasive. This table describes the differences.
Table 32 Factory default configuration preset vs a factory reset
Item

Factory default
configuration preset

Factory reset function

Pearl Nano - Resets the channel settingsüü

Deletes all recorded files in the channels(Pearl Nano has a single channel)üResets network configuration

üü

Pearl Nano - Resets front screen PINüüResets user passwords

üüü

Deletes all created configuration presets
Removes all CMS including Epiphan
Edgeregistration informationüü

Removes records for all scheduled andcompleted CMS events

ü

ü

140

Pearl Nano User Guide

Item

Create a configuration preset

Factory default
configuration preset

Factory reset functionüDeletes all uploaded media files
Resets all Source settingsüü

Resets EDID to factoryüü

Deletes all SCP/SFTP identities

üü

Deletes all LDAP settingsüü

Deletes all Automatic file upload settingsüü

There are different ways you can apply the Factory default configuration preset to the Pearl device, you can:lApply a configuration preset using the Admin panellApply a configuration preset using the front screen menu

A reboot is required to apply the factory default configuration preset.
To perform a factory reset, see Perform a factory reset.
Operators who are assigned certain administrative-level privileges can apply the Factory default configuration
preset and perform a factory reset, see Assign administrator privileges to operators.
Returning the Pearl device to the factory defaults or performing a factory reset does not delete theregistered resource instance in Kaltura CMS. You can reregister your Pearl device using the same
resource name and take over for the resource instance that is still registered in Kaltura, see
Reassign a registered resource.

Create a configuration preset
You can create as many configuration presets as you need; however, there's a limit to the amount of space
available for configuration presets. A maximum of 256 MB is available for configuration presets and the
maximum size of a single configuration preset is 128 MB.
Before creating and using a configuration preset, read Configuration preset considerations.
For each configuration preset you create, you get to name the preset and choose which groups of settings toinclude. See Configuration groups for which settings are included in each group.
After you finish configuring Pearl Nano, it's good practice to save a full backup with all groups selected so thatyou can restore your full configuration at a later date.
Configuration presets for Pearl devices that include network or system settings require a system restart whenapplied.

141

Pearl Nano User Guide

Apply a configuration preset using the Admin panel

Important considerationslConfiguration preset file names should be unique and should not contain # or + symbols.

l

If you try to save a configuration preset but one or more of the related image files is missing, an error
message is displayed. You'll be unable to save the preset until the missing files are restored or the layouts
referencing the missing files are modified to remove the bad references.

l

If you try to save a configuration preset but there isn't enough space, an error message is displayed. You'll
need to delete some presets before proceeding.

Create a configuration preset using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance . The maintenance page opens.
3. Under Create a configuration preset, enter a name for your configuration preset in the Name field.
Configuration preset file names should be unique and should not contain # or + symbols.
4. Check the configuration groups you want to include in the preset. For a full system backup, select allgroups.
After a configuration preset has been created, you can select which sections of theconfiguration preset to apply. For more information, see Apply a configuration preset using
the Admin panel.
5. Click Save. Your configuration preset appears in the list.

Apply a configuration preset using the Admin panel
When you apply a configuration preset, the system settings for all included configuration groups are updated.
Other settings on the system are not affected. For example if you apply a preset that includes the configurationgroups channels (single channel on Nano) and automatic file upload, your network settings, passwords, time
server, source configurations, etc are not modified. Similarly, if you apply a configuration preset that has only
network settings included, only the network settings change.
If you apply a preset that has the network or system configuration group, a reboot is required. If you apply apreset that has the EDID configuration group, the system may appear unresponsive for a short time while itapplies these EDIDs to the video grabbers.
You can verify which configuration groups are included in a preset by looking at the list to the right of theconfiguration preset name. The term 'all' means all groups are included. Otherwise groups are listed individually.
You may apply multiple presets one after another. If you apply two (or more) configuration presetsthat include a particular configuration group, the settings (for that group) from the last applied preset
are the active settings. In short, last in wins.

142Pearl Nano User Guide

Apply a configuration preset using the front screen menu

Apply a configuration preset using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance. The maintenance page opens.
3. In the Configuration presets section, select which sections of the configuration you wish to apply.
For example, if you have imported a configuration preset and don't want to apply the Network section,clear the Network check box for the configuration preset. If you want to apply all of the sections, skip to thenext step.
4. Click Apply selected below the configuration preset you want to apply.
5. Click OK when prompted. The Pearl device reboots automatically if the configuration preset includes the
network or system configuration groups.

Apply a configuration preset using the front screen menu
You can use Pearl Nano's front screen menu to apply configuration presets that are either stored locally on theinternal storage of Pearl or from a USB drive that is attached to a USB port on Pearl. See below for instructions
on how to prepare the USB drive and use it to apply a configuration preset to your Pearl.. Configuration presetsthat only contain the network configuration group can also be applied using an alternative method, which is also
described in this procedure.
If you apply a preset that has the EDID configuration group, the system may appear unresponsive for a short time
while it applies these EDIDs to the video grabbers.

Prepare USB drive and use it to apply a configuration preset
1. Make sure that USB drive is formatted with either FAT, exFAT, ext2 or ext4
2. Connect the USB drive to a computer.
3. Change the USB drive label to ‘EPIPHAN’. In majority of operating systems, this is usually performed byright clicking on the USB drive and select the rename option.
4. Create a folder called ‘EPIPHAN’ as a top level level folder.
5. Copy one or more Pearl Configuration Presets to the EPIPHAN folder created in the previous step.
6. Safely eject the USB drive from your computer.
7. Connect the Maintenance USB drive to one of the USB ports on your Pearl.

143

Pearl Nano User Guide

Apply a configuration preset using the front screen menu

Apply a configuration preset using the front screen menu
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, scroll down using
the arrow key and select Configuration preset to open the Configuration preset screen.

3. If a specially prepared USB drive that contains a Pearl Nano configuration preset is attached to the USB
port, use the arrow and check mark to change between the USB drive or internal storage to see available
presets on either storage device.
4. From the Configuration preset screen, highlight Preset and press the check mark key to expand the list ofavailable presets, then use the arrow keys to highlight the name of the preset you want. Press the check
mark key to select it.

144

Pearl Nano User Guide

Export and import configuration presets

5. From the Configuration preset screen, use the down arrow key to highlight Apply and press the check
mark key to apply the selected configuration preset. The selected configuration preset is shown in the
Preset field of the Configuration preset screen.
6. If prompted, reboot Pearl Nano to apply the configuration preset. Return to the System screen and use thedown arrow key to scroll down until Reboot appears. Then select Reboot using the check mark key andselect Reboot now when prompted.

Export and import configuration presets
You can download configuration presets to your local computer, then upload and apply the preset to another
Pearl Nano or save the configuration preset as a backup of your current configuration. Either way, it's a simple
two-step process to download the preset from one system and upload it to another.

Before you beginlRead Configuration preset considerations.

lConfiguration presets are not cross compatible between different Pearl models or between Pearl devices
and Unify projects.

l

You cannot download/upload configuration presets using the local console on the Pearl device. Use the
web-based Admin panel instead.

Download or export a configuration preset using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, Click Maintenance . The maintenance page opens.
3. In the Configuration presets section, click the Download button next to the configuration preset you want
to export. The configuration preset file (with extension .preset) is saved to your admin workstation (in yourbrowser's download folder).

Import a configuration preset using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance. The maintenance page opens.

145

Pearl Nano User Guide

Update a configuration preset

3. In the Import configuration preset section, click Choose file and select the file you want to upload (withthe extension .preset), then click OK.
4. Click Import.

5. If your system already has a configuration preset with the same name as the one you're loading, awarning is shown. Click OK to overwrite the existing preset or Cancel to cancel the upload.

What's next
After you upload a configuration preset file, you must apply the configuration preset to Pearl Nano. To apply theconfiguration preset, see Apply a configuration preset using the Admin panel or:lPearl Nano -Apply a configuration preset using the front screen menu

Update a configuration preset
To update a configuration preset, or add/remove different configuration groups from the preset using the Admin
panel, use the following procedure:

Update a configuration preset using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance . The maintenance page opens. All existing
configuration presets are listed in the Configuration presets section.
3. Copy the name of the preset you want into the Name field and select the configuration groups to include,
then click Save.
4. Click OK when prompted to overwrite the existing configuration preset with the new one.

146

Pearl Nano User Guide

Delete a configuration preset

Delete a configuration preset
You can delete individual configuration presets from the Maintenance page in the Admin panel.

Delete a configuration preset using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Maintenance. The maintenance page opens.
3. Click Delete beside the configuration preset that you want to delete, and then click OK when prompted.
Pearl devices can delete all configuration presets at once by doing a factory reset. You cannot delete the built-in
configuration presets.

Status and monitoring
Pearl Nano lets you monitor audio and check the status of your channels, live streams, and recordings.
Topics include:lMonitoring audiolConfidence monitoring using the front screenlView system status using the front screen menulView system information using the Admin panellView network statusl

View 802.1x network connection statusl

View channel status and stream informationlView the video output port statusl

View AFU and file transfer progresslView scheduled CMS events and history

For a description of the front panel LEDs on Pearl Nano, see Front and back view of Pearl Nano.

Monitoring audio and VU sensitivity
You can connect headphones to the 3.5 mm audio jack on the front panel of Pearl Nano and monitor audio forthe channel. To monitor audio for the channel, make sure the Channel view is displaying on the front screen. The
audio you hear depends on the channel's custom layout. That's because you can choose different audio sourceson the custom layout. To monitor audio for a specific video source, make sure the screen for the video source isdisplaying on the front screen.
To adjust the headphone volume, use the up and down arrow keys on the control key interface when the Channel
view or one of the video sources is displayed on the front screen. See Monitoring audio for details.

147

Pearl Nano User Guide

Confidence monitoring using the front screen

A VU meter on the front screen shows the audio levels for the channel. The value is displayed in dBFS (decibels
relative to full scale). Colored bars represent the audio level.
Table 33 Audio VU meter levels
Color

Decibel range

Red

0 to -9 dBFS

Yellow-9 to -18 dBFS

Green

-18 dBFS and lower

You can also monitor the audio VU meters for all audio inputs from the Audio inputs screen. If you don't see the
Audio inputs screen displayed on the front screen, press the left arrow key on the control key interface to cycle
through the different views.

Confidence monitoring using the front screen
Have complete confidence about what you're capturing, streaming, and recording. The Channel view displays
your video sources in a custom layout that you can configure using the custom layout editor.

148

Pearl Nano User Guide

Confidence monitoring using the front screen

The Channel view opens by default when you turn on Pearl Nano. If you don't see the Channel view displayed on
the front screen, press the left arrow key (or the right arrow key) on the control key interface to cycle through thedifferent views.

The audio VU meter uses quasi-peak ballistics with samples averaged every 10 ms. The maximum average
audio level in each 100 ms period is displayed using colored bars.
l

RED = 0 to -9 dBFSlYellow = -9 to -18 dBFSlGreen = -18 dBFS and lower

If an error occurs while streaming or recording, an error message appears in the header bar and the word Error
replaces the related timer in the footer. At the same time, the Stream (or Record) control key on the front panel of
Pearl Nano visibly flashes.

You can also monitor a specific video input from the front screen. If you don't see the video input displayed on thefront screen, press the left arrow key on the control key interface to cycle through the different views. If the video
input source has no video signal, the no signal screen displays.

149

Pearl Nano User Guide

View system status using the front screen menu

To monitor a different video input or return to the Channel view, press the left arrow key on the control key
interface to cycle through the different views. To toggle the content displayed in the header and footer bars on
and off, press the check mark key on the control key interface.
For information about monitoring audio, see Monitoring audio and VU sensitivity.

View system status using the front screen menu
Find the serial number, check the installed firmware version of Pearl Nano and more on the System Status
screen using the front screen and control key interface.
The System Status screen displays basic system information that's useful when first setting up your Pearl Nano.
If you don't see the System status screen displayed on the front screen, press the left arrow key on the control
key interface to cycle through the different views.

Table 34 System status parameters
Label

Description

IP address

The IP address assigned to Pearl Nano. Use
this IP address to connect to the Admin panel.
To setup networking, see Configure network
settings.

150

Pearl Nano User Guide

View system status using the front screen menu

Label

Description

Firmware

The firmware that is currently loaded on Pearl
Nano.

UptimeHow long Pearl Nano has been powered on
displayed as hh:mm.

CPU load

The current amount of CPU load (%).
The amount of storage available.

SD card or SSD

USB storage

SD card only displays if a SATA M.2 2280
SSD is not installed. When an SSD is
installed, the field displays SSD instead of SD
card.
Displays the amount of storage available on a
USB storage device that is connected to Pearl
Nano.

151

Pearl Nano User Guide

View system information using the Admin panel

View system information using the Admin panel
Get useful information about Pearl Nano on the Info page from the Configuration menu. You can view yourcurrent firmware level, the system hardware version (if available), and currently configured settings for a channel.

View system information using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Info. The system information page opens.
The Bitrate / Actual bitrate values show the total of the video bitrate plus audio bitrate.

View network status
Get useful status information about Pearl Nano network connection from the Network configuration page using
the Admin panel, including:lCurrent IP addressl

HostnamelRated Ethernet link speed (Mbps)l

Sending and receiving speed (Mbps)l

MAC addressl802.1x status

View the network status using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Network. The Network configuration page opens.

152

Pearl Nano User Guide

View 802.1x network connection status

View 802.1x network connection status
View the 802.1x network connection status in the following locations:lthe Connectivity status diagnostic in the Admin panellthe front screen menu on Pearl Nano when you select System > Network > Connectivity Status.

The status can display as either passed, failed, or disabled.

.
If you attempt to connect to a network that isn't 802.1x enabled when 802.1x is configured on Pearl Nano, aconsistent 802.1x status: failed status message appears on the Network Configuration page in the Admin panel.
For more information about the Connectivity status diagnostics, see Diagnostic tools.

View channel status and stream information
You can see information about the status of a channel on Pearl Nano from the channel's status page using theAdmin panel, including:l

The status and uptime of encoder serviceslStream information and URLslChannel previewlActive network connections

More encoder information can be found on the Info page from the Configuration menu, see View system
information using the Admin panel

View the status information for a channel using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channels menu, click a channel to open the status page for that channel.

153

Pearl Nano User Guide

View the video output port status

Active unicast and multicast stream information displays under Connections.

View the video output port status
The current status of the video output port and attached video display appears at the top of the video output port
configuration page. You can view the status using the Admin panel.

154

Pearl Nano User Guide

View AFU and file transfer progress

View the video output port status using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Output port(s) menu, click the output port. The video output port configuration page opens.

Table 35 Possible video output status messages
Message

Description

Disabled

This video output port is disabled in the configuration.

Display is not connected

There is no display connected to the video output port or the connecteddisplay is not powered on or not functioning.

Source is currently unavailable

The video output port is configured to display a source that no longer exists.
Change the source. see Select the video output source using the device
screen.

Starting ...

The video output port is configuring the display and will shortly output thefirst frame.

Running at w×h

The video output port is functioning at the specified resolution.

View AFU and file transfer progress
You can view Automatic File Upload (AFU) and file transfer information from the following places:lthe Admin panel.

lfront screen menu on Pearl Nano

155

Pearl Nano User Guide

View AFU and file transfer progress

View file transfer status using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Automatic File Upload. If there are files to be uploaded, they appear
in the queue.

View File transfer status using the Pearl Nano front screen menu
1. Enable configure and enable Automatic File transfer or configure Pearl system to manually move or copy
recorded files to an inserted USB drive. A file upload indicator icon is shown on the video preview screensof Pearl system and on the front screen of Pearl Nano. Press the left arrow key repeatedly on the control
key interface until the Menu screen displays.

2. The background of the file upload indicator icon blinks green when Pearl system is actively uploading files
to the external destination.

156

Pearl Nano User Guide

View AFU and file transfer progress

3. The background color of the file transfer indicator alternates between blinks yellow when Pearl system
encounters an error while uploading files to the external destination.

To see details of the error, from the File transfer screen, do one of the following:a. Use the arrow keys to highlight Automatic File Upload and press the check mark key to view the AFU
progress.

157

Pearl Nano User Guide

View scheduled CMS events and history

b. Use the arrow keys to highlight Copy to USB drive and press the check mark key to view the Copy to
USB drive progress.

View scheduled CMS events and history
Using the Admin panel, select the Events menu to see up to 90 days of upcoming scheduled events and up to 90
days of ongoing and completed events for Pearl Nano. Click the page arrows at the bottom of each list to
navigate through multiple pages.

158

Pearl Nano User Guide

View scheduled CMS events and history

The Events page updates to show new events every hour. Click Refresh schedule at any time to manually
update the Events page. The Events page only displays when a CMS is enabled on Pearl Nano.
If the time and zone settings of Pearl Nano are out of synchronization with Kaltura's schedulingserver, an error appears on the Events page when you refresh the schedule. Configure the time
settings on Pearl Nano to match the time and zone of Kaltura's scheduling server, see Configure
date and time.
When CMS is enabled on Pearl Nano, an Events screen is added to the screens you can view on the front
screen. If you don't see the Events screen on the front screen, press the left arrow key (or the right arrow key) on
the control key interface to cycle through the different views.

159

Pearl Nano User Guide

View scheduled CMS events and history

When an event is scheduled, the Event screen updates with the event name and a countdown timer. Five
minutes before the scheduled event, the event name and timer on the Events screen turn red.

160

Pearl Nano User Guide

CaptureCaptureCapturing is the process of taking the signals from your video and audio sources and encoding them so they're
ready for streaming and recording. You add the captured video and audio to channels, which you customize forlive streaming and recording.
This section covers how to set up a channel and customize the layout so that you can capture, stream, andrecord exactly what you want - how you want! Whether that's a simple channel with a single video and audio
source or multiple video and audio sources in a custom, picture in picture layout.
Topics include:lWhat is a channel?

lChannel layout exampleslChannel configurationlCustom layout configurationlVideo and audio input sources

161

Pearl Nano User Guide

What is a channel?

What is a channel?
A channel is an encoding instance associated with your video and audio inputs to produce video recordings
and/or live streams. Your video and audio sources can be combined and added to a channel, which you canstream and record.
lPearl Nano - has a single channel already preconfigured as an Auto channel by default.
l

As soon as you connect a video source to one of the video input ports, it appears automatically inthe channel's custom layout. For information about video inputs and signal priority when using Autochannels, see About automatic channels .
l

If you connect an HDMI video source to the HDMI IN port, the Auto channel automaticallyuses the HDMI video and embedded HDMI audio.

l

If you connect an SDI video source to the SDI port, the Auto channel automatically uses the
SDI video and embedded SDI audio.

l

If both HDMI and SDI video sources are connected, the HDMI video source and embedded
audio takes priority and is used in the Auto channel by default.

l

If no video sources are connected, a standard No Signal screen displays.

l

The Auto channel's frame size is set to match the video source by default and the best bit rate forthe default frame rate of 30 fps is applied automatically.

l

Changing the channel's frame rate will change the frame rate used at the output port for that video
input.

Default auto channels have the related HDMI port selected by default. As soon as you connect your video source
to the port, it appears automatically in the channel's custom layout. Changing the channel's frame rate or deletingthe channel will change the frame rate used at the output port for that video input. Deleting the channel forces thevideo output port to use the original frame rate of the video input source.

Channel layout examples
Here are some examples of different layouts you can create using the custom layout editor with just two video
input sources and two media image files.
In the Epiphan products column, "All" means the layout can be created with Pearl-2, Pearl Mini, Pearl Nano, andEpiphan Unify. Pearl Nano does not support multiple channel layouts.

162

Pearl Nano User Guide

Layout example

Channel layout examples

Epiphanproducts

Description

One video source (a slideshow
presentation in this case), at the fullsize of the channel.
All

To get this look: Using the custom
layout editor, add one video source
to the layout, select keep aspectratio and stretch to fill the entire
layout area.

One video source with a logo (.pngwith transparency) in the bottom left
corner.

All

To get this look: Upload an image
with transparency. Using the custom
layout editor, add one video source
to the layout, select keep aspectratio and stretch to fill the entire
layout area. Then, add the image tothe layout and drag it where youwant it to appear on screen.
One source with a text overlay in thebottom right corner.

All

To get this look: Using the custom
layout editor, add one video source
to the layout, select keep aspectratio and stretch to fill the entire
layout area. Then, add a text overlay
to the layout and drag it where youwant it to appear on screen.

163

Pearl Nano User Guide

Layout example

About automatic channels

Epiphanproducts

Description

One video source (a slideshow
presentation in this case), with agreen background matte.
All

To get this look: Using the custom
layout editor, select a backgroundcolor. Add a video source to thelayout and size appropriately,leaving the background mattevisible.
Two video sources (a slideshow anda presenter cropped to a new aspectratio using the tool to Crop a video
source), a background image, and alogo. Make sure the backgroundimage has the correct aspect ratio.

All

To get this look: Upload yourbackground and logo images (youcan do this from the Media page or
the Layouts page for the channel).
Using the custom layout editor, add
the background image to the layout
and stretch it to fill the entire layout
area. Then add your two video
sources to the layout, adjusting theirsize and position as needed. Lastly,
add the logo to the layout and moveit in to position. For the second video
source, use the Crop tool to crop thesecond source to a square aspectratio.

About automatic channels
Pearl Nano
To get you started as quickly as possible, Pearl Nano comes pre-configured with an automatic channel called
Auto. Simply plug a source into one of the video inputs and Pearl Nano automatically configures the channel'sframe size to match the source resolution and configures a frame rate and bitrate. The detected video source's
audio is also automatically added to the channel.

164

Pearl Nano User Guide

About automatic channels

Embedded audio from a DVI source that is connected to the HDMI input using an adapter is notdetected on automatic channels. You must manually add the audio to the channel's layout using thecustom layout editor.
You can start viewing the automatic channel immediately on the device screen or using a web browser on thesame local network as the Pearl device. Browse to the following URL:

Pearl Nano
http://<serial>.local/preview.cgi?channel=1
For example:http://d560515f.local/preview.cgi?channel=1
If Bonjour services, which permits browsing by serial number, are not installed on your admin computer, you can
get the IP address of your Pearl device by doing the following:

Pearl Nano
Use the front screen to select System status screen and browse to:http://<IP Address for Pearl Nano>/preview.cgi?channel=1
Links for other channel streams (i.e. RTSP or MPEG-TS) can be found by logging into the Admin panel andselecting Status in the Channel menu.

Important considerationsl

The default auto channel has the related HDMI (or SDI) port selected by default. As soon as you connect
your video source to the port, it appears automatically in the auto channel's custom layout. Changing theauto channel's frame rate or deleting the auto channel will change the frame rate used at the output port
for that video input. Deleting the auto channel forces the video output port to use the original frame rate of
the video input source.

l

If you delete the auto channel, it will re-appear upon factory reset or when loading the default
configuration preset.

lPearl Nano - If you modify the automatic channel's video input source manually using the custom layout
editor, the channel no longer functions as an automatic channel and the channel name changes to thename of the video source. To revert a channel back to an automatic channel, add Auto as the sole video
source for the channel using the custom layout editor and delete the current channel name. When youpress Enter using your keyboard to save the blank channel name, the channel reverts to the default
automatic channel. Alternatively, you could perform a factory reset or apply the default configuration
preset to restore the automatic channel; however, other important system settings and configurations will
also revert to their default settings.

Which signal does the auto channel use?
The Pearl device has video input sensing, which means that it knows when a video signal is received from anattached source.

165

Pearl Nano User Guide

Channel configuration

If you attach more than one video source to the video inputs while the Pearl device is powered on, the first source
you attach has the highest priority. If you attach more than one source before powering on the Pearl device, thefollowing priority is used:
Priority

Pearl device

Connector Type

1All

HDMI (with HDMI Audio)

2 - Pearl Mini
and Pearl
Nano

All

SDI (with SDI Audio)

The auto channel uses a source until that source no longer has a signal. Then, it switches to the next highest
priority signal.
If all the connected sources lose signal at the same time (i.e. for example, is SDI loses video signal and no othervideo signal is found) no change is made and the auto channel continues to use the current source. In this case,a no signal image is displayed for viewers.
You can see which video and audio sources are configured for the channel from the Info page, see View system
information using the Admin panel

Channel configuration
A channel lets you encode your video and audio sources so they can be live streamed and recorded. Before
using a channel, you should check the channel settings. You can fine-tune your channel to maximize the qualityof your live streams, minimize the amount of bandwidth used, and ensure your video and audio encoding
settings are optimized for your event. You can control exactly how the video is presented and streamed to shareddestinations and multiple viewers.
Channel encoding settings may be automatically overwritten when using a Pearl device with aContent Management System, see About Panopto recording and webcasting
Topics include:l

Pearl-2 and Pearl Nano - Configure an auto channell

Add video sourcesl

Add an audio source to a layoutlRename a channellPreview a channell

Add or remove channel metadatalConfigure encodingl

Codecs and file format compatibility

166

Pearl Nano User Guidel

Configure video encodinglConfigure audio encoding

Configure an auto channel

Configure an auto channel
Pearl-2 and Pearl Nano include Auto channels to make setup quick and simple. However if you want to set
custom encoding or streaming configuration for the channel, you can configure it like any other channel.

Configure an automatic channel using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
3. From the Channel menu, click Auto. The channel's status page opens

4. Configure the automatic channel as you would any other channel.
To change the video source for the automatic channel, just select a different video source using thecustom layout editor, see Add video sources. The channel name automatically changes to thename of the selected video source if there's only one source in that channel. For important
information about changing the channel name, see Rename a channel.

167

Pearl Nano User Guide

Add video sources

Add video sources
Pearl Nano
You can add up to two video sources to the custom layout for your channel using the custom layout editor.
If more than one video source is added to a channel, we recommend configuring the channel
encoding to use a fixed resolution as the frame size instead of automatically using the resolutionof the video source as the frame size (default). A fixed channel resolution ensures that yourchannel displays properly at a fixed resolution.
For more information, see Configure encoding.

Add a video source using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layouts. The custom layout editor opens.
3. Below the Layout editing area, click Add new item and select Video Source. The Source settings appear.

4. Under Source settings, select either a video input or a channel in the Source drop-down menu.
5. Under Source settings, select a video input in the Source drop-down menu.
For best results, check Keep aspect ratio when scaling in the Source settings.
The selected video source appears in the layout editing area.

168

Pearl Nano User Guide

Add video sources

When adding an RTSP network source, a preview image may not display in the layout area until you
Save the layout. The preview can also appear to have no signal if the RTSP source is not currently
sending content.
6. Click and drag the red and white handles on the corners of the source to re-size it in the layout editor area.
Alternatively, enter a value in the fields along the side and bottom of the layout editing area to resize theselected item.

To layer video sources over top of each other, like for picture in picture, you can click
and drag the video sources that appear in the item list beneath Add new item and169

Pearl Nano User Guide

Add video sourceschange their order. Items that are higher up the list appear over top items that arelower down the list.
7. Select an audio source from the list of audio sources.
If a channel is selected as the video source, the corresponding audio for that channel
is selected automatically by default.
8. Click Save.
To layer multiple video sources on Pearl Nano for picture in picture or add other items like logos and images, you
can click and drag the video sources that appear in the item list beneath Add new item and change their order.
Items that are higher up the list appear over top items that are lower down the list.

A note about item positioning and sizing
There are multiple ways to position and size images, text overlays, and video sources in the layout areal

Using the mouse.

lUsing the keyboard.

lUsing the manual positioning values with percents.

lUsing the manual positioning values with pixels.

Using the mouse
Click and drag to move the item. Click and drag the round, red and white handles to resize an image or video
source (for text overlays, just use the padding settings). Using this method you can make quick changes that are
in increments of approximately 5% of the width or height of your layout area. For more refined movements, press
the Ctrl key on your keyboard while dragging the item with the mouse.

Using the keyboard
Use the arrow keys on the keyboard to move the item up, down, left or right in the layout. Changes are inincrements of approximately 5% of the height or width of the layout area. Press the Ctrl key while using the arrow
keys to make more refined movements. To change the size of an image or video source, press the Shift key while
using the arrow keys (for text overlays, just use the padding settings). Press both Ctrl and Shift for fine-grained
size control.

Using percents
Specify a whole number, followed by a percent sign (e.g. 4%) in any of the manual positioning fields. See Resize
and position items using percents or pixels for more information.

Using pixels
If you need to specify an exact amount in pixels (rather than percent) you can type a pixel value in any of thepositioning value squares followed by the characters px (e.g. 56px). You can mix and match pixels and percents

170

Pearl Nano User Guide

Add an audio source to a layoutchanging only the boxes you want to use pixel values. At any time you can switch back to percents by typing apercent. See Resize and position items using percents or pixels for more information.

Add an audio source to a layout
You can add multiple audio sources to the layouts for a channel using the Admin panel. By default, audio isenabled for the channel on the channel's encoding page.

Important considerationsl

For SRT and RTSP input sources, there's no need to manually add the audio sources separately to yourchannel. When the network stream is connected to your Pearl device as an input source, a corresponding
audio source is automatically added to the list of audio sources for your channels, even if there is no audio
in the stream.

l

The XLR-B audio inputs and the RCA audio inputs are linked within Pearl-2. The XLR L/R audio inputs
and the RCA L/R audio inputs are linked within Pearl Nano. If you use both at the same time, their audio ismixed. If the two audio sources share the same audio signals, the common audio signals are amplified. To
avoid this, you can disable one or the other audio port, see Assign audio sources to an input.

l

If a channel is selected as the video source for a layout, the corresponding audio for that channel is added
automatically.

l

You can add multiple audio sources to the same layout. However, if the two audio sources share all orsome of the same audio signals, then the common audio signals are amplified.

lSelecting multiple loud audio sources in the same layout may cause audio clipping on that layout. Before
going live, always check the volume levels for the layout and adjust the volumes at audio sources to avoid
clipping, see Adjust audio gain and delay.

l

If audio encoding is not configured for a channel, no audio signal is processed or sent with the video
content when recording, streaming, or confidence monitoring, see Configure audio encoding.

l

If an audio source is added to a layout and then the audio device is disconnected from the input port on
the Pearl device, some residual noise may be detected in the layout. Remove the audio source from thelayout.

Add an audio source to a layout using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layouts. The custom layout editor opens.
3. In the Layouts list that appears at the top of the page, click a layout's row to select that layout.
4. Check the audio source that you want to use for the layout and click Save.

171

Pearl Nano User Guide

Rename a channel

What's Next
You can check the audio encoding settings for your channel and ensure that audio is enabled, see Configure
encoding.
To adjust the gain for an audio input source, see Adjust audio gain and delay.

Rename a channel
You can change a channel's name from any of the channel configuration pages or using the custom layout editor.

Auto channels on Pearl-2 and Pearl Nano
Auto channels initially have the channel name Auto . If you manually change the video input source on the layout
to something other than the automatic video source, the name of the channel changes to the name of the video
input source. To revert the channel name back to the auto channel's default name, delete the channel name andleave the name field blank. When you save, the Pearl device will automatically repopulate the name field with thedefault name.

International characters
You can include certain international characters in channel names. For a complete list, see International
character support.

172

Pearl Nano User Guide

Preview a channel

Do not include any special currency, mathematical symbols, and other special characters such asslashes or spaces in the channel name. Pearl Nano replaces special characters with an underscore.

Rename a channel using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and choose any of menu options for the channel. For
example, select Metadata.
3. Click on the channel name that appears at the top of the page. The text turns red.

4. Enter the new name using alphanumeric characters. We recommend using underscores to separate
words rather than using spaces.
5. Press Enter using your keyboard to save the new name.

Preview a channel
You can open a live preview of a channel in your web browser to see any configuration changes you make to thechannel as you make them. Web browsers that support HTML5 and Flash are supported.
There are several ways to preview a channel:lPreview a channel from the Info pagelPreview a channel from the Status page

Important considerationslSome web browsers disable auto playback of videos with audio. In those cases, the audio for the channel
being previewed is muted by default.

lHTML5 does not support PCM audio encoding. If PCM audio encoding is configured for a channel, audio
does not play in the preview link for the channel.

173

Pearl Nano User Guide

Add or remove channel metadatal

PCM audio encoding at 48 kHz is not supported. A live broadcast preview link is not provided for achannel that is configured for PCM audio encoding with a sampling bitrate of 48 kHz.

l

If HTTPS is configured for Pearl Nano, the live broadcast URL will start with https instead of http.

Preview a channel from the Info page using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Info. The information window opens. Then click View to open a
preview window of the channel.

Preview a channel from the Status page using the Admin panel
You can use the Admin panel to open a preview link for a channel from the Status page. The Live broadcast
preview can be viewed using web browsers that support HTML5 or Flash. You can also see a preview of thechannel directly from the Status page itself.
The Status page lists information about the channel, including stream information such as the bitrate, frame size,
streaming and preview links, as well as the state of the services on Pearl Nano.
This feature is not available using the local console on the Pearl device.
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Status. The Status page opens and a live
preview snapshot appears below the Stream info.
3. Right-click the Live Broadcast link and select Open in a new Tab or Open in a new Window.

Add or remove channel metadata
When you configure metadata for a channel, that metadata is embedded in all channel recordings and streams.
You can specify the following metadata that the media player displays for your viewers:

174

Pearl Nano User Guide

Configure encodingltitle of the presentationlAuthorl

copyright date or other labels such as proprietary information, preliminary etc.

ladditional comments about the broadcast, such as time of the broadcast, or change to the schedule

How metadata is displayed depends largely on the media player. For example VLC, stores the metadata in amedia information file, while other media players scroll the text horizontally from right to left across the bottom of
the media player window.
Use only alphanumeric and diacritic characters in metadata descriptions. The whole metadata string
is refused if any special currency or mathematical symbol appears in the description. You must
remove the offending characters before Pearl Nano will accept the description.

Add or remove channel meta data using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Metadata. The Metadata configuration pageopens.
3. Type information into the fields or modify existing content as needed, then click Apply.

Configure encoding
You can modify the encoding settings for a channel. The encoding settings let you fine tune your channel
recording or live stream. You can select a specific frame size, bitrate, audio or video codec, and more.
Channel encoding settings may be automatically overwritten when using the Pearl device with aContent Management System, see About Panopto recording and webcasting.
Topics include:175

Pearl Nano User Guide

Codecs and file format compatibilitylCodecs and file format compatibilitylConfigure video encodinglConfigure audio encoding

Codecs and file format compatibility
Pearl Nano supports the following codecs:
Table 36 Supported video codecs
Value

Description

H.264

H.264 provides high quality video while using low bandwidth.

H.265 (Pearl Nano only)

H.265 provides the highest quality video while using a comparatively low
bandwidth. Compare the quality and required bandwidth relative to H.264.

Table 37 Supported audio codecs and bitrate guidance
Value

Description
AAC is comparable to MP3 and may even provide better sound quality at a similar sample
bitrate. Supported sampling bitrate values are: 16, 22, 44 and 48K kHz.

AAC

Setting the channel bitrate to match the audio source's bitrate provides the best sound quality
and avoids audio resampling. Most digital signals (HDMI or SDI sources) use 48 kHz. Most
digital signals (HDMI or SDI sources) use 48 kHz audio. For analog signals, 44 kHz provides agood quality audio sample.
The maximum bitrate for mono encoding of a 44 kHz signal is 264 kbps. For stereo, 320 kbps
is supported. Note that lower bitrates (e.g. 32 kbps) with a 44 kHz signal may result in
distorted audio.
MP3 provides a common audio format for audio storage. Supported sampling bitrate values
are: 22 kHz, 44 kHz and 48 kHz.

MP3

Setting the channel bitrate to match the audio source's bitrate provides the best sound quality
and avoids audio resampling. Most digital signals (HDMI or SDI sources) use 48 kHz. For
analog signals, 44 kHz provides a good quality audio sample.
Web browsers that use Flash (FLV) do not support 48 kHz MP3 audio. Whenselecting this encoding, you must use a web browser that supports HTML5 or a
media player to preview your channel.

PCM

Pulse Code Modulation (PCM) is a standard for digital audio in computer and other devices
such as, digital telephone systems.
Setting the level to match the audio source's level provides the best sound quality and avoids

176

Pearl Nano User Guide

Value

Codecs and file format compatibility

Description
audio resampling. Most digital signals (HDMI or SDI sources) use 48 kHz audio. For analog
signals, 44 kHz provides a good quality audio sample.

Format compatibility
Not all streaming and recording protocols support all combinations of video and audio codecs. The following
table lists any video/audio codec compatibility considerations for the supported streaming formats on Pearl
Nano.
Table 38 Video/audio codecs and formats for streaming
Video Codec selected

Audio Codec selected

RTSP

FLV

MPEG-TSNo audio codec

ü

ü

ü

PCM

ü

ü

MP3

ü

ü

ü

AAC

ü

ü

ü

No audio codec

ü

PCM

ü

MP3

ü

ü

AAC

ü

ü

MJPEG

H.264

ü

H.265 (Pearl Nano only)

The following table displays the compatibility between the video/audio codecs and the supported recording
formats.
Table 39 Video/audio codecs and formats for recording

Video Codec selected

Audio
Codec
selected

MP4 and
MP4-Fragmented

AVI

MOV

MPEGTS

H.264 (and H.265 for Pearl Nano)

No audio
codec

ü

ü

ü

ü

H.264 (and H.265 for Pearl Nano)

PCM

ü

ü

ü

H.264 (and H.265 for Pearl Nano)

MP3

ü

ü

ü

ü

H.264 (and H.265 for Pearl Nano)

AAC

ü

ü

ü

ü

177

Pearl Nano User Guide

Configure video encoding

Configure video encoding
You can configure the video encoding settings for a channel using the Admin panel. Video encoding settings
include:lVideo codec: The video codec determines the type of compression and decompression, and also affects
the video quality.
l

Pearl Nano supports H.264 and H.265 encoding.

lVideo encoding profile: This can be set to High, Main, or Baseline. Main is only available on Pearl Nano if
H.265 codec is selected.

l

Frame size: The resolution applied to the channel when you stream, record, or output video to aconfidence monitor. This can be set to automatically match the input video's resolution or set to a fixed
resolution.

l

Key frame interval: How often a key frame that contains all the pixels is sent when streaming. The longer
the key frame interval, the smaller the video file size (and vice versa).

lLimit frame rate: You can limit the frame rate for the channel.

lBitrate: Increase or decrease image quality by increasing or decreasing the channel's Bitrate value.
Video with a high level of motion and high resolution, such as sporting events, requires a higher bitrate.
By default, Pearl Nano automatically uses the incoming video source frame size as the frame sizefor streaming and recording when the channel has only one layout with a single video source. If
you're channel has multiple video sources or layouts, you must manually set a frame size for thechannel. If you plan to switch layouts during a live stream, a fixed frame rate is recommended. Thisavoids the stream from stopping and restarting due to frame size changes when switching between
single-source layouts that use different frame sizes.

Important considerationsl

For optimum system performance, the frame size of the channel should be set to match the frame size ofyour video input source to avoid scaling, see Optimum System Load.

l

If your channel has a custom layout with only one source and your source and stream aspect ratios differ,then your source appears centered in the frame and matte bars are added automatically to the top andbottom (or left and right sides) of the frame to make up the difference. See Remove black bars (matte)from the video.

l

If an SDI or HDMI video input source that is selected to display at the HDMI output port also appears in acustom layout for a channel, then the channel's encoding settings are used at the HDMI output. Changing
the channel's frame rate will change the frame rate used at the output port for that video input. If the video
source appears in multiple layouts in different channels, the one with the highest frame rate set in theencoding settings is used.

178

Pearl Nano User Guide

Configure video encodingl

The larger the channel's frame size, the more bandwidth is needed for streaming and the recorded files
are bigger. Instead of using the same frame size as the original video source, you can configure a smaller
frame size for the channel and let Pearl Nano downscale the video. For example, if the input video signal
resolution is 1920×1080 (a 16:9 aspect ratio) and the channel's frame size is set to 1280×720, Pearl Nano
downscales the video and streams/records the channel at the lower frame size, using less bandwidth andproducing smaller recorded files.

l

If you have unchecked all the manual resizing and positioning boxes in the custom layout editor and you
downscale the video source using the frame size setting on the Encoding tab (for example, select
1280×720 frame size for a full HD video source), then the source appears cropped within the frame
instead of scaling to fit the frame.

You can add black bars around your video source by adjusting the frame size. For example, if your video source
has a 16:9 widescreen/HD format but you need a 4:3 frame size on your output, Pearl Nano automatically adds
black bars to the top and bottom of the frame if you choose a frame size for the channel that has a 4:3 aspectratio.
There is some trade off between video quality and bandwidth size, depending on the encoding settings you
choose. The following table lists some additional considerations when choosing video encoding settings.
Table 40 Video encoding settings
Setting

Description

H.264

H.264 provides high quality video while using low bandwidth.

H.265(PearlNano
only)

H.265 provides a high quality video while using a lower bandwidth. Compare the quality andrequired bandwidth relative to H.264.

Key
frame
intervall

The key frame interval feature specifies how often a key frame (a frame that contains all the
pixels) is sent when streaming the video. This setting also impacts how quickly a video
moves through the frames when a viewer uses the search function of their media player.

lIncreasing the number of seconds between key frames can significantly reduce yourbandwidth and system resource usage with minor impact to your video quality. A good ruleof thumb is to keep the interval between 2 to 3 seconds and decrease the key frame intervalas the motion increases.

l

Try different settings and note changes in the video quality. If your video quality is poor andjittery you may need to decrease the interval between key frames. If you have unlimited
bandwidth and system resources you can choose an option to stream key frames only.

Frame rate reflects the number of images that are encoded per second. Reducing the frame rate
for a channel reduces bandwidth usage, and vice versa.
Frame
rate

The system's ability to maintain a set frame rate is based on several factors, for example:loverall system load affects the ability for the device to process pixels;lavailable network bandwidth;lthe source and stream frame size (resolution);

179

Pearl Nano User Guide

Setting

Configure video encoding

Descriptionlthe type of motion that is captured; andlnumber of users accessing the stream.

When adjusting the frame rate, you may need to try different values to achieve the best outcome.
In general, higher bitrates mean higher image quality, but more bandwidth is needed for streaming
and video recordings are larger. You can set the bitrate to improve the image quality .
For example, an HD Blu-ray video is typically in the range of 20 Mbps, whereas a standarddefinition DVD is usually 6 Mbps.

BitrateIf you're unsure what bitrate value to use, start at 5000 kbps (slightly less than a typical DVD) andtest to see how this looks for your viewers.

Configure video encoding for a channel using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Encoding. The encoding configuration pageopens.
3. Select a video Codec and do one of the following:l

If H.264 (or H.265 on Pearl Nano) is selected, select a Video encoding preset and a Video
encoding profile.

Item

Options

Video encoding
presetSoftware: This matches the default from previous generations of Epiphan products.
Only select this if you need software encoding or X.264 encoding to match results
created with previous generations of Epiphan products or firmware
Baseline: Choose this option when streaming to an application that requires
robustness and cannot tolerate data loss, for example video-conferencing.

Video encoding
profileMain: Choose this option for standard-definition broadcasts.
High: This is the default. Choose this option when video is viewed for broadcast
and disk storage applications, particularly for high definition television applicationsuch as Blu-ray disk storage format and HDTV broadcast service.

180

Pearl Nano User Guide

Configure audio encoding

4. Configure the frame size, do the following:a. Uncheck Use current signal resolution as the frame size.

Enabling Use current signal resolution as the frame size is not recommended
if the video input resolution changes frequently. An unstable cable or otherdisturbance that causes the resolution of the video input signal to change during
a live stream can cause the stream to drop. Unchecking this feature helps
prevent that.
b. Select a Frame size from the list of options or enter a custom frame size in pixels.
5. Change the Limit frame rate. The default should be adequate in most applications. While decreasing thelimit may improve system performance, you may need to test different values to balance video
smoothness and processing power
6. Change the Bitrate. You can increase or decrease image quality by increasing or decreasing the target
Bitrate value. Video with a high level of motion and high resolution, such as a sporting event, requires ahigh bitrate.
7. Click Apply.

Configure audio encoding
If your channel includes audio sources in any of the layouts, then AAC 48 kHz is set as the default audio codec
for the channel. You can choose a different audio codec for a channel using the Admin panel. The following tablelists the supported audio codecs and bitrates.
Table 41 Supported Audio codecs and bitrates
Value

Description
The AAC (default) audio codec is comparable to MP3 and may produce better soundquality with a similar bitrate. Supported values are 16, 22, 44 and 48K kHz.

AAC

Most digital signals (HDMI or SDI sources) use 48 kHz audio. Matching the encodedlevel with the source level provides the best sound quality by avoiding audio
resampling. For analog signals, 44 kHz provides higher sampling.
The maximum bitrate for mono encoding of a 44 kHz signal is 264 kbps. For stereo,
320 kbps is supported. Note that lower bitrates (e.g. 32 kbps) with a 44 kHz signal
may result in distorted audio.

MP3

MP3 provides a common audio format for audio storage. Supported values are 22

181

Pearl Nano User Guide

Value

Configure audio encoding

Description
kHz, 44 kHz and 48 kHz.
Most digital signals (HDMI or SDI sources) use 48 kHz audio. Matching the encodedlevel with the source level provides the best sound quality by avoiding audio
resampling. For analog signals, 44 kHz provides higher sampling.
Flash (FLV) doesn't support 48 kHz MP3 audio. When selecting thisvalue you'll need to use a media player to preview your channel.
Pulse Code Modulation (PCM) is a standard for digital audio in computer and otherdevices such as, digital telephone systems.

PCM

Most digital signals (HDMI or SDI sources) use 48 kHz audio. Matching the encodedlevel with the source level provides the best sound quality by avoiding audio
resampling.
Flash (FLV) doesn't support 48 kHz PCM audio. When selecting thisvalue you'll need to use a media player to preview your channel.

Change the audio codec for a channel using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Encoding. The encoding configuration pageopens.

3. In the Audio settings, ensure that Enable audio is checked to include audio in the channel.
4. From the Audio format drop down, select an audio codec.
5. From the Audio channels drop down, choose mono or stereo (default).

182

Pearl Nano User Guide

Custom layout configuration

Choose Mono to have left and right stereo channels combined so that when you listen to thestreamed or recorded audio, the same blended sound comes through both the left and rightchannels.
If you have only one mono analog input, use the left jack and select mono encoding to havethe same sound come from both the left and right channels. (If stereo sound is chosen, thesound will only come through on the left channel.

Pearl Nano - XLR/RCA1

6. From the Audio bitrate drop down, choose a bitrate. For guidance, see audio bitrates. For stereo audio,
we recommend 256 kbps or 320 kbps.
7. Click Apply.

Custom layout configuration
Using the custom layout editor, you can create completely different looks for your channel - like picture in picture
or side-by-side video sources. You can add media like transparent images and custom backgrounds to a layout,
then resize and arrange all the different media elements the way you want.
Topics include:lAbout the custom layout editorlResize and position items using percents or pixels

lOpen the custom layout editor for a channellConfigure a custom layout for a channell

Set the background colorl

Add an image to a layoutlUpload or remove an image using the Media pagel

Add a text overlaylCustom system variables for text overlayslCrop a video source

About the custom layout editor
The custom layout editor gives you full control of the size and position of images, video sources, and text
overlays.

183

Pearl Nano User Guide

About the custom layout editor

Access the custom layout editor using the Admin panel when you select your channel from the Channels menu
and click Layouts.

Layout editing
The layout editing area is where you can add images, video sources, and text overlays to your layout. You canalso choose a background matte color, crop images and video, and edit video sources. Note- the Pearl Nano
cannot edit video sources.

The main layout area has the same frame size and aspect ratio as the encoding setting of the channel. As you
add items to the layout, they appear in the layout editing area. The currently selected item is presented in fullcolor. Unselected items appear transparent.
To change the settings for an item, click an item in the item list that appears below the layout editing area. The
settings for that item appears.

Move and size items in the layout editing area
You can use the mouse to click and drag items into position, or you can type values into the fields along the sideand bottom of the layout area and manually position the selected item. You can also enter values as apercentage of the full layout area (for example, enter 4%) or in pixels (for example, enter 16px).
You can resize an image, text overlay, or video source by clicking and dragging the red and white handles at thecorners of an item or by entering values into the fields along the side and bottom of the layout area. To maintainthe aspect ratio when resizing an item, make sure you've checked the Keep aspect ratio when scaling box forthat item.

184

Pearl Nano User Guide

About the custom layout editor

A note about item positioning and sizing
There are multiple ways to position and size images, text overlays, and video sources in the layout areal

Using the mouse.

lUsing the keyboard.

lUsing the manual positioning values with percents.

lUsing the manual positioning values with pixels.

Using the mouse
Click and drag to move the item. Click and drag the round, red and white handles to resize an image or video
source (for text overlays, just use the padding settings). Using this method you can make quick changes that are
in increments of approximately 5% of the width or height of your layout area. For more refined movements, press
the Ctrl key on your keyboard while dragging the item with the mouse.

Using the keyboard
Use the arrow keys on the keyboard to move the item up, down, left or right in the layout. Changes are inincrements of approximately 5% of the height or width of the layout area. Press the Ctrl key while using the arrow
keys to make more refined movements. To change the size of an image or video source, press the Shift key while
using the arrow keys (for text overlays, just use the padding settings). Press both Ctrl and Shift for fine-grained
size control.

Using percents
Specify a whole number, followed by a percent sign (e.g. 4%) in any of the manual positioning fields. See Resize
and position items using percents or pixels for more information.

Using pixels
If you need to specify an exact amount in pixels (rather than percent) you can type a pixel value in any of thepositioning value squares followed by the characters px (e.g. 56px). You can mix and match pixels and percentschanging only the boxes you want to use pixel values. At any time you can switch back to percents by typing apercent. See Resize and position items using percents or pixels for more information.

Audio source selection and saving edits
Select audio source(s) for your channel by adding them to your layouts. The bottom section of the custom layout
editor is where you select the audio source for the currently selected layout. It's also where you'll find the Save
button.
l

Pearl-2 and Pearl Nano - If an Auto channel is selected as a video source, then Auto A audio is selectedby default.

You can have multiple audio sources in a layout. The audio sources are mixed together at the same volume level
as one another.
When setting the audio gain for your channel, add all your audio sources to your layout first, then set level of gain
for your audio sources appropriately. When you're done all your changes, click Save.

185

Pearl Nano User Guide

Resize and position items using percents or pixels

Resize and position items using percents or pixels
You can resize layout items using the percent/pixel adjustment boxes in a layout using the custom layout editor.
You can also reposition video sources. See Resize layout items and Position layout items.
There are three adjustment boxes along your layout's horizontal axis and another 3 boxes along the vertical axis.
You can enter percent or pixel values into checked adjustment boxes (bordered with red) to position and resize
your item(s).

Percent values are used in adjustment boxes by default, and can be converted to pixels by simply overwriting thepercent value in a given adjustment box and replacing it with a pixel value.
When entering percent values, ensure the suffix "%" is added to your value (i.e. "20%").
When entering pixel values, ensure the suffix "px" is added to your value (i.e. "200px"). A
layout item's total pixel dimensions are a reflection of your channel's frame size, asconfigured in your encoding settings (see Configure encoding ).

Unchecked boxes are grayed-out in color and are not directly editable but dynamically change their values toreflect a 100% total of either the horizontal or vertical axis, depending on values entered in adjacent adjustment
boxes. See the Adjustment boxes for item resizing and positioning table below for more information.

The values contained in checked boxes (bordered with red) are anchored and do not dynamically adjust theirvalues.

186

Pearl Nano User Guide

Resize and position items using percents or pixels

Table 42 Adjustment boxes for item resizing and positioning
Item

Description

1

The area of your layout item. The four red/white dots represent the boundaries of your layout item.
There may be some black space between your item and its boundaries if Keep aspect ratio when
scaling is enabled (see Add an image to a layout ).

2

The percentage of blank space (or number of pixels) from left to right on the layout's horizontal axis.
(for example, the item is displaced 20%, or 200px, to the right).

3

If using percents, this value is the item's percentage of total width on the layout's horizontal axis.
(for example, the item takes up 60% of the layout's width – represented by a thin red bar above thepercent box).
If using pixels, this value is the item's width, in pixels, with a maximum pixel width (for example,
frame size) identified in your channel's encoding settingsConfigure encoding.

4

The percentage of blank space (or number of pixels) from right to left on the layout's horizontal axis.
(for example, the item is displaced 20%, or 200px, to the left).

5

The percentage of blank space (or number of pixels) from the bottom upward on the layout's
horizontal axis. (for example, the item is displaced 10%, or 100px, from the bottom up).

6

If using percents, this is the items percentage of total height on the layout's vertical axis. (forexample, the item takes up 80% of the layout's height – represented by a thin red bar to the left of the187

Pearl Nano User Guide

Item

Resize and position items using percents or pixels

Description
percent box).
If using pixels, this value is the item's height, in pixels, with a maximum pixel width (for example,
frame size) identified in your channel's encoding settings Configure encoding.

7

The percentage of blank space (or number of pixels) from the top downward on the layout's verticalaxis. (for example, the item is displaced 10%, or 200px, from the top down).

Resize layout items
The easiest way to resize a layout item is to use the center adjustment boxes (annotated as #3 and #6 in theimage above) on each of the horizontal and vertical axes to set your item's width and height respectively. You
can also use your mouse cursor to select the corners and manipulate them into the size you want. Hold the shift
key while doing so to keep the frame size constant. If you need to crop your image, see Crop a video source.

In the example, the video source is resized to 60% of the layout's width and 70% of the layout's height (withaspect ratio maintained). (Alternatively, pixels could be used to resize the layout item in a similar fashion.)

An important consideration when resizing layout items
Your item will resize automatically if both left and right (or top and bottom) adjustment boxes contain values(percents or pixels) that exceed the total of 100% (if using percents), or maximum pixel count (if using pixels) forthe corresponding horizontal (or vertical) axis.

188

Pearl Nano User Guide

Resize and position items using percents or pixels

For example, if you originally set the width of an item to 50% of the layout area (or 960 pixels, assuming your item
has a maximum width of 1920 pixels in this example) with no values entered in the left and right adjustment
boxes (i.e. the left and right boxes are deselected), the item automatically centers itself in the layout area with theleft and right percents at 25% each (remember – percents are used by default in the layout editor, even if pixels
are used in adjacent boxes). Combined with the 50% (960px) width of the image, these two 25% (480px) values
total 100% (1920px) of the layout's horizontal axis.
If you instead decide to enable the left and right percent boxes and change their values to 30% each (instead of
the current 25%), then the image's width shrinks from 50% (960px) to 40% (750px) to accommodate the change
and maintain a total layout width of 100% (1920px).

Setting the left and right (or top and bottom) percent values so the axis total among the three percent boxes
exceeds 100% will always result in the center percent box value automatically reducing itself to maintain the
100% total, shrinking your selected layout item in the process.
To resize a video source so that it appears smaller within the frame, like for a picture in picture
layout, you can change the scale from the video input's configuration page. You can also crop a
video source smaller. For examples, see Channel layout examples. After a video source is resized
smaller than the frame size of the channel, you can simply click and drag the video source into
position or use any of the other methods described.

Position layout items
There are multiple ways to reposition items in the frame using the layout editor:l

You can reposition images and video sources by entering values into the left/right and top/bottom
adjustment boxes (identified as #2/4 and #5/7 respectively in the Adjustment boxes for item resizing andpositioning table). The values entered into these boxes represent a portion of the total percentage (orpixels) of the layout's width or height.

l

Alternatively, you can position your layout items using the keyboard by selecting the item with your mouse
cursor, and pressing the arrow keys to move the selected item by 5% in any direction.

l

You can also position your item with additional keyboard precision by holding Ctrl and pressing thearrow keys to nudge your item by a very small fraction in the direction of your choice.

189

Pearl Nano User Guide

Resize and position items using percents or pixels

Example 1: horizontal positioning using percents
To position your item along the horizontal axis, first resize your items if desired (as described in Resize layout
items), then enter a percent or pixel value into either the left or the right adjustment box to shift your layout item.
For example, using percents to move a layout item with a 60% width as far to the right of the layout
area as possible, you would need to enter 40% into the left percent box to push the item to theright. The layout item originally takes up 60% of the layout width, so this added 40% shift pushes
the item as far to the right as possible (I.e. 100% of the horizontal axis).

The right adjustment box automatically sets itself to 0% to reflect that there is no more room remaining tomaneuver the image along the horizontal axis any further. Alternatively, you could reposition the image in theexact same way by instead setting the right percent box to 0%.

Example 2: vertical positioning using pixels
To position your layout item along the vertical axis, enter a percent or pixel value into either the top or the bottom
adjustment box to shift your layout item downward or upward, respectively.
For example, using pixels to move a layout item that is set to 756px in height to the top of thelayout while leaving a small margin of background (say 25px), you could either enter "25px" into
the top percent box (to specify the small margin from the top down) or enter 27% into the bottom
percent box (to specify a 27% margin from the bottom up – added to the item's 70% height thisleaves a 3% margin above your layout item.)

190

Pearl Nano User Guide

Open the custom layout editor for a channel

You can manipulate elements to get the custom look that you want using percents, pixels, your keyboard, or any
combination. Here's an example of using pixels and percents to created a custom layout with two video sources
and a background image. The slideshow video source is scaled and the presenter's video source is cropped inthis example.

Open the custom layout editor for a channel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layout(s). The custom layout editor opens.

191

Pearl Nano User Guide

Configure a custom layout for a channel

3. From the Layouts list, select the layout you want to edit. The layout editor updates to display the selectedlayout and the row for the selected layout is highlighted in green.
If this is a new layout, an unformatted layout, or there is no video source connected, then the layout area is empty
and a black background matte appears.

Configure a custom layout for a channel
Configure a custom layout for a channel using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channels menu, select the channel and click Layouts. The custom layout editor opens.
3.

lPearl Nano - If this is an Auto channel and you have a video source connected to Pearl Nano andthe channel encoding is set to use the current signal resolution as frame size, the video source
automatically appears in the full frame. Otherwise, a No Signal image appears.

4. Click and drag the red and white handles on the corners of the video source to re-size it in the layout editor
area.

192

Pearl Nano User Guide

Rename a layout

5. Click Save when you're done or continue to add additional video sources to the layout, resize and crop
each video source to exactly how you want them to appear. For examples, see Channel layout examples.

Rename a layout
You can rename a layout using the custom layout editor.
You can include certain international characters in layout names. For example, common character sets forWestern and Central European languages, Nordic languages, and Russian are supported. For a complete list,
see International character support.

Rename a layout using the Admin panel's custom layout editor
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layout(s). The custom layout editor opens.
3. Select a layout from the layout list at the top of the page.
4. Click the name of the layout so that the name turns red. Type a new name and then press the Enter key.

Set the background color
You can select the background color to fill any unused space in a layout using the custom layout editor. For
example you can add a color from your corporate color scheme.

193

Pearl Nano User Guide

Add an image to a layout

Set a background color matte for a layout using the Admin panel's custom layout editor
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layout(s). The custom layout editor opens.
3. Click the drop down arrow next to the existing (by default black) background color field. The color picker
opens.

4. Pick a new color or type in an RGB value in the field; the color is updated in the layout area.
5. Click anywhere off the color picker to close the picker.
6. Click Save.

Add an image to a layout
You can add images to a layout using the custom layout editor. Use images to create a background for yoursource, to add your corporate logo, or to add relevant information about the event you're streaming.
Pearl Nano supports .PNG and .JPEG images up to a maximum size of 4096×2160. For many applications like abackground, you will want your image to have the same aspect ratio as the channel in which the image appears.
Pearl Nano supports images of all different shapes, such as 16×16 pixels; however, we recommended that you
upload exactly the size you need and avoid scaling the image using the custom layout editor.
Images can be uploaded in advance from the Media page, see Upload or remove an image using the Media
page. Otherwise, you can drag and drop to upload an image using the custom layout editor. Note that no warning
is displayed if the image is too large or if an image exists with the same name using drag and drop. The file will be
replaced with the new image you upload.
Any image without the proper file extension appears in the layout editor but doesn't display in the actual video
output. For instance, a .PNG image with the file extension .bmp or an invalid file extension such as .png2 areexamples of improper file extensions.
If your uploaded image does not appear in the list, ensure it doesn't exceed the maximum
image size of 4096×2160. No warning or error message is displayed if your image is toolarge.

194

Pearl Nano User Guide

Add an image to a layout

Add an image to a layout using the Admin panel's custom layout editor
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layout(s). The custom layout editor opens.
3. Click Add new item and choose Picture from the drop down. The picture settings appears.

4. Select an image from the Use picture drop-down menu. To upload the image, drag and drop it from yourdesktop to the gray Please select picture area. For best results, keep the Keep aspect ratio when
scaling check box selected (default).
For best results, check Keep aspect ratio when scaling in the Source settings.
5. Your picture appears in the Picture settings preview and is added to the layout area.
6. In the layout area, use the mouse, the keyboard or the manual position value fields to position and resize
your image. For background images, click and drag to fill the full layout area. For more details, see Aboutthe custom layout editor.

7. Re-order the items in your layout by clicking and dragging items in the item list.
To layer items over top of each other, like for background images or a transparent logo, you
can click and drag elements that appear in the item list beneath Add new item and change
their order. Items that are higher up the list appear over top items that are lower down the list.
8. Click Save.

195

Pearl Nano User Guide

Upload or remove an image using the Media page

Upload or remove an image using the Media page
You can customize a channel by adding pictures as backgrounds, overlays, or transparent overlays. Video files
are not supported on Pearl Nano. Image file formats supported include: PNG and JPEG for pictures.
The maximum supported picture image size is 4096×2160. No warning or error message is displayed if yourimage is too large. Files that exceed the maximum size won't appear in the drop-down list.

For best results always upload images that are already the correct size needed in your layout.
Background images should match the frame size of your channel (frame size is set in the Encoding
configuration page).
There are two ways to upload images. You can upload images from the Media page using the Admin panel ordrag and drop your image onto the Add new item area using the custom layout editor, see Add an image to alayout.

Important considerationslMedia file names should not include special characters, slashes, or spaces. The underscore character "_"is allowed.

lUploading an image of the same name overwrites the existing image.

l

Any image without the proper file extension appears in the layout editor but doesn't display in the actual
video output. For instance, a .PNG image with the file extension .bmp or an invalid file extension such as.png2 are examples of improper file extensions.

Upload or remove an image using the Admin panel's Media page
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Media. The Media page opens.
3. To upload a file, click Choose File and browse to select the file to upload, then click Upload.
4. To remove a file, click Remove beside the file name and click OK when prompted.

196

Pearl Nano User Guide

Add a text overlay

If you delete an image that is used as part of the layout for any channel, select a different image orno image by using the drop-down list in the Picture settings box within that channel's layout before
deleting the file using the steps below.

Add a text overlay
Text overlays are useful to add information like a title, location, or the date and time in to layouts in your channel.
You can add text to any layout using the custom layout editor. The following tables lists shortcut codes that you
can enter and the resulting content that appears on screen.
Table 43 Overlay text shortcut codes
Item

Shortcut code

Exampledate format: yyyy-mmdd%F

2019-01-26

date format: mm/dd/yy%D

01/26/19

year

%G

2019

month (01)%m

01month (Jan)

%b

Jan

month (January)%B

January

day of the month%d

26

weekday (Thu)

%a

Thu

weekday (Thursday)%A

Thursdaytime (24-hour clock)%T

20:40:45

hour (24-hour clock)%k

20

hour (12-hour clock)%I

08

minute%M

40

second%S

45

millisecond

%#m

378

channel name%cCamera Feed 1

AM/PM

%p

AM

am/pm

%P

am

197

Pearl Nano User Guide

Add a text overlay

Itemtime zone

Shortcut code
%Z

ExampleEST

If you use a non-monospaced font, the size of the text overlay changes as the letters, numbers, andthe length of words change. Use a monospaced font to maintain a consistent size for the text overlay(assuming the total number of characters in the text string doesn't change).
You can include certain international characters in text overlays. For a complete list, see International character
support.

Add a text overlay using the custom layout editor
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layout(s). The custom layout editor opens.
3. Click Add new item and select Text. The new item is added to the layout editing area and to the top of thelist of items. The Text settings also appear.

198

Pearl Nano User Guide

Add a text overlay

You can change the order in which items appear on the layout editing area by re-arranging
the order the items appear in the list beneath Add new item. Items at the top of the list appear
in front, and items lower down the list appear behind.
4. In the Text field, type what you want to appear in the text overlay. Include Overlay text shortcut codes asneeded. Press Tab or click outside the text field to refresh the preview in the custom layout editor.
For example, if you enter:%A %B %d, %G. Live streaming channel Input A.
The resulting text is displayed:

5. Select the Font, Font size, and Text color. You can also change the default Line spacing in percentages.
For a mono-spaced font, use Droid Sans Mono.
Limitations: The maximum supported text size is 500 px. Padding values must notexceed the frame size. Do not enter negative padding values.

199

Pearl Nano User Guide

Custom system variables for text overlays

6. Resize the overlay text box using the padding settings.
The handles on the corner of the overlay text box are not click-and-drag and do notresize the text box. To resize the text box, use the padding fields to add space above,
below, and on either side of the text.
7. In the layout editing area, click and drag to move the overlay text box or enter values in the manual
position value fields along the side and bottom of the layout area.
8. Click Save.

Custom system variables for text overlays
Using HTTP APIs, you can create your own custom system variables for use in text overlays. Pearl devices also
support RS-232 APIs. This is useful to add custom overlay text that changes throughout the course of your live
stream or recorded program.
For example, using the HTTP API you can create a system variable for the current GPS co-ordinates, then use ascript to update the GPS co-ordinates in your custom variable as the physical location in your stream changes.
Here's an example custom variable called gpsvar1 that has a value of N103 68201 W765 29712. To insert thecustom system variable into a text overlay, simply type %(gpsvar1) into the Text field.
If you use a non-monospaced font, the size of the text overlay changes as the letters, numbers, andthe length of words change. Use a monospaced font to maintain a consistent size for the text overlay(assuming the total number of characters in the text string doesn't change).

The RS-232 SET command syntax in this case is VAR.SET.<name>=<value>, for example:
VAR.SET.gpsvar1=N103 68201 W765 29712
where <name> is gpsvar1 and <value> is N103 68201 W765 29712.

200

Pearl Nano User Guide

Crop a video source

There are no limits for the frequency of system variable commands using RS-232. However, only one command
can be issued at a time.
HTTP system variable commands are issued at a frequency of 5 per second. You can include up to six variables
in a single HTTP SET command. After issuing a SET command, all channels using the specified variables are
updated.
System variables are considered volatile. They are deleted when a Pearl system reboots.
To learn more about global variable command syntax and important considerations when using them, see thePearl System API Guide for details.
For more information about sizing and positioning elements in the custom layout editor area, see About thecustom layout editor.

Crop a video source
You can crop a video source to change the size and shape of your video as it appears on screen using thecustom layout editor. Cropping a source gives you a lot of advantages and can help to conserve the overall
amount of processing CPU usage for Pearl Nano.
Pearl-2 and Pearl Nano can capture a 1080p section from a 4K source, a specific aspect ratio or size from asource, or select a crop that fits into your layout better than the full area of your video.

Crop a source using the Admin panel's custom layout editor
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Layout(s). The custom layout editor opens.
3. Select a video source from the items list. The Source settings appears.
4. Click Crop. Your video source appears in a pop-up editing window.

201

Pearl Nano User Guide

Crop a video source

5. The Crop window has several tools for creating the best crop possible.
lFree form is the default crop mode. In this mode, you can change the size, aspect ratio, andposition of the crop with minimal restrictions.

l

The red box with click-and-drag circular handles in the corners shows the cropped area thatappears in the final layout. Only the content inside the box shows in the layout. In Free form mode,
you can click and drag the red handles to change the size and ratio of the box, and you can click
and drag the box itself to change its position. When you have selected an aspect ratio, you canalter the size by dragging the red handles. When you have selected a size, you can change its
position by dragging the box.

l

The number boxes allow you to make precise crops. Click the text boxes and enter a number todetermine how many pixels of distance from the edge that line is drawn. You can also erase the"px" after the number and type in "%" to manipulate the box using percentages. For more details on
how these boxes work, see Resize and position items using percents or pixels.

l

To create a crop with a specific resolution, choose a Size from the available list. This creates a box
with that exact resolution. Click and drag the box to move it into position. The size cannot bechanged except by selecting a different size, or by selecting Free form or Aspect Ratio.

lSelecting an aspect ratio allows you to create a crop box of almost any size in a particular ratio.
After selecting a ratio, you can manipulate the crop area's size and position without changing its
shape.

6. Click OK to close the crop window.
7. Click Save.

202

Pearl Nano User Guide

Crop a video source

You can also manipulate the crop-box using keyboard controls. You can move the crop box using
the arrow keys, and holding Ctrl or Shift while resizing the box keeps the aspect ratio of the box
constant. Hold Shift and use the arrow keys to move one side of the box while leaving the other inthe same location.

If creating a crop on a video source that has no active signal the crop is based on the default
resolution of the 'No Signal' image, which is 1280x720p. To work around this set a custom 'No
Signal' image at the same resolution as the video source you intend to bring in and crop.

203

Pearl Nano User Guide

Video and audio input sources

Video and audio input sources
The Admin panel automatically discovers all video and audio sources that you connect to the input ports on thePearl device and lists them in the Inputs menu of the Admin panel. You can also configure a video source's
settings using the Admin panel.
Networked video sources like SRT need to be manually added before they display in the Inputs menu. A
corresponding audio source is always added to your custom layout editor when you add a networked video
source, even if the video stream contains no audio, see Add an audio source to a layout.
An input source's content can be video, a picture, or music from a connected audio mixer. Content can originate
from a camera, computer screen, an imported image in the Pearl device, and even another Pearl device.
Topics include:lAbout connecting video and audio sourceslTested RTSP-based IP cameraslConnect an RTSP sourcelConnect an SRT stream as an inputlPreview a video source using the Admin Panell

Rename an input portlConfigure a video input sourcel

Add a custom No Signal image

For instructions to configure an audio input and adjust audio gain or delay, see Audio input ports.

About connecting video and audio sources
You can connect and disconnect video and audio sources while the Pearl device is powered on and when it ispowered off. However, for network video sources connecting via the Ethernet port, the source device sending thestream and the Pearl device must both be powered on to make the connection.
Connect your video and audio sources to the following input ports on your device:
Table 44 Cable and port connections
Source type

Input port

SDI

SDI port

HDMI (HDCP-protected) or DVI(adapter)HDMI port

USB audio (UAC)

USB 3.0 port (rear)

Ethernet

RJ-45 port. SRT and RTSP are digital sources you connect to your Pearldevice via the Ethernet network port.

204

Pearl Nano User Guide

Tested RTSP-based IP cameras

Source type
Audio

Input port
Pearl-2 and Pearl Nano - XLR or RCA

You can also connect RTSP sources such as IP cameras and even another Pearl device over the network using
the Admin panel.
Application of amplified speaker signals to the audio line inputs exceeds the recommended ratingsand may permanently damage the device.
The Admin panel automatically discovers all video and audio sources that you connect to the input ports on Pearldevice and lists them in the Inputs menu of the Admin panel. Sources coming from the Ethernet network such as
SRT and RTSP need to be added manually to appear in the Inputs menu. When a network source is added as an
input, a corresponding audio source is automatically added to the list of audio sources for your channels, even if
there is no audio. See Add an audio source to a layout.
When a video source is connected, the system automatically detects and adjusts the image capture settings
every 60 seconds. The interval is configurable. Generally no further configuration is needed; however you canfine tune some settings using the Admin panel.
If no video source is connected to an input port or no stream is being transmitted from a source over the Ethernet
connection, "No Signal" displays wherever that input is used. You can change that to display the default "No
Signal" image for Pearl devices or create your own custom no signal image. See Add a custom No Signal image .
Changing the video or audio source while streaming or recording can cause the recording to stop or the stream
frame size to change, depending on how your channel is configured. If the frame size changes, viewers may get
disconnected and need to re-connect to the live stream.
Audio mixers and other line-level audio devices can be connected to:l

Pearl-2 and Pearl Nano - the XLR and RCA audio input ports .

Embedded audio from sources connected to the HDMI, SDI, and USB ports (only USB audio on Pearl Nano) is
also supported.
For guidance on connecting an audio source, see Selecting an audio source .

Tested RTSP-based IP cameras
Pearl devices are compatible with all Ethernet-based IP cameras and other RTSP sources. The cameras listed in
the following table represent a sample of common third-party cameras that have been tested to work with Pearldevices. Information such as URL syntax, default credentials and audio streaming capability specific to eachcamera is included.
The URL syntax refers to the additional piece of text that needs to be included in the source URL to connect yourIP camera to a Pearl device, see Connect an RTSP source to learn how to connect an RTSP source like an IP
camera using the Admin panel.

205

Pearl Nano User Guide

Tested RTSP-based IP cameras

For example, to connect a Sony SRG300SE camera with an IP address of "192.168.0.160", your source
URL needs to be entered as:"rtsp://192.168.0.160/video1"
Or, if using a Q-See QCN8029Z camera, your source URL needs to be entered as:"rtsp://192.168.0.160/"
Table 45 List of tested IP cameras

Brand

Model

Q-See

QCN8029ZImage

URL syntax

Audio?

/

No

Default username andpassword

admin
admin

admin
Sony

SRG300SE/video1Yesadmin/MediaInput/h264/stream_1
Panasonic

AWHE40HPK⁑admin(To add a second URL, use:"/MediaInput/h264/stream_
2")

Yes

/axis-media/media.amp

No

12345

root
Axis

P1428-E

root

root
Axis

M1034-W/axis-media/media.amp

Yes
admin

⁑During testing, the Panasonic AW-HE40 did not consistently synchronize its time with Pearl devices.

206

Pearl Nano User Guide

Connect an RTSP source

Connect an RTSP source
You can connect an RTSP source (such as an IP camera or another Pearl device) to Pearl Nano over a network
using the Admin panel.
For a list of tested cameras and their URL syntax, see Tested RTSP-based IP cameras .
RTSP video encoding is supported with H.264 video codec (and H.265 on Pearl Nano) and MP3 or AAC audio
formats. We recommend using the hardware acceleration option for improved performance (enabled by default).

Important considerationsl

If an RTSP source is connected but unused in any channel, only key frames are encoded to preserve CPU
resources.

lPearl Nano - It is recommended to only use a single RTSP source for a Pearl Nanol

To synchronize timestamps between your RTSP source and Pearl Nano, the same time synchronization
server should be used for both. We recommend that you configure an NTP server on your Pearl device
and use it as a time synchronization server for your RTSP source. see Configure a time server.
The timestamps of an RTSP source and Pearl device tend to gradually go out of sync. If
there's a 2500 –3000 ms difference between the timestamp of your RTSP source and thePearl device, a "no signal" image displays and your RTSP source won't stream audio. Reconnect your RTSP source to reset any time synchronization issues.

Connect an RTSP source using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, click Add input, and then click Add RTSP input The RTSP input page opens.
3. Enter the Input URL, Username and Password for your RTSP source and select either UDP or TCP as
the Preferred transport. If you're using another Pearl device as an RTSP source, see Share a live
broadcast stream (HTTP, HTTPS, or RTSP) .
4. (Optional) Rename the RTSP source, see Rename an input port .
5. (Optional) Configure a custom "No signal" image, see Add a custom No Signal image .
6. Click Apply to save your settings and connect your RTSP source.
After your RTSP source is connected, you can view basic video and audio signal information and packet loss
statistics for the source under the Status header at the top of the page. Any warnings or errors associated withyour RTSP stream are also displayed on this page.

207

Pearl Nano User Guide

Connect an SRT stream as an input

Alternatively, you can view stream connection information when you click check at the bottom of the page.

Connect an SRT stream as an input
Secure Reliable Transport (SRT) is a low-latency protocol used to stream over the Internet to SRT destinations(decoders), such as CDNs and other SRT decoders.
You can configure Pearl Nano as an SRT destination (decoder) and ingest SRT streams as video inputs that you
can add to custom layouts for switching, recording, and streaming.
l

Pearl Nano - Pearl Nano cannot be used as a switcher.

l

Pearl Nano - Only one video input on Pearl Nano can be from an SRT source.

When adding an SRT input, be sure to select the correct SRT mode. For example, if the SRT source stream isusing rendezvous mode, ensure you set the SRT input in the Admin panel to rendezvous mode. If the SRT
source stream is using caller mode, then set the SRT input in the Admin panel to listener mode. For more
information about SRT modes, see About streaming using SRT.

208

Pearl Nano User Guide

Connect an SRT stream as an input

What's needed for this setupl

The IP address and SRT port of the SRT source (encoder) is needed for caller mode and rendezvous
mode.

l

For rendezvous mode, you must configure the SRT input to use the same port value as the SRT source.
For an example SRT stream using rendezvous mode, see Set up an SRT stream using rendezvous mode.

l

For caller/listener modes, you must know which mode the SRT source uses and configure the SRT input
on Pearl Nano to use the corresponding mode.

llCaller mode can be used only for connection with the publicly accessed destination/source.

lListener mode can be used for connection with any source/destination (including within a local
network behind the firewall).

l

For example, if the SRT source is in caller mode, then the input must be in listener mode. For an
example SRT stream using caller/listener modes, see Set up an SRT stream using caller andlistener modes.

If AES encryption and a passphrase is required, consult your IT administrator for this information. Pearl
Nano supports 128 bits, 192 bits, and 256 bits AES encryption. Special characters are not supported in
the passphrase.
If AES encryption and a passphrase is configured, ensure this information is provided to the SRT
source. The SRT stream from the source must use the same AES and passphrase values, see Set
AES encryption and a passphrase for SRT.

Add an SRT stream as an input using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, select Add input and select Add SRT input. The SRT input configuration pageopens.

209

Pearl Nano User Guide

Preview a video source using the Admin Panel

3. In the Connection mode field, select the SRT mode:a. For Caller mode, enter the following:l

URL - the URL of the SRT source (encoder) using the format srt://<encoder-ipaddress>:<port>, where the <encoder-ip-address> and <port> could be a Pearl device
sending an SRT stream.

l

Source port - enter the port number for Pearl Nano to use for SRT traffic.

lStream ID - In the Stream ID field, enter a unique name for this stream.

b. For Listener mode, optionally enter the following:lEnter the Port number for this device to use for SRT traffic. See Network ports used by Pearl
Nano to determine available ports.

c. For Rendezvous mode enter the following:l

URL of the SRT source (encoder) using the format srt://<encoder-ip-address>:<port>,
where the <encoder-ip-address> and <port> values are provided by the SRT encoder
device.

4. Enter the following optional settings:lEncryption - select the check box and choose the AES Key length if the SRT destination requires
AES encryption. These settings must match the encryption settings of the destination device.

lPassphrase - Enter a passphrase if one is required along with AES encryption.

lLatency - Add from 80 ms to 8000 ms of latency to the SRT stream. Increasing latency gives moretime to buffer packets and resend any that got lost in transit to the destination. If the latency value
set for the stream is too low and there is packet loss over the network, retransmission of lost
packets will not be possible and the stream quality will suffer.If you require real-time responses
from your audience, you should use as little latency as possible.

l

Audio delay - The audio delay feature helps you adjust audio coming from external sources so thatyour video and audio sources are synchronized when captured, streamed, and recorded. You canapply from -300 ms to +300 ms of delay. By default, there's 0 ms of delay applied to audio sources.

l

No signal image - Select an image to be displayed if there is no signal in the SRT stream. from thedropdown list. The DEFAULT image displays the words NO SIGNAL. To add a new image, selectMedia in the Configuration menu and click Choose File.

lTimeout - Select an amount of time with no signal before the No signal image appears.

5. Click Apply.
We recommend using the default latency value for an initial test stream. After you perform a test stream, you candetermine the Quality of Service (QoS) and calculate the latency requirements. To set the SRT stream latency,
see Adjust latency and view the SRT stream status.

Preview a video source using the Admin Panel
You can preview the images captured from your video sources in the Admin panel.

210

Pearl Nano User Guide

Rename an input port

Preview an input source using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. Ensure a source is connected to the input port.
3. From the Inputs menu, click the source name. The configuration page for the source opens. A preview
appears at the bottom of the page.

Rename an input port
The input port names are used when adding your video and audio sources to channels. A channel that has only
one source is automatically assigned the same name as the input source by default. If you change the name of
the input source, the channel name will update automatically to match.
Sometimes it's helpful to configure the input port name to match the data it's capturing so that it's clear what thechannel is capturing. Alternately you can change the channel's name, see Rename a channel.
For a complete list of international characters supported, see International character support.

To change an input port name:
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, click the source name. The configuration page for the source opens.
3. Click on the input port name that appears at the top of the page. The text turns red.
4. Enter the new name using alphanumeric characters. We recommend using underscores to separate
words rather than using spaces.
5. Press Enter using your keyboard to save the new name.

Configure a video input source
Captured video sources don't usually need configuration, but you can change some of the video settings using
the Admin panel, including:lVideo settingsl

SDI video settings

For details to configure networked video sources on your Pearl device, see:lConnect an RTSP sourcelConnect an SRT stream as an input

Open the configuration page for an input source using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. Ensure a source is connected to the input port, see About connecting video and audio sources.
3. From the Inputs menu, click the source name. The configuration page for the source opens.

211

Pearl Nano User Guide

Add a custom No Signal image

Video settings
Value

Input type

Description

Scaling (Pearl
Nano)

Use this setting to scale the video input source. This is useful when adding
multiple video sources in a custom layout such as picture in picture or
HDMI, DVI, SDI side-by-side. The frame size selected for the video source is also whatgets sent out the HDMI OUT port when you select the video input as theoutput source.

Image

This menu allows you to choose a custom no-signal image for thechannel. The drop-down list gives you the option to choose the default
HDMI, DVI, SDI
image or any image you have uploaded through the Add a custom No
Signal image

Timeout

The timeout represents the number of seconds after losing the signal that
HDMI, DVI, SDI the no-signal is displayed. You may change this number to adjust how
soon you wish the no-signal image to appear after the signal disappears.

1Requires 4K feature add on

SDI video settings
The following options are available for signals via the SDI port.
Value

Description

Scaling

Use this setting to scale the video input source. This is useful when adding multiple video
sources in a custom layout such as picture in picture or side-by-side. The frame size
selected for the video source is what gets sent out the HDMI OUT port.

Image

This menu allows you to choose a custom no-signal image for the channel. The dropdown list gives you the option to choose the default image or any image you haveuploaded through the Add a custom No Signal image

Timeout

The timeout represents the number of seconds after losing the signal that the no-signal isdisplayed. You may change this number to adjust how soon you wish the no-signal
image to appear after the signal disappears.

Add a custom No Signal image
By default the system displays a No Signal image when there is no video signal coming in to any of the video
input ports on the Pearl device. You can customize this image to display a different message to your viewers. For
example if a viewer logs in early, or if you are experiencing delays you could indicate the start time (or expected
resolution time) using the no signal image.
Before you can specify a custom No Signal image for an input port on a Pearl device, you must upload the image.
For more information, see Upload or remove an image using the Media page.

212

Pearl Nano User Guide

Add a custom No Signal image

Set the no signal image for an input port using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, click the source name. The configuration page for the source opens.
3. In the "No signal" image section, select an image from the Image drop down list.

4. In the Timeout field, enter the number of seconds before the No Signal image is displayed. If no manual
value is entered, the default time to display is 5 seconds.
5. Click Apply.
6. Test that the No Signal image is correctly applied by disconnecting your source and previewing thechannel(s) containing said source, see Preview a channel.

213

Pearl Nano User Guide

StreamStreamStreaming is a powerful way to deliver live video content to your viewers. Stream to viewers, servers, and media
players. Using the Admin panel, you can configure streaming in multiple formats to multiple destinations anddevices, such as web browsers, media players, set-top boxes, Smart TVs, and Content Distribution Networks.
Pearl Nano is flexible, easy to setup, and supports all the standard codecs, as well as the most common media
players. Streaming options include: unicast, multicast, SRT, HLS, RTMP, SAP, and more.
Topics include:lWhat is streaming?

lViewing a channel's live broadcast streamlDirectly sharing channel stream URLs with viewerslSuggested stream settingslStreaming a channel direct to viewerslStreaming to servers, CDNs, and other deviceslStreaming to a media player or smart TV

For instructions on how to use Pearl Nano's front screen menu to start/stop scheduled CMS webcasts, see
Stop/start scheduled CMS events using Pearl Nano's front screen menu.
For information about streaming to Content Management Systems (CMSs) like Kaltura and Panopto, see CMS
recording and webcasting control.

214

Pearl Nano User Guide

What is streaming?

What is streaming?
After you connect your camera, audio source, and set up a channel, it’s time to stream your content live andshare that with your viewers.
Epiphan products provide many different streaming options and supports a variety of streaming protocols. The
easiest way to stream a single channel directly to viewers on the same local network is to share the channel's live
broadcast URL. Various stream types are available so users can watch using their favorite devices, including:
HTTP/HTTPS, HTTP FLASH (.FLV), MPEG-TS (HTTP), and RTSP.
At the same time, stream to a multicast server or CDN and reach viewers across the globe. You can even stream
to smart TVs in overflow rooms using SAP. The streaming method you choose depends on factors like thenumber of viewers of your stream, are you broadcasting live over a local TCP-based network or streaming to a
CDN over the Internet, how much bandwidth do you have available, and is live streaming security a concern?
Pearl devices can stream to a CDN or media server using any of the following streaming protocols:l

SRT (push)l

HLS (push)l

RTMP/RTMPS (push)l

RTSP Announce

A channel can support multiple streams. That means you can stream a channel to multiple destinations using
different streaming protocols. Unicast and multicast streams are also supported.
lPearl Nano - start and stop streaming by using the Streaming key located on the front panel or directlyfrom the Admin panel . You can also control streaming using Epiphan Edge from a mobile device or tablet,
see Control recording and streaming using Epiphan Edge.

In addition to streaming from the Pearl device, the following streaming formats are supported as input sourcesthat the Pearl device can ingest:
l

SRT

l

RTSP

The Pearl device also comes with APIs so you can setup third party tools to control streaming, see the Pearl
System API Guide for details.

Additional considerationsl

Are you streaming live video or recorded video?

l

Do you need to stream the content to one client (peer-to-peer) or deliver a single stream to multiple clients(multicast)?

l

Do you need to provide web-based streaming that multiple clients can access using a Content Distribution
Network (CDN), such as YouTube or Facebook Live?

l

Do you need to encrypt your live stream for higher security?

lStreaming to a Content Management System (CMS) like Kaltura or Panopto? See CMS recording andwebcasting control

215

Pearl Nano User Guide

Streaming to a CDN, multicasting, and streaming tomultiple destinations

Streaming to a CDN, multicasting, and streaming to multiple
destinations
A Content Delivery Network (CDN) relies on geo-diverse CDN servers to receive and disperse web content to the
CDN server closest to the user. The closer the server is to the user, the faster the content is delivered. Streaming
your content through a CDN allows you to stream any time, anywhere, regardless of the viewing device and you
don't have to worry about maintaining your own video streaming servers on site.

Streaming content to a multicast IP address is different than streaming to a CDN. Multicasting lets you directly
share the stream with multiple viewers on the same LAN. All viewers receive the same stream at the same time.
Similar to turning on a radio station where all listeners hear the same music at the same time. Multicasting isuseful for training sessions when there is a specific time frame for the audience to view the content live.
Pearl Nano can publish to multiple destinations at the same time. Do not use Motion JPEG (MJPEG) encoding
when streaming a channel to CDNs and multicast streaming at the same time. For more information, see
Configure video encoding.
Publishing Options

Use this option to...
Stream web content to many viewers on different Content Delivery Networks
simultaneously to any geographical location. Using a CDN to host your broadcast ishighly scalable and saves you from having to purchase and maintain your own
servers to host and deliver video content.

Content Distribution
Network (CDN)

Using one or more CDNs to stream live content allows you to reach a large
geographically diverse audience and because CDNs perform format conversion, thestream is platform independent.
Streaming protocols supported include: SRT (push), HLS (push), RTMP/RTMPS, .
For more information about streaming to a CDN, see Streaming to servers, CDNs,
and other devices.

Multicast Streaming

This delivery method relies on network equipment that supports multicasting and isusually used on high bandwidth corporate LANs and not on Internet-basedarchitectures.

216

Pearl Nano User Guide

Publishing Options

Directly sharing channel stream URLs with viewers

Use this option to...
Multicasting is what's typically used to stream video and audio to an IP TV or set-top
box playlist. If you're streaming over a Gigabit Ethernet network to a 10/100 Mbps
set-top box that is dropping frames, you can limit the stream's bandwidth, see Set up
traffic shaping.
Multicast streaming protocols supported include: MPEG-TS UDP, MPEG-TS
RTP/UDP, and RTP/UDP.
For more information about using multicasting for streaming your content, see
Multicast streaming

To stream video outside of your LAN, use a CDN or configure port forwarding on your router. Consult
your Network Administrator to set up port forwarding.
By default, no streaming is configured for the channels configured on Pearl Nano.

Publishing to a CDN
When you publish a stream to a CDN provider, make sure you use a streaming protocol that the CDN supports.
Contact your CDN for a list of supported streaming protocols and audio codecs they support.
To publish content to a CDN provider, ensure you have:l

the URL (or path) to the mount point or an XML configuration file (provided by the CDN provider)lthe supported transport protocols, audio codecs, and any other settings like key frame rates and bit rates
recommended by the CDN providerl

See Suggested stream settings for the best streaming settings for Pearl Nano.

You can control streaming to a CDN using the Admin panel. You can also use:l

Pearl Nano - Streaming button on the front panel.

For more information see Start and stop streaming to a CDN.
You can also test how your content is streamed by sending your content to Epiphan’s CDN. For a list of
Epiphan’s preferred CDN providers, see: https://www.epiphan.com/partners/cdn-partners/.

Streaming to multiple destinations
Pearl Nano supports streaming to multiple destinations. A stream uses the channel's encoding settings.
Therefore, all streams you create for the channel have the same encoding settings.

Directly sharing channel stream URLs with viewers
People on the same local network as Pearl Nano can easily view a channel's live broadcast stream. All you needto do is provide the channel's stream URL and log in credentials for viewers, see Change user passwords.

217

Pearl Nano User Guide

About streaming using SRT

Choose the right type of URL for the type of device the person will use to watch the stream. Viewers can watch
the stream using a digital media player or browser. For more information on supported streaming formats anddevices, see Viewing a channel's live broadcast stream.

HTTP is used for MPEG-TS and FLV streaming. HTTPS is not supported.

About streaming using SRT
Secure Reliable Transport (SRT) is an open-source streaming protocol that offers quality, low-latency streaming
to CDNs and other SRT enabled decoders across unreliable Internet connections using User Datagram Protocol(UDP) transport and additional error checking. Low-latency SRT is particularly good for real-time, two-way
communications between a remote guest and a local on-site host.
You can configure Pearl Nano as an SRT source encoder and stream video using SRT. You can also configure
Pearl Nano as an SRT decoder and ingest SRT streams as video inputs. Up to one of the video inputs you
configure for Pearl can be from an SRT source and Pearl Nano can stream up to three SRT streams.

218

Pearl Nano User Guide

About streaming using SRTPearl Nano as SRT source encoders in a multiple-source setup.

Before content is streamed between the SRT source and destination, a communication link must be establishedbetween them for SRT control and recovery packets. Any firewalls blocking the path must be traversed.

SRT streaming modes and firewalls
Streaming through firewalls can be a challenge. With SRT you get easy firewall traversal with little to no IT
involvement.
SRT offers three modes to simplify the process: Rendezvous, Caller, and Listener.
lRendezvous mode is the easiest to setup and usually doesn't need any intervention from your IT
administrator for the SRT stream from the source to traverse the firewall to the destination. The SRT
source and destination devices must use the same SRT port value, see Set up an SRT stream using
rendezvous mode.

lCaller and Listener modes work together to establish the SRT connection between your source anddestination devices when traversing the firewall is difficult. In this case, your IT network administrator must
configure the network to allow traffic that comes in on the port configured for SRT streaming and forward
the traffic to the destination device, see Set up an SRT stream using caller and listener modes.
The device you set as the Caller (or Listener) is arbitrary, as long as one device is a Listener and theother is a Caller. To establish the SRT connection between a source and destination device inrendezvous mode, both devices must be configured and ready to establish the connection between
them.

219

Pearl Nano User Guide

Secure streaming

SRT latency controls and AES stream encryption
SRT includes latency controls to adjust for poor network quality while maintaining an acceptable amount of
delay. Pearl Nano provides statistics to determine the amount of packet loss. Using the Admin panel, you canincrease or decrease the amount of latency applied to the stream to help mitigate any Quality of Service (QoS)
issues. The default latency values are 125 ms for an SRT stream and 80 ms for an SRT input, see Adjust latency
and view the SRT stream status.
For greater security, you can set the SRT stream to 128 bits, 192 bits, or 256 bits AES encryption. Encryption
settings must be set to the same values on both the SRT encoder sending the stream and the SRT decoder
that's receiving the stream, see Set AES encryption and a passphrase for SRT.

Secure streaming
Secure streaming is a great option for confidential content, such as corporate meetings or internal employee
training. There are several ways to secure your live stream.
lStream to a CDN or media server over the Internet using Secure Reliable Transport (SRT).

lStream to a CDN or media server over the Internet using Real Time Messaging Protocol Secure(RTMPS).

lStream HLS (push) over local HTTPS networks.

SRT streaming includes additional AES encryption settings for even more security. You can set the SRT stream
for 128 bits, 192 bits, or 256 bits AES encryption. Encryption settings must be set to the same values on both the
SRT encoder sending the stream and the SRT decoder that's receiving the stream, see Set AES encryption anda passphrase for SRT.
RTMPS wraps the RTMP stream in TLS/SSL packets before it's transported over a TCP connection between the
network server and the Pearl device(i.e. the client). To set up secure streaming using RTMPS, see Set up an
RTMP or RTMPS (push) stream

220

Pearl Nano User Guide

Suggested stream settings

Suggested stream settings
When you're setting up your live stream, you would typically consult your CDN or publishing destination for theirrecommended settings to use.
Stream setup can be a matter of balancing quality and system resources. When choosing your stream settings,
it's important to consider the type of content you're streaming and the streaming protocol you've chosen.
For streaming fast moving video, a higher bitrate and frame rate delivers a better image. If you're streaming aslide presentation, you can save bandwidth and system processing by lowering the bitrate and frame rate without
any noticeable image degradation.
The following table provides suggested settings to maximize your video quality while minimizing system
resource usage when streaming video content from Pearl Nano.
Table 46 Suggested stream settings for video
OptionSetting

Codec

Pearl Nano - H.265

Video encoding preset

Hardware accelerated (this is the only option on Pearl
Nano)

Video encoding profile

Pearl Nano - Main

Key frame interval

2 sec1

Limit frame rate

301
Pearl Nano:

BitrateAudio formatl6000 kpbs for Full HDl

24 Mbps for 4K UHD4K

AAC 44 KHz1

1For HLS streaming, the key frame interval should be set to 2s and the frame rate should be set to 30 fps for live

NTSC content.
The following table provides suggested settings to maximize your stream quality while minimizing system
resource usage when streaming a slide presentation from a PC, Mac, or tablet.
Table 47 Suggested stream settings for slides
OptionSetting

Codec

Pearl Nano - H.265

Video encoding preset

Hardware accelerated (this is the only option on Pearl
Nano)

221

Pearl Nano User Guide

Suggested stream settings

OptionSetting

Video encoding profile

Pearl Nano - Main

Key frame interval

2 sec

Limit frame rate

30
Pearl Nano:

BitrateAudio formatl3000 kpbs for HDl

24 Mbps for 4K UHD4K

AAC 44 KHz

222

Pearl Nano User Guide

Streaming a channel direct to viewers

Streaming a channel direct to viewers
Stream content directly to viewers on the local network using the default streaming settings as soon as you've
powered on the system and configured a channel. Just choose the live broadcast method that's right for yourviewers. They can tune into the stream and watch using their favorite web browser or media player.
Table 48 Publishing options for streaming direct to viewers on the local network
Publishing Options

Use this option to...
Viewers on the same local network as Pearl Nano can access the Live broadcast
URL using a web browser on the local network and are instantly connected.

HTTP or HTTPS

Viewers can also choose to use their favorite media player to watch the stream on thelocal network. They just need the URL for any of the other supported streaming
methods (like FLV or MPEG-TS) to watch using their media player.
Use these direct streaming methods for only a small number of viewers because
each viewer uses the full stream bandwidth and consumes resources on Pearl Nano.
For more information about using an HTTP stream, see Share a live broadcast
stream (HTTP, HTTPS, or RTSP).
Viewers can copy and paste the URL of the RTSP stream into a media player andwatch the stream on the local network. For more information about using RTSP
streaming, see Share a live broadcast stream (HTTP, HTTPS, or RTSP).

RTSP

HTTP Live Streaming(HLS) pull

Stream live over the standard HTTP port 80, making it possible to cross firewalls andproxies that are normally accessible to other HTTP traffic and facilitates content
delivery to CDNs. If HTTPS is configured on Pearl Nano, traffic from port 80 isredirected to port 443. See Enable HLS (pull) for details.
There is approximately a 30 second delay when streaming using HLS.

To stream video outside your LAN using the channel's HTTP/HTTPS or RTSP URLs, you must
configure port forwarding on your router. Consult with your Network Administrator.
To set up Pearl Nano for direct streaming to viewers, see:lDisable and enable direct channel streaminglRestrict viewer access to channel streamslShare a live broadcast stream (HTTP, HTTPS, or RTSP)l

Change HTTP and RTSP streaming port valueslEnable HLS (pull)223

Pearl Nano User Guide

Share a live broadcast stream (HTTP, HTTPS, or RTSP)

Share a live broadcast stream (HTTP, HTTPS, or RTSP)
The easiest way to deliver your content to your viewers is to give them the live broadcast URL of the channel.
You can get that using the Admin panel. A separate URL exists for each channel you stream.
The format of the URL depends on the method you used to access Pearl devices, which can be done though
network discovery using a Pearl device's serial number or IP address. The Pearl device must be accessible on
the viewer's LAN for them to access and view the stream using serial discovery.
If HTTPS is configured, the live broadcast URL will start with https instead of http.
If Pearl Nano is behind a firewall and you want to share a stream with remote viewers, you need to
set up port forwarding on your network. Consult with your network administrator.
Table 49 URL options
Access Method

URL Format
http://<serial>.local/preview.cgi?channel=<channel number>
https://<serial>.local/preview.cgi?channel=<channel number>
rtsp://<serial>.local:<port>/stream.sdp

serial discovery
Where serial is the serial number of the system, the port number for the channel isfound on the Info page, and the channel number is provided from the Admin panel.
You must install Bonjour Print Services on your Windows or Mac computer to accessthe live Preview using the serial number.

IP address

http://<IP Address>/preview.cgi?channel=2
https://<IP Address>/preview.cgi?channel=2
rtsp://<IP Address>:<port>/stream.sdp
Where IP address is the IP address of the system, the port number for the channel isfound on the Info page, and the channel number is provided from the Admin panel.

An RTSP stream is supported by most media players such as QuickTime and VLC. You can choose from two
RTSP transport protocol options.
l

RTSP (UDP/TCP): The client chooses UDP or TCP as the preferred transport protocol. The preferred
option for Pearl Nano is UDP, which is a connectionless transport protocol that does minimal error
checking for less delay when transporting packets. UDP is suitable for use with stable, low-loss networks.

l

RTSP (TCP): Uses TCP as the transport protocol. Use TCP if you're network connection is lossy andwould benefit from the error-checking and packet-loss retransmission that TCP performs.

224

Pearl Nano User Guide

Enable HLS (pull)

Retrieve the stream URL for your viewers using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Status. The Status page appears.

3. Record the Live broadcast, RTSP stream URL or other web streaming address. This is the address you
can send to viewers or use to create a link to your broadcast.
If you're seeing URLs with serial numbers instead of IP addresses and want to change this, log into
the Admin panel by IP address (instead of by Serial number/Bonjour Print Services) to see
URLs with the IP address, see Connect to the Admin panel.

Enable HLS (pull)
Stream a live broadcast of a channel directly to viewers on the same local network as Pearl Nano using
HTTP over port 80. This gives viewers with iOS devices convenient access to the channel's live broadcast. If
HTTPS is configured for Pearl Nano, the traffic from port 80 is redirected to HTTPS port 443.
HTTP Live Stream (HLS) supports the H.264 codec (and H.265 on Pearl Nano) and MP3 or AAC audio
encoding. Audio and video are sent as a series of small files called media segment files. You can set thesegment duration, as well as define the playlist size using the Admin panel. By default, the segment duration is 9
seconds and the playlist size is 3.
When live broadcasting a channel using HLS (pull), there is approximately a 30 second delay.

Enable HLS (pull) streaming using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel containing video you want to stream and click Streaming.
The Streaming configuration page opens.
3. Under HTTP Live Streaming (HLS), check Enabled.
4. (Optional) Set the Segment duration and Playlist size.

225

Pearl Nano User Guide

Restrict viewer access to channel streams

5. (Optional) Check Bypass stream access control for HLS video data to allow the viewer software to readthe HLS stream's video data without having to provide a viewer password or LDAP authentication as
configured on Pearl Nano. A viewer password or LDAP authentication that is configured on Pearl Nano isstill needed to access the HLS stream’s playlist.
Try enabling this option if your viewer is unable to access the HLS stream when a viewer
password or LDAP authentication is configured on Pearl Nano.
6. Click Apply
7. To share the HLS (pull) URL with viewers, click Status from the Channels menu, then copy the HLS URL
and provide that to your viewers.

Restrict viewer access to channel streams
Your Pearl device can restrict access to all viewer streams from the channel using global viewer passwords andIP allow/deny lists. see Change user passwords andRestrict viewers by IP address.
If LDAP is configured for viewer authentication, the viewer must pass global autentication using LDAP
credentials (or the viewer global password, if there is one) and must meet the local channel settings (come froman allowed IP address). See Configure LDAP user authentication for more information on LDAP configuration.

Restrict viewers for a channel using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The streaming configuration pageopens.
3. In the Stream access control section, select Use these settings from the drop down.

226

Pearl Nano User Guide

Restrict viewers by IP address

To return the channel to the global access control settings, select Use global settings from the drop down
and click Apply. The configuration fields are disabled and any changes to the configuration fields are notsaved.
Global LDAP settings are always enforced. Any local settings are in addition to LDAP sign on.
4. (Optional) Specify a password for viewers of this channel. The password is masked as you enter it.
If you have global allow/deny lists or a global user password, you can override the global
settings and remove all access control for a channel by selecting Use these settings andleaving all the fields blank.
5. (Optional) Enter the allow and deny IP addresses for viewers of this channel. see Restrict viewers by
IP address for details about allow and deny lists.
6. Click Apply.

Restrict viewers by IP address
Pearl devices permit you to restrict which computers can access broadcasts by building a list of allowed anddenied IP addresses. You can do this at a global level for the system and can also override these settings on a
per-channel basis. Both global and per-channel configuration procedures are described.
The following table describes what happens when an IP address is added to the allowed and denied IP address
lists.
Table 50 IP Based Restriction Options
Item

Description

Allow IP's

Users connecting from addresses in this list are permitted to view broadcasts from thedevice, provided their IP address is not in the Deny IP’s list.

227

Pearl Nano User Guide

Item

Restrict viewers by IP address

Description
To allow all except IP addresses in the deny list, if any, leave the field blank.
You can use the Allow list by itself, or in conjunction with the Deny IP’s list as an exception toa rule in the allow list.

Deny IP's

Users connecting from addresses in this list are not allowed to view broadcasts from thedevice, unless their IP address is in the Allow IP’s list. If a specific IP address is in both lists,
access to the stream is denied.
You can use the Deny list by itself, or in conjunction with the Allow IP’s list as an exception toa rule in the allow list.

If your viewer account has a password, your viewers must connect to the device from a computer (or gateway)with a permitted IP address and must also supply the user name (viewer) and password before they can view thebroadcast.
To restrict access by IP address, you need to know the IP addresses or range of addresses for your viewers. By
default, all IP addresses are allowed to connect to the broadcast.
If a user attempts to connect to the stream from a disallowed IP address, access is denied. If there's an attempt
to connect using a web browser, the message "IP address rejected" is displayed.
If you’re not familiar with creating allow/deny lists, see IP restriction examples.
IP address restriction is valid for the viewer only and does not affect the Admin panel or the mobile
configuration interface.

Restrict viewer access to watch streams on a channel by their IP address
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channels menu, select a channel and click Streaming. The channel's streaming configuration
page opens.
3. From the Stream access control drop-down, select Use these Settings to enable local password andAllow/Deny IP lists are enabled.
4. (Optional) Enter a password for the viewer in the Viewer Password field.
5. Enter the allowed IP addresses or address ranges in the Allow IP’s field and enter denied IP addresses oraddress ranges in the Deny IP's field. Separate addresses with a comma. To specify a range, use ahyphen (-). Optional spaces improve readability.
6. Click Apply.

IP restriction examples
The following table lists some sample allow lists.

228

Pearl Nano User Guide

Restrict viewers by IP address

Table 51 Example allow lists
ExampleDescription
The simplest allow/deny list is to use the list of known IP addresses to craft alist of allowed IP addresses. All other addresses are denied access to thebroadcast.

Allow list with distinct IP
addresses

For example if your system is accessible on your local area network (LAN) andyou want to make sure only the CEO’s specific desktop, laptop and tablet
computers (with IP Addresses 192.168.1.50, 192.168.1.51, and 192.165.1.75,
respectively) can connect to the broadcast, construct the following allow list:
Allow: 192.168.1.50, 192.168.1.51, 192.168.1.75

Allow list with a range of IP
addresses

Sometimes you’ll want a range of computer IP addresses to connect to yoursystem. This may happen when you have one range of IP addresses assigned
to desktop computers (i.e. in the range 192.168.1.1 to 192.168.1.100) andanother range assigned to boardroom computers (i.e. the range 192.168.1.200
to 192.168.1.250). If you only want the boardroom computers to connect tobroadcasts from the system you can specify the range of boardroom IP
addresses rather than needing to type in each individual address. The allow list
looks as follows:
Allow: 192.168.1.200-192.168.1.250
Note that we could have specified two of the IP addresses in the previous
example as a range.

Allow list with a range of IP
addresses and one or more
specific IP addresses

Putting the first two examples together, we want to permit access to IP
addresses in the range of boardroom computers (192.168.1.200192.168.1.250) and also want to add the desktop, laptop and tablet computersof the CEO (IP addresses 192.168.1.50, 192.168.1.51, and 192.168.1.75,
respectively). Note the first two IP addresses are consecutive, so they can be
added as a second range. Add these IP addresses to the list as follows:
Allow: 192.168.1.200-192.168.1.250, 192.168.1.50-192.168.1.51,
192.168.1.75
Your list can have multiple ranges and multiple distinct IP addresses, provided
they are separated by commas.

Allow list with a range ofIP addresses, distinct
IP addresses, and an
exception

Building on the previous examples, consider a situation where you want the
CEO’s computers (192.168.1.50, 192.168.1.51, 192.168.75) and all boardroom
computers (192.168.1.200-192.168.1.250) to access the broadcast, with the
exception of the public boardroom computer (192.168.1.211). Use both allow
and deny lists to create the rule as follows:229

Pearl Nano User Guide

ExampleRestrict viewers by IP address

Description
Allow: 192.168.1.200-192.168.1.250, 192.168.1.50-192.168.1.51,
192.168.1.75
Deny: 192.168.1.211
Both lists can have multiple ranges and multiple distinct IP addresses, provided
they are separated by commas.

The following table lists some sample deny lists.
Table 52 Example deny lists
ExampleDescription
Another simple allow/deny list is to use the list of known IP addresses to list
specific denied IP addresses. All other addresses are allowed access to thebroadcast.

Deny list with distinct IP
addresses

For example imagine your system is accessible on your local area network(LAN) and you want to allow any computer on the LAN can access the stream
except your publicly-accessible boardroom (with IP address 192.168.1.211).
You can use the following deny list (leave the allow list empty) to permit allcomputers except the boardroom computer:
Deny: 192.168.1.211
As with allow lists, your deny list can specify a range of IP addresses, and canspecify multiple ranges or distinct IP addresses in a comma-separated list.
Consider a situation where you want every computer on the network to accessthe broadcast, with the exception of the CEO’s desktop, laptop and tablet
computers. Additionally, boardroom computers should not be permitted withthe exception of the cafeteria computer (IP address 192.168.1.222).

Deny list with a range of IP
addresses

The deny list is an "exception" list for the allow list. So to craft the rule describedabove we need to allow all the computers in the local subnet, then deny specificsub-ranges including two groups of boardroom computers ensuring thecafeteria computer's IP address is not in the deny list:
Allow: 192.168.1.1-192.168.1.250
Deny: 192.168.1.200-192.168.1.221, 192.168.1.223-192.168.1.250,
192.168.1.50-192.168.1.51, 192.168.1.75

230

Pearl Nano User Guide

Change HTTP and RTSP streaming port values

Change HTTP and RTSP streaming port values
You can use the Admin panel to configure a specific streaming port value for the channel. Ensure that eachchannel has unique streaming port values that are not currently assigned to any other process, see Network
ports used by Pearl Nano.
By default, each channel you create is assigned a unique HTTP and RTSP port number. You cannot createchannels on the Pearl Nano.
For RTSP streaming directly to users on your LAN, the only information that's needed to view the broadcast is
the URL and the RTSP port number used to stream the broadcast.
HTTP port numbers are used for FLV and MPEG-TS streaming methods.

Set the HTTP and RTSP streaming ports for streaming to viewers on the local network
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming page opens.

3. Set the HTTP Streaming port to specify the port used to stream the HTTP broadcast. This value alongwith the URL is used by viewers to access the FLV and MPEG-TS streams.

231

Pearl Nano User Guide

Disable and enable direct channel streaming

The port number must be higher than 500 for HTTP. In the case of RTSP streaming this value
is ignored.
4. Set the RTSP Streaming port to specify which port to use when you are streaming live video via RTSP.
This value along with the URL is used by viewers to access the broadcast. The default for channel one is554.
5. Click Apply.

Disable and enable direct channel streaming
The channel streaming URLs are enabled by default. The URLs are listed on the Status page for the channel,
which you can share with viewers. You can disable the channel's streaming URLs from the Streaming
configuration page using the Admin panel.
Disabling channel streaming for viewers using their web browser or media player does not disable live streaming
to a CDN.
Disabling streams for viewers does disable all viewer formats, including: HTTP/HTTPS, RTSP, and
HLS.

Disable or enable the channel streaming URLs using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel menu, select a channel and click Streaming. The streaming page opens.

232

Pearl Nano User Guide

Viewing a channel's live broadcast stream

3. Beneath Streams for viewers, uncheck Enabled to disable direct streaming of channels to viewers using
the channel's streaming URLs. Leave Enable checked to allow direct streaming using the channel's
URLs.
4. Click Apply.

Viewing a channel's live broadcast stream
When you set up a channel, the system automatically generates and displays a list of available live broadcast
streams. You can share the channel's stream URLs with people on the same local network as Pearl Nano sothey can watch a live broadcast of the channel. All you need to do is provide them the channel's stream URL andlog in credentials if you've set one for viewers, see Change user passwords.
To stream video outside your LAN using the channel's live broadcast streams, you must configure
port forwarding on your router. Consult with your Network Administrator.
The live broadcast stream URLs for a channel are available from the Channel menu in the Admin panel when
you select Status. The audio and video codecs configured for the channel affect which live broadcast formats arelisted.

233

Pearl Nano User Guide

Viewing a channel's live broadcast stream

Just copy the live broadcast URL and share that with viewers so they can watch the channel stream using a web
browser, see View the live broadcast URL using a web browser.
Or choose one of the other channel stream URLs if your viewers prefer to watch using a media player, see View
the streaming URL using a media player.

If the channel is configured with 48 kHz audio, some web browsers may not work. In this case, we
recommend using one of the channel's other URL formats and viewing the channel steam using a
media player instead.

234

Pearl Nano User Guide

View the live broadcast URL using a web browser

View the live broadcast URL using a web browser
You can share a channel's live broadcast URL with viewers so they can watch your live stream using theirfavorite web browser. Your viewers must be on the same network as Pearl Nano to watch a live broadcast using
the channel's live broadcast URL.
If the channel you're streaming is configured with 48 kHz audio, some web browsers may not work.
In this case, we recommend viewing the channel steam using a media player instead.
The live broadcast URL appears in two places in the Admin panel:l

On the channel's status page.

l

On the Info page from the Configuration menu.

To locate the IP address for the broadcast, see Directly sharing channel stream URLs with viewers .
If a viewer password is configured, provide participants with the password to log in, along with the URL of thestream. To set a viewer password, see Change user passwords.
If HTTPS is enabled on Pearl Nano, replace http with https in the URL of the stream.

Share the live broadcast URL with viewers
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Status. The Live broadcast link is listed under
Stream info. You can copy the Live broadcast URL and share that with your viewers.
3. Alternatively, open the Info page to get the live broadcast URL. From the Configuration menu, click Infoand then click View on the far right of the channel you want to share the broadcast URL.
A page opens displaying the live broadcast and the broadcast URL. Copy the URL and share that withyour viewers.

235

Pearl Nano User Guide

View the streaming URL using a media player

Watch a stream using a web browser and the live broadcast URL
1. From your web browser, enter the IP address of the live broadcast stream.
If the IP address of the broadcast is 172.20.1.33, then browse to:http:// 172.20.1.33/preview.cgi?channel=<channel number>
2. Enter viewer as the user name and the password when prompted and press Enter. The stream plays in a
new tab in your web browser.

View the streaming URL using a media player
You can share a channel's streaming URL with viewers so they can watch your live stream using their favorite
media player, like VLC. Your viewers must be on the same network as Pearl Nano to watch a channel stream
using a stream URL.
The different stream types available for channels include: RTSP, MPEG-TS, and Flash streams, see Viewing achannel's live broadcast stream . The URL contains either the IP address of Pearl Nano or the serial number, see
The type of stream URL you provide to your viewers can affect their choice of media player needed to watch thestream.
This procedure assumes that the VLC media player is used.
If a viewer password is configured, provide participants with the password to log in, along with the URL of thestream. To set a viewer password, see Change user passwords .

Share the channel's stream URL with viewers
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Status. You can copy the Live broadcast URL
and share that with your viewers.

View the channel's stream URL using a VLC
1. Launch a media player.
2. Click the Media tab and select Open Network Stream from the drop-down menu.
3. Enter the stream URL. In this example, the serial number method is shown.
rtsp://.local:554/stream.sdp

236

Pearl Nano User Guide

View the streaming URL using a media player

4. Press Play to watch the stream in the media player window.

237

Pearl Nano User Guide

Streaming to servers, CDNs, and other devices

Streaming to servers, CDNs, and otherdevicesPearl Nano can stream to CDNs, local media servers, and even to other Pearl Nano devices that are acting as a
streaming ingestion point. Pearl Nano supports many streaming protocols. Use the Admin panel to set up
individual channels for streaming.
Topics include:l

Set up an RTMP or RTMPS (push) streaml

Set up an SRT stream using caller and listener modesl

Set up an SRT stream using rendezvous modelAdjust latency and view the SRT stream statusl

Set AES encryption and a passphrase for SRTl

Set up an HLS (push) streaml

Set up an RTSP announce streamlStart and stop streaming to a CDN

For details to configure multicast streaming, see Multicast streaming. For more information on video encoding
configuration, see Configure encoding .

Set up an RTMP or RTMPS (push) stream
Real Time Messaging Protocol (RTMP) is this the most common way to stream to a CDN, including to Facebook
Live and YouTube.
Use Real Time Messaging Protocol Secure (RTMPS) on your Pearl devices to encrypt content before it's
streamed over a TLS/SSL connection for secure live streaming. When enabled, Pearl Nano will always attempt
to validate the digital certificate it receives from the CDN to establish a secure RTMPS connection. The
connection will fail if Pearl Nano can't find the CA certificate of your CDN in it's list of certificates.
Pearl Nano has the CA certificates for many of the major CDNs already installed. For RTMPS streaming to workfor your particular CDN, or if you're using a proprietary RTMPS server, ensure that your streaming server's CA
certificate is uploaded to Pearl Nano, see Manage CA and self-signed certificates.

Set up an RTMP or RTMPS stream using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and choose RTMP push. The new stream is created using the default name Stream 1.
4. Click the stream name to see the stream settings.

238

Pearl Nano User Guide

Set up an SRT stream using rendezvous mode

5. Enter the URL of the ingestion point provided by the CDN or media server.
l

For RTMP push, enter rtmp followed by the rest of the URL, for example: rtmp://<server-ipaddress>:<port>/etc...

l

For RTMPS, enter rtmps followed by the rest of the URL, for example: rtmps://<server-ipaddress>:<port>/etc...

6. Enter the Stream name (which also is called a stream key by some CDNs)
7. (Optional) Enter a User name and Password.
The CDN provider assigns a user name and password to authenticate the publisher. Contact
the CDN provider for your log in credentials. Some CDNs, like YouTube and Facebook Live,do not require you to enter your log in credentials here.
8. (Optional) Rename the stream. Click the current name and enter a different name, then press Enter.
Refresh your browser if the new stream name doesn't immediately display.
9. Click Apply.
10. To start streaming, click Start or click Start all to simultaneously start this stream and any other streams
you have configured for this channel.
11. Click Delete this stream at any time to delete the stream.

Set up an SRT stream using rendezvous mode
Secure Reliable Transport (SRT) is an open-source streaming protocol that offers quality, low latency streaming
to CDNs and other SRT enabled decoders across unreliable Internet connections via UDP.
The easiest way to establish a link between the SRT source and destination devices is to use rendezvous mode.
In rendezvous mode, both the SRT source and destination device are ready to establish the SRT connection assoon as an SRT stream starts.

Typically, no intervention is needed from your IT administrator to traverse a firewall in rendezvous mode.
However, you can switch to SRT caller and listener modes if you experience difficulties streaming through afirewall in rendezvous mode, see Set up an SRT stream using caller and listener modes.

239

Pearl Nano User Guide

Set up an SRT stream using rendezvous modeTo establish the SRT connection between the source and destination devices in rendezvous mode, both devices
must be configured and ready to establish the connection between them. Each must know the IP address of theother device and both must be configured to use the same port for the SRT stream.
In the following example, a Pearl Nano is set up as SRT Source A (192.168.1.10) with port 20000 and another
Pearl Nano is set up as SRT Destination B (203.0.113.10) with port 20000.

240

Pearl Nano User Guide

Set up an SRT stream using rendezvous mode

Source A streams through Firewall A and Firewall B to Destination B, which ingests the SRT stream as a video
input with embedded audio. All traffic received at Firewall B that's addressed to 168.112.1.1 on port 20000
passes through the firewall directly to Destination B (203.0.113.10) because of the port number.

What's needed for this setupl

The public IP address of Source A (e.g. 198.51.100.20) and the public IP address of Destination B (e.g.
168.0.113.10).

l

The SRT streaming port that Source A is configured to use (e.g. port 20000).

l

Configure SRT Destination B to use the same port value as Source A for the SRT stream (e.g. 20000). If
the destination device is another Pearl Nano, you do this when adding the SRT stream as a video input
source using the Admin panel, see Connect an SRT stream as an input.

When you're configuring an SRT stream on Pearl Nano, you can also adjust the recovery bandwidth overheadusing the Admin panel. This setting defines how much of the stream's total bandwidth is dedicated for theexchange of SRT control and recovery packets between the source and destination. Ensure that the total SRT
stream bitrate (i.e. the bandwidth required for the stream plus the recovery bandwidth overhead) is less than the
network bandwidth you have available.

Set up Pearl Nano as a streaming source in rendezvous mode using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and choose SRT push. The new stream with the default name Stream 1 is created.
4. Click the stream name to expand the stream settings.
5. In the Connection mode field, select Rendezvous.
6. Enter the URL of the SRT destination (decoder) using the format srt://<decoder-ip-address>:<port>,
where the <decoder-ip-address> and <port> values are provided by the CDN, media server, or an SRT
decoder device such as a second Pearl Nano at the destination.
7. (Optional) Check Encryption and choose the AES key length if the SRT destination requires AES
encryption. These settings must match the encryption settings of the destination device, see Set AES
encryption and a passphrase for SRT.
8. (Optional) If the SRT destination has a required security Passphrase along with the AES encryption, you
can enter that here.
9. (Optional) In the Latency field adjust the amount of latency to apply to the stream. The default value is 125
ms.
We recommend using the default latency and recovery bandwidth overhead values for an
initial test stream. After you perform a test stream, you can determine the Quality of Service(QoS) and calculate the latency requirements. To set the SRT stream latency, see Adjust
latency and view the SRT stream status.

241

Pearl Nano User Guide

Set up an SRT stream using caller and listener modes

10. (Optional) In the Recovery bandwidth overhead field, adjust the % value of the bandwidth that's dedicate
for SRT control and recovery packets. The default value is 25%.
11. (Optional) Rename the stream. Click the current name and enter a different name, then press Enter.
Refresh your browser if the new stream name doesn't immediately display.
12. Click Apply.
13. When your ready to start streaming, click Start

What's next?
If you also need to set up Pearl Nano as an SRT destination and ingest an SRT stream from a remote source,
you must add the SRT stream as a input, see Connect an SRT stream as an input.

Set up an SRT stream using caller and listener modes
When setting up SRT streaming on Pearl Nano, you can configure Pearl Nano as an SRT source encoder andsend an SRT stream over the Internet to other SRT destinations (decoders) such as a CDN or another Pearl
Nano.
Caller and listener modes work together to establish the SRT link between your SRT source and destination
device when traversing the firewall is difficult and Rendezvous mode didn't work.

To establish an SRT link between the source and destination devices, ensure that one device is a Listener andthe other is a caller. The device you set as the caller (or listener) is arbitrary. If the destination device is set as thelistener and is ingesting multiple SRT sources, then all your SRT source devices must be set as callers.
In the following example, Pearl Nano is set up as SRT Source A (192.168.1.10) and another Pearl Nano is setup
as SRT Destination B (203.0.113.10). Source A is streaming through a firewall/NAT to Destination B, whichingests the SRT stream as a video input with embedded audio.

242

Pearl Nano User Guide

Set up an SRT stream using caller and listener modes

The public IP address of the Firewall/NAT is 168.112.1.1 and port 2000 is the designated SRT streaming port. All
traffic received at 168.112.1.1 on port 2000 is granted permission to pass through the firewall and is forwarded (C ) to Destination B's internal IP address (203.0.113.10) on port 3000.

What's needed for this setupl

The internal IP address of SRT Destination B (e.g. 203.0.113.10).

l

The SRT port value that was configured on SRT Destination B using the Admin panel when the SRT
stream was added as a video input source using the Admin panel (e.g. port 3000).

l

The public IP address of the firewall. An easy way to get the public IP address is to use a web browser anddo a Google search for "What is my IP address" (e.g. 168.112.1.1).

l

The IT administrator in charge of the firewall must open a port for the SRT stream (e.g. port 2000). The
port must allow 2-way traffic and route the traffic to the internal IP address and SRT port of Destination B.
In this example, traffic received at the firewall's public IP address 168.112.1.1 on SRT port 2000 is routed
to 203.0.113.10:3000.

243

Pearl Nano User Guide

Set up an SRT stream using caller and listener modes

When you're configuring an SRT stream on Pearl Nano, you can also adjust the recovery bandwidth overheadusing the Admin panel. This setting defines how much of the stream's total bandwidth is dedicated for theexchange of SRT control and recovery packets between the source and destination. Ensure that the total SRT
stream bitrate (i.e. the bandwidth required for the stream plus the recovery bandwidth overhead) is less than the
network bandwidth you have available.

Set up Pearl Nano as a streaming source in caller/listener mode using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and choose SRT push. The new stream with the default name Stream 1 is created.
4. Click the stream name to see the stream settings.
5. In the Connection mode field, select if this Pearl Nano is the caller or a listener.
a. If Caller is selected, do the following:i. In the URL field, enter the IP address of the SRT destination (decoder) using the format
srt://<decoder-ip-address>:<port>, where the <decoder-ip-address> and <port> could be
provided by the CDN, media server, or another SRT decoder device.
ii. (Optional) In the Source port field, enter the port number that this Pearl Nano should use for
SRT traffic.
b. If Listener is selected, enter the Port number that this Pearl Nano should use for SRT traffic. See
Network ports used by Pearl Nano to determine available ports.
6. (Optional) In the Stream ID field, enter a unique name for this stream.
7. (Optional) Check Encryption and choose the AES key length if the SRT destination requires AES
encryption. These settings must match the encryption settings of the destination device, see Set AES
encryption and a passphrase for SRT.
8. (Optional) If the SRT destination has a required security Passphrase along with the AES encryption, you
can enter that here.
9. (Optional) In the Latency field adjust the amount of latency to apply to the stream. The default value is 125
ms.
We recommend using the default latency and recovery bandwidth overhead values for an
initial test stream. After you perform a test stream, you can determine the Quality of Service(QoS) and calculate the latency requirements. To set the SRT stream latency, see Adjust
latency and view the SRT stream status.
10. (Optional) In the Recovery bandwidth overhead field, adjust the % value of the bandwidth that's
dedicated for SRT control and recovery packets. The default value is 25%.
11. (Optional) Rename the stream. Click the current name and enter a different name, then press Enter.
Refresh your browser if the new stream name doesn't immediately display.

244

Pearl Nano User Guide

Adjust latency and view the SRT stream status

12. Click Apply.
13. When your ready to start streaming, click Start

What's next?
If you also need to set up Pearl Nano as an SRT destination and ingest an SRT stream from a remote source,
you must add the SRT stream as a input, see Connect an SRT stream as an input.

Adjust latency and view the SRT stream status
Secure Reliable Transport (SRT) achieves high-quality, low-latency streaming across unreliable Internet
connections via UDP packets. If packets are lost in transit to the SRT destination, a request to retransmit the lost
packets is sent back to Pearl Nano. Using the Admin panel, you can adjust the latency to improve the Quality ofService (QoS) of the stream and reduce the number of dropped packets.
During the SRT stream, you can view the stream statistics using the Admin panel and adjust the amount oflatency based on the packet loss % and Round Trip Time (RTT). SRT stream statistics are provided on thestreaming configuration page for a channel when Pearl Nano is configured as an SRT source. If Pearl Nano is
configured as an SRT destination with an SRT input, then SRT statistics are available on the SRT input
configuration page.
The following example shows SRT statistics for an SRT stream. The statistics section appears only while an SRT
stream is active. It takes about 30 seconds for the statistics to appear after the SRT connection is established.

245

Pearl Nano User Guide

Adjust latency and view the SRT stream status

You can add from 80 ms to 8000 ms of latency to the SRT stream. Increasing latency gives more time to buffer
packets and resend any that got lost in transit to the destination. If the latency value set for the stream is too low
and there is packet loss over the network, retransmission of lost packets will not be possible and the stream
quality will suffer.
Latency can be configured at the source and at the destination. SRT uses the highest of the twolatency values.
The formula to calculate latency is:

SRT Latency = RTT Multiplier × RTT
where the recommended range of the RTT Multiplier is a value from 3 to 20.
The following table provides guidelines for what values to use when calculating latency. An RTT multiplier valueless than 3 is too small for SRT to be effective and a value above 20 indicates a network with 100% packet loss.
Ensure the measured buffer is less than or equal to the latency value you use.
Table 53 Suggested SRT latency values

Packet loss%

RTT multiplier

Recovery bandwidth overhead

Minimum SRT
latency(for RTT ≤ 20
ms)

% is ≤ 1

3

33

60

% is ≤ 3

4

25

80

% is ≤ 7

5

20

100

% is ≤ 10

6

17

120

These values are from the SRT Deployment Guide. For up-to-date calculations, visit www.srtalliance.org.

For example, if the % of packet loss is 0.53 and the measured RTT is 16.506 ms, the latency calculation is:49.518 = 3 × 16.506 ms or 50 ms of latency (rounded up).

246

Pearl Nano User Guide

Adjust latency and view the SRT stream status

Adjust latency and recovery bandwidth overhead for an SRT stream using the Admin
panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. View the SRT statistics for the active stream. Do one of the following:a. To open the SRT statistics from the Channel(s) menu, select the channel with the SRT stream toconfigure and click Streaming. The Streaming configuration page opens. Then select the arrow
beside the SRT stream to reveal the SRT stream statistics.
b. To open the SRT statistics from the Inputs menu, select the SRT input. Then on the SRT input
configuration page, select the arrow beside Statistics.

The statistics section only appears while an SRT stream is active.
3. In the Latency field, enter a numerical value from 80 ms to 8000 ms.
4. Click Apply.
We recommend testing your settings. Start the SRT stream and use the stream statistics to evaluate the effectthe latency and recovery bandwidth overhead values have on the packet loss % of the stream.

247

Pearl Nano User Guide

Set AES encryption and a passphrase for SRT

Set AES encryption and a passphrase for SRT
You can configure your Secure Reliable Transport (SRT) streams to use 128 bits, 192 bits, or 256 bits AES
encryption using the Admin panel. You can also assign the SRT stream an alphanumeric passphrase if required.
The encryption and passphrase settings on the SRT encoder sending the stream must match the settings on the
SRT decoder receiving the stream.
The encryption key length is negotiated between the source and destination devices. The key length of thesender is used to determine the key length that is eventually used to secure the connection, and the receiverobtains the key length from the sender. As long as the passphrases match, the key length will be negotiated.

Set up AES encryption and a passphrase for an SRT stream using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel with the SRT stream to configure and click Streaming.
The Streaming configuration page opens.
3. Click the arrowhead beside the SRT stream name to reveal the stream settings. In this example, the nameof the SRT stream is Stream 1.
4. Check Encryption and choose the Key length.
5. In the Passphrase field, enter the passphrase using alphanumeric characters (if required). The password
must be a minimum of 10 characters and maximum of 79 characters.
6. Click Apply.

Set up AES encryption and a passphrase for an SRT input using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, select the SRT input you want to configure. The SRT input configuration pageopens.
3. Check Encryption and choose the Key length.
4. In the Passphrase field, enter the passphrase using alphanumeric characters (if required). Special
characters are not supported.
5. Click Apply.

Set up an HLS (push) stream
HTTP Live Streaming (HLS) is an adaptive, HTTP-based streaming protocol that sends video and audio content
over the network in small, media segments that get reassembled at the streaming destination. Media segments
stream over HTTP port 80 or port 443 for HTTPS, which are typically open for network access. As such, thecontent can easily traverse firewalls with little to no IT involvement.
Pearl Nano can send a single resolution and bitrate HLS stream as an HTTP POST (or HTTP PUT) to HLS
ingestion servers and CDNs such as Akamai and YouTube. The default is HTTP POST. Your channels on Pearl
Nano must be configured for H.264 or preferably H.265 on Pearl Nano and AAC audio codec to stream using
HLS. Pearl Nano supports MD5, SHA-256, and SHA-512 hashing algorithms to authenticate the stream.

248

Pearl Nano User Guide

Set up an HLS (push) stream

HLS uses an MPEG2-TS transport stream container with a configurable media segment duration, as well as aconfigurable playlist size for reassembling the media segments at the ingestion server. Because HLS favors
Quality of Service (QoS) over low-latency, lag times that can be high. If a specific media segment size isn't
required by the ingestion server, then you can shorten the duration of the media segment to decrease latency.
The default segment duration is six seconds.
Using the Admin panel, you can add advanced features like a master manifest, which is an address applied toeach individual media playlist in the stream. You can also assign the HLS stream a user name and password. If
security and authentication credentials are required to stream to the ingestion server, consult the ingestion
server provider.

Important considerationsl

Only a single resolution and bitrate stream is supported.

l

See Suggested stream settings for the best streaming settings for Pearl Nano.

lFragmented MP4 is not supported.

l

If the HLS ingestion server requires a custom user-agent name, add that to the HLS stream in the
Advanced settings using the Admin panel and ensure the agent-name is added to the HLS ingestion
server's white list. Contact the IT administrator responsible for the ingestion server.

l

If the HLS ingestion server requires a user name and password, you can get those credentials from the IT
administrator responsible for the ingestion server.

Set up an HLS (push) stream using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and choose HLS push. The new stream is created using the default name Stream 1. To
see the settings, click the stream name.
4. In the Media Playlist URL field, enter the URL of the destination server that is ingesting the stream. For
example: http://p-ep721023.i.akamaientrypoin.net/722223/hlsQualification/my_video.m3u8
5. (Optional) In the Segment template field, enter the naming format used for the names of media
segments. For example: chunk-$Number%05d$.ts
6. (Optional) Enter a Username and Password if required for this stream. Get this from the ingestion server
provider.
7. In the Method field, select POST or PUT. This selection must match the requirements of the ingestion
server.
8. In the Segment duration field, enter the length of the media segment in seconds. The default duration issix seconds. Fractions and periods are not supported.
9. In the Playlist size field, enter the number of .ts segment files in each segment. The default playlist size is
six.

249

Pearl Nano User Guide

Set up an RTSP announce stream

10. (Optional) Under Advanced settings, you can set the following:a. Master manifest: Enter the URL (including the master playlist file name) of where Pearl Nano will
upload the master manifest file. The master playlist also provides the bitrate, resolution, and codec.
b. User-agent: Enter a user-agent name using alphanumerical characters only if the ingestion server
requires a specific value in the user-agent header to allow the incoming stream from this device.
11. Click Apply.
12. When you're ready to start streaming this channel, click Start.

Set up an RTSP announce stream
Pearl can stream using RTSP announce. Viewers can copy and paste the URL of the RTSP stream into a media
player and watch the stream on their local network. For more information about using RTSP streaming, see
Share a live broadcast stream (HTTP, HTTPS, or RTSP).

Setup an RTSP announce stream using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and choose RTSP announce. The new stream is created using the default nameStream 1.

4. Click the stream name to see the stream settings.
5. (Optional) To rename the stream, click the current name and type a different name, then press Enter.
Refresh your browser if the new stream name doesn't immediately display.

250

Pearl Nano User Guide

Set up a stream to the CDN using an XML profile

6. Enter the following parameters:l

The URL of the ingestion point provided by the CDN or media server.

l

Select the Transport type as either UDP or TCP. Consult your CDN provider to find out whichtransport protocols the CDN supports.

l

The CDN User name and Password (if required).
The CDN provider assigns a user name and password to authenticate the publisher. Contact
the CDN provider for your log in credentials.

7. Click Apply.
8. To start streaming, click Start or click Start all to simultaneously start this stream and any other streams
you have configured for this channel.
9. Click Delete this stream at any time to delete the stream.

Set up a stream to the CDN using an XML profile
Some CDNs provide an XML file for easy configuration setup. Pearl Nano supports using XML profiles to set a
stream.

Set up a stream using an XML profile from the CDN
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel menu, select the channel and click Streaming. The Streaming configuration pageopens.

251

Pearl Nano User Guide

Start and stop streaming to a CDN

3. Click New stream and select Use profile XML.
4. Select the XML file that was provided by your CDN provider, then click OK. The new stream is createdusing the default name Stream 1 and the configuration from the XML file is applied.

5. Click Apply.
6. To start streaming, click Start or click Start all to simultaneously start this stream and any other streams
you have configured for this channel.
7. Click Delete this stream at any time to delete the stream.

Start and stop streaming to a CDN
After your stream to a CDN is configured on the channel, you can start and stop streaming.
Start and stop your stream using:lthe admin panellEpiphan Edgelthe front screen streaming button or the front screen menu. When you use the front screen menu, you canalso modify the URL of a chosen stream.

Start and stop streaming using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select a channel and click Streaming. The Streaming configuration pageopens.
To set up a stream using the Admin panel, click New stream and follow the instructions for
how to Streaming to a CDN, multicasting, and streaming to multiple destinations.

252

Pearl Nano User Guide

Multicast streaming

3. Click Start at the top right corner to start that stream, or click Start all at the top of the page to start
streaming all streams that are configured for the channel.
4. Click Stop at the top right corner to stop that stream, or click Stop all at the top of the page to stop
streaming for all streams that are configured for the channel.

Start and stop streaming using the front screen menu
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.
2. Use the arrow and check mark keys to select Channel. Then from the Channel screen, select Streaming
to open the Streaming screen with the list of streams already configured for the channel.
3. Use the arrow and check mark keys to select a stream and open the stream's details screen.
4. From the stream's details screen, use the arrow keys to highlight Start and press the check mark key start
streaming. When you're done, highlight Stop and press the check mark key to stop streaming.
Before you start the stream, you can select Destination url using the check mark key andmodify the stream destination's URL.

Start and stop streaming using the Stream control key on the front panel
Simply press the Stream control key on Pearl Nano's front panel to easily start and stop streaming a channel.
The Stream control key glows solid blue and the streaming timer on the Channel view increments while
streaming is in progress. When you're done, press the Record control key again to stop streaming. If multiple
streams are configured for the channel, pressing the Stream control key starts and stops all streams at the sametime. For more information, see Record and stream using the control keys.

Multicast streaming
You can add multiple multicast streams to a channel in Pearl Nano. A multicast stream consists of one stream
distributed to many viewers via a multicast-capable network. You can stream to several multicast networks andat the same time, stream to non-multicast CDNs.
Pearl Nano supports multicast streaming to an IP TV or a set-top box playlist using SAP when the stream format
is MPEG-TS.

253

Pearl Nano User Guide

MPEG-TS streams using RTP/UDP push

Topics include:l

MPEG-TS streams using RTP/UDP pushl

MPEG-TS streams using UDP pushlMulticast streaming using RTP/UDPl

Set up traffic shapinglViewing with Session Announcement Protocol (SAP)MPEG-TS streams using RTP/UDP push
When you configure an MPEG-TS stream using RTP/UDP push, you have the option to enable SAP and
multicast over a local network at the same time.
Before configuring your channel for MPEG-TS streaming, ensure the following codecs are configured:lVideo – H.264

l

Audio – MP3 or AAC, if audio is configured.

If you're streaming to 10/100 Mbps set-top boxes over Gigabit Ethernet and you notice frames are dropping, you
can limit the bandwidth of the stream, see Set up traffic shaping.

Configure a channel for MPEG-TS using RTP/UDP push and enable SAP
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and select MPEG-TS RTP/UDP push.

254

Pearl Nano User Guide

MPEG-TS streams using RTP/UDP push

4. Enter the destination multicast IP address where the broadcast can be viewed.
A IPv4 multicast address range is an address between 224.0.0.0 to 239.255.255.255.
Contact your System Administrator for the specific address to use.

255

Pearl Nano User Guide

MPEG-TS streams using UDP push

5. Enter the destination port number through which the media will stream.
6. (Optional) To advertise your stream to a media player over a local network, do the following:a. Check SAP announcement to enable advertising your stream over a local network. When this isenabled and a multicast IP address is configured, your stream is displayed in the playlist of thelocal media player.
b. Enter a multicast IP address in the SAP announcement IP field. If your media player is configured
to receive multicast streams from an IP address that is different from the default address
224.2.127.254, you may need to contact your system administrator for a specific multicast IP
address.
c. Enter a channel number in the Channel number field to identify your stream in the media player.
By default, the Channel number is the channel identifier.
When a channel number value is not specified, viewers cannot select a channel
from the set-top box or Smart TV .
d. Enter a name for a group of streams in the text box next to Group name. Since media players
simply present a list of available streams, you can organize your streams into multiple folders or incases where folders are not displayed, use dot separator hierarchy to help your viewers filter out
unwanted streams by category.
7. Click Apply.
8. Select Start when you're ready to start streaming.
9. Select the Info menu to see the stream information.

View the MPEG-TS RTP/UDP stream
To view the stream from a media player, open the URL in the media player, for example:
rtp://@ip:port or in the case of the sample configuration in the figure shown above:
rtp://@226.10.24.32:7000
To view the stream when SAP announce has been set and the stream is advertised on a media player, set-top
box, or Smart TV, refer to Viewing with Session Announcement Protocol (SAP).

MPEG-TS streams using UDP push
When you configure an MPEG-TS stream using UDP push, you have the option to enable SAP and multicast
over a local network at the same time.
Before configuring your channel for MPEG-TS streaming, ensure the following codecs are configured in theencoding section:

256

Pearl Nano User Guide

MPEG-TS streams using UDP pushlVideo – H.264 or H.265 for Pearl Nanol

Audio – MP3 or AAC, if audio is configured.

To configure MPEG-TS with UDP push and enable SAP:
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and select MPEG-TS UDP push.
4. Enter the destination multicast IP address where the broadcast can be viewed.
A IPv4 multicast address range is an address between 224.0.0.0 to 239.255.255.255.
Contact your System Administrator for the specific address to use.
5. Enter the destination port number through which the media will stream.
6. (Optional) To advertise your stream to a media player over a local network, do the following:a. Check SAP announcement to enable advertising your stream over a local network. When this isenabled and a multicast IP address is configured, your stream is displayed in the playlist of thelocal media player.
b. Enter a multicast IP address in the SAP announcement IP field. If your media player is configured
to receive multicast streams from an IP address that is different from the default address
224.2.127.254, you may need to contact your system administrator for a specific multicast IP
address.
c. Enter a channel number in the Channel number field to identify your stream in the media player.
By default, the Channel number is the channel identifier.
When a channel number value is not specified, viewers cannot select a channel
from the set-top box or Smart TV .
d. Enter a name for a group of streams in the text box next to Group name. Since media players
simply present a list of available streams, you can organize your streams into multiple folders or incases where folders are not displayed, use dot separator hierarchy to help your viewers filter out
unwanted streams by category.
7. Click Apply.
8. Select Start when you're ready to start streaming.

View the MPEG-TS UDP stream
To view the stream from a media player, open the URL in the media player, for example:

257

Pearl Nano User Guide

Multicast streaming using RTP/UDP

udp://@ip:port
For example: udp://@226.10.24.32:7000
To view the stream when SAP announce has been set and the stream is advertised from a media player, set-top
box or Smart TV, refer to Viewing with Session Announcement Protocol (SAP).
If you're streaming to 10/100 Mbps set-top boxes over Gigabit Ethernet and you notice frames are dropping, you
can limit the bandwidth of the stream, see Set up traffic shaping.

Multicast streaming using RTP/UDP
You configure an RTP/UDP (push) stream on Pearl Nano using the Admin panel.
If you're streaming to 10/100 Mbps set-top boxes over Gigabit Ethernet and you notice frames are dropping, you
can limit the bandwidth of the stream, see Set up traffic shaping.

Configure a channel to stream using RTP/UDP push
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and select RTP/UDP push.
4. Enter the following:lDestination multicast IP address.

l

Audio port number through which the audio will stream.

lVideo port number through which the video will stream.

Audio and video use nearby port numbers (<port number>and <port number+2>). The minimum
distance between audio and video ports must be 2.
5. Click Apply. An SDP file is generated.
6. From the channel's Status page, click the SDP file to download it. Provide the SDP file name and location
if prompted.
7. Share the file with your viewers and when you're ready to start streaming, select Start.

Set up traffic shaping
If you're multicasting to set-top boxes that have 10/100 Mbps interfaces on the same Gigabit Ethernet and you
notice frames are dropping, you can limit the bandwidth of the stream using traffic shaping to adapt for the lower
bandwidth set-top boxes. Only multicast streams support traffic shaping: MPEG-TS USP, MPEG-TS RTP/UDP,
and RTP/UDP.

258

Pearl Nano User Guide

Set up traffic shaping

If traffic shaping was previously setup using the API, we recommend switching to this method ofsetting traffic shaping using the Admin panel. If traffic shaping is currently setup using Pearl Nano's
API, see the Technical Notes for your Pearl Nano model for instructions. They're available from theproduct resources page on the Epiphan.com website.
When traffic shaping is enabled, the default bitrate limit is set to auto. In auto mode, the bitrate is limited to thesum of the channel's configured bitrate plus 4 Mbps and is adjusted to fit within the range of 4 Mbps minimum to
95 Mbps maximum.
You can also set a bitrate limit for the maximum amount of bandwidth that gets streamed using the Admin panel
when traffic shaping is enabled. When you do, the streamed video won't exceed the maximum bitrate you set.
The valid bandwidth limit bitrate range is 4 Mbps to 95 Mbps. We recommend that you set the bitrate to a value
no less than the channel encoding bitrate plus 4 Mbps.
For example, if the bitrate for the channel is set to 10 Mbps in the encoding settings, the minimum value werecommend for the bandwidth limit bitrate is 14 Mbps.

Important considerationslTraffic shaping works for the local switch. Switches connected to the local switch don't respect the policy.

l

If the channel encoding bitrate is set to a value that's less than 4 Mbps and traffic shaping is enabled, theminimum bandwidth limit does not drop below than 4 Mbps.

l

If the channel encoding bitrate value is greater than 95 Mbps and traffic shaping is enabled, the maximum
bandwidth limit does not exceed 95 Mbps.

l

If the bandwidth limit is set to auto and the total of the channel bitrate plus 4 Mbps exceeds 95 Mbps, themaximum bandwidth limit does not exceed 95 Mbps.

l

After enabling traffic shaping for a channel using the Admin panel, you can no longer use the Pearl Nano
API to clear or configure traffic shaping for that channel. If you currently use the API to configure traffic
shaping, see the Technical Notes for your Pearl Nano model for instructions. They're available from theproduct resources page on the Epiphan.com website.

After traffic shaping is enabled, we recommend that you first test a multicast stream using the auto traffic shaping
settings. If your low bandwidth network device is displaying poor video quality, then go ahead and manually set
the limit bandwidth bitrate according to the bandwidth of your particular network device.

Set traffic shaping for a multicast stream using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Streaming. The Streaming configuration pageopens.
3. Click New stream and select a multicasting stream as the type: MPEG-TS USP, MPEG-TS RTP/UDP, or
RTP/UDP. The new stream is created with the default name Stream 1.
4. Click the stream name to see the stream settings.

259

Pearl Nano User Guide

Viewing with Session Announcement Protocol (SAP)

5. Check Limit bandwidth. The default bitrate is set to auto.
6. (Optional) Set the Limit bandwidth rate and enter a bitrate value from 4,000 kbps to 95,000 kbps.
7. Click Apply.

Viewing with Session Announcement Protocol (SAP)
When SAP Announce is configured for a stream that uses UDP streaming, the stream is advertised over the local
network. Local viewers can view the stream using a software or hardware media player. Viewers are presented
with a list of available channels, similar to a television menu. Viewers need only click on a stream and the video isstreamed to their desktop, mobile or tablet. To configure SAP announce, go to Multicast streaming.
Your stream is advertised by the metadata title, if one was configured; otherwise, the stream is identified by its
channel identifier. For Pearl Nano, the channel identifier is always 1. For a description of how to set the
metadata, refer to Add or remove channel metadata.
When browsing from a VLC media player, streams are advertised by their channel identifier and are organized by
the group name. When browsing from an XBMC media player, streams are advertised by the stream's metadata
title (if configured); otherwise, streams are advertised by their channel identifier.

View the Session Annoucement Protocol (SAP) stream
1. Ensure the stream has SAP announcement enabled; otherwise, it is not advertised in the media player's
playlist.

260

Pearl Nano User Guide

Viewing with Session Announcement Protocol (SAP)

2. Ensure the SAP announcement IP is a multicast IP address.
Some media players, for example Exterity receivers, listen for SAP announcements on a
specific multicast address 239.255.255.255. If your audience is using Exterity to view yourstream, you must change the SAP announcement IP address to 239.255.255.255.
3. Launch a media player and play the streams.
a. Using VLC, click View and select Playlist. The right-hand panel indicates the playlist is empty.
b. From the side menu, click Network streams (SAP). The playlist is populated with all streams inyour network that are SAP announcement enabled. If you specified a Group Name when you
configured the publish stream the stream will be listed in folder identified by the group name.
c. Click on a live stream in the playlist to play the stream.
This VLC example shows two streams D2P83658.vga and D2P83658.video, which are organized in afolder by their group name.

261

Pearl Nano User Guide

Streaming to a media player or smart TV

Streaming to a media player or smart TV
Your Pearl Nano can use SAP to stream to set-top boxes, digital signs, smart TVs and other digital media
players.
The following table gives an overview of how this works.
Publishing Options

Use this option to...

SAP

SAP (session announcement protocol) is a protocol for broadcasting
multicast session information. You can enable SAP and stream over a local
network when MPEG-TS multicast streaming is configured, see Multicast
streaming.
Media players can see the announcement or can use the multicast SDP file
(session description file) directly, see Viewing with Session Announcement
Protocol (SAP).

To stream video outside of your LAN, use a CDN or configure port forwarding on your router. Referto your Network Administrator. Network configuration is beyond the scope of this guide.

262

Pearl Nano User Guide

RecordRecordYou can stream your content and record it at the same time. Pearl Nano encodes the video and audio it captures.
There are different ways to download recordings, like automatically downloading recordings to a USB memory
device. For Pearl Nano, an SD card or a SATA M.2 2280 SSD must be installed to record content, see SD card
and SATA M.2 2280 SSD storage.
Topics include:lAbout recordingl

Record a channellConfigure recording settings, file size, and typel

Restart recording to a new filelManage recorded fileslAutomatic file transfers

For instructions on how to use Pearl Nano's front screen to start/stop scheduled recordings for a CMS event, see
Stop/start scheduled CMS events using Pearl Nano's front screen menu.
For information about recording with Content Management Systems (CMSs), see CMS recording andwebcasting control.

About recording
You can record a channel on Pearl Nano as AVI, MOV, MPEG-TS, MP4, or MP4-Fragmented. Easily stop andstart recording using any of the following:
Epiphan product

Admin panel

Device screen

Epiphan Edge

EpiphanLive

Pearl Nano

Yes

Yes (Use front panel control
keys)

Yes

No

If an accidental system shutdown occurs while recording is in progress, your recordings are closed off so they
are still playable. Physically unplugging a video source from the input port or otherwise interrupting the signal
does not stop recording. A No Signal image is inserted.
Pearl devices also come with APIs so you can setup third party tools to control recording, see the Pearl System
API Guide for details.
If PoE+ power is interrupted while Pearl Nano is actively recording, the recorded file could become
corrupted and be unplayable.
You can set the maximum recording time or file size limit using the Admin panel. The default recording limits are
set to 30 minutes or 500 MB, whichever comes first. When the time or file size limit is reached, the current

263

Pearl Nano User Guide

About recording

recording is saved and a new recording file starts automatically without losing any content. When the local drive
is full, newer recordings overwrite oldest recordings.

Important considerationsl

If recordings are selected for Automatic File Upload (AFU) while AFU is at maximum upload capacity or
when AFU is unavailable, the recordings are added to an upload queue. If there is no available space left
in the storage medium, new recordings fail and do not overwrite recordings in the AFU queue.

l

For information about recording to Content Management Systems (CMSs) like Kaltura and Panopto, see
CMS recording and webcasting control.

lPearl Nano - While actively recording a channel that includes a layout with multiple video input sources, a
new file is created if an additional video input source is added to the channel.

lPearl-2 and Pearl Nano - If the channel that is recording is an auto channel, a new recording is started if
the video input source automatically switches from one video source to another due to signal loss.

Tested media players
Epiphan has tested recordings with the following players. See Troubleshooting Quick Reference for known
player issues.
Table 54 Tested Media Players
Operating System

Tested PlayerslQuickTime 10.3lQuickTime 7.6.6+l

VLC 2.2.4

lPlayback Pro 2.3.2

lFinal Cut Pro 10.3.2lAdobe Premiere Pro CC 2017l

QuickTime 7.6.6+l

VLC 2.2.6

lWindows Media player 12+lMovies & TV (Windows 10)l

Adobe Premiere Pro CC 2015l

MPlayerl

VLC 2.2.2

lGoogle Chrome 37+ (works with MOV and MP4 files using H.264 codec)

Mac OS

Windows

Linux
HTML 5 Browsers(Windows)

264

Pearl Nano User Guide

Pearl Mini and Pearl Nano recording storage information

Not all media players and editors support all recording formats, such as the more modern MP4fragmented format. To playback MOV files created by the Pearl device, we recommend using a
newer media player.

Pearl Mini and Pearl Nano recording storage informationl

An SD card (or a SATA M.2 2280 SSD on Pearl Nano) must be installed to record, see SD card andSATA M.2 2280 SSD storage.

lAfter an SD card is formatted using Pearl Nano or Pearl Mini, do not manually change the default file
folder structure on the SD card.

lEjecting the SD card while the recording is in progress may corrupt the SD card and cause loss of data.
Power down the Pearl device before ejecting the SD card. Stop all recording before powering down thesystem.

l

The maximum file size cannot be larger than a quarter of the total available space on the SD card. For
example, the maximum file size limit for a 64 GB SD card is 16 GB. A warning appears if you set a file size
limit that is bigger than a quarter of the SD card capacity.

l

If you set the file size limit and then swap in a smaller SD card, you must change the file size limit to asmaller size using the Admin panel if the file size limit is bigger than the SD card.

l

Recording with a file size limit that exceeds the size of the SD card will corrupt the SD card.

l

Newer recordings overwrite oldest recordings when the amount of free space on the SD card (or M.2
SSD) is less than the configured recording file size limit.

l

The SD card is formatted for Ubuntu systems and is not compatible with Windows and Mac devices. To
download recordings, see Manage recorded files.

l

We recommend using large capacity SD cards such as 256 GB (or a large capacity M.2 SSD when using
Pearl Nano) with a CMS. Do not schedule recordings that are longer than the capacity of the storage
device to store the recording to the storage medium.

l

We recommend using large capacity SD cards such as 256 GB or more when using a CMS. Do notschedule recordings that are longer than the capacity of the Pearl device to store the recording.

l

If you create multiple recorders and start recording them at the same time, the SD card will be corrupted if
the total of the file size limits for each recorder exceeds the size of the SD card.

l

For instructions on how to use Pearl Nano's front screen to start/stop scheduled recordings for a CMS
event, see Stop/start scheduled CMS events using Pearl Nano's front screen menu.

l

The maximum file size cannot be larger than a quarter of the total available space on the SD card. For
example, the maximum file size limit for a 64 GB SD card is 16 GB. A warning appears if you set a file size
limit that is bigger than a quarter of the SD card capacity.

l

If you set the file size limit and then swap in a smaller SD card, you must change the file size limit to asmaller size using the Admin panel if the file size limit is bigger than the SD card.

l

Recording with a file size limit that exceeds the size of the SD card will corrupt the SD card.

265

Pearl Nano User Guidel

Record a channel

Newer recordings overwrite oldest recordings when the amount of free space on the SD card is less thanthe configured recording file size limit.

Record a channel
Using the Admin panel , you can start and stop recording a channel, as well as configure recording settings forthe channel. You can also start and stop recording using Epiphan Edge, or:l

Pearl Nano - the Record control key on the front panel

In the Admin panel, the channel number turns red to indicate it's recording. If the system runs out of storage
space, the oldest recorded file is deleted to make room for the new recording.

If PoE+ power is interrupted while Pearl Nano is actively recording, the recorded file could become
corrupted and be unplayable.

Start and stop recording using the Admin panel
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.
2. From the Channel(s) menu, select the channel and click Recording. The channel recording menu opens.
3. Select Start to start recording the channel and select Stop when you're done.

If the Start button is not active, there are no active sources for the channel. Check yourinputs to ensure signals are working as expected.

Start and stop recording using the Record control key on the Pearl Nano
Simply press the Record control key on Pearl Nano's front panel to easily start and stop recording a channel.
The Record control key glows solid red and the recording timer on the Channel view increments while recording

266

Pearl Nano User Guide

Record a channel

is in progress. When you're done, press the Record control key again to stop recording. For more information,
see Record and stream using the control keys.

Start and stop recording using the front screen menu on Pearl Nano
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select Channel. Then from the Channel screen, select Recording
to open the Recording screen.

3. From the Recording screen, use the arrow keys to highlight Start and press the check mark key start
recording. When you're done, highlight Stop and press the check mark key to stop recording.

267

Pearl Nano User Guide

Configure recording settings, file size, and type

Configure recording settings, file size, and type
Recordings are saved as MP4 files by default. Each channel and recorder also has a file size limit set to 500 MB
and the maximum file length set to 30 minutes by default. When a recording reaches the file length of 30 minutes
or 500 MB (whichever comes first), the system closes the current recording file and immediately opens a newone. No recorded data is lost.
If you don’t know what size to select, do some test recordings to get an idea of the file sizes
you can expect. If you want to guarantee the recording lasts to a given time limit, select a filesize that is far larger than you saw in your tests.

Important considerationsl

You cannot change the recording settings, file size, and type for channels used with Kaltura events.

l

The file recording type for a channel you are controlling and recording using Epiphan Edge must be set toMP4 and the maximum file size supported is 500 MB.

The following table describes the recordings configuration settings.
Table 55 Recordings Configuration Settings
Label

Description / Options

Time limit

Specifies the length of time the system waits before the recording file is saved and a new
one is started (assuming the size limit has not yet been reached). Values range from 5
minutes to unlimited. The MOV file type on Pearl is limited to a maximum duration of
13h15m, regardless of the value set in the Pearl UI.

Size limit

Specifies the maximum file size a recording can reach before it is saved and a newrecording is started (assuming the time limit has not yet been reached).
l

Pearl Mini and Pearl Nano - maximum storage depends on the size of the SD
card (or SSD on Pearl Nano) installed

Specifies the recording file type. Select from AVI, MP4, MP4-Fragmented, MPEG-TS, or
MOV.

File typel

AVI: Generally used for playback on Windows.

lMP4: A progressive version of MP4. Select MP4 for the best compatibility withmost video players and editors. Progressive MP4 files are initially recorded as
MP4-Fragmented and are converted when the recording ends.
If the recording is stopped while in progress or during conversion, the files
remain in fragmented MP4 format. You can run the file through ffmpeg or
another transcoder to convert to the progressive format.

268

Pearl Nano User Guide

Label

Restart recording to a new file

Description / OptionslMP4-Fragmented: A newer MP4 format. Fixed 10 second intervals. Select MP4Fragmented for the same file format as releases 3.15.x. Some applications, like
Adobe Premiere Pro, don't yet support fragmented MP4.
There's no way to tell the difference between MP4 files and MP4-Fragmented files
from the file name because both use the .mp4 extension.

l

MPEG-TS:Does not support PCM audio encoding.

l

MOV: A progressive version of MOV. Generally used for playback on Mac OS.
This type of MOV has the best compatibility with video players and editors.

Specifies how the recordings are named. Recording files start with the given prefix
followed by the date and time of the recording, which is set by the system. The channel orrecorder name is used if no prefix is given. Allowed characters: A-Z, a-z, 0-9, _, , #, -, [], ().

Filename prefix

Avoid using spaces in recording file names. Use underscores or hyphens to separate
words instead.
Automatic file
uploadSelect this if you want this channel or recorder to be part of any scheduled automatic
uploads. See Automatic file transfers for information on automatic uploads.

Change the recording configuration using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Channel(s) menu, select Recording. The recording page opens.
3. Under Recorder Setup, select change. The recorder settings open.
4. Change the default recording file settings.
lTime limit: Select a value from 5 minutes to unlimited.

lSize limit:llPearl Nano - Select a value from the listed options. The range depends on the size of the
SD card or M.2 SSD installed.

File type: AVI, MPEG-TS, MOV, MP4, or MP4-Fragmented.

5. (Optional) Enter a prefix for the recordings. All new recorded files for this channel or recorder will be
prefixed using the text you enter.
6. (Optional) Check the check box to exclude this channel from automatic file uploads, see Automatic filetransfers.
7. Click Apply.

Restart recording to a new file
Recordings are automatically saved to a file and a new recording is started when:269

Pearl Nano User Guide

Restart recording to a new filel

The recording reaches the configured time or size limit.

l

The channel name is changed.

lChanges are made to the stream if recording and streaming the channel.

You can manually force a recording that's in progress to save to a file and continue recording in a new file fromthat point forward without any loss of content. This is useful if you need to download a recording since you cannot
download recordings that are in progress.

Restart recording to a new file using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. Pearl Nano - From the Channel menu, select Recording. The Recording page opens.

3. Select Reset to stop the current recording and start a new recording.
4. Refresh the page to see the updated list of recordings.

270

Pearl Nano User Guide

Manage recorded files

Manage recorded files
Pearl Mini and Pearl Nano save recordings by default to the SD card (or SATA M.2 2280 SSD on Pearl Nano).
When the SD card is full, new recordings overwrite the oldest recordings. You can not manually transfer
recordings off the SD card to iOS or Windows systems.
There are a variety of ways to automatically transfer files from the system to local network storage. You can also
manually select individual recordings to transfer or delete using the Admin panel.
For information about automatic file transfers, see Automatic file transfers.

Manage the recordings for a channel using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. Pearl Nano - From the Channel menu, select Recording. The Recording page opens.
3. All recordings are listed and sorted by date.
Files that are part of the same recording session are listed one after another. Three dots appear between
files of different recording sessions. The file currently being recorded (if applicable) is shown at the top of
the list. It cannot be modified or downloaded until it has finished recording.
4. If there are no recordings, a message indicates there are no recorded files for this channel or recorder.

l

To download an individual file, select the recording filename to download it.

lTo download multiple files, select the check box next to the recordings to download and then click
Download Selected. The files are download as a .zip file containing the selected recordings.

l

To rename a recorded file, select the edit icon next to the file name you want to change. Type the new filename and press Enter using your keyboard.

lTo view a recorded file, click on the triangle Play button next to the file you want to play back. This will
open the video file in an HTML5 player within the browser for viewing.
The Admin panel keeps track of the filename extension (i.e. .avi) so you do not need toinclude it when renaming the file.

l

To delete a single recording, click the X icon to the right of a recording and click OK when prompted.

l

To delete multiple recordings, check the check box beside the recordings you want to delete, then click
Delete Selected. Click OK when prompted.

l

To delete all recordings for the channel, click Delete All and click OK when prompted.

271

Pearl Nano User Guide

Join recorded files together

The list may not update immediately. You can refresh the list by reloading the Recording page(for channels) or the recorder settings page (for recorders).
For information about automatic file transfers, see Automatic file transfers.

Join recorded files together
After recording files on Pearl Nano, you can join two or more files together. This is useful when a recording
exceeds the maximum recording time limit and the recording is split into multiple files. You can use the third-party
tool called ffmpeg to join the files.

Download ffmpeg from the Internet and join multiple recorded files
1. Download the files that you need from Pearl Nano and make sure you have the right paths and file names.
For example:

C:\Users\JoesComputer\downloads\Program_A_May11_16-24-56.avi
2. Use the command ffmpeg -i to specify the input file. For example:

ffmpeg -i C:\Users\JoesComputer\downloads\Program_A_May11_16-24-56.avi
3. Repeat the process and specify the file you want to join to the first file. You can keep adding as many files
as you want to join together. For example, specifying a second file looks like this:

ffmpeg -i C:\Users\JoesComputer\downloads\Program_A_May11_16-24-56.avi -i
C:\Users\JoesComputer\downloads\Program_A_May11_12-26-14.avi
4. Use the -c copy command to specify the output file. After the command, type in the location, file name andfile extension that you want for the concatenated file. The full line looks like this:
ffmpeg -i C:\Users\JoesComputer\downloads\Program_A_May11_16-24-56.avi -i
C:\Users\JoesComputer\downloads\Program_A_May11_12-26-14.avi -c copy
C:\Users\JoesComputer\Desktop\Concatenated_File.avi
5. After completing the process, you will be able to access your new file in the location you specified. The file
moves straight from the first video into the second without a pause.
You can this process to join multiple files; however, the more files you join, the greater the chancethat some audio desychronization can occur between the clips.

272

Pearl Nano User Guide

Automatic file transfers

Automatic file transfers
Pearl Nano can be configured to automatically upload recordings from local storage to a network storage
location or an attached USB drive. This is called Automatic File Upload, or AFU for short. You can schedule
automatic file uploads for a time and day that's most convenient for your workflow.
Topics include:lAbout Automatic File Upload (AFU)l

Set channels and recorders to include in AFUlEnable AFU, schedule, and set optionslConfigure AFU to FTP server parameterslConfigure AFU to SFTP server parameterslConfigure AFU to RSync server parameterslConfigure AFU to CIFS server parameterslConfigure AFU to SCP client parameterslConfigure AFU to AWS S3 parameterslConfigure AFU to WebDav server parametersl

AFU or copy to USB

To manage the AFU queue and view the AFU upload logs:l

Add recordings to an AFU queuelManage the AFU queuelView AFU and file transfer progresslManage USB file transfer queuelView the AFU log

About Automatic File Upload (AFU)
Pearl Nano can automatically upload recorded files to an accessible off-system storage location. You can set thefile transfer to happen after a set amount of time or after the file completes recording.
There are additional settings to help you manage your AFU recordings and avoid file name collisions at the AFU
server side. You can:lAutomatically create a folder for your recorded files using the channel name.

lSave recordings to a folder that's labeled using Pearl Nano's serial number.

Automatic File Upload (AFU) is not enabled by default. You must enable this feature for a channel that you want
included in automatic file transfers. A log file of all file transfers is created that you can view anytime from theAdmin panel.
The following types of off-system storage are supported for AFU:

273

Pearl Nano User Guidel

FTP/SFTP

l

RSync

l

CIFS

l

SCP

l

Amazon Web Server 3 (AWS S3)l

WebDavl

USB Drive

Set channels and recorders to include in AFU

Important considerationsl

Only one type of AFU can be used for all file transfers from the same channel.

lAutomatic File Upload (AFU) is not available while Content Management System (CMS) is enabled on
Pearl Nano.

l

Files are automatically uploaded only once. New recordings created during later sessions do not overwrite
files that were previously uploaded. A new file is uploaded.

l

If the connection is lost during the transfer, the transfer automatically restarts when the connection isreestablished.

l

If recorded files are selected for upload while the AFU is at maximum upload capacity or when the AFU isunavailable, they are added to an upload queue. Files and their relevant information are displayed in a list
and are uploaded when the upload capacity becomes available.

l

If recordings are selected for Automatic File Upload (AFU) while AFU is at maximum upload capacity or
when AFU is unavailable, the recordings are added to an upload queue. If there is no available space left,
new recordings fail and do not overwrite recordings in the AFU queue.

Set channels and recorders to include in AFU
When configuring automatic file upload (AFU), you need to tell the system which channels and recorders you
want included in the upload schedule. If no channels or recorders are configured as a part of AFU, the following
message appears in the Automatic File Upload configuration page.
You must enable Automatic File Upload (AFU) for the channel before you can include channel recordings in the
upload schedule. If AFU is not enabled for the channel, the following message appears in the Automatic
File Upload configuration page.

274

Pearl Nano User Guide

Enable AFU, schedule, and set options

Set a channel or recorder to include in the AFU schedule using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. Click Recording in the Channel(s) menu.
3. Under Recorder Setup, select change. The recorder settings open.
4. Check Automatic file upload and click Apply.

What's Next
After you've enabled AFU for your channels and recorders, enable AFU and configure the AFU settings for thelocation type (i.e. FTP, USB, AWS, etc).

Enable AFU, schedule, and set options
After the channels and recorders you want to include in your Automatic File Upload (AFU) are selected, you canenable AFU and schedule when and where you want the recorded files to upload. To select channels andrecorders to include in AFU, see Set channels and recorders to include in AFU .
By default, recorded video files are uploaded as soon as recording stops. However, you can schedule file
uploads to only occur during a specific period of time every 24-hours. Recordings that end within the configured
time period automatically upload right away. Recordings that end outside the upload time period are queued up
and upload when the scheduled upload time period is reached.
To use AFU scheduling with a CMS, make sure to select a start and end time that provides enoughupload time for all the files to upload to the CMS.
If you want to use the reset button to force the current recording to close and open a new one or want to limit therecorded file size, see Configure recording settings, file size, and type.
Recorded files saved before automatic file upload is configured are not included as part of theautomatic upload.

275

Pearl Nano User Guide

Enable AFU, schedule, and set options

The following table describes the AFU options.
Table 56 AFU options
OptionDescription

Remote path

If no remote path is specified, the files are copied to the root folder of thedestination file system.

Remove after upload

Delete files from local storage on Pearl Nano when the upload completes.

Mark file as downloaded

Change the color of the file in the recording list to show the files aredownloaded. This only applies if the files are not deleted after upload iscomplete.

Create a subfolder for eachchannelSave the downloaded files into a folder using the channel name.

Create a subfolder for device

Save the downloaded files into a folder using the serial number of Pearl
Nano.

Enable AFU and set a schedule or AFU options using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Automatic File Upload. The Automatic File Upload configuration
page opens.
If your screen does not indicate that AFU is enabled for at least one channel or recorder, return to
Set channels and recorders to include in AFU .
3. Check Enable Automatic File Upload.
4. (Optional) Enter a remote path. If no path is specified, the files are copied to the root folder of thedestination file system.
5. (Optional) Check any optional parameter to select it. For example, you can check Mark file as
downloaded and Create a subfolder for each channel.
6. To schedule AFU, check File upload schedule and select a start time and an end time in the Start upload
and Stop upload fields to define the automatic file upload period.

7. Click Apply.
If AFU to your server fails, check the server configuration and permissions.

276

Pearl Nano User Guide

Configure AFU to FTP server parameters

Configure AFU to FTP server parameters
You can automatically upload recordings to an FTP server when you select FTP as the AFU protocol transfer
type using the Admin panel.
The following table describes the parameters to configure for AFU to an FTP server.
Table 57 FTP Automatic Upload Configuration Parameters
Name

Description

ServeraddressThe IP address (or fully qualified domain name) of the FTP server.

Server port

The port used by the target FTP server. Standard port is 21.

Login

User name for the FTP server.

Password

Password for the FTP user.

Use temp file

Causes files to be named with .part extension on the server during active upload. When the
upload completes, the file is renamed to the appropriate extension (.mov, .mp4 or .avi).

PrerequisiteslChannels and/or recorders are already added for AFU, see Set channels and recorders to include in AFU.

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to an FTP server using the Admin panel
1. From the Automatic File Upload configuration page, select FTP Client as the protocol transfer type.

2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure DHCP), you can use the server’s fully qualified domain name instead of theIP address.

277

Pearl Nano User Guide

Configure AFU to SFTP server parameters

3. Specify the Server Port used for the target FTP server. The standard port is 21.
4. Enter the FTP account username in the Login field.
5. Enter the FTP account password in the Password field. The characters are masked with dots.
6. Select Use temp file to name files with a temporary filename extension (.part) on the server until upload iscomplete.
7. Click Apply.

Configure AFU to SFTP server parameters
You can automatically upload recordings to a secure FTP (SFTP) server when you select SFTP as the AFU
protocol transfer type using the Admin panel.
The following table describes the parameters to configure AFU to an SFTP server.
Table 58 SFTP Automatic Upload Configuration Parameters
Name

Description

ServeraddressThe IP address or fully qualified domain name of the SFTP server.

Server port

The port used by the target SFTP server. Standard port is 22.

Login

Username for the SFTP server.

Password

Password for the SFTP user.

Use temp file

Causes files to be named with .part extension on the server during active upload. When the
upload completes, the file is renamed to the appropriate extension (.mov, .mp4 or .avi).

PrerequisiteslChannels and recorders are already added for AFU, see Set channels and recorders to include in AFU .

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to an SFTP server using the Admin panel
1. From the Automatic File Upload configuration page, select SFTP Client as the protocol transfer type.

278

Pearl Nano User Guide

Configure AFU to SFTP server parameters

2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure DHCP ), you can use the server’s fully qualified domain name instead of theIP address.
3. Specify the Server Port used for the target SFTP server. The standard port is 22.
4. Enter the SFTP account username in the Login field.
5. Enter the SFTP account password in the Password field. The characters are masked with dots.
Alternatively, you can choose to use a private key instead of a password for authentication.
6. Select Use temp file to name files with a temporary filename extension (.part) on the server until upload iscomplete.
For secure file transfer, you can upload an SSH identity for Pearl Nano. This key must be
trusted by the destination server. Details for generating the key and setting up this trust are
beyond the scope of this document.

279

Pearl Nano User Guide

Configure AFU to RSync server parameters

7. (Optional) Set up SSH identity for SCP and SFTP clients. If no identity is uploaded, or to upload a new
identity (overwrites the old identity):a. Click Choose File and navigate to select the private key file from your hard drive, then click Open.
b. Click Upload to upload the file.
The system accepts RSA keys for SSH-1; DSA, ECDSA, EC25519 and RSA for SSH2. Keys must be in OpenSSH format.
c. (Optional) Use the Test your key field to test your uploaded key against the secure server.
8. Click Apply

Configure AFU to RSync server parameters
You can automatically upload recordings to an RSync server when you select RSync as the AFU protocol
transfer type using the Admin panel.
The following table describes the parameters to configure for AFU to an RSync server.
Table 59 RSync Automatic File Upload Configuration Parameters
Name

Description

ServeraddressThe IP address (or fully qualified domain name) of the RSync server.

Server module

The name of the shared folder on the RSync server.

Login

Username for the RSync server.

Password

Password for the RSync user.

280

Pearl Nano User Guide

Configure AFU to CIFS server parameters

Name

Description

Checksum

Select to enable checksum checking during file transfer. This increases the time taken totransfer, but also increases reliability of the transfer.

PrerequisiteslChannels and recorders are already added for AFU, see Set channels and recorders to include in AFU .

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to an RSync server using the Admin panel
1. From the Automatic File Upload configuration page, select RSync Client as the protocol transfer type.

2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure DHCP), you can use the server’s fully qualified domain name instead of theIP address.
3. Specify the Server module. This is the name of the shared folder on the server. If needed, request thisvalue from your network administrator.
4. Specify a username for the RSync Server in the Login field. The user must have write permissions for themodule.
5. Specify the password for the user in the Password field; the value is masked by dots.
6. (Optional) Select the Checksum check box to add a checksum validation to the transfer between thesystem and the recipient server.
7. Click Apply.

Configure AFU to CIFS server parameters
You can automatically upload recordings to a CIFS server (also known as SMB or samba) when you select CIFS
as the AFU protocol transfer type using the Admin panel. SMB2 and SMB3 are supported.

281

Pearl Nano User Guide

Configure AFU to CIFS server parameters

The following table describes the parameters to configure AFU to a CIFS server.
Table 60 CIFS Automatic File Upload Configuration Parameters
Name

Description

Server Port

The CIFS server port. Leave blank to use the default port, or enter the port used for your
CIFS server.

ServeraddressThe IP address (or fully qualified domain name) of the CIFS server.

Server share

The name of the shared folder on the CIFS server.

DomainThe CIFS server's Windows domain or Work Group name . Needed if the server is part of
Active Directory or a Domain Controller.

Login

Username for the CIFS server.

Password

Password for the CIFS user.

Use temp file

Causes files to be named with .part extension on the server during active upload. When the
upload completes, the file is renamed to the appropriate extension (.mov, .mp4, .ts or .avi).

PrerequisiteslChannels and recorders are already added for AFU, see Set channels and recorders to include in AFU .

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to a CIFS server using the Admin panel
1. From the Automatic File Upload configuration page, select CIFS Client as the protocol transfer type.

282

Pearl Nano User Guide

Configure AFU to SCP client parameters

2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure DHCP), you can use the server’s fully qualified domain name instead of theIP address.
3. Enter the target Server port, if you have configured the server to use something non-standard. Leave thisvalue blank to use the default port.
4. Specify the Server share. This is the CIFS share name or the name of the shared folder on the server. If
needed, request this value from the network administrator.
5. If the system is in a different domain than the server or if it is part of Active Directory, enter the Domainname of the CIFS server.
6. Specify a username for the CIFS Server in the Login field. The user must have write permissions for theshare folder.
7. Specify the password for the user in the Password field; the value is masked by dots.
8. Select Use temp file to name files with a temporary filename extension (.part) on the server until upload iscomplete.
9. Click Apply

Configure AFU to SCP client parameters
You can automatically upload recordings to an SCP (secure copy) client when you select SCP as the AFU
protocol transfer type using the Admin panel.
The following table describes the parameters to configure AFU to an SCP client.
Table 61 SCP Automatic Upload Configuration Parameters
Name

Description

Server address The IP address (or fully qualified domain name) of the destination server.
Server port

The SCP port used by the target server. Standard port is 22.

Login

Username for the SCP server.

Password

Password for the SCP user.

PrerequisiteslChannels and recorders are already added for AFU, see Set channels and recorders to include in AFU .

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

lEnsure there is adequate space on the destination device, if space may be an issue disable the AFU
option 'Remove after upload' to avoid accidental deletion of files.

Configure AFU upload to an SCP client using the Admin panel
1. From the Automatic File Upload configuration page, select SCP Client as the protocol transfer type.

283

Pearl Nano User Guide

Configure AFU to SCP client parameters

2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure DHCP), you can use the server’s fully qualified domain name instead of theIP address.
3. Specify the Server Port used for the destination SCP server. The standard port is 22.
4. Enter the SCP account username in the Login field.
5. Enter the SCP account password in the Password field; the characters are masked with dots.
(Alternatively you can choose to use a private key instead of a password for authentication.)
For secure copy you can upload an SSH identity for your Pearl Nano. This key must be
trusted by the destination server. Details for generating the key and setting up this trust
are beyond the scope of this document.

284

Pearl Nano User Guide

Configure AFU to AWS S3 parameters

6. (Optional) Set up SSH identity for SCP and SFTP clients. If no identity is uploaded, or to upload a new
identity (overwrites the old identity):a. Click Choose File and navigate to select the private key file from your hard drive, then click Open.
b. Click Upload to upload the file.
The system accepts RSA keys for SSH-1; DSA, ECDSA, EC25519 and RSA for SSH2. Keys must be in OpenSSH format.
c. (Optional) Use the Test your key field to test your uploaded key against the secure server.
7. Click Apply

Configure AFU to AWS S3 parameters
You can automatically upload recordings to an Amazon Web Server (AWS) when you select AWS S3 as the AFU
protocol transfer type using the Admin panel.
The following table describes the parameters to configure AFU to a bucket on Amazon Simple Storage Solution(S3).
Table 62 AWS Automatic Upload Configuration Parameters
Name

Description

AWS Region CodeThe geographical region of the AWS server that contains the bucket you want to upload
to, e.g. us-east-2.

Bucket

The id of the data storage container you created in Amazon S3 for the recorded live
streaming files.

Access Key Id

The Access Key ID is part of your access key for your AWS account and is a required
parameter, i.e. GAKSOSIFDONN2EXAMPLE.

285

Pearl Nano User Guide

Configure AFU to AWS S3 parameters

Name

Description

Secret Access Key

The Secret Access Key is part of your access key for your AWS account and is arequired parameter, i.e.bHaprXUenFEMI/K6MANVG/cPxDfiBYEXAMPLEKEY.

Session Token

The temporary security token provided by the AWS Security Token Service (STS) thatallows access to your AWS account for authorized users.

Prerequisitesl

You must have read and write privileges for your AWS account before you can setup AFU to upload to an
AWS S3 location. You also need the AWS Access Key ID and Secret Access Key.

l

Channels and recorders are already added for AFU, see Set channels and recorders to include in AFU.

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to AWS S3 using the Admin panel
1. From the Automatic File Upload configuration page, select AWS S3 Client as the protocol transfer type.

2. Specify the AWS Region Code and the data storage Bucket where you want to upload the file.
3. Enter your AWS Access Key Id and Secret Access Key to authenticate access to the AWS S3 data
storage bucket.
Failure to provide these values could result in content loss if Remove after uploading isselected.
4. In the Session Token field, enter the temporary token you got from the AWS Security Token Service(STS).
5. Click Apply.

286

Pearl Nano User Guide

Configure AFU to WebDav server parameters

Configure AFU to WebDav server parameters
You can automatically upload recordings to a WebDav server when you select WebDav as the AFU protocol
transfer type using the Admin panel.
The following table describes the parameters to configure AFU to a WebDav server.
Table 63 WebDav Automatic Upload Configuration Options
Name

Description / Options

ServeraddressThe IP address (or fully qualified domain name) of the FTP server.

Server port

The port used by the target WebDav server. Standard port is 21.

Login

Username for the WebDav server.

Password

Password for the WebDav user.

EnableHTTPS

Select if you need to use a secured HTTPS link to the WebDav server.

Use temp file

Causes files to be named with .part extension on the server during active upload. When the
upload completes, the file is renamed to the appropriate extension (.mov, .mp4 or .avi).

PrerequisiteslChannels and recorders are already added for AFU, see Set channels and recorders to include in AFU .

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to a WebDav server using the Admin panel
1. From the Automatic File Upload configuration page, select WebDav Client as the protocol transfer type.

287

Pearl Nano User Guide

AFU or copy to USB

2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure DHCP), you can use the server’s fully qualified domain name instead of theIP address.
3. Specify the Server Port used for the target WebDav server. The standard port is 21.
4. Enter the FTP account username in the Login field.
5. Enter the FTP account password in the Password field. The characters are masked with dots.
6. Select Enable HTTPS if you need a secure HTTPS link to the WebDav server.
7. Select Use temp file to name files with a temporary filename extension (.part) on the server until upload iscomplete.
8. Click Apply.

AFU or copy to USB
The Pearl device has USB 3.0 ports (a single port on Pearl Nano) that you can use to copy recordings to external
USB flash drives or hard drives. Use this to conveniently provide speakers with a copy of their presentation
before they leave the presentation venue.
A USB port is available on the back panel of the Pearl device.
The USB storage device must be formatted with one of the following file systems:
l

FAT16

l

FAT32

l

XFS

l

EXT2

l

EXT3

l

EXT4

l

NTFS

288

Pearl Nano User Guide

AFU or copy to USB

We recommend you only connect one USB device to a Pearl device at a time. Only one copy or move to USB
operation is permitted at a time, even though the UI may appear to let you start a second one. Please wait until
the first is complete before starting a new operation.
To view AFU and monitor file transfer progress on the Pearl's screen, see View AFU and file transfer progress.
Topics on this page include:lAutomatic File Upload to a USB storage devicelOne-time copy all recordings to USB storage devicelManually copy recordings to USBlManage USB file transfer queuelManage USB drive

AFU to a USB storage device
Transfer recordings to a USB storage device automatically when you select an external USB device as the AFU
protocol transfer type using the Admin panel.

PrerequisiteslA properly formatted USB device must be connected to a USB port on the Pearl device.

lChannels and/or recorders are already added for AFU, see Set channels and recorders to include in AFU.

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to a USB storage device using the Admin panel
1. From the Automatic File Upload configuration page, select External USB Drive as the protocol transfer
type. If your Automatic File Upload setting conflicts with your new USB device setting, a message isdisplayed. Click the fix it link and click Apply.

The fix it link disables any other type of automatic file upload you have configured. When you
are done with USB uploads, return to the Automatic File Upload configuration page andreconfigure your AFU settings.
2. (Optional) Select Create a subfolder for each channel to have recordings organized by channel. Pearl
Nano only has a single channel.
3. Click Apply.

289

Pearl Nano User Guide

AFU or copy to USB

Do a one-time move/copy all recordings to USB storage device
When one-time move/copy of files is configured, the Pearl device automatically starts copying files as soon as
you connect a USB storage device to the USB port.
Newest recordings are copied first. Files continue copying over until one of the following events occur:l

all files are copiedlthe specified maximum number of files are copiedlthe target drive runs out of storage space

File that are currently recording do not transfer until recording ends.
The following table describes the options available for a one-time move/copy of recordings to a USB storage
device.
Table 64 One-Time Move/Copy File Transfer Options
Name

Description

create subfolder with
serial number (<serial>)

If checked, the transfer process creates a sub-folder with the system’s serial
number on the USB drive. This is useful if you are using the same drive to collectrecordings from multiple systems and want to know which system they came from.

create subfolder for thechannelIf checked, the transfer process creates a sub-folder for the channel into which thefiles are copied (within the subfolder for the serial number, if that option is also
selected).

remove after copying

If checked, the file(s) are removed after being copied to the USB drive. Checking
this box makes the transfer a move instead of a copy.

mark file as downloaded

If checked, the files that are downloaded are marked with a downloaded icon whenviewing file lists. This has no effect if remove after copying is checked.

ignore alreadydownloaded files

If checked, files that were previously downloaded or marked as downloaded are
not included in subsequent downloads.

If your USB drive has no activity indicator to let you know when the transfer is complete, select the
one-time move/copy option to remove after copying or mark the file as downloaded so that you
know when the transfer has finished.

PrerequisiteslA properly formatted USB device not connected to a USB port on Pearl Nano.

Configure a one-time copy of all recorded files to a USB storage device using the Admin
panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.

290

Pearl Nano User Guide

AFU or copy to USB

2. From the Configuration menu, select External USB Drive. The External USB Drive configuration pageopens.
3. Select used for one-time move/copy of the recorded files (upon insertion).

If a conflict is reported regarding the Automatic file upload settings, click Fix it or go to the
Automatic File Upload configuration page and either disable automatic file upload or switch toa non-USB based upload type.
4. Check the options you want to use for the one-time move/copy file transfer and click Apply.
5. Insert the USB storage device into the USB port on Pearl Nano. File transfer starts automatically.
6. Follow the steps to Safely eject the USB storage device when the activity light on the USB storage device
stops flashing. If your USB device doesn't have activity indicators:
a. Check the Recording list for the channel to verify if there are files that have yet to be copied.
b. Safely eject the USB storage device when you are satisfied all files have been copied, or if you
notice the USB storage device is out of space, see View available USB storage space.

Manually copy recordings to USB storage device
You can manually copy recordings to a USB storage device that is connected to Pearl Nano. This procedure isseparate from automatic file upload and does not need any pre-configuration in the automatic file upload page.
The following table describes the options available when manually copying recordings to a USB storage device.
Table 65 One-Time Move/Copy File Transfer Options
Name

Description

create subfolder withIf checked, the transfer process creates a sub-folder with the system’s serial

291

Pearl Nano User Guide

AFU or copy to USB

Name

Description

serial number (<serial>)

number on the USB drive. This is useful if you are using the same drive to collectrecordings from multiple systems and want to know which system they came from.

create subfolder for thechannelIf checked, the transfer process creates a sub-folder for the channel into which thefiles are copied (within the subfolder for the serial number, if that option is also
selected).
Choose the action to take if a file with the same name already exists in the copy
location:

File already existslreplace (default)

l

skip

l

renameManually copy recorded files to a USB device using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select External USB Drive link. The External USB Drive configuration
page opens.
3. Select used to manually move/copy selected files via the Admin panel and click Apply.

If a conflict is reported regarding the Automatic file upload, click Fix it or go to the Automatic
File Upload configuration page and disable automatic file upload or switch to a non-USB
based upload type.
4. Insert your USB storage device into the USB port on Pearl Nano, then click Recording from the Channelmenu in the Admin panel. The Recording page opens.
5. Check the files you want to download and do one of the following:a. Click Copy Selected to external drive to copy the files to the USB drive.
b. Click Move Selected to external drive to move the files and delete them off of Pearl Nano.
In this example, the first file is currently recording and cannot be downloaded.

292

Pearl Nano User Guide

AFU or copy to USB

6. Follow the steps to Safely eject USB storage device when you're done.

View file transfer status and cancel file copy to a USB device
During a file transfer to an External USB drive, you can monitor the file transfer progress and cancel the filetransfer using the Admin panel. You can only cancel the transfer of a file while it is in progress.
For other options to view the USB file transfer progress, see View AFU and file transfer progress.

View file transfer to USB device status and cancel using the Admin panel
1. While the file transfer is in progress, select External USB Drive link from the Configuration menu in the
Admin panel. The External USB Drive configuration page opens.
2. View the current file transfer status under the Status section. To cancel the current file transfer, selectCancel and confirm when prompted. The option to cancel only appears while the file transfer is inprogress. The file that is highlighted in green is currently being transferred.

293

Pearl Nano User Guide

AFU or copy to USB

View available USB storage space
When you insert a USB storage device into a USB port and select an External USB Drive action other thanignored (i.e. manual copy, automatic copy, etc), the total and free space are calculated and displayed in the
Admin panel.
When you insert your USB storage device into an available USB port, an External storage usage information tab
appears at the bottom of the menus panel in the Admin panel.

294

Pearl Nano User Guide

AFU or copy to USB

You can also view the storage capacity when you select Storage using the front screen menu. A USB storage
device must be connected to see the USB storage listed.

Safely eject the USB storage device
When you're done saving recordings to the USB storage device, you can safely eject it using the link at thebottom of the Admin panel page.
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. At the bottom of the menus panel, click eject and click OK when prompted.

295

Pearl Nano User Guide

Automatic File Upload to a USB storage device

It's now safe to disconnect the USB storage device from Pearl Nano.

Automatic File Upload to a USB storage device
Transfer recordings to a USB storage device automatically when you select an external USB device as the AFU
protocol transfer type using the Admin panel.

PrerequisiteslA properly formatted USB device must be connected to a USB port on the Pearl device.

lChannels and/or recorders are already added for AFU, see Set channels and recorders to include in AFU.

l

AFU is enabled and the parameters configured, see Enable AFU, schedule, and set options.

Configure AFU upload to a USB storage device using the Admin panel
1. From the Automatic File Upload configuration page, select External USB Drive as the protocol transfer
type. If your Automatic File Upload setting conflicts with your new USB device setting, a message isdisplayed. Click the fix it link and click Apply.

The fix it link disables any other type of automatic file upload you have configured. When you
are done with USB uploads, return to the Automatic File Upload configuration page andreconfigure your AFU settings.
2. (Optional) Select Create a subfolder for each channel to have recordings organized by channel. Pearl
Nano only has a single channel.
3. Click Apply.

Manually copy recordings to USB
You can manually copy recordings to a USB storage device that is connected to Pearl Nano. This procedure isseparate from automatic file upload and does not need any pre-configuration in the automatic file upload page.
The following table describes the options available when manually copying recordings to a USB storage device.

296

Pearl Nano User Guide

Manually copy recordings to USB

Table 66 One-Time Move/Copy File Transfer Options
Name

Description

create subfolder with
serial number (<serial>)

If checked, the transfer process creates a sub-folder with the system’s serial
number on the USB drive. This is useful if you are using the same drive to collectrecordings from multiple systems and want to know which system they came from.

create subfolder for thechannelIf checked, the transfer process creates a sub-folder for the channel into which thefiles are copied (within the subfolder for the serial number, if that option is also
selected).
Choose the action to take if a file with the same name already exists in the copy
location:

File already existslreplace (default)

l

skip

l

renameManually copy recorded files to a USB device using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select External USB Drive link. The External USB Drive configuration
page opens.
3. Select used to manually move/copy selected files via the Admin panel and click Apply.

If a conflict is reported regarding the Automatic file upload, click Fix it or go to the Automatic
File Upload configuration page and disable automatic file upload or switch to a non-USB
based upload type.
4. Insert your USB storage device into the USB port on Pearl Nano, then click Recording from the Channelmenu in the Admin panel. The Recording page opens.

297

Pearl Nano User Guide

Manually copy recordings to USB

5. Check the files you want to download and do one of the following:a. Click Copy Selected to external drive to copy the files to the USB drive.
b. Click Move Selected to external drive to move the files and delete them off of Pearl Nano.
In this example, the first file is currently recording and cannot be downloaded.

6. Follow the steps to Safely eject USB storage device when you're done.

View file transfer to USB device status and cancel using the Admin panel
During a file transfer to an External USB drive, you can monitor the file transfer progress and cancel the filetransfer using the Admin panel. You can only cancel the transfer of a file while it is in progress.
For other options to view the USB file transfer progress, see View AFU and file transfer progress.
1. While the file transfer is in progress, select External USB Drive link from the Configuration menu in the
Admin panel. The External USB Drive configuration page opens.
2. View the current file transfer status under the Status section. To cancel the current file transfer, selectCancel and confirm when prompted. The option to cancel only appears while the file transfer is inprogress. The file that is highlighted in green is currently being transferred.

298

Pearl Nano User Guide

Manually copy recordings to USB

View available USB storage space
When you insert a USB storage device into a USB port and select an External USB Drive action other thanignored (i.e. manual copy, automatic copy, etc), the total and free space are calculated and displayed in the
Admin panel.
When you insert your USB storage device into an available USB port, an External storage usage information tab
appears at the bottom of the menus panel in the Admin panel.
You can also view the storage capacity when you select Storage using the front screen menu. A USB storage
device must be connected to see the USB storage listed.

299

Pearl Nano User Guide

One-time copy all recordings to USB storage device

Safely eject the USB storage device using the Admin panel
When you're done saving recordings to the USB storage device, you can safely eject it using the link at thebottom of the Admin panel page.
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. At the bottom of the menus panel, click eject and click OK when prompted.

It's now safe to disconnect the USB storage device from Pearl Nano.

One-time copy all recordings to USB storage device
When one-time move/copy of files is configured, the Pearl device automatically starts copying files as soon as
you connect a USB storage device to the USB port.
Newest recordings are copied first. Files continue copying over until one of the following events occur:l

all files are copiedlthe specified maximum number of files are copiedlthe target drive runs out of storage space

File that are currently recording do not transfer until recording ends.

300

Pearl Nano User Guide

One-time copy all recordings to USB storage device

The following table describes the options available for a one-time move/copy of recordings to a USB storage
device.
Table 67 One-Time Move/Copy File Transfer Options
Name

Description

create subfolder with
serial number (<serial>)

If checked, the transfer process creates a sub-folder with the system’s serial
number on the USB drive. This is useful if you are using the same drive to collectrecordings from multiple systems and want to know which system they came from.

create subfolder for thechannelIf checked, the transfer process creates a sub-folder for the channel into which thefiles are copied (within the subfolder for the serial number, if that option is also
selected).

remove after copying

If checked, the file(s) are removed after being copied to the USB drive. Checking
this box makes the transfer a move instead of a copy.

mark file as downloaded

If checked, the files that are downloaded are marked with a downloaded icon whenviewing file lists. This has no effect if remove after copying is checked.

ignore alreadydownloaded files

If checked, files that were previously downloaded or marked as downloaded are
not included in subsequent downloads.

If your USB drive has no activity indicator to let you know when the transfer is complete, select the
one-time move/copy option to remove after copying or mark the file as downloaded so that you
know when the transfer has finished.

PrerequisiteslA properly formatted USB device not connected to a USB port on Pearl Nano.

Configure a one-time copy of all recorded files to a USB storage device using the Admin
panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select External USB Drive. The External USB Drive configuration pageopens.

301

Pearl Nano User Guide

Manually copy recordings to USB

3. Select used for one-time move/copy of the recorded files (upon insertion).

If a conflict is reported regarding the Automatic file upload settings, click Fix it or go to the
Automatic File Upload configuration page and either disable automatic file upload or switch toa non-USB based upload type.
4. Check the options you want to use for the one-time move/copy file transfer and click Apply.
5. Insert the USB storage device into the USB port on Pearl Nano. File transfer starts automatically.
6. Follow the steps to One-time copy all recordings to USB storage device when the activity light on the USB
storage device stops flashing. If your USB device doesn't have activity indicators:
a. Check the Recording list for the channel to verify if there are files that have yet to be copied.
b. One-time copy all recordings to USB storage device when you are satisfied all files have been
copied, or if you notice the USB storage device is out of space, see One-time copy all recordings to
USB storage device.

Manually copy recordings to USB
You can manually copy recordings to a USB storage device that is connected to Pearl Nano. This procedure isseparate from automatic file upload and does not need any pre-configuration in the automatic file upload page.
The following table describes the options available when manually copying recordings to a USB storage device.
Table 68 One-Time Move/Copy File Transfer Options
Name

Description

create subfolder withIf checked, the transfer process creates a sub-folder with the system’s serial

302

Pearl Nano User Guide

Manually copy recordings to USB

Name

Description

serial number (<serial>)

number on the USB drive. This is useful if you are using the same drive to collectrecordings from multiple systems and want to know which system they came from.

create subfolder for thechannelIf checked, the transfer process creates a sub-folder for the channel into which thefiles are copied (within the subfolder for the serial number, if that option is also
selected).
Choose the action to take if a file with the same name already exists in the copy
location:

File already existslreplace (default)

l

skip

l

renameManually copy recorded files to a USB device using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select External USB Drive link. The External USB Drive configuration
page opens.
3. Select used to manually move/copy selected files via the Admin panel and click Apply.

If a conflict is reported regarding the Automatic file upload, click Fix it or go to the Automatic
File Upload configuration page and disable automatic file upload or switch to a non-USB
based upload type.
4. Insert your USB storage device into the USB port on Pearl Nano, then click Recording from the Channelmenu in the Admin panel. The Recording page opens.
5. Check the files you want to download and do one of the following:a. Click Copy Selected to external drive to copy the files to the USB drive.
b. Click Move Selected to external drive to move the files and delete them off of Pearl Nano.
In this example, the first file is currently recording and cannot be downloaded.

303

Pearl Nano User Guide

Manually copy recordings to USB

6. Follow the steps to Safely eject USB storage device when you're done.

View file transfer to USB device status and cancel using the Admin panel
During a file transfer to an External USB drive, you can monitor the file transfer progress and cancel the filetransfer using the Admin panel. You can only cancel the transfer of a file while it is in progress.
For other options to view the USB file transfer progress, see View AFU and file transfer progress.
1. While the file transfer is in progress, select External USB Drive link from the Configuration menu in the
Admin panel. The External USB Drive configuration page opens.
2. View the current file transfer status under the Status section. To cancel the current file transfer, selectCancel and confirm when prompted. The option to cancel only appears while the file transfer is inprogress. The file that is highlighted in green is currently being transferred.

304

Pearl Nano User Guide

Manually copy recordings to USB

View available USB storage space
When you insert a USB storage device into a USB port and select an External USB Drive action other thanignored (i.e. manual copy, automatic copy, etc), the total and free space are calculated and displayed in the
Admin panel.
When you insert your USB storage device into an available USB port, an External storage usage information tab
appears at the bottom of the menus panel in the Admin panel.
You can also view the storage capacity when you select Storage using the front screen menu. A USB storage
device must be connected to see the USB storage listed.

305

Pearl Nano User Guide

Manage USB file transfer queue

Safely eject the USB storage device using the Admin panel
When you're done saving recordings to the USB storage device, you can safely eject it using the link at thebottom of the Admin panel page.
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. At the bottom of the menus panel, click eject and click OK when prompted.

It's now safe to disconnect the USB storage device from Pearl Nano.

Manage USB file transfer queue
You can view USB file transfer information, delete files in the USB file transfer queue, and cancel USB file
uploads using the Admin panel.
Information such as the file name and size, start time, duration, and progress are displayed. A history of filetransfers displays until either Pearl Nano is restarted or the list is manually cleared. External USB storage must
be configured for the USB file transfer status to display.

View USB file transfer status, delete files in the queue, or cancel file uploads using the Admin panel

306

Pearl Nano User Guide

Manage USB file transfer queue

1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select External USB Drive. The External USB Drive configuration pageopens. If there are files to be uploaded, they appear in the queue.

3. To remove a file from the USB transfer queue, click X beside the file you want to remove.
4. To cancel the current USB file transfer that's in progress and remove all files that are currently waiting in
the USB transfer queue, click Cancel.

307

Pearl Nano User Guide

Manage USB drive

Manage USB drive
View available USB storage space
When you insert a USB storage device into a USB port and select an External USB Drive action other thanignored (i.e. manual copy, automatic copy, etc), the total and free space are calculated and displayed in the
Admin panel.
When you insert your USB storage device into an available USB port, an External storage usage information tab
appears at the bottom of the menus panel in the Admin panel.
You can also view the storage capacity when you select Storage using the front screen menu. A USB storage
device must be connected to see the USB storage listed.

Safely eject the USB storage device using the Admin panel
When you're done saving recordings to the USB storage device, you can safely eject it using the link at thebottom of the Admin panel page.
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. At the bottom of the menus panel, click eject and click OK when prompted.

It's now safe to disconnect the USB storage device from the Pearl device.

308

Pearl Nano User Guide

Add recordings to an AFU queue

Add recordings to an AFU queue
You can add previously recorded files to an AFU queue using the Admin panel. Before you can add a previously
recorded file, the channel must be enabled for AFU and at least one new recording must have been queued.

Add an existing recording to an AFU queue using the Admin panel
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.
2. Find the recordings by channel or by recorder and select the files you want to add to the AFU queue.
3. Select Add Selected to Automatic file upload.

View the AFU log
A log is kept of automatic file uploads. You can view the AFU log using the Admin panel, If you want to view the
AFU status, see View AFU and file transfer progress.

View the AFU log using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Automatic File Upload. The Automatic File Upload configuration
page opens.
3. Click Show log of automatic file upload. The log page opens. If no logs are present, the page is blank.
4. Click the browser's back button when you are done.

309

Pearl Nano User Guide

Manage the AFU queue

Manage the AFU queue
The Automatic File Upload (AFU) queue displays a list of recorded files waiting to be uploaded. You can view the
AFU queue and remove files from the queue using the Admin panel. Automatic File Transfer must be configured
for the AFU queue to display.
For other options to view AFU and file transfer progress, see View AFU and file transfer progress.
Emptying the AFU queue does not cancel an AFU transfer.

View the AFU queue and remove files from the queue using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Automatic File Upload. If there are files to be uploaded, they appear
in the queue.
3. To remove a file from the AFU queue, click X beside the file you want to remove.
4. To remove all files that are currently waiting in the AFU queue, click Empty Queue.

310

Pearl Nano User Guide

Integration

Integration
Pearl devices are fully integrated with Kaltura, Panopto, YuJa and Opencast Content Management Systems(CMSs). Learn to use the Admin panel to set up and manage your Pearl device with these Content Management
Systems, as well as how to record and stream.
Topics include:lKaltura registrationlKaltura recording and webcasting setuplPanopto registrationlPanopto recording and webcasting setupl

CMS recording and webcasting controll

YuJa setupYuJa setuplOpencast registrationlOpencast recording setup

For information about using the Pearl device RS-232 and HTTP/HTTPS APIs, see the Pearl System API Guide.

Kaltura registration
The Pearl Nano is fully integrated with Kaltura Content Management Systems (CMSs) for a seamless video
recording and webcasting experience. After it is registered, it appears as a resource in Kaltura's MediaSpaceand can be selected for scheduled recordings and webcasts, as well as be used for unscheduled ad hoc events
that you can create using the Admin panel (or from Pearl-2 and Pearl Mini's touch screen). Registering it as aresource with the Kaltura Content Management System (CMS) only needs to be done once.
Topics include:lEnable CMS and register with KalturalDisable or deregister from KalturalChange the resource name used for KalturalReassign a registered resource

After Kaltura is registered, proceed to check the VOD and webcasting event settings and set up authentication
for ad hoc events. See Kaltura recording and webcasting setup.

Enable CMS and register with Kaltura
When CMS is enabled, use the Admin panel to register Pearl Nano as an encoder resource for Kaltura. After
Pearl Nano is registered, you can assign it a unique name that appears in the list of resources when creating an

311

Pearl Nano User Guide

Enable CMS and register with Kaltura

event in Kaltura's MediaSpace. The default name includes the serial number of Pearl Nano to ensure the name isunique.
If more than two other resources are already registered with the same name, you're prompted to choose a
different name and try to register Pearl Nano again. If only one resource is registered with the same name, you're
prompted to take over the events for that other resource. If you do, Kaltura transfers all scheduled events fromthat other device over to Pearl Nano. For more information, see Reassign a registered resource.
It may take some time for Kaltura to display a newly registered resource, depending on how busy the
Kaltura system is when you register.
There are two methods to register your Pearl Nano:lUsing your Kaltura partner ID and administrator secretlUsing an application token and the token ID

A Kaltura application token can be created from the Kaltura developer website: www.developer.kaltura.com

There are two types of Kaltura application tokens you can use with Pearl Nano: an administrative session typeand a user session type. With an administrative session token, Pearl Nano uploads event recordings to therespective event owner's account in Kaltura as expected.
A user session token requires the following permissions:

312

Pearl Nano User Guide

Enable CMS and register with Kaltura

KMC_ACCESS,KMC_READ_ONLY,BASE_USER_SESSION_PERMISSION,WIDGET_SESSION_PERMISSION,CONTENT_INGEST_BASE,CONTENT_INGEST_UPLOAD,CONTENT_MANAGE_
BASE,cuePoint.MANAGE,CONTENT_MANAGE_SCHEDULE,CAPTURE_DEVICE_PERMISSION,CONTENT_INGEST_REFERENCE_MODIFY,disableentitlement

Important considerations for user session application tokenslPearl Nano uploads all events (scheduled and ad hoc) to the user account ID associated with the user
token.

l

All event recordings (scheduled and ad hoc) upload to the Kaltura account of the user who created theevent if there is no user ID associated with the token.

l

Do not include a creation date for the user session token. A creation date in the token causes Pearl Nano
to upload events only to the token creator. .

Before you begin, you should already have:l

A Kaltura instance createdlEither of the following:lYour Kaltura partner ID and administrator secretlYour application token ID and token value

Enable Pearl Nano as a resource and register with Kaltura using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. From the Choose CMS drop down, select Kaltura and then click Apply.
4. In the Authorization method field, select the authorization method and do one of the following:a. If you select Administrator secret, enter your Kaltura Partner ID and Administrator secret that you
got from Kaltura.
b. If you select Application token, enter the application Token ID and Token value .
Ensure the Token hash type matches the hash type set in the application token. The
default is SHA1.
5. (Optional) Change the Resource name that appears for this device in Kaltura. The default resource nameincludes the serial number of Pearl Nano.
6. Click Register device.
An Events screen is added to Pearl Nano's front screen. Press the left arrow key on the control key interface until
you see the Events screen display. This is where you can see a list of scheduled Kaltura events for your Pearl
Nano device.

What's next
Choose which Pearl Nano channels you want this resource to record, assign the channel to use for webcasting,313

Pearl Nano User Guide

Disable or deregister from Kaltura

setup authentication for ad hoc events, and specify default ad hoc event parameters. See Kaltura recording andwebcasting setup. Pearl Nano only has a single channel.

Disable or deregister from Kaltura
You can disable CMS using the Admin panel and still select Pearl Nano as a resource using Kaltura
MediaSpace. However, the events schedule won't synchronize on Pearl Nano and any events that are scheduled
to start while CMS is disabled do not start on Pearl Nano. If CMS is re-enabled on Pearl Nano before the event isscheduled to end, that event will start automatically after the events schedule is refreshed on Pearl Nano, see
View scheduled CMS events and history.
Existing events that are already associated with the device do not lose their association when CMS is disabled.
As soon as you re-enable Kaltura CMS on Pearl Nano, you can record and stream events as usual. CMS isdisabled by default.
Deregistering removes Pearl Nano from Kaltura's list of resources and any existing events that were associatedwith that resource lose their association. You must select a new resource for those events using MediaSpace.
Content Management Systems (CMSs) can change channel settings automatically. After disabling
CMS on Pearl Nano, check your channel settings or apply a configuration preset to restore yourchannel to known values.

Important considerationsl

You cannot start ad hoc (manual) Kaltura events when CMS is disabled or when Pearl Nano has been
deregistered.

lWhen CMS is disabled or Pearl Nano is deregistered, existing scheduled events that are associated withthe device do not record or stream.

l

If Pearl Nano is deregistered, existing events associated with that device lose the association. You mustselect a new resource for those events.

lEnsure the deregistered Pearl Nano entry in the list of encoder devices on Kaltura disappears before
registering again if using the same device name.

l

Do not disable CMS while an event is in progress.
After disabling or deregistering from Kaltura, the recording file size limit for the channels reset to 64
GB. Check to ensure this value does not exceed the maximum recording space allowed for the
installed SD card and change the value to avoid unintentionally overwrite existing recordings. For
more information about setting the recording file size limit, see Disable or deregister from Kaltura.

Disable Pearl Nano as a resource or deregister from Kaltura using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.

314

Pearl Nano User Guide

Change the resource name used for Kaltura

3. To disable CMS, select none from the Choose CMS drop down and then click Apply.
4. To deregister Pearl Nano, click Deregister device.

Change the resource name used for Kaltura
Using the Admin panel, you can change the resource name that's assigned to Pearl Nano while it's registeredwith Kaltura.
Each Pearl Nano is assigned a unique resource name that includes the serial number of the device by default.
You can transfer scheduled VOD and scheduled webcasting events from one resource to another by assigning
Pearl Nano the same resource name as another resource.
When a resource with the same name is already registered in Kaltura, a warning message appears when you try
to apply the new resource name to Pearl Nano.
l

If there's only one other registered resource with that name, you're prompted to choose whether or not totake over the events for that other resource. If you do take them over, Kaltura transfers all scheduled
events from that other device over to Pearl Nano.

l

If more than two other resources are already registered with the same resource name in Kaltura, the namechange fails. You're prompted to choose a different resource name and try again.

Change Pearl Nano resource name using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Change the Resource name and click Apply.

Reassign a registered resource
Every encoder you register with Kaltura has a unique resource name. To swap out one Pearl Nano with anotherone, you can simply reassign the existing Pearl Nano resource name to the replacement Pearl Nano.
Assigning Pearl Nano the same resource name when you register the encoder transfers all the existingschedules and recordings over to the replacement Pearl Nano. When a resource tries to register using the same
name as another device, a warning message appears and you're asked whether or not you want to take overfrom the other resource.
l

If there's only one other registered resource with that name, you're prompted to choose whether or not totake over the events for that other resource. If you do take them over, Kaltura transfers all scheduled
events from that other device.

l

If more than two other resources are already registered with the same resource name in Kaltura,registration fails. You're prompted to choose a different resource name and to try registering Pearl Nano
again.

This works well when you want to change the encoder in a room but retain all the existing schedules andrecordings that are associated with the encoder for that room.

315

Pearl Nano User Guide

Kaltura recording and webcasting setup

Alternatively, you can avoid having to register the replacement Pearl Nano with Kaltura. If you apply aconfiguration preset to set up the replacement Pearl Nano with the settings from the currently registered Pearl
Nano, the replacement Pearl Nano assumes the identity of the registered resource. For more information about
configuration presets, see About configuration presets.
Using a configuration preset can result in two Pearl Nano resources with the same identity, which
can effect recording and the content that's uploaded to Kaltura for scheduled events. Power down,
disconnect from the network, and consider performing a factory reset on one of the Pearl Nano
resources to remove the possibility of having duplicate resources.
If you've performed a factory reset that resulted in an orphaned Kaltura resource registration, you can perform
this procedure to reregister your Pearl Nano using the same resource name to take over the resource instancethat is still registered in Kaltura.
Before you begin, you should already have:l

A Kaltura instance createdl

Access to the Kaltura Management Console (KMC)lYour Kaltura partner ID

lYour Kaltura administrator secret

Enable Pearl Nano as a resource and register with an existing resource name using theAdmin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. From the Choose CMS drop down, select Kaltura and then click Apply.
4. Enter your Partner ID and Administrator secret that you got from Kaltura.
5. Change the Resource name to the resource name of the Pearl Nano you are replacing and click Registerdevice.
6. When you're prompted to take over the events from the existing resource with that same name, click Yes.

Kaltura recording and webcasting setupYour Pearl device appears as an available resource as soon as the device is registered with Kaltura. Connect
multiple audio and video sources directly to the Pearl device and assign them to separate channels. Eachchannel you configure on the Pearl device is treated as a separate video source.
The channel you set up on Pearl Nano is treated as a single video source.
For more information about using the auto channel feature, creating channels or using custom layouts, see Whatis a channel?.
Topics include:316

Pearl Nano User Guide

About Kaltura recording and webcastinglAbout Kaltura recording and webcastinglKaltura settingsl

Set up channel for Kaltura VOD events on Pearl Nanol

Set up channel and URLs for Kaltura webcasting eventsl

Set Kaltura ad hoc event parametersl

Set the extend Kaltura CMS event intervallChange the events schedule refresh intervall

Use RTMPS for a Kaltura webcasting event

About Kaltura recording and webcasting
Pearl devices support scheduled events, recurring events, and unscheduled ad hoc recordings and webcasts.
After the Pearl device is registered, Kaltura users can simply assign the Pearl device as a resource when setting
up an event using MediaSpace.
Scheduled events start and end automatically. No manual intervention is required. After the event ends, therecording automatically uploads. Back up recordings for each channel are also saved locally on the Pearl device.
Pearl Mini and Pearl Nano - An SD card must be installed to record events. We recommend usinglarge capacity SD cards such as 256 GB with a CMS.(Pearl Nano can also use a large capacity
SATA M.2 2280 SSD when using Pearl Nano)
If the network connection or the CMS goes down during an event, the Pearl device continues to record locallyand uploads the recording when network connectivity resumes. Depending on how busy the Kaltura CMS
system is when the files upload, it may take some time for the files to appear in Kaltura's media lists.
You can start and stop events earlier than the scheduled time using the Admin panel or the device screen.
Starting or stopping a scheduled VOD event before the scheduled start or stop time does not change
the event in to an ad hoc event.
Pearl administrators can:lCreate ad hoc events, see Create ad hoc events using the Admin panel.

l

Set ad hoc event parameters.

lView the Events page to see all upcoming scheduled sessions and completed sessions, see View
scheduled CMS events and history.

l

Change how often Pearl Nano polls Kaltura for an updated list of Events.

l

Download local recordings for each channel, see Recover channel backup recordings.

lStart and stop scheduled events before the scheduled time, see Start/stop scheduled CMS events using
the Admin panel.

317

Pearl Nano User Guide

About Kaltura recording and webcastinglExtend scheduled events, see Extend or pause CMS recordings and webcastslChange the extend event button time allotment in 5, 10, and 15 minute intervals, see Set the extend
Kaltura CMS event interval.

General informationl

The Pearl device must be registered with Kaltura to record and stream Kaltura events, see Enable CMS
and register with Kaltura.

l

Scheduled events have priority over ad hoc events. If an ad hoc event is still in progress when it's time tostart a scheduled event, the ad hoc event is stopped and the scheduled event starts.

lScheduled events automatically start recording locally on the Pearl device even If the network is down or
Kaltura is unavailable. After the session ends, the locally recorded files upload automatically to yourKaltura media list when the network link to Kaltura is re-established.

l

After the event ends, it may take a while for content to show up in Kaltura's media lists, depending on how
busy the Kaltura CMS system is at that time.

l

The recorded event must be a minimum of 2 minutes long for Kaltura to process the video.

l

The Kaltura Editor does not open recorded events that are less than a minute long.

l

If the network connection is lost during a file upload to Kaltura, the transfer automatically restarts when the
network connection re-establishes.

l

If the Pearl device loses power while a scheduled event is being recorded, the recording stops. If the Pearldevice is powered back on before the scheduled end time for the event, recording of the scheduled event
restarts automatically and a second set of files are created. When the event ends, both files automaticallyupload to Kaltura.

l

If the Pearl device was unavailable on the network or powered down and misses a scheduled event, thestatus of that event appears as Skipped on the Events page in the Admin panel.

l

If the time and zone settings of the Pearl device are out of synchronization with Kaltura's schedulingserver, an error appears on the Events page and you're prompted to reconfigure the time settings on thePearl device, see Configure date and time.

l

Do not use AFU or configure recording file size, type and other channel recording settings when CMS isenabled on Pearl Nano.

l

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.

l

Do not schedule recordings that are longer than the capacity of Pearl Nano to store the recording on thelocal drive.

318

Pearl Nano User Guide

Kaltura settings

Default Kaltura encoding settings are applied automatically to the channel when Kaltura is enabled,which override the existing encoding settings. If you manually change the encoding settings using
the Admin panel after Kaltura is enabled, the settings revert back to the default Kaltura settings
when a scheduled or ad hoc event starts.

Pearl Nano information
Kaltura treats the channel you setup on Pearl Nano as a single video-source event for VODs and webcasts. The
event recording is uploaded to Kaltura and appears as a single entry in the Kaltura media list. The name of the
uploaded recording includes the name of the channel plus the date and time the file was recorded. For example:
Channel 1_May23_10-12-05
To use the front screen on Pearl Nano to start and stop events, see Stop/start scheduled CMS events using
Pearl Nano's front screen menu.
With Pearl Nano, you can:lDeselect the Pearl Nano channel so that it cannot be displayed as the main default view when watching
the VOD in Kaltura.

lDisplay the Channel view on Pearl Nano's front screen, see Confidence monitoring using the front screen.
You can also monitor the channel using the Admin panel.

Kaltura settings
The following list of features is available once your Pearl device has been registered with Kaltura.

VOD event channelslChannel - Select a channel for VOD.

l

Enabled - Select to enable the channel.

lMain entry - Select which channel will be the main entry (only one can be selected).

Live-stream event channellChannel - Select a channel to be live-streamed.

lSecure streaming - Select to send an RTMPS (instead of RTMP) stream.

l

Backup stream - Select to enable a backup stream, the select the Ad hoc event backup stream from thedropdown list.

lAd hoc event primary stream - Select a primary stream. If Auto is the only available option, then no
additional streams are configured for the channel.

l

Ad hoc event backup stream - Once Backup stream has been enabled, select a backup stream. If Auto is
the only available option, then no additional streams are configured for the channel.

319

Pearl Nano User Guide

Kaltura settings

Unscheduled ad hoc event detailslSession title - Assign a default title for ad hoc events. Default variables specify the current date and timeas the title using the format yyy-mm-dd hh:mm. This default title can be changed when an ad hoc event iscreated.

l

Event owner - Assign an owner to ad hoc events created using the Pearl device.

l

Owner suffix - Enter a suffix to be automatically applied to the Event owner field when users authenticate
with Kaltura from the Pearl device. For example, if the owner account is wilson@myorg.com, enter thesuffix @myorg.com here so that the user only needs to enter wilson to authenticate.
l

For Pearl Nano, you must authenticate from the Admin panel.

lDescription - The description of the uploaded media that appears in Kaltura.

lTags - Assign tags to the uploaded media for use by Kaltura. To assign multiple tages, separate the tagswith a ",".

lCategories - Assign Kaltura categories to the uploaded media. To assign a nested category to the
uploaded media, use the ">" symbol (with no spaces) between categories. To assign multiple categories,
separate the categories with a ",". For example: Recordings>Tutorials>Biology1000,
Recordings>Tutorials>Chemistry1000l

Duration - Assign a default duration for ad hoc events. This value can be changed when an ad hoc eventis created.

l

Automatically logout - Automatically logs out the ad hoc event creator when the ad hoc event ends. Thisis disabled by default.
l

For the Pearl-2 and Pearl Mini, automatic logout only works if the touch screen was used to create
the ad hoc event.

Upload schedule
These settings are optional - they are not required for deployment.
lFile upload schedule - Select the check box to enable scheduled file uploads.

lStart upload - Select a start time for file uploads

lStop upload - Select a finish time for file uploads.

Click Apply when you have configured your upload settings.

Advanced
These settings are optional - they are not required for deployment.
lKaltura groups -Provide Kaltura admin owner privileges to members of a Kaltura group for any Kaltura
events created on this device. Now when you create a new event, you can select a Kaltura Group as an
Admin owner, so the group will have Kaltura admin owner privileges to the uploaded file.
Pearl admin will only display groups created prior to this login session. If groups were createdduring the login session, log out and log in again to refresh the groups.

320

Pearl Nano User Guidel

Set up channel for Kaltura VOD events on Pearl
Nano

Kaltura monitoring dashboard - Select to allow Pearl devices to be visible in Kaltura's My Dashboard.
For more information on Kaltura's My Dashboard feature, contact your Kaltura administrator.

Set up channel for Kaltura VOD events on Pearl Nano
Kaltura treats the channel on Pearl Nano as a single video-source event for scheduled and ad hoc VOD events.
After Pearl Nano is registered with Kaltura, the channel defaults should work for scheduled VOD events without
further configuration. However, you can disable the channel for VOD events using the Admin panel. To set up ad
hoc parameters, see Set Kaltura ad hoc event parameters.
For information about how to customize the channel, see Set up channel for Kaltura VOD events on
Pearl Nano.
The channel is automatically set as the main entry, which is the default view that people see when they arewatching. Adding VOD metadata and edits like trimming the VOD can be done later in Kaltura after the recording
has uploaded.

Select channels for event views using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.

3. Under VOD event channels, uncheck Enabled to disable the channel for VOD events or leave it checked
to enable using the channel for VOD events.
4. Click Apply at the bottom of the page.

Set up channel and URLs for Kaltura webcasting events
Pearl Nano's channel is automatically selected for scheduled and ad hoc webcasting events. However, you canchoose to stream the event to the secondary backup stream URL using the Admin panel.
When a webcasting event is scheduled in Kaltura or started from Pearl Nano as an unscheduled ad hoc event,
the stream URL and other event settings are sent to Pearl Nano. The Kaltura ingestion settings are applied
automatically to Pearl Nano.

321

Pearl Nano User Guide

Set Kaltura ad hoc event parameters

When you create a Kaltura webcasting event on Pearl Nano, you have the option to use the primary and backup
URLs supplied by Kaltura for the stream or to choose a stream destination that is created locally for the channel
on Pearl Nano. Alternative streaming destinations must already be configured for the channel being webcast.
Select the Auto option to use the primary and backup URLs supplied by Kaltura. Auto is the default setting.
When it's time for the scheduled webcasting event to start, Pearl Nano automatically sends an RTMP (orRTMPS) stream to the primary URL associated with that event. If you've enabled the backup stream, Pearl Nano
sends an RTMP stream to both the primary URL and the secondary backup URL associated with that event. If
the primary URL stream fails for any reason, Kaltura automatically switches over to the backup URL.

Set up the channel and URLs for scheduled webcasting events using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under the Live-stream event channel section, the channel is automatically selected. No further action isrequired. Optionally, you can select None to prevent Pearl Nano from webcasting the channel.
4. (Optional) Select an Ad hoc event primary stream from the drop-down list or select Auto to use theprimary URL from Kaltura. If Auto is the only available option, then no additional streams are configured
for the channel.
5. (Optional) Check Backup stream and select an Ad hoc event backup stream from the drop-down list.
Select Auto to use the backup URL from Kaltura. If Auto is the only available option, then no additional
streams are configured for the channel.
6. Click Apply at the bottom of the page.

Set Kaltura ad hoc event parameters
For ad hoc events, you can enter the metadata to associate with the uploaded media using the Admin panel.
However, you can modify the metadata at any time using the Kaltura Management Console (KMC) after the322

Pearl Nano User Guide

Set Kaltura ad hoc event parameters

content is uploaded.
Table 69 Kaltura ad hoc event parameters
Item

Description

Session title

This assigns a default title for ad hoc events. Default
variables specify the current date and time as the title using
the format yyy-mm-dd hh:mm. This default title can bechanged when an ad hoc event is created.
This assigns an owner to ad hoc events created using
the Pearl device.

Event owner

The owner you enter here appears on the Login screen by
default and can be overwritten when authenticating from
Pearl-2 or Pearl Mini.

Owner suffix

Enter a suffix to be automatically applied to the Event owner
field when users authenticate with Kaltura from the Pearldevice (the Pearl Nano must use the Admin panel). For
example, if the owner account is wilson@myorg.com, enter
the suffix @myorg.com here so that the user only needs toenter wilson to authenticate.

Description

The description of the uploaded media that appears in
Kaltura.

Tags

Assign tags to the uploaded media for use by Kaltura.
Assign Kaltura categories to the uploaded media. To assign
a nested category to the uploaded media, use the">" symbol (with no spaces) between categories. For
example:Categories

Recordings>Tutorials>Biology1000
To assign multiple categories, separate the categories witha ",". For example: Recordings>Tutorials>Biology1000,
Recordings>Tutorials>Chemistry1000

Duration

Assign a default duration for ad hoc events. This value canbe changed when an ad hoc event is created.

Automatic logout

Automatically logs out the ad hoc event creator when the ad
hoc event ends. This is disabled by default.

Important considerationsl

Before you start recording, we recommend that you enter the event parameters you want associated withad hoc events using the Admin panel. However, users can modify or add this metadata later using the323

Pearl Nano User Guide

Set the extend Kaltura CMS event interval

Kaltura Management Console.
l

CMS must be enabled and the Pearl device registered with Kaltura to create ad hoc events.

Set default ad hoc event parameters using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Unscheduled ad hoc events, enter the information you want associated with this ad hoc event andclick Apply at the bottom of the page.

Set the extend Kaltura CMS event interval
A button on the device screen lets users extend the length of an event that is in progress. By default, the event is
extended in 5 minute intervals each time the button is tapped. Using the Admin panel, you can set the amount oftime the event is extended to 5, 10, or 15 minute intervals. Events cannot be extended beyond the start of thenext scheduled event.

Set the extend Kaltura CMS event interval using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Advanced, select the Extend event time interval from the drop down list and click Apply.

Change the events schedule refresh interval
Using the Admin panel, you can change how frequently to poll Kaltura for the latest event information to refreshthe events listed on the Events page. The default interval is once every 3600 seconds (1 hour).

324

Pearl Nano User Guide

Use RTMPS for a Kaltura webcasting event

Requesting updated information too frequently can impact performance. We recommend setting aninterval of no less than 120 seconds (once every 2 minutes). The longest interval supported is604800 seconds (once a week).

Change how often Pearl Nano polls Kaltura for the latest event information
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Advanced, enter the Schedule refresh interval in seconds or choose a value from the drop down
list. Click Apply at the bottom of the page.

Use RTMPS for a Kaltura webcasting event
The Pearl device sends an RTMP stream to the primary URL associated with the webcasting event, or to boththe primary URL and the secondary backup URL if you've enabled the backup stream. For more information,see:lPearl Nano - Set up channel and URLs for Kaltura webcasting events.

You can configure Pearl device to send an RTMPS stream instead using the Admin panel.

Configure Pearl device to send an RTMPS stream using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Live-stream event channel, check Secure streaming and click Apply.

Panopto registration
Pearl Nano is fully integrated with Panopto Content Management Systems (CMSs) for a seamless video
recording and webcasting experience. After a simple registration process, Pearl Nano is available for your CMS
users to select as a remote recorder resource or capture device for scheduled, recurring, and ad hoc events.
Completed recordings automatically upload to the CMS. Registering Pearl Nano as a remote recorder for
Panopto only needs to be done once.
Topics include:lEnable CMS and register with PanoptolDisable CMS and disconnect from Panopto

After Pearl Nano is registered, proceed to create URL redirects for Pearl Nano, setup authentication for ad hoc
events, and select default settings. See Panopto recording and webcasting setup.

325

Pearl Nano User Guide

Enable CMS and register with Panopto

Enable CMS and register with Panopto
Use the Admin panel to register Pearl Nano as a remote recorder for scheduled, recurring, and ad hoc recordings
and webcasts. When you register Pearl Nano, a default name is assigned that includes the serial number of
Pearl Nano. This name appears in the list of remote recorders in Panopto. You can change the remote recordername using the Admin panel.
Before you begin, you need:lYour Panopto service URL, for example: https://<myorg>.hosted.panopto.com/lA Panopto-generated registration key for the remote recorder.

l

The Epiphan API key from Panopto is required for on-premise versions of Panopto version 6 or earlier.
Contact Panopto support for assistance to install the Epiphan API key.

Important considerationsl

You create a registration key in Panopto from System > Remote Recorders when you click Manage
registration keys. Record the key somewhere safe before closing the screen in Panopto. The key cannot
be retrieved after the screen is closed. If you lose the registration key, you must create a new one toregister Pearl Nano as a remote recorder.

l

Scheduled recordings are associated to a remote recorder using the registration key and not the device
name.

l

If you disconnect Pearl Nano and register again using a different registration key, the scheduled sessions
previously associated with the original key do not migrate over.

l

If you're using the on-premise version of Panopto version 6 or earlier, you must manually add the API key
for Pearl Nano. Contact Panopto support for assistance.

l

If you are unable to register Pearl Nano, contact your Panopto administrator or Epiphan support.

Enable Pearl Nano as a remote recorder and register with Panopto using the Admin
panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration page opens.
3. From the Choose CMS drop down, select Panopto and then click Apply.
4. Enter the Panopto Service URL, Registration key, and optionally enter a Device name you want toappear in Panopto for this device, then click Apply at the bottom of the page. The Status updates toConnected.
Changing Panopto's device name for Pearl Nano does not change the name that is
assigned to Pearl Nano in the Device info fields, see Configure device info, name,description, and location

326

Pearl Nano User Guide

Disable CMS and disconnect from Panopto

What's next?
For Panopto, proceed to create URL redirects for Pearl Nano, setup authentication for ad hoc events, and selectdefault settings. See Panopto recording and webcasting setup.
An API client ID with two URL redirects are required to enable authentication on Pearl Nano, see Set
up Panopto authentication for ad hoc events

Disable CMS and disconnect from Panopto
When you use the Admin panel to disable CMS on Pearl Nano, the remote recorder disconnects from Panopto.
As long as Pearl Nano is still registered, you can create new scheduled sessions in Panopto for this remoterecorder, but the events schedule won't synchronize until CMS is re-enabled.
If CMS is re-enabled on Pearl Nano before a VOD session is scheduled to end, recording starts automatically on
Pearl Nano when the connection to Panopto is re-established. However, when the start of a scheduledwebcasting event is missed, the stream does not automatically start when the connection is re-established. A
new webcasting event should be created.
Revoking the registration key and deleting Pearl Nano as a remote recorder is performed in Panopto, seePanopto's documentation for instructions. If you delete Pearl Nano in Panopto, all scheduled and recurring
events that were associated with Pearl Nano are permanently deleted.
Content Management Systems (CMSs) can change channel settings automatically. After disabling
CMS on Pearl Nano, it's good practice to check your channel settings or apply a configuration preset
to restore your channel to known values.

Important considerationsl

You cannot start unscheduled ad hoc events when CMS is disabled on Pearl Nano.

l

Sessions that are scheduled to start while CMS is disabled on Pearl Nano do not start on Pearl Nano.

l

Scheduled webcasting events do not start if Pearl Nano's connection to Panopto is not available.

lDeleting Pearl Nano in Panopto permanently deletes future scheduled and recurring sessions associatedwith that remote recorder.

l

Do not disable CMS while an event is in progress.

Disconnect Pearl Nano from Panopto using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. To disconnect Pearl Nano, select none from the Choose CMS drop down and then click Apply.

327

Pearl Nano User Guide

Panopto recording and webcasting setup

Panopto recording and webcasting setup
Pearl Nano appears as an available resource as soon as the device is registered with Panopto. Pearl Nano also
requires the channel is treated as a single video source. Next, set up authentication for ad hoc events to create
ad hoc events from Pearl Nano.
For more information about channels, see What is a channel?.
After that, you're ready to select video sources for multiple source recordings and webcasts. Video sources must
be connected to Pearl Nano and assigned to a channel. Each channel configure on Pearl Nano is treated as aseparate video source for multiple source events in Panopto.
Topics include:lAbout Panopto recording and webcastingl

Set up Panopto authentication for ad hoc eventslSet Panopto ad hoc event parametersl

Set the extend Panopto CMS event intervallEnable mute and display image on pauselDisable low disk space Panopto alerts

About Panopto recording and webcasting
The Pearl device supports scheduled events, recurring events, and unscheduled ad hoc recordings andwebcasts. Scheduled events start and end automatically. No manual intervention is required. After the event
ends, recorded files automatically upload to the event owner's folder in Panopto. Backup recordings are also
saved locally on Pearl Nano. If the network connection or the CMS goes down during an event, Pearl device
continues to record locally and uploads the recording when network connectivity resumes.
Pearl Mini and Pearl Nano - A large capacity (256 GB or more) SD card (or a large capacity SATA
M.2 2280 SSD on Pearl Nano) must be installed to record events. Do not remove the SD card whilefiles are uploading to Panopto.
Administrators can:l

Set up Panopto authentication for ad hoc events, see Set up Panopto authentication for ad hoc events.

l

Set Panopto ad hoc event parameters, Set Panopto ad hoc event parameters.

lChange the extend event button time allotment in 5, 10, and 15 minute intervals, see Set the extend
Panopto CMS event interval.

lEnable muting audio and displaying an event paused image when an event is paused, see Extend or
pause CMS recordings and webcasts.

lDisable low disk space alert sent from Pearl Nano, see Disable low disk space Panopto alerts.

328

Pearl Nano User Guide

About Panopto recording and webcastinglCreate ad hoc events, see Create ad hoc events using the Admin panel.

lView the Events page to see all upcoming scheduled sessions and completed sessions, see View
scheduled CMS events and history.

l

Download local recordings for a channel, see Recover channel backup recordings.

lStart and stop scheduled events before the scheduled time, see Start/stop scheduled CMS events using
the Admin panel.

lExtend and pause scheduled events, see Extend or pause CMS recordings and webcasts

General InformationlStarting or stopping a scheduled VOD event before the scheduled start or stop time does not change theevent into an ad hoc event.

l

Pearl Nano must be registered with Panopto to record and stream Panopto events, see Enable CMS andregister with Panopto.

l

The maximum allowed bitrate for webcasts in Panopto is 2.5 Mbps, regardless of what bitrate is actually
set for the target resolution of the remote recorder in Panopto. For example, when creating a scheduledwebcasting event in Panopto, if you set the target resolution to a quality of 1920 x 1080 60 fps Bitrate:
4000 kbps, Pearl Nano streams the event at the maximum bitrate of 2500 kbps.

lScheduled events have priority over ad hoc events. If an ad hoc event is still in progress when it's time tostart a scheduled event, the ad hoc event is stopped and the scheduled event starts.

lScheduled VOD events automatically start recording locally on Pearl Nano even If the network is down orPanopto is unavailable. After the session ends, the locally recorded files upload automatically to yourfolder in Panopto when the network link to Panopto is re-established.

l

Scheduled webcasting events do not start if Pearl Nano's connection to the CMS is not available.

l

If the network connection is lost during a file upload to Panopto, the transfer automatically restarts when
the network connection re-establishes.

l

If Pearl Nano loses power while a scheduled event is being recorded, the recording stops. If Pearl Nano is
powered back on before the scheduled end time for the event, recording of the scheduled event restarts
automatically and a second set of files are created.On Pearl Nano, a second recording is created. Whenthe event ends, the files are uploaded to Panopto.

l

If Pearl Nano was unavailable on the network or powered down and misses a scheduled event, the statusof that event appears as Skipped on the Events page in the Admin panel.

l

Do not use AFU or configure recording file size, type and other channel recording settings when CMS isenabled on Pearl Nano.

l

For ad hoc events, Pearl Nano ignores a user's presets that are set in Panopto. As a result, ad hocrecordings automatically upload to the user's default folder as originally assigned by Panopto.

lChannel encoding settings you make on Pearl Nano are overridden by the default encoding settings thesystem uses to record to Panopto.
For Panopto VOD events, if you manually stop a scheduled VOD event before the scheduled end
time when Pearl Nano doesn't have network connectivity, Pearl Nano uploads the completed event's

329

Pearl Nano User Guide

Set up Panopto authentication for ad hoc events

recording when network connectivity resumes. However, Panopto does not recognize that the event
has ended. The event remains in the In Progress state in Panopto and you must wait until theoriginal event's scheduled end time before creating a new event using that Pearl Nano.

Encoding settings
Default Panopto encoding settings are applied automatically to the channel when Panopto is enabled, which
override the existing encoding settings. If you manually change the encoding settings using the Admin panel
after Panopto is enabled, the settings revert back to the default Panopto settings when a scheduled or ad hoc
event starts.
You can change the channel resolution in Panopto when creating a new scheduled or recurring session. Pearl
Nano also supports Panopto device templates so you can quickly set up your Pearl Nano remote recorder when
you create a new event.

Pearl Nano informationl

Pearl Nano - You can start and stop events earlier than the scheduled time, as well as pause an event
using the Admin panel or the front panel control key interface on Pearl Nano.

lPanopto treats the channel you setup on Pearl Nano as a single video-source event for recordings andwebcasts. For ad hoc events, the default name of the uploaded recording includes the date and start timeof the event. For example: 2019-07-15 08:00. A more intuitive name can be entered when the ad hoc
event is created.

l

To use the front screen on Pearl Nano to start and stop events, see Stop/start scheduled CMS eventsusing Pearl Nano's front screen menu.

lDue to a Panopto limitation, single-channel recorders like the Pearl Nano can only be used as a primary
recording device for scheduled events. Setting the Pearl Nano as a secondary recording device for ascheduled event will result in no secondary channel being recorded.

l

To monitor the channel during an event, you can display the Channel view on Pearl Nano's front screen,
see Confidence monitoring using the front screen. You can also monitor the channel using the Admin
panel or see a live preview of the channel and the audio level from the remote recorder page in Panopto.

Set up Panopto authentication for ad hoc events
Panopto users can create unscheduled ad hoc events using the Admin panel. You can set up Pearl Nano toallow users to authenticate using their local Panopto login credentials, their credentials for a third-party LMS
integrated with Panopto (like Canvas), and SAML 2.0 credentials if configured on Panopto.
The Pearl device uses a JavaScript web application to negotiate authentication with Panopto. You must create a
new API client ID and add two URL redirects in Panopto for ad hoc event authentication to work. The Pearl Nano
only needs a single URL redirect.
Before you begin, you need:330

Pearl Nano User Guide

Set up Panopto authentication for ad hoc eventsl

Admin access to Panopto.

l

A Pearl Nano remote recorder that's registered with Panopto.

Important considerationslRecord all API client IDs and secret keys that are generated in Panopto somewhere safe. The ID and key
cannot be retrieved after the screen is closed and must be regenerated if lost.

l

You can use the same API Client ID to enable ad hoc authentication on multiple Pearl Nano systems;
however, you must create a separate API client URL redirect for the web-based Admin UI of eachindividual Pearl Nano device.

l

Third-party application authentication for ad hoc events is only supported for Panopto.

Enable ad hoc authentication on Pearl Nano
1. Login to Panopto as an administrator.
2. In the header bar, click the arrow beside your user name and select User Settings. The User Settings
page opens.

331

Pearl Nano User Guide

Set up Panopto authentication for ad hoc events

3. Create the API Client ID. Do the following:a. From the User Settings page, click API Clients, and then click Create a new API Client. The
Create API Client page opens.

b. From the Create API Client page, enter a unique name for the Pearl Nano API client in the Client
Name field. If a client already exists in Panopto with that name, choose a different name.

c. In the Client Type field, select JavaScript Web Application. . Pearl Nano only- then click Create
API Client.
d. On the New API Client created pop-up, record the Client ID and the Client Secret for futurereference, and then click OK. The new Pearl API Client appears in your list of API clients.

332

Pearl Nano User Guide

Set Panopto ad hoc event parameters

4. Add a URL redirect for the web-based Admin panel to the Pearl API Client. Do the following:a. From the User Settings page under API Clients, click Edit beside the Pearl API Client that you justcreated.

b. In the Allowed Redirect URLs field, enter http://<device_ip>/admin/events where<device_ip> is the IP address of Pearl Nano.
If Pearl Nano is configured for https, enter https:// instead of http://.
c. In the URL Type field, select Redirect URL.
d. Click Add URL. The Admin panel URL redirect appears in the Allowed URL list.
5. Login to the Admin panel as admin, see Connect to the Admin panel.
6. From the Configuration menu, click CMS. The Content management system configuration page opens.
7. In the Unscheduled ad hoc events section, enter the Pearl Nano API client id that was generated earlier,and then click Apply.

Set Panopto ad hoc event parameters
Using the Admin panel, you can set parameters that are associated with ad hoc events, including:lUpload destination: Choose whether you want the recorded files from ad hoc events to be automaticallyuploaded to the Panopto Default Folder assigned to Pearl or to a user selectable folder. Options aredefault folder or user selectable folder.

lEnable user-customizable ad hoc events: If this is selected, user will have the option to customize theevent title, duration and event type using Pearl management interface.

lSession title: This assigns a default title for ad hoc events. Default variables specify the current date andtime as the title using the format yyy-mm-dd hh:mm. This default title can be changed when an ad hoc
event is created. Otherwise, the default values specified here will be used.

l

API client id: This is the API client ID that was generated for ad hoc event authentication, see Set up
Panopto authentication for ad hoc events.Required if user selectable folder is selected as the Upload
destination.

l

Duration: Assign a default duration for ad hoc events. This value can be changed when an ad hoc event iscreated.

333

Pearl Nano User Guidel

Set the extend Panopto CMS event interval

Event type: Options are VOD or Live stream. The former will record and upload files to Panopto when theevent events and the latter will only live stream the event.
Pearl Nano must be connected to Panopto for this procedure to work.

Enter Panopto ad hoc event parameters using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Unscheduled ad hoc events, enter the information you want associated with this ad hoc event andclick Apply

Set the extend Panopto CMS event interval
A button on the front screen lets users extend the length of an event that is in progress. By default, the event is
extended in 5 minute intervals each time the button is tapped. Using the Admin panel, you can set the amount oftime the event is extended to 5, 10, or 15 minute intervals. Events cannot be extended beyond the start of thenext scheduled event.

Set the extend Panopto CMS event interval using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Settings, select the Extend event time interval from the drop down list and click Apply.

334

Pearl Nano User Guide

Enable mute and display image on pause

Enable mute and display image on pause
Using the Admin panel, you can set up Pearl Nano to automatically mute the audio and display an event paused
image while a Panopto event is paused.

335

Pearl Nano User Guide

Enable mute and display image on pause

Pearl Nano records and uploads the full event to Panopto for processing. After the event is uploaded, Panopto
removes the paused segments from the final recording. However, Panopto does not remove paused segmentsfrom webcasts. The complete webcast recording including the time the event was paused is retained.

Enable mute and display image on pause using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Settings, check Display "Event paused" image and mute on pause, then click Apply at thebottom of the page.

336

Pearl Nano User Guide

Disable low disk space Panopto alerts

Disable low disk space Panopto alerts
Pearl Nano sends a low disk space alert to Panopto when the amount of internal storage space on the device islow. You can disable the low disk space alerts that Pearl Nano sends to Panopto using the Admin panel andenable it again at any time.

337

Pearl Nano User Guide

Disable low disk space Panopto alerts

Disable low disk space Panopto alerts using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration page opens.
3. Under Settings, uncheck Low disk space alert and click Apply at the bottom of the page to disable
sending these alerts to Panopto.

338

Pearl Nano User Guide

Disable low disk space Panopto alerts

4. To enable this feature again, simply check Low disk space alert and click Apply.

339

Pearl Nano User Guide

YuJa setup

YuJa setup
Pearl-2, Pearl Mini, and Pearl Nano hardware encoders integrate directly with YuJa. Once paired, Pearl canaccess your YuJa calendar to automatically start and stop recordings or streams at scheduled times.
Pearl automatically pushes event recordings to YuJa, minimizing administration time and ensuring your content
makes it to the right place.
For more information see:l

YuJa known issuesl

YuJa registrationl

YuJa settingslCreating, modifying, and deleting YuJa eventsl

Set the extend YuJa CMS event intervallView YuJa eventsl

Accessing YuJa recordings

For additional information on YuJa, see YuJa's support page.

YuJa known issues
This section includes known issues or limitations that affect YuJa functionality or usability and ways that you canwork around these limitations.
l

If you delete a profile that is linked to a future event, Pearl will remember the profile's settings and apply
them regardless of deletion. Instead, remove the profile from the event in YuJa before deletion.

l

If the Pearl admin is taking a long time to load or apply YuJa settings, the YuJa server may be unavailable.
The Pearl admin page may provide inaccurate information or no message at all. If you have trouble
establishing a connection between your Pearl device and YuJa, contact Epiphan support.

l

YuJa Video Platform may not always show accurate Pearl device connectivity status.

lProfiles may not be reflected accurately in YuJa previews. The YuJa preview may seem incorrect.
However, YuJa streaming/recording will work as intended.

l

If you rename your Pearl device in the YuJa interface, this name will not be updated in the Pearl admin oron the Pearl device.

l

If you start an event early in YuJa using any Pearl interface and then extend the event, the event appears
to extend but ends at the originally scheduled ending time.

YuJa registration
Pearl devices are fully integrated with YuJa for a seamless video recording and webcasting experience. Afteryour Pearl device is registered, it appears as a resource in YuJa's device list and can be selected for scheduledrecordings and webcasts. Registering a Pearl device with YuJa only needs to be done once.

340

Pearl Nano User Guide

YuJa registration

To register your Pearl device with YuJa:
1. Log in to the Admin panel as admin. For more information, see Connect to the Admin panel.
2. Click CMS in the Configuration panel.
3. Select YuJa in the Choose CMS dropdown. Click Apply.
4. When integrating YuJa with Pearl Nano you'll need an authentication token. In YuJa this is also called an
API Token. For information on finding the API Token in YuJa, contact your YuJa administrator.
lWhen generating an API token ensure that it has at least the same permissions as in the image
below or the integration will not work correctly,

341

Pearl Nano User Guide

YuJa settings

5. Enter the following information into the YuJa settings section of the page:l

YuJa Service URL: This is your organization's unique URL for YuJa. It will look like this:https://your-organization.yuja.com/
For more information on your YuJa Service URL, contact your YuJa administrator.

lAuthentication token: This is a randomly generated series of numbers and letters provided by
YuJa that is mentioned in the previous step. In YuJa it is called an API Token. Copy and paste an
API Token in here.

lUser ID Type: Select UsernamelUser ID: Enter your YuJa user name.

lDevice name: Label your Pearl device something that will make sense when you (and others)
read it in YuJa. For example, "Biology Lab 1" or "Classroom 237".

6. Click Apply. If the information was entered successfully, the Status will update to Registered.
Once your Pearl device is registered with YuJa, YuJa will recognize your Pearl device and it will appear in the
YuJa list of devices. After registering your product, see YuJa settings to configure the Pearl device for YuJa.
To deregister your Pearl device from YuJa, click Deregister device in the YuJa settings section.

YuJa settings
The following list of features is available once your Pearl device has been registered with YuJa. For more
information on registering your Pearl device, see YuJa registration.
If you select Motion JPEG encoding, it will be overridden. Contact your YuJa administrator to ensure
your Pearl channels are correctly configured for YuJa.

YuJa profiles
Profiles tell Pearl which channels will be recorded and/or streamed for a scheduled YuJa event.
For example, your Pearl 2 may have a channel connected to a laptop called Slides and a channel called
Camera. YuJa can capture up to three channels simultaneously, or a single channel.
Click + Create new to create a new profile or Select a profile from the list.

Profile configurationlProfile name - Enter the name for the profile.

lChannel configuration - Select which channels will be recorded and/or streamed when this profile is used
for a scheduled event.

342

Pearl Nano User GuidelCreating, modifying, and deleting YuJa events

Live streaming - Enable or disable live streaming for this profile. When live streaming is enabled for thisprofile, the selected channel(s) will be live streamed when this profile is selected for a scheduled event.

Click Apply when you have configured your profile.
All channels that are live streamed for an event are also recorded locally and uploaded to YuJa
when the event ends.

Upload Settings
These settings are optional - they are not required for deployment.
lFile upload schedule - Select the check box to enable scheduled file uploads. If enabled, locally recorded
files will only be uploaded to YuJa between the start and stop upload times.

lStart upload - Select a start time for file uploads

lStop upload - Select a finish time for file uploads.

Click Apply when you have configured your upload settings.
YuJa events must be scheduled in YuJa. To view YuJa events in the Pearl admin panel, click Eventsand look under Scheduled events.

Creating, modifying, and deleting YuJa events
Once a Pearl device is registered with YuJa, scheduled events can be created, modified, and deleted.
All creation, modification, and deletion of YuJa events must be done from the YuJa interface. To learn more
about creating, modifying, and deleting events in YuJa, contact your YuJa administrator.
Once an event has been created in YuJa, view the event in the Pearl Admin panel by clicking Events in thenavigation pane.
Once an event is scheduled in YuJa, click Refresh schedule in the Pearl Admin panel and the event
will appear. Alternatively, wait five minutes for the Pearl device to automatically refresh and pullscheduled events from YuJa.

Do not restart your Pearl device during a YuJa scheduled event.

Accessing YuJa recordings
All YuJa recordings are automatically uploaded to YuJa. For more information on accessing the recordings,
contact your YuJa administrator.

343

Pearl Nano User Guide

Set the extend YuJa CMS event interval

The Pearl device's Automatic File Upload (AFU) feature is not available when the Pearl device isregistered to YuJa.

Set the extend YuJa CMS event interval
A button on the front screen lets users extend the length of an event that is in progress. By default, the event is
extended in 6 minute intervals each time the button is tapped. Using the Admin panel, you can set the amount oftime the event is extended to 6, 10, or 15 minute intervals. Events cannot be extended beyond the start of thenext scheduled event.

Set the extend YuJa CMS event interval using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Settings, select the Extend event time interval from the drop down list and click Apply.

View YuJa events
There are several ways to view YuJa events linked to your Pearl device:l

Pearl Admin panel - Log in to the Pearl Admin panel as admin, then click Events in the Pearl Admin
navigation pane.

lEpiphan Cloud - Log in to Epiphan Cloud, then click Events in the Epiphan Cloud navigation pane.

l

Pearl device screen - Select the Events screen on your Pearl device's touch screen or front screen todisplay any upcoming YuJa events and any YuJa event in progress.

lMultiViewer - Enable CMS events for MultiViewer and MultiViewer will display event name, time left
before event start, and current event details.

l

YuJa - Contact your YuJa administrator to view YuJa events.

344

Pearl Nano User Guide

Opencast registration

Opencast registration
Pearl Nano is fully integrated with Opencast Content Management Systems (CMSs) for a seamless video
recording experience. After a simple registration process, Pearl Nano is available for your CMS users to selectas an Opencast capture agent for scheduled, recurring, and ad hoc events. Completed recordings automaticallyupload to the Opencast. Registering Pearl Nano as a capture agent for Opencast only needs to be done once.
Topics include:lEnable CMS and register with OpencastlDisable CMS and disconnect from Opencast

Disable CMS and disconnect from Opencast
When you use the Admin panel to disable CMS on Pearl Nano, the remote recorder disconnects from Opencast.
As long as Pearl Nano is still registered, you can create new scheduled sessions in Opencast for this remoterecorder, but the events schedule won't synchronize until CMS is re-enabled.
If CMS is re-enabled on Pearl Nano before a VOD session is scheduled to end, recording starts automatically on
Pearl Nano when the connection to Opencast is re-established.

Important considerationsl

You cannot start unscheduled ad hoc events when CMS is disabled on Pearl Nano.

l

Sessions that are scheduled to start while CMS is disabled on Pearl Nano do not start on Pearl Nano.

lDeleting Pearl Nano in Opencast permanently deletes future scheduled and recurring sessions
associated with that remote recorder.

l

Do not disable CMS while an event is in progress.

Disconnect Pearl Nano from Panopto using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. To disconnect Pearl Nano, select none from the Choose CMS drop down and then click Apply.

Enable CMS and register with Opencast
Use the Admin panel to register Pearl Nano as an Opencast Capture Agent (CA) for scheduled, recurring, and ad
hoc recordings. When you register Pearl Nano, a default name is assigned that includes the serial number of
Pearl Nano. This name appears in the list of capture agents in Opencast. You can change the CA name using
the Admin panel.
Before you begin, you need:

345

Pearl Nano User Guide

Opencast recording setuplYour Opencast service URL, for example: https://stable.opencast.org//lOpencast user name and password for your capture agent

Important considerationsl

The Opencast user name of type either opencast or system may be used by Pearl to register with
Opencast.

l

If Pearl is going to use an Opencast user name that was created using the Opencast Admin UI, then thisuser name must have the following minimum Opencast roles: ROLE_API_EVENTS_CREATE, ROLE_
API_EVENTS_EDIT, ROLE_API_WORKFLOW_DEFINITION_VIEW, ROLE_API_EVENTS_
SCHEDULING_EDIT, ROLE_CAPTURE_AGENTl

If Pearl is going to be used to create ad hoc or unscheduled events and opencast user name of type
opencast was used by Pearl, make sure that this user has the opencast ROLE_ADMIN.

Enable Pearl Nano as a capture agent and register with Opencast using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration page opens.
3. From the Choose CMS drop down, select Opencast and then click Apply.
4. Enter the Opencast Service URL, username and password.
5. Optionally enter a Device name you want to appear in Opencast for this device, then click Apply at thebottom of the page. The Status updates to Connected.

What's next?
Proceed to select which Pearl channels will be advertised to Opencast server and settings for ad hoc events, andselect default settings. See Opencast recording setup.

Opencast recording setup
Pearl Nano appears as an available capture agent as soon as the device is registered with Opencast. After asuccessful registration, you're ready to select video sources for multiple source recordings. Video sources must
be connected to Pearl Nano and assigned to a channel. Each channel configure on Pearl Nano is treated as aseparate video source for multiple source events in Opencast.
For more information about channels, see What is a channel?.
Topics include:lAbout Opencast recordingl

Set Opencast ad hoc event parametersl

Set the extend Opencast CMS event interval

346

Pearl Nano User Guide

About Opencast recording

About Opencast recording
The Pearl supports scheduled events, recurring events, and unscheduled ad hoc recordings. Scheduled events
start and end automatically. No manual intervention is required. After the event ends, recorded files
automatically upload to Opencast. Backup recordings are also saved locally on Pearl. If the network connectionor the CMS goes down during an event, Pearl continues to record locally and uploads the recording when
network connectivity resumes.
Pearl Mini and Pearl Nano - A large capacity (256 GB or more) SD card (or a large capacity SATA
M.2 2280 SSD on Pearl Nano) must be installed to record events. Do not remove the SD card whilefiles are uploading to Panopto.
Administrators can:l

Set Opencast ad hoc event parameters, Set Opencast ad hoc event parameters.

lChange the extend event button time allotment in 5, 10, and 15 minute intervals, see Set the extend
Opencast CMS event interval.

lCreate ad hoc events, see Create ad hoc events using the Admin panel.

lView the Events page to see all upcoming scheduled sessions and completed sessions, see View
scheduled CMS events and history.

l

Download local recordings for a channel, see Recover channel backup recordings.

lStart and stop scheduled events before the scheduled time, see Start/stop scheduled CMS events using
the Admin panel.

lExtend and pause scheduled events, see Extend or pause CMS recordings and webcasts

General InformationlStarting or stopping a scheduled VOD event before the scheduled start or stop time does not change theevent into an ad hoc event.

l

Pearl Nano must be registered with Opencast to record and stream Opencast events, see Enable CMS
and register with Opencast.

lScheduled events have priority over ad hoc events. If an ad hoc event is still in progress when it's time tostart a scheduled event, the ad hoc event is stopped and the scheduled event starts.

lScheduled VOD events automatically start recording locally on Pearl Nano even If the network is down orOpencast is unavailable. After the session ends, the locally recorded files upload automatically to
Opencast when the network link to Opencast is re-established.

l

If the network connection is lost during a file upload to Opencast, the transfer automatically restarts when
the network connection re-establishes.

l

If Pearl Nano loses power while a scheduled event is being recorded, the recording stops. If Pearl Nano is
powered back on before the scheduled end time for the event, recording of the scheduled event restarts
automatically and a second set of files are created.On Pearl Nano, a second recording is created. Whenthe event ends, the files are automatically uploaded to Opencast.

347

Pearl Nano User Guide

Set the extend Opencast CMS event intervall

If Pearl Nano was unavailable on the network or powered down and misses a scheduled event, the statusof that event appears as Skipped on the Events page in the Admin panel.

l

Do not use AFU or configure recording file size, type and other channel recording settings when CMS isenabled on Pearl Nano.

Pearl Nano informationl

Pearl Nano - You can start and stop events earlier than the scheduled time, as well as pause an event
using the Admin panel or the front panel control key interface on Pearl Nano.

lOpencast treats the channel you setup on Pearl Nano as a single video-source event for recordings. For
ad hoc events, the default name of the uploaded recording includes the date and start time of the event.
For example: 2019-07-15 08:00. A more intuitive name can be entered when the ad hoc event is created.

l

To use the front screen on Pearl Nano to start and stop events, see Stop/start scheduled CMS eventsusing Pearl Nano's front screen menu.

lTo monitor the channel during an event, you can display the Channel view on Pearl Nano's front screen,
see Confidence monitoring using the front screen. You can also monitor the channel using the Admin
panel or see a live preview of the channel and the audio level from the remote recorder page in Panopto.

Set the extend Opencast CMS event interval
A button on the front screen lets users extend the length of an event that is in progress. By default, the event is
extended in 5 minute intervals each time the button is tapped. Using the Admin panel, you can set the amount oftime the event is extended to 5, 10, or 15 minute intervals. Events cannot be extended beyond the start of thenext scheduled event.

Set the extend Opencast CMS event interval using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Settings, select the Extend event time interval from the drop down list and click Apply.

Set Opencast ad hoc event parameters
Using the Admin panel, you can set parameters that are associated with ad hoc events, including:lSession title: This assigns a default title for ad hoc events. Default variables specify the current date andtime as the title using the format yyy-mm-dd hh:mm. This default title can be changed when an ad hoc
event is created.

l

Duration: Assign a default duration for ad hoc events. This value can be changed when an ad hoc event iscreated.

348

Pearl Nano User Guide

CMS recording and webcasting controll

Subject: This assigns a default subject for Opencast ad hoc events. This default title can be changed
when an ad hoc event is created.

l

Description: This assigns a default description for Opencast ad hoc events. This can be changed when an
ad hoc event is created.
Pearl Nano must be registered with Opencast for this procedure to work.

Enter Opencast ad hoc event parameters using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Unscheduled ad hoc events, enter the information you want associated with this ad hoc event andclick Apply

CMS recording and webcasting control
Pearl Nano appears as an available resource as soon as the device is registered with your CMS and records
scheduled events, recurring events, and unscheduled ad hoc events for the CMS the Pearl is registered with.
Connect multiple audio and video sources directly to Pearl Nano and record content from HD cameras,
document cameras, HDMI output from computers, and even digital microscope cameras.
Scheduled events start and end automatically. No manual intervention is required. After the event ends,
recorded files automatically upload to the CMS. If the network connection or the CMS goes down during an
event, it records locally on Pearl Nano and uploads automatically when network connectivity resumes. You canmanually control recording and webcasting using the Admin panel or the device screen. Back up recordings areeasily recovered using the Admin panel.
Do not schedule recordings that are longer than the capacity of Pearl Nano to store the recording on
it's local drive. We recommend using large capacity SD cards such as 256 GB or a large capacity
SATA M.2 SSSD when using Pearl Nano with a CMS.

Do not remove your storage device from the Pearl device during a recording.
Topics include:lStart/stop scheduled CMS events using the Admin panellExtend or pause CMS recordings and webcastslStop/start scheduled CMS events using Pearl Nano's front screen menulCreate ad hoc events using the Admin panell

Log out of an ad hoc session349

Pearl Nano User Guidel

Schedule when CMS event recordings uploadlRecover channel backup recordings

Set up a CMS start screen

For important considerations before recording or webcasting to a CMS, see About Kaltura recording andwebcasting and About Panopto recording and webcasting.

Set up a CMS start screen
You can use the Admin panel to set the Pearl device to show the Content Management System (CMS) Events
screen on the Pearl device screen at start up. You can also lock the start screen to restrict access to any otherscreen. Locking the start screen is useful when operating the Pearl device in public spaces, classrooms, andunmanned kiosks.
To access the touch screen configuration page (front screen configuration page on Pearl Nano), click Touch
Screen (Front Screen for Pearl Nano) in the navigation pane of the Admin panel.
The start screen options for CMS event control are:l

Default: The CMS Events screen appears automatically on the device screen when CMS is enabled andthere's an upcoming scheduled event. On Pearl-2 or Pearl Mini you can also tap the calendar icon at thebottom of the touch screen.

lContent Management System: The CMS Events screen displays automatically on the device screen
when you power on the Pearl device. Operators can still navigate to other screens using the device
screen.

l

Start screen locked mode: The CMS Events start screen is the only screen that displays on the screen of
the Pearl device. Operators cannot navigate to other screens.

If no 4-digit PIN set when the start screen is in locked mode, you can access the CMS Events start screen rightaway. However, you cannot access any other screens.
If you set a 4-digit PIN when the start screen is in locked mode, a lock appears in the top right of the start screen.
You must enter the PIN to unlock the CMS Events start screen and access the other screens. When you return to
the CMS Events start screen, Pearl device automatically locks itself and you must re-enter the 4-digit PIN to
unlock the screen.

Setup a CMS Events start screen using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Touch Screen (Front Screen on Nano). The Touch Screen/Front
Screen configuration page opens.
3. From the Start screen drop-down menu, select Content Management System.
4. (Optional) Check Start screen locked mode and set a 4-digit PIN. For more information about setting a
PIN, see Set a PIN security code.

350

Pearl Nano User Guide

Start/stop scheduled CMS events using the Admin
panel

5. Click Apply.

If you chose Content Management System, the Pearl device screen automaticallyrefreshes to display the CMS Events screen.

Start/stop scheduled CMS events using the Admin panel
You can start scheduled CMS events from the Events menu using the Admin panel and stop events before theirscheduled end time. After an event ends, the recorded video files upload automatically to the CMS.

Important considerationsl

If you manually stop a scheduled CMS VOD event before the scheduled end time when the Pearl device
doesn't have network connectivity, the Pearl device uploads the completed event's recording when
network connectivity resumes. However, Panopto does not recognize that the event has ended. The event
remains in the In Progress state in Panopto and you must wait until the original event's scheduled end
time before creating a new event using that Pearl device.

l

Do not power down a Pearl device while a scheduled webcast event is in progress. The webcast ends but
the RTMP stream that was created automatically on the Pearl device is not deleted from the channel's
Streaming page. Use the Admin panel to manually delete the webcast stream instance from the channel's
Streaming page.

Start a scheduled CMS event using the Admin panel
From the Admin panel, select the Events menu and click Start beside the scheduled event on the Events page.

351

Pearl Nano User Guide

Stop/start scheduled CMS events using Pearl
Nano's front screen menu

Stop a scheduled CMS event using the Admin panel
Under Ongoing and completed events, a Stop button appears beside the event while the event is recording.
You can select that to stop the event before the scheduled end time.

TIP: In the Admin panel, you can click Refresh schedule at any time to manually update the events listed on the
Events page.
After the event ends, it may take a while for content to show up in Kaltura's media lists, depending on
how busy the Kaltura CMS system is at the time.

Stop/start scheduled CMS events using Pearl Nano's front
screen menu
You can use the Pearl Nano's front screen and the control key interface to manually start scheduled events up to
thirty minutes before the scheduled start time.
When CMS is enabled on Pearl Nano, an Events screen is added to the screens you can view on the front
screen. If you don't see the Events screen on the front screen, press the left arrow key (or the right arrow key) on
the control key interface to cycle through the different views.

When an event is scheduled, the Event screen updates with the event name and a countdown timer. Five
minutes before the scheduled event, the event name and timer on the Events screen turn red. You can selectStart event using the control keys to start the event up to a half an hour before the scheduled start time.
When the event starts, the button changes to Stop event. Select Stop event when you're done or just wait for the
event to stop automatically at the scheduled time. Recordings upload automatically to your CMS.

352

Pearl Nano User Guide

Stop/start scheduled CMS events using Pearl
Nano's front screen menu

For important considerations before recording or webcasting to a CMS, see About Kaltura recording andwebcasting and About Panopto recording and webcasting, or YuJa setup.

Important informationlYour Pearl device must already be registered with your CMS to appear listed as a remote recorderresource in Kaltura or Panopto. Contact your CMS administrator responsible for setting up hardware
encoders for your organization if the Pearl device isn't listed as a resource or the calendar icon does notappear on the front screen.

l

Pearl Nano's channel is treated as a single, primary video source in Kaltura and Panopto.

l

For Kaltura, the channel used for live streaming is pre-configured by the Pearl administrator.

lPanopto users can select the resolution for the video source in Panopto when a new scheduled orrecurring session is created. The encoding settings are applied automatically to the channel on Pearl
Nanol

After the event ends, recordings automatically upload to the CMS. It may take a while for content to show
up in Kaltura's media lists, depending on how busy the Kaltura CMS system is at that time. Recordings areassociated with the user account that scheduled the event.

l

If network connectivity is lost during a scheduled VOD event, the Pearl device continues to record theevent locally. When network connectivity re-establishes and the event ends, the recording uploads to the
CMS as expected.
For Panopto VOD events, if you manually stop a scheduled VOD event before the scheduled
end time when the Pearl device doesn't have network connectivity, the Pearl device uploads
the completed event's recording when network connectivity resumes. However, Panopto
does not recognize that the event has ended. The event remains in the In Progress state in
Panopto and you must wait until the original event's scheduled end time before creating a
new event using that Pearl device.

353

Pearl Nano User Guide

Extend or pause CMS recordings and webcasts

Extend or pause CMS recordings and webcasts
You can extend an active scheduled or ad hoc event using the Pearl device's front screen or the Admin panel.
The extend event button can be configured to add 5, 10, or 15 minutes to the event each time it is selected, or 6,
10, or 15 in the case of YuJa. See Set the extend Kaltura CMS event interval, Set the extend Panopto CMS event
interval, Set the extend Opencast CMS event interval or Set the extend YuJa CMS event interval, depending on
the integrated CMS.
The option to extend the event appears on the Events screen while the event is in progress. Events cannot be
extended beyond the start of the next scheduled event.
On the Pearl Nano, use the front panel control key interface to select the button to add the specified amount oftime to the current event.

For Panopto, Opencast and YuJa events, you can also pause active recordings and webcasts from the Pearldevice screen or using the Admin panel. An extra pause button appears on the Events screen. For Panopto you
can also set up your Pearl device to mute the audio and display an event paused image to let your viewers know
the event is paused, see Enable mute and display image on pause.

If mute on pause and the on-screen pause illustration are not enabled on your Pearl device, yourviewers watching the stream can see and hear the live webcast while the event is paused, as well as
in the recording in Panopto

If an Opencast event is paused, audio is muted and an event paused image is displayed to letviewers know that the event is paused. The duration for which the recording was paused is notedited out of the video however.

354

Pearl Nano User Guide

Extend or pause CMS recordings and webcasts

Important informationl

The Pearl device records and uploads the full event to Panopto, or YuJa, for processing. After the event is
uploaded, the CMS platform removes the paused segments from the final recording. However, Panopto
and YuJa do not remove paused segments from webcasts. The complete webcast recording including thetime the event was paused is kept.

l

If audio doesn't mute and an event paused screen doesn't appear, you must enable that feature using theAdmin panel, see Enable mute and display image on pause.

l

If Opencast event is paused, audio is muted and an event paused image is displayed to let viewers knowthat the event is paused. The duration for which the recording was paused is not edited out of the video
however.

Pause an event using a programmable USB attached button
Panopto, Opencast or YuJa recording in progress on Pearl can be paused and then resumed using a
programmable USB attached button. The following Delcom USB button are supported:lDelcom USB HID Programmable Single Button Switch, part number 706501

Programming the Delcom USB HID Programmable Single Button Switch

1. Download, install and start the Delcom Software utility on a Windows computer.
2. Connect the Delcom USB Single Button switch to a USB port on the computer.
3. Within the Delcom setup utility, click the Read Device button.
4. Verify that the Delcom setup utility is able to successfully detect and read data from the attached USB
button.

355

Pearl Nano User Guide

Extend or pause CMS recordings and webcasts

5. In the Button setup section of the setup utility, program BUTTON 1 of the switch with the following
settings:
a. TYPE: KEYBOARD
b. ACTION: Momentaryc. CODE: 19 - Keyboard p and P
d. LED: Off
e. Init: selected
6. Click Program Device.
7. Click Yes, when prompted to program the device.
8. Verify that the programming was successful.
9. Within the Delcom setup utility, click the Read Device button to verify the settings match those
programmed.

To pause a Panopto, Opencast or YuJa event that is in progress:

1. Attach the Delcom USB HID Programmable Single Button Switch to one the USB ports at the back ofPearl.
2. When CMS event is in progress, the LED light on the Delcom button is turned on.
3. Press the button to pause the recording.
4. The LED light pulses to indicate that the CMS event is paused.
5. Press the button again to resume event.

Extend or pause an event using the Admin panel
1. From the Admin panel, select the Events menu and then click the button to extend the current event. In
this example, the button adds +5 minutes each time it is pressed.

2. If this is a Panopto, Opencast, or YuJa, event, you can select Pause to pause the current event. Whenpaused, the button changes to Resume. When you're ready to continue, select Resume.

356

Pearl Nano User Guide

Create ad hoc events using the Admin panel

Extend or pause an event using the front screen on Pearl Nano
1. If you don't see the Events screen on the front screen, press the left arrow key (or the right arrow key) on
the control key interface to cycle through the different views. The Event screen shows the event name anda countdown timer when an event is in progress.

2. To extend the current event, use the arrow and check mark keys to select the button to extend the current
event. In this example, the button adds +5 minutes each time it is selected.
3. If this is a Panopto, Opencast, or YuJa, event, you can use the arrow and check mark keys and selectPause to pause the current event. When paused, the button changes to Resume. When you're ready tocontinue, select Resume.

Create ad hoc events using the Admin panel
You can create and start an ad hoc recording or webcast using the Admin panel. Your Pearl device must be
registered with your CMS to create ad hoc events, seeIntegration .
You must authenticate using your CMS login credentials before you can enter the ad hoc event details and start
the event. Contact your CMS administrator if authentication fails and login is denied.
User accounts must be defined on the CMS itself and not a subsidiary system such as an LMS.

357

Pearl Nano User Guide

Create ad hoc events using the Admin panel

Kaltura event details
Table 70 Kaltura ad hoc event details
Item

Description

Event owner

The event owner will be the email connected to your Kaltura account.

Full name

The full name associated with the Kaltura account.

Admin ownerSelect a Kaltura user group from the drop down list. The groups listed here aregroups that the event creator is a member of. Kaltura groups must be enabled fromthe Kaltura settings page. For more information, see Kaltura settings.

Session title

Enter a unique name for the ad hoc event. If no name is entered, a default event
consisting of the current date and time is applied. For example: 2019-07-04 13:22

Description

Enter a description of the event.

Tags

Add Kaltura search tags separated by commas. For example: tag1, tag2, tag3.

Category

Add a Kaltura category.

Duration

Select the event duration in minutes from the drop down list or enter a value using
your keyboard. Select a value from 5 to 240 minutes or enter a value using yourkeyboard.

Event type

Choose either VOD (Video on Demand), Live-stream, or VOD + Live-stream as thead hoc event type.

Panopto event details

358

Pearl Nano User Guide

Create ad hoc events using the Admin panel

Table 71 Panopto ad hoc event details
Item

Description

Session title

Enter a unique name for the ad hoc event. If no name is entered, a default event
consisting of the current date and time is applied. For example: 2021-07-04 13:22
Select the folder in Panopto where you want the recorded file to upload. Your Panopto
MyFolder is the default folder.

FolderFor ad hoc events, the Pearl device ignores a user's presets that are set in Panopto.
As a result, ad hoc recordings automatically upload to the user's default folder as
originally assigned by Panopto.

Duration

Select the event duration in minutes from the drop down list or enter a value using
your keyboard. Select a value from 5 to 240 minutes or enter a value using yourkeyboard.

Event type

Choose either VOD or Live-stream as the ad hoc event type.

Table 72 Opencast ad hoc event details
Table 73
Item

Description

Session title

Enter a unique name for the ad hoc event. If no name is entered, a default event
consisting of the current date and time is applied. For example: 2021-07-04 13:22

Duration

Select the event duration in minutes from the drop down list or enter a value using
your keyboard. Select a value from 5 to 240 minutes or enter a value using yourkeyboard.

Subject

Provide a subject for the event.

Description

Enter a description for this Opencast event

Create an ad hoc event using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Events menu, click Events. The Events page opens.

359

Pearl Nano User Guide

Create ad hoc events using the Admin panel

3. Click Create new event. A pop-up window appears.
a. For Kaltura: In the Event owner field, enter your Kaltura user ID as your CMS login credentials, thenclick Login. After you're authenticated, your user name appears in the Full name field and you canenter the ad hoc event details.
b. For Panopto: Enter your Panopto CMS user name and password in the login window, then click
Sign in. In the events details pop up, your user name appears in the Full name field and you canenter the ad hoc event details.
If you get the login error that your account is not active, your CMS has blocked youraccount. If login to the CMS is denied, the account you entered may not exist or may
not have access rights to create an ad hoc event using Pearl device. Contact your
CMS administrator for CMS related login and account issues.
4. Click Start event now when you're ready to start recording or Live-streaming. Or click Cancel.
When you're done creating ad hoc events, it's good practice to log out of the CMS so that nobody can use
your CMS account to create events using the Admin panel, see Log out of an ad hoc session.

360

Pearl Nano User Guide

Log out of an ad hoc session

Log out of an ad hoc session
After you've logged into Kaltura from the Admin panel (or touch screen on Pearl 2 and Pearl Mini) and started anunscheduled ad hoc event, your login session stays active for one hour after the event ends. You areautomatically logged out after one hour.
For Panopto ad hoc events that you start using the web-based Admin panel, Panopto preserves your login
credentials after the ad hoc event ends. To avoid someone else from using your account to create ad hoc
Panopto events from the Admin panel, you must manually logout after you're ad hoc event ends and close yoursession with the Panopto server. Alternatively, you can use an incognito/private browser session with the Admin
panel. Then when you manually log out of your Panopto session using the Admin panel and close theincognito/private browser, your Panopto session closes and you are fully logged out.
Before you begin, you need your Panopto server URL, for example:
https://<myorg>.hosted.panopto.com/

Manually logout of an ad hoc session with Panopto using the Admin panel
1. From the Events menu, click Events. The Events page opens.

2. Click Logout beside your login user name.
3. To close the authentication session with the Panopto server, open a new tab in the same browser that you
used to login and go to: https://<PanoptoServerURL>/Panopto/Pages/Auth/Logout.aspx
Closing the authentication session with the Panopto server may not close theauthentication session with a third-party LMS.
4. Return to the Admin panel and click Create new event on the Events page to confirm that you're logged
out of Panopto. A blank login page should appear.

Schedule when CMS event recordings upload
As soon as your Content Management System (CMS) event ends, the Pearl device uploads the associatedrecordings to the CMS server if a network connection to the CMS server is available. Using the Admin panel, you
can schedule the Pearl device to upload recordings only during a specific time period. Recordings made outside361

Pearl Nano User Guide

Upload the local Panopto webcast recording

the upload time period are queued and only upload when the time to start uploading is reached. This feature isdisabled by default.

Schedule when the Pearl Device can upload event recordings using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration menu opens.
3. Under Upload schedule, check File upload schedule and select the start and stop times of the file upload
period. Then click Apply at the bottom of the page.

Upload the local Panopto webcast recording
By default, the Pearl device always records a Panopto webcasting event locally and uploads that recording when
the webcast ends. Once uploaded, the Panopto server uses the local recording from the Pearl device instead of
the original webcast. You can disable this feature using the Admin panel.
The Pearl Mini and the Pearl Nano need a storage solution to use this feature. The Pearl Mini canuse an SD card and the Pearl Nano can use an SD card or SATA m.2 2280 SSD.
If an upload schedule is set, the webcast recording uploads during the scheduled upload time period, see
Schedule when CMS event recordings upload.

Enable or disable uploading the local webcast recording using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click CMS. The Content management system configuration page opens.
3. Under Settings, check Upload the webcast recording and click Apply at the bottom of the page to always
upload the local recording of webcasting events or uncheck Upload the webcast recording to disable thefeature.

362

Pearl Nano User Guide

Recover channel backup recordings

Recover channel backup recordings
Recordings automatically upload to Kaltura or Panopto after the event ends. If for some reason the recordings
are not available in the CMS, administrators can manually download backup recordings for a channel on thePearl device.
Your Pearl device saves a local backup of recordings automatically in a round-robin fashion. When the record
drive is full, new recordings overwrite the oldest ones. Pearl administrators and operators can use the Admin
panel to manually download and delete channel recordings. For more details about managing recordings, seeManage recorded files.

Download recordings for a channel using the Admin panel
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.
2. From the Events menu, click the arrow icon beside the event to see which channels were included for thatevent.

3. From the Channels menu, click Recording. The Recordings page for that channel opens with a list ofrecorded files.
4. Click the name of the recording to download the file or select multiple files and click Download Selected.

363

Pearl Nano User Guide

Recover channel backup recordings

Delete recordings for a channel using the Admin panel
To delete recordings for a channel, do one of the following:l

To delete a single recording, click the X icon to the right of a recording and click OK when prompted.

l

To delete multiple recordings, check the check box beside the recordings you want to delete and click OK
when prompted.

l

To delete all recordings for the selected channel, click Delete Selected and click OK when prompted.

364

Pearl Nano User Guide

Recover channel backup recordings

The list may not update immediately. You can refresh the list by reloading the Recording page(for channels) or the recorder settings page (for recorders).

365

Pearl Nano User Guide

Maintenance

Maintenance
Keep your Pearl Nano running smoothly using the latest firmware updates and maintenance features.
Topics include:lPower down and system restartl

Back up your Pearl device setuplPerform a factory resetlFirmware upgradelSupportlRegister your devicelStorage capacity and maintenancePower down and system restart
You can do the following to power off Pearl device or reboot the device:lChoose Reboot from the Maintenance page using the Admin panel.

l

Reboot using the front screen menu.

lPower off the device by removing the power adapter cable attached to the rear panel of Pearl Nano.

Reboot the device using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance. The maintenance page opens.
3. Under the Maintenance section, select Reboot Now and click OK when prompted.

366

Pearl Nano User Guide

Power down and system restart

Reboot the device using the front screen menu
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, scroll down using
the arrow key and select Reboot.

3. Press the check mark key to select Reboot now when prompted.

367

Pearl Nano User Guide

Back up your Pearl device setup

Back up your Pearl device setup
Configuration presets are the perfect way to back up your Pearl device setup so that you can reapply it later
without worrying if someone changes your settings or does a factory reset.
You can create a configuration preset from the Configuration menu when you select Maintenance, see
Configuration presets.

368

Pearl Nano User Guide

Perform a factory reset

Perform a factory reset
Administrators can use the Admin panel to perform a factory reset and restore the configuration of Pearl Nano to
the manufacturer's original default settings. For a list of affected settings, see The Factory default configuration
preset and Factory reset.
Performing a factory reset erases all your input port settings (video and audio), channel
configuration, network settings, configuration presets, all locally saved media files and recordings
from Pearl Nano.
Consider applying a factory default configuration preset if you want to preserve your uploaded media files,
configuration presets, and channel recordings, see Configuration presets.

Perform a factory reset using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Maintenance. The maintenance page opens.

3. Under the Maintenance section, select Reset and click OK when prompted.

4. The device resets to factory defaults and reboots. Wait for the system to finish rebooting before
configuring Pearl Nano.

Perform a factory reset using the front screen menu369

Pearl Nano User Guide

Firmware upgrade

1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, select Settings toopen the Settings screen.

3. From the Settings screen, select Factory reset to open the Factory reset screen.

4. Select Factory reset using the check mark key to reset to the factory settings.

Firmware upgrade
When you register your product with Epiphan, you can choose to receive email notifications whenever firmware
updates are available. To take advantage of exciting new features and important fixes for your Pearl device,install new firmware whenever the system indicates that a firmware update is available.
Topics include:370

Pearl Nano User Guidel

Firmware upgradelUpdate the firmware

Firmware upgrade

Check for firmware updatesYour Pearl device automatically checks for firmware updates if the Enable connection to maintenance server
option is checked on the Maintenance page of the Admin panel. You can also manually check for updates If yourPearl device has internet access. Don't miss out on any feature enhancement. Register your Pearl device and be
eligible to download firmware updates, see Register your device.
When Enable connection to maintenance server is checked, the built-in firmware update
mechanism checks for updates for your specific product and hardware version automatically.

Manually check for new firmware using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Firmware Upgrade. The firmware upgrade page opens.
3. Click check for updates beside the current firmware version. If an update is found, a red box appears in
the top left side of the Admin panel with a link to download and install the firmware.

Manually check for new firmware using the front screen menu
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Use the arrow and check mark keys to select System. Then from the System screen, scroll down using
the arrow key and select Reboot.

371

Pearl Nano User Guide

Firmware upgrade

3. Press the check mark key to select Reboot now if prompted.

Update the firmware
If your Pearl Nano has internet access, the easiest way to install a firmware update is to use the download linkthat's provided when you check for new firmware. If you have a Pearl Nano firmware file that was provided to you
by Epiphan Video, you can install the new firmware using the web-based Admin panel.
You cannot install new firmware from a locally saved file using the local console on Pearl Nano.
While the firmware is updating, the front screen displays a firmware update in-progress notice. All streaming andrecording functions stop until after the firmware upgrade is complete.
Installing new firmware takes a few minutes, after which the system reboots. Depending on the upgrade, a disk
rebuild may be required, causing the restart process to take more time. Please be patient and wait for the system
to finish rebooting.
Do not interrupt power to the system during a firmware upgrade.

Before you begin
Schedule a time to when you can update the firmware without negatively impacting viewers or automatic file
upload and recording schedules.
It's good practice to make a backup of your current configuration before applying a firmware update so that you
can revert to the previous firmware if needed, see Create a configuration preset. You should also clear your web
browser's cache after the update is complete.

Perform a firmware update using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. (Optional) Save a copy of the current system configuration. See Configuration presets.
3. From the Configuration menu, select Firmware Upgrade. The firmware upgrade page opens.

372

Pearl Nano User Guide

Firmware upgrade

4. Do one of the following:a. Click check for updates. If a red box appears in the top left side of the Admin panel, click
Download and install.
b. Click Choose File and select the firmware upgrade file that's located on your admin computer, thenclick Apply. The system unpacks and verifies the file. If the file is valid, the upgrade begins.
A notice that the firmware update is in progress appears on the front screen.

Do not interrupt power to the system during the firmware upgrade.
5. When the firmware update is complete, a message lets you know that Pearl Nano is going to reboot. Wait
for the system to restart.

6. After the system reinitializes, go to the settings for your web browser and clear your web browser's cache.
7. Connect to the Admin panel and login as admin, see Connect to the Admin panel.
8. From the Configuration menu, select Firmware Upgrade. The firmware upgrade page opens. Verify thatthe firmware version is the expected new version.
If in the rare occasion the firmware update fails, the front screen reports the failure. Please collect system
information such as the serial number of Pearl Nano, the previous firmware version (if known), and the newfirmware version and contact info@epiphan.com

373

Pearl Nano User Guide

BIOS update

Perform a firmware update using the front screen menu
When a firmware update is available, a new option to update the firmware appears on the Menu screen.
1. Press the left arrow key repeatedly on the control key interface until the Menu screen displays.

2. Press the check mark key to select Firmware update when that option appears on the front screen.

3. Press the check mark key to select Reboot now if prompted.

BIOS update
If Pearl Nano requires a BIOS update, a BIOS Upgrade section appears on the Firmware update page in the
Admin panel. We recommend performing the BIOS update whenever they become available to ensure optimum
performance of your device.
The BIOS Upgrade section appears on the Firmware Update page only when your Pearl Nano system requiresa BIOS update.

Perform a BIOS update using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. (Optional) Save a copy of the current system configuration. See Configuration presets.
3. From the Configuration menu, select Firmware Upgrade. The firmware upgrade page opens.
4. Select Update BIOS and click OK when prompted. The update should begin.

374

Pearl Nano User Guide

BIOS update

Do not interrupt power to the system during the BIOS update.
5. When the BIOS update is complete, a message lets you know that Pearl Nano is going to reboot. Wait forthe system to restart.

6. After the system reinitializes, go to the settings for your web browser and clear your web browser's cache
7. Connect to the Admin panel and login as admin, see Connect to the Admin panel.
8. From the Configuration menu, select Info and confirm that the date of the BIOS has updated.

375

Pearl Nano User Guide

Register your device

You can also confirm that the latest BIOS is installed on Pearl Nano when the section called
BIOS Upgrade no longer appears on the Firmware Upgrade page in the Admin panel.

Register your device
When you register your product with Epiphan, you become eligible to download firmware updates when they
become available. Take advantage of exciting new features and important fixes for your Pearl device.
Registering your Pearl device is free and only needs to be done once. You have an option to sign up for email
notifications whenever a new firmware update is available.
You can register using the Admin panel or online at: www.Epiphan.com/register
You need the serial number of your Pearl device to register. The serial number appears on a sticker attached tothe bottom of the device. You can also see the serial number using the front screen menu when you selectSystem > Device Information.
The banner to register your device appears on the Firmware update page in the Admin panel. If yoursystem is registered or there are no firmware updates are available, you will not see a banner on the
Firmware update page.

Register using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Firmware Upgrade. The firmware upgrade page opens.
3. Click Register in the banner at the top of the page, then enter the information on the registration form.

376

Pearl Nano User Guide

SupportSupportYour Pearl device comes with a one-year complimentary support plan starting one year from the original productshipment date. You can purchase a 2-year extended support plan from Epiphan Video for a total of three years of
product support from the original product shipment date:lSupportPlan offers a 2-year support extensionlSupportPlan+ offers a 2-year support extension plus remote troubleshooting support

Remote troubleshooting support allows the Epiphan support team to remotely access Pearl Nano to help
troubleshoot issues and reset lost admin passwords. No private information is sent to the Epiphan maintenanceserver during a remote session. For more information about service plans, see www.epiphan.com/supportplan.
To contact Epiphan support:lEmail: support@epiphan.com

lOnline chat: www.epiphan.com/support (Monday to Friday between 9am and 5:00pm EST)l

Call: 1-877-599-6581 / 613-599-6581

From time to time, Epiphan support may ask you for logs from your system. Follow the instructions to download
files for support.
Remote support is only provided for systems covered by SupportPlan+.

Download the logs using the Admin panel
If requested by Epiphan support, you can download the logs files and/or "allinfo" data from your system. Thesefiles help our support team troubleshoot problems.
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Maintenance. The maintenance page opens.

377

Pearl Nano User Guide

Support

3. Check Permanent Logs and click Apply.
4. Select Maintenance again to refresh the maintenance page and click Download permanent logs. A zip
file containing system downloads.

Download the allinfo file
1. From your browser, run the allinfo script. A file is saved to your computer.
Pearl devices: http://<ip address of your system>/admin/allinfo.cgi
2. Share the log files and the allinfo results with Epiphan support.

Configure remote support
Remote support is enabled on Pearl Nano by default and allows the Epiphan support team to remotely access
Pearl Nano to help you troubleshoot issues and reset lost admin passwords.
Your network must allow access to the Epiphan maintenance server, which has the domain nameepiphany.epiphan.com. Pearl Nano must be able to resolve this domain name to connect to the Epiphan
maintenance server for remote support.
Remote support uses ports 22 and 30. Ensure that these ports are opened to allow remote communication. If
your Pearl Nano is on a network that is protected from the Internet by a firewall, consult with your network
administrator to configure your network to allow remote Internet access through the firewall for those ports and to
add epiphany.epiphan.com to the network's allowed list.

378

Pearl Nano User Guide

SupportRemote support is only provided for systems covered by SupportPlan+. For more information about
service plans, see www.epiphan.com/supportplan.

Configure remote support using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Maintenance. The maintenance page opens.

3. Check Enable remote support to enable incoming connections from Epiphan Systems.
4. Check Enable connection to maintenance server to enable outgoing links to the Epiphan maintenanceserver epiphany.epiphan.com.
5. Click Apply.
6. Test that Pearl Nano can access the maintenance server:
a. From the Configuration menu, select Network.
b. In Network Diagnostics, enter epiphany.epiphan.com and click ping.
c. The result of the ping should show an IP address for epiphany.epiphan.com. Report any packet
losses to Epiphan support.
7. If Pearl Nano can't reach the maintenance server, check the network settings to ensure DHCP is selectedor a DNS server is listed, then try again. Consult with your network administrator if problems persist.
8. If Pearl Nano reaches the maintenance server, ensure your firewall has port 30 open.
9. Confirm with Epiphan support that they are able to access your Pearl Nano for remote troubleshooting.

379

Pearl Nano User Guide

Storage capacity and maintenance

Disable remote support
Remote support is enabled by default. You can turn remote support off for your Pearl Nano using the Admin
panel.
Disabling remote support removes the ability for Epiphan to reset a lost admin password on yourPearl Nano. If you forget the admin password and remote support feature is off, you will need toreturn the system to Epiphan for reprogramming.

Disable remote support for your Pearl Nano using the Admin panel
1. Login to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, click Maintenance. The maintenance page opens.
3. Uncheck Enable remote support to disable incoming connections from Epiphan Systems.
4. Uncheck Enable connection to maintenance server to disable outgoing links to the Epiphan
maintenance server epiphany.epiphan.com.
5. Click Apply.

Storage capacity and maintenancePearl Nano has support for removable SD cards, which are formatted to use the ext4 file system and can only beread with a computer running Linux. Video recordings that you make are saved to the SD card. You can checkhow much space you have left on the SD card using the Admin panel and from the front screen.
If you install a SATA M.2 2280 SSD, the SD card is no longer used for recordings and the status of the SD cardchanges to not detected. Any video recordings that are saved to the SD card no longer appear in the channel's
list of recordings and cannot be download using the Admin panel. We recommend that you temporarily remove
the SSD until you have retrieved the recorded files from the SD card using the Admin panel.
Pearl Nano also has local storage for internal processes and 6 GB of that space is allocated for uploaded media,
like image files that you add to your channel layout. You can see how much space you have for media files from
the Media menu using the Admin panel.
Topics include:lCheck storage capacityl

Check media storage capacity

Check storage capacity
Using the Admin panel, the amount of available storage space on the SD card is shown at the bottom of themenu panel, as well as on the SD card configuration page.

380

Pearl Nano User Guide

Storage capacity and maintenance

If a SATA M.2 2280 SSD is installed in Pearl Nano, the available storage space on the SSD is shownat the bottom of the menu panel and the SD card option is removed from the list of Configuration
menu options in the Admin panel.
You can also check available storage capacity using the front screen menu on Pearl Nano. The total amount ofstorage capacity depends on the size of storage device you install.
It’s good practice to check how much storage you have available. If the amount of storage is low, you can swap
SD cards or remove some of the recorded files, see Manage recorded files and Automatic file transfers.

Check the storage capacity using the Admin panel
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.
2. Using the Admin panel, view the Internal Storage section at the bottom of the menu panel. The bar will bemostly green if there is lots of space left, or mostly red if storage space is nearly full.

If no SD card or SSD is installed, the following appears:

Check storage capacity from the front screen
Press the left arrow key repeatedly on the control key interface until the System status screen appears. The
amount of storage available on the installed storage media is displayed.

381

Pearl Nano User Guide

Storage capacity and maintenance.
If a SATA M.2 2280 SSD is installed, the SSD storage capacity displays instead of the SD card.
You can also view the storage capacity when you select Storage using the front screen menu. A USB storage
device must be connected to see the USB storage appear.

Check media storage capacity
Pearl Nano has 6GB of internal storage that's allocated for uploaded media, like image files that you add to achannel layout. You can see how much space you have for media files using the Admin panel.

Check media storage capacity using the Admin panel
1. Login to the Admin panel as admin or operator, see Connect to the Admin panel.

382

Pearl Nano User Guide

Storage capacity and maintenance

2. From the Configuration menu, select Media. The Media configuration page opens with the amount ofcapacity listed at the top of the page.

383

Pearl Nano User Guide

Troubleshooting

Troubleshooting
Pearl devices have easy-to-use diagnostic tools to test connectivity status, check upload/download bandwidth,
traceroute, and more to help you troubleshoot your Pearl device. You can also fine tune channel settings such as
frame rate, resolution and bitrate to ensure optimal use of resources while streaming a quality video and fine tune
the video input sources.
Topics include:lDiagnostic toolslRun diagnostic tests using the Admin panell

Run diagnostic tests using the device screenlTroubleshooting Quick ReferencelRemove black bars (matte) from the videol

Use a specific EDID for the video input port
It's good practice to backup your configuration settings so that you can revert back to a good
configuration if the changes you made are not desirable, see Configuration presets .

If your problems persist, there are more resources, including contact information, at Epiphan Support.

Diagnostic tools
Diagnostic tools are available to help you troubleshoot your Pearl device setup and network connection. You canrun them using the Admin panel. The Connectivity status diagnostic is also available using the front screen
menu.
Available diagnostic tools:lConnectivity status: Display the status of critical network connections and features like 802.1x, seeConnectivity status results.

lPing: Test if the Pearl device can reach a specified destination server on the network. Not all networks
support ping.

l

Trace route: Trace the route that packet traffic takes to get from Pearl device to a specified destination
server on the network. Not all networks support traceroute.

lBandwidth test: Display the available upload and download bandwidth speed in Mbps.

l

Domain name resolution: Confirm that the domain name of the DNS server configured on Pearl device isresolvable.

lProbe: Check if a network port is open on the network side.

Using the Admin UI, diagnostic tools are accessed from the Configuration menu when you select Network. To
learn how, see Run diagnostic tests using the Admin panel.

384

Pearl Nano User Guide

Connectivity status results

The Connectivity status diagnostic tool can also be accessed from the front screen menu when you selectSystem > Network > Connectivity status.

The following table describes what the colored icons in the results indicate.
Table 74 Diagnostic test result icons
Icon

Description
The diagnostic test result is okay. This can alsomean that a specific feature is enabled on Pearl
Nano.
The feature or option is disabled on Pearl Nano.
The diagnostic test result is not okay. An error was
detected.

Connectivity status results
The following table describes the Connectivity status diagnostics results shown on the front screen and theAdmin panel.

385

Pearl Nano User Guide

Connectivity status results

Table 75 Connectivity status diagnostics results
Diagnostic

Description

Ethernet cable

Check if an Ethernet cable is detected and connected to theLAN.

802.1xReport the status of 802.1x negotiation and if the feature isdisabled on Pearl Nano. Status results include: disabled,
authenticated, in progress, and failed.

DNS

Check if Pearl Nano can resolve host names with theirassociated IP address using the DNS server that isconfigured for Pearl Nano. For information about setting a
DNS server IP address for Pearl Nano, see Configure astatic IP address.
Check for connectivity issues caused by a Captive portal.
An okay result can indicate several conditions:

Captive portall

No captive portal is detected and Pearl Nano can
successfully reach the Internet.

l

A captive portal is detected and Pearl Nano can
successfully reach the public Internet.

Internet

Check if Pearl Nano is connected to the Internet by sending
a ping to IP address 8.8.8.8 on the Internet.

HTTP (port 80)

Check if traffic can be sent and received over the network
using HTTP port 80.

HTTPS (port 443)

Check if traffic can be sent and received over the network
using HTTPS port 443.

Support server

Check if the connection to the Epiphan support server isenabled and if enabled, confirm that Pearl Nano canestablish communication with the server. A successfulconnection is required to use the Epiphan Edge remotelogin feature.

Epiphan Edge™

Check if the Epiphan Edge remote management feature isdisabled on Pearl Nano and if Pearl Nano can successfully
connect to Epiphan Edge.

Public IP

Display the public IP address of this Pearl Nano. Knowing
the public IP address is useful when configuring SRT on
Pearl Nano, especially if Pearl Nano is behind a NAT on the
network. An empty result means the IP address was notreported.

386

Pearl Nano User Guide

Run diagnostic tests using the Admin panel

When you run Connectivity status diagnostics using the Admin panel, additional networking information about
Pearl Nano is displayed.
l

MAC addressl

IP addresslNetwork masklDefault gatewayl

DNS servers

l

mDNS

Run diagnostic tests using the Admin panel
Using the Admin panel, you can access useful diagnostic tools from the Configuration menu when you selectNetwork.
Available diagnostic tools:lConnectivity status: Display the status of critical network connections and features like 802.1x, seeConnectivity status results.

lPing: Test if the Pearl device can reach a specified destination server on the network. Not all networks
support ping.

l

Trace route: Trace the route that packet traffic takes to get from the Pearl device to a specified destination
server on the network. Not all networks support traceroute.

lBandwidth test: Display the available upload and download bandwidth speed in Mbps up to a maximum
bandwidth of 1000 Mbps.

l

Domain name resolution: Confirm that the Pearl device can resolve a Fully Qualified Domain Name(FQDN) using the DNS server that is configured for the Pearl device.

lProbe: Check if the Pearl device can establish communication to a specific port on a network host using a
network protocol that you specify. Supported network protocols are: TCP, HTTP, HTTPS, RTSP, RTMP,
and RTMPS.

To troubleshoot networking issues yourself, try to ping the IP address of your Pearl device or do a traceroute to aserver such as 8.8.8.8. If you are unable to resolve your networking issues, contact your network administrator
and provide them the IP address and MAC address of your Pearl device or contact Epiphan support.
For more information about diagnostic tools, test results, and how to run the Connectivity status diagnostic fromthe front screen menu, see Diagnostic tools.

Run diagnostics using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Configuration menu, select Network. The Network configuration page opens.
3. In the Network diagnostics section, select the diagnostic test to run from drop down.

387

Pearl Nano User Guide

Run diagnostic tests using the device screena. If Connectivity status is selected, the results display after you click Start.
b. If Ping is selected, enter the destination server IP address or domain name before clicking Start.
c. If Trace route is selected, enter the destination server IP address or domain name to routetrace
before clicking Start.
d. If Bandwidth test is selected, the measured upload and download bandwidth displays after you
click Start.
e. If Domain name resolution is selected, enter the IP address or server name to resolve before
clicking Start.
f. If Probe is selected, choose the transport protocol from the drop-down menu and then enter thedestination server IP address or server name along with the port before clicking Start. For
example, enter: 10.100.10.1:1234 or domain.example.com:1234
4. Click Start.

Run diagnostic tests using the device screen
You can access useful diagnostic tools from the device screen when you select Settings > Network and selectConnectivity Status. The Pearl-2 and Pearl Mini have additional diagnostic tools found on the second pageunder Network Tools.

Available diagnostic tools for all Pearl devices:l

Connectivity status: Display the status of critical network connections and features like 802.1x, see Run
diagnostic tests using the device screen.

Available diagnostic tools on Pearl Mini and Pearl-2
lPing: Test if the Pearl device can reach a specified destination server on the network. Not all networks
support ping.

l

Trace route: Trace the route that packet traffic takes to get from the Pearl device to a specified destination
server on the network. Not all networks support traceroute.

lBandwidth test: Display the available upload and download bandwidth speed in Mbps up to a maximum
bandwidth of 1000 Mbps.

l

Domain name resolution: Confirm that the Pearl device can resolve a Fully Qualified Domain Name(FQDN) using the DNS server that is configured for the Pearl device.

lProbe: Check if Pearl device can establish communication to a specific port on a network host using a
network protocol that you specify. Supported network protocols are: TCP, HTTP, HTTPS, RTSP, RTMP,
and RTMPS.

To troubleshoot networking issues yourself, try to ping the IP address of your Pearl device or do a traceroute to aserver such as 8.8.8.8. If you are unable to resolve your networking issues, contact your network administrator
and provide them the IP address and MAC address of your Pearl device or contact Epiphan support.
For more information about diagnostic tools and test results, see Diagnostic tools.

388

Pearl Nano User Guide

Run diagnostic tests using the device screen

Run diagnostics
1. Tap the gear icon to open the System settings screen. If the control icons aren't showing, tap anywhere on
the touch screen. If you are using the Pearl Nano, navigate to the Settings screen.
2. Select Network. The Network settings page opens.

3. To run the connectivity status diagnostics, select Connectivity status and then select Start on theConnectivity status screen.

Use Network Tools on Pearl-2 or Pearl Mini
1. To run other diagnostic tools, tap the chevron icon in the bottom right of the screen to go to the second
page of network options, and then tap Network Tools.

2. Do one of the following:a. If Ping is selected, enter the destination server IP address or domain name in the empty field.
b. If Trace route is selected, enter the destination server IP address or domain name to routetrace inthe empty field.
c. If Bandwidth test is selected, the measured upload and download bandwidth displays after you
click Start.
d. If Domain name resolution is selected, enter the IP address or server name to resolve in the empty
field.
e. If Probe is selected, choose the transport protocol from the drop-down menu and then enter thedestination server IP address or server name along with the port in the empty field. For example,
enter: 10.100.10.1:1234 or domain.example.com:1234
3. Tap Start.

389

Pearl Nano User Guide

Troubleshooting Quick Reference

Troubleshooting Quick Reference
Use the follow quick reference table for help if you are experiencing problems or unexpected behavior from yourPearl device.
Table 76 Troubleshooting Quick Reference
Problem

Action(s) to Resolve

4K features not working

The most likely problem is that the 4K Feature add-on is not
activated. You can lean more about activating this feature here:
4K

Check each source's input from the source preview in the Admin
panel.
Not sure if the connected video inputs arebeing captured.

OR
Use the front screen and control key interface and check thescreens for each video input source.
Verify that you are using the correct audio input by following thesteps in Configure encoding.
OR

No sound is coming from an audio source.

Captured SDI audio contains audible"clicking" sound or other audio distortions
upon playback.
When previewing a channel using the Livebroadcast link or the preview link in the
Admin panel, some web browsers do notplay audio.

Use the front screen and control key interface and check theaudio meters or use the 3.5 mm headphone jack on the front of
Pearl Nano to verify audio, see Confidence monitoring using thefront screen.
Ensure audio sample rate is set to 48 kHz. Lower sample rates(i.e. 32 kHz and 44 kHz) can sometimes cause audio distortion.
The Flash (FLV) plugin must be installed for your web browser toplay back audio that's encoded as PCM.
Web browsers that use Flash players to preview video do notsupport audio that's encoded using 48 kHz MP3 or 48 kHz PCM.

All my input names don't look normal in the
Refresh your browser to clear the cache and restore the proper
Admin panel menu after I applied the
input names displayed in the Admin panel.
default preset

Time stamps between Pearl Nano and an
RTSP source are not synchronized.

Reconnect your RTSP source to reset desynchronized timestamps. Verify that you are using a local NTP server on yourPearl Nano as a time synchronization server for your RTSP
source, see Configure a time server.

There's an audible clicking noise inrecordings and live streams of my RTSP

Remove the RTSP source using the Admin panel and recreate it
to resolve the issue.

390

Pearl Nano User Guide

ProblemTroubleshooting Quick Reference

Action(s) to Resolve

video source
Too much noise is present in the audio
output.

Check the input level of the audio source to make sure it's thecorrect level. Modify the input gain if necessary, see Adjust
audio gain and delay.

Video playback is fine, but when I play theclip in Adobe Premiere Pro the audio andvideo are out of sync.

Adobe Premiere Pro has a known issue handling video that isrecorded using a variable frame rate. Convert the clip to a
constant frame rate using a third-party software, such as
Handbrake, before editing in Adobe Premiere Pro.

Adobe Premiere Pro won't load my .mp4
recording from Pearl Nano.

Check if the selected recording format in Pearl Nano is MP4Fragmented. Adobe Premiere Pro does not currently support
fragmented .mp4 files. Before editing in Adobe Premiere Pro,
convert the clip to progressive .mp4 format. Run the file throughffmpeg or a third-party software such as Handbrake to preserveboth audio and video output.
The following tips can help improve image quality:

Image quality is poor or insufficient.

1. Ensure the source resolution is used as the output orrecorded resolution.
2. Increase the Bitrate value and/or decrease the Limit
frame rate value in the Encoding menu. See Configure
encoding.
The following tips can help improve frames per second (fps):
1. Increase the Limit frame rate value and/or decrease the
Bitrate value in the Encoding menu. See Configure
encoding.

Frames per second are lower than
expected.

2. Reduce the number of actions happening simultaneouslyon the system (i.e. if streaming, recording, and copying
files, consider waiting to copy files until after streaming
and recording are complete).
3. Enter a low negative value (i.e. -5) in the Frame Grabber's
Vertical Shift field.

Stream won't play in my media player orbrowser.

Verify that the Stream Type matches with the media player used
and that you have the correct url or SDP file for the player. See
Share a live broadcast stream (HTTP, HTTPS, or RTSP) andStreaming to a media player or smart TV.
If you still cannot see the stream, try disabling your local
computer firewall.
If the issue is still not resolved, contact Epiphan Support at
support@epiphan.com.

391

Pearl Nano User Guide

ProblemTroubleshooting Quick Reference

Action(s) to Resolve
The following tips can help diagnose image problems:
1. Ensure the source resolution is used as the output orrecorded resolution.

The stream interrupts or the image breaksup.

2. Increase the Bitrate value and/or decrease the Limit
frame rate value in the Encoding menu. See Configure
encoding.
3. Check network settings including filters, routers andapplication settings. Packet loss can result in stream
failure.

The video streamed to my set-top box is
dropping frames.

If you're streaming to set-top boxes that have 10/100 Mbps
interfaces on the same Gigabit Ethernet and you notice frames
are dropping, you can limit the bandwidth of the stream using
traffic shaping to adapt for lower bandwidth set-top boxes andprevent frame drops, see Set up traffic shaping.

Recording won't start.

If recording will not start, check the Disk Status Information to see
if the system is out of storage space. See Storage capacity andmaintenance and Manage recorded files.

AFU to my CIFS server doesn't work.

Pearl Nano supports Automatic File Transfer (AFU) to CIFS
servers (also known as SMB or samba) with samba version 1.

Firmware upgrade fails.

Reboot the system and try again. If the problem persists, contact
Epiphan support at support@epiphan.com.
Depending on the media player used, there could be different
issues. If you encounter a playback issue, try using a different
media player. Some issues we know of include:

Certain Media players won't play encoded
videos but others will.

1. On Windows 10, the Movies & TV app sometimes fails to
playback MP4-fragmented files with MP3 audio: trychanging your MP4 audio encoding to AAC.
2. VLC doesn't play MP4-fragmented files normally.
3. Streams and recordings at very low frame rates (e.g. 1fps) are not playable in VLC media player, use Windows
Media Player and Quicktime Player instead.
Some media players won't play MOV videos that are recordedwith MP3 audio encoding, including:

Certain Media players won't play MOV
videos.

1. VLC 2.2.4 (Microsoft Windows) if MP3 audio encoding is
at 48 kbps.
2. Movies & TV 10.16122.1029 on Windows 10.
3. Windows Media Player 12.

392

Pearl Nano User Guide

Remove black bars (matte) from the video

Problem

Action(s) to Resolve
Choose a different audio encoding when recording MOV files or
use a different media player to playback the recording.
The MOV file type on Pearl also has a time limit of 13h15m,
exceeding this limit will render the file unplayable.

There's no audio when I playback an MP4
file in QuickTime 10.

I can't hear the audio in VLC or the video
won't play.

Apple doesn't support MP3 audio. If your MP4 file is created with
MP3 audio, you will not hear the audio during playback in
QuickTime 10. Choose a different audio encoding whenrecording MP4 files or use a different media player to playback
the recording.
VLC version 3.0.3 won't play audio for MP4 fragmented files. In
VLC's Input/Codecs settings page, you can try increasing the filecaching parameter.
VLC version 3.0.6 (windows) won't play MP4 fragmented video
files. This is a VLC issue.

There's noticeable latency on the video
output port.

Disabling the audio on the video output port improves latency forthe port, see Disable or enable audio and output port volume.

System is not starting up correctly.

Ensure there is no USB stick inserted into a USB port during
power up. A potential conflict with the internal hard drive could
cause unexpected behavior.

I can't register my Pearl Nano with Kaltura
using the same device name that I justderegistered.

If you deregister Pearl Nano from Kaltura and then too quickly
register again using the same name, you may receive thefollowing error message "Unable to register device: Systemname [MyPearl] already exists". To avoid this, ensure thederegistered Pearl Nano entry in the list of encoder devices
disappears before registering again using the same device
name.

My login attempt to create an ad hoc eventfrom Pearl Nano was denied.

Kaltura or Panopto has denied you access to create unscheduled
ad hoc recordings and webcasts using Pearl Nano. Contact your
CMS administrator to either activate your CMS account or enable
the necessary access rights.

Remove black bars (matte) from the video
A channel with only one layout and only one source by default uses the aspect ratio of the video input source
when the output is streamed. If the input video signal doesn't match the encoded frame aspect ratio of thechannel, bars are added to the sides or top and bottom of the encoded stream when the output is streamed andrecorded.

393

Pearl Nano User Guide

Remove black bars (matte) from the video

If you see bars on your output but would rather have the image fill the whole screen, you can change the output
frame size to match the aspect ratio of the video source at the input, see Match output frame size with aspectratio of input signal.
The color of the bars (matte) is defined by the Background color that is selected using the custom layout editor
for the channel, see Custom layout configuration.
For example:lInput signal resolution is 720×480 (a 3:2 aspect ratio)lencoded resolution is 640×480 (a 4:3 aspect ratio that is narrower than the input resolution)
Borders are added to the top and bottom of the image to preserve the wider ratio of the input.

For example:lInput signal resolution is 720×480 (a 3:2 aspect ratio)lencoded resolution is 1280×800 (a 16:10 aspect ratio that is wider than the input resolution)
Borders are added to the left and right of the image to preserve the narrower ratio of the input.

394

Pearl Nano User Guide

Remove black bars (matte) from the video

Match output frame size with aspect ratio of input signal
The output frame size is automatically matched only for a layout that has one source. If you have a layout withmultiple video sources and see bars on the output but would rather have the image fill the whole screen, you canchange the output frame size on channels to match the aspect ratio of the video source to avoid this problem.

Change the output frame size of a channel to match the aspect ratio of the video source using the Admin
panel
1. Connect to the Admin panel and login as admin, see Connect to the Admin panel.
2. To determine the input port name of the video source that's used in the channel, select the channel fromthe Channel menu and click Layout. The custom layout page opens.
3. Once you have determined the name of the video input source , select the input port for that video source
under Inputs menu.

395

Pearl Nano User Guide

Use a specific EDID for the video input port

4. Make note of the input signal resolution.
5. From the Channel menu, click Encoding for the channel. The Encoding page opens.
6. You can either check Use current signal resolution as frame size or you can choose the frame size
resolution from the list.
a. If the source resolution appears in the list, you can choose any resolution that's listed on the sameline (i.e. with the same aspect ratio).
b. If the source resolution doesn't appear in the list, calculate the source resolution and enter it in the
Frame size fields.

TIP: Temporarily check Use current signal resolution as frame size to see the frame size
listed in the Frame size fields, then uncheck that check box and manually enter the value inthe Frame size fields.
7. Click Apply.

Use a specific EDID for the video input port
Extended display identification data (EDID) is data provided by a video display device, like a monitor. The
EDID describes the display's capabilities to a video source, such as the graphics card in a PC or other video
output device.
In the Pearl device, the video source uses the EDID information to determine what resolutions, color depth, andother settings the monitor supports.
EDID is crucial for DVI sources.
The video input ports on the Pearl device have a factory set EDID. When you connect a video source such as alaptop or camera to the Pearl device, the video source sees the Pearl device as if it were a monitor. The EDID

396

Pearl Nano User Guide

Use a specific EDID for the video input port

that's assigned to the input port is read by the video source to determine what video signal it needs to send to thePearl device.
Usually, the video input ports on the Pearl device correctly emulate a monitor for the connected video source.
However, there are times when you may need to upload a custom EDID, like when your source uses a custom
set of display properties.
When you upload a custom EDID to an input port on the Pearl device, you can force the port to supply a specificresolution, color depth, etc to the connected video source.

Upload a new EDID
In most cases, the factory installed default EDID works fine for sources connected to the HDMI ports on the Pearldevice. However, there may be times when a connected video source uses resolutions that you do not want touse. In that case, you can manually upload an EDID and force the Pearl device to use a specific set of attributes
for a specific HDMI input port. All video sources you connect to that HDMI input port will use the EDID you've
manually assigned to the port.
EDID changes remain in effect for the HDMI input port until you replace the EDID with another one or specificallychoose to restore the factory EDID for that specific HDMI input port. A system-level factory reset does notremove a manually assigned EDID from the HDMI port.
To get a new EDID, contact Epiphan Support. When you have the new EDID, you can upload that using theAdmin panel.
This feature is not available using the local console on the Pearl Nano.

Upload a new EDID file using the Admin panel
1. Connect to the Admin panel and log in as admin. See Connect to the Admin panel
2. From the Inputs menu, select the input port for which you want to upload the EDID.
3. On the configuration page for that source, scroll to the EDID upload section and click Choose FIle.

4. Browse to the location where the custom EDID file was saved and select it, then click open.
5. Select upload. When the upload is complete, the page updates to reflect success or failure.

397

Pearl Nano User Guide

Use a specific EDID for the video input port

Restore factory default EDID
When you no longer want a custom EDID assigned to an input port, you can restore the input port to use thefactory default EDID. Currently there is no way to tell if your input port is using a custom EDID. If you are unsure,
restoring to factory default is the best approach.

Restore the default EDID using the Admin panel
1. Log in to the Admin panel as admin, see Connect to the Admin panel.
2. From the Inputs menu, select the source you want to restore. The source configuration page opens.
3. Scroll to the EDID section and select restore.

4. When the default EDID is applied, the page updates to reflect success or failure.

398

Pearl Nano User Guide

External keyboard shortcuts

External keyboard shortcuts
You can use keyboard shortcuts with an external USB keyboard that is connected to Pearl Nano. For information
about connecting a USB keyboard, see Connect an external keyboard.

Table 77 Keyboard shortcuts available for the different screens
Item

Description

Channel View
shift+F

Enter full screen and toggle show/hide on-screen items like thestatus bar.

shift+E

Open the Content Management System (CMS) events screen.

shift+C

Create a new ad hoc event.

shift+P

Open the settings.

shift+R

Start recording the channel and toggle start/stop recording.

shift+T

Start streaming the channel and toggle start/stop streaming.

shift+I

Open the system information screen.

Events screen
shift+C

Create a new ad hoc event.

shift+S

Start/stop the current event.

Enter

When it is the last text field on a screen, press Enter to move tonext screen (if available) or start an action on the current
screen.
Initiate a button action, accept text entered into a text field, andtoggle a switch or check box.

Space bar

Select and initiate a control button action when only one button
appears on screen.
When the last text field on a screen is highlighted, press Spacebar to move to the next screen (if available) or start an action
on the current screen.

Common to most screens
Tab

Move to the next input field or control.

399

Pearl Nano User Guide

External keyboard shortcuts

Item

Description

shift+Tab

Move to the previous input field or control.
Initiate a button action, accept text entered into a text field, andtoggle a switch or check box.

Space bar

Select and initiate a control button action when only one button
appears on screen.
When the last text field on a screen is highlighted, press Spacebar to move to the next screen (if available) or start an action
on the current screen.

Esc

Cancel unapplied changes on the current screen and return tothe previous screen.

400

Pearl Nano User Guide

Limitations and known issues

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

Affecting firmware upgrades to 4.17l

If Pearl power connection is interrupted after a recording has been stopped, but before the Automatic File
Upload has finished, Pearl will complete the upload after power has been restored but both the file savedon the Pearl and the file uploaded to the AFU location will be corrupted.

l

If you start an event early in YuJa using any Pearl interface and then extend the event, the event appears
to extend but ends at the originally scheduled ending time.

lWhen using the front headphone jack to monitor audio if the touch screen goes dark due to timeout and isthen tapped to wake it up sometimes the audio will not return. Workaround: Change screens, navigate toa different section of the touch screen and then back to the channel and the audio should resume.

l

In Pearl Nano front screen if audio input is not assigned to channel no Gain dropdown box appears. Thisis expected behavior, Pearl can only modify audio inputs that are encoded in a channel.

Affecting encodinglLimitation: When Pearl Nano is overloaded, video frames or audio samples can be dropped causing
variable frame rate and audio cracks.
Workaround: Pearl Nano is a powerful system capable of many simultaneous tasks, but like any othercomputing device, it has finite resources. If this problem is observed, check the CPU load from yoursystem's Info page.

l

Pearl Nano 1080p 60fps HDMI output may seem shaky at times. Workaround: use a lower output frame
rate.

l

H.265 encoding over SRT from a Haivision Makito encoder cannot be decoded by Pearl Nano.

l

Limitation: When encoding 720×480i and 720×576i HDMI™ video signals that have a YUV 4:2:2 color
space and a bit depth of 24 bits, black visual elements such as a background display as green.

lChanging input settings for an HDMI or SDI input can cause the Pearl Nano's channel to stop working.
This includes scaling settings, output resolution or frame rate, and disconnecting/reconnecting an input.
Workaround: This can be prevented by disabling Use current signal resolution as frame size on the
Channel encoding settings page. Alternatively, restore the channel by restarting the device.

401

Pearl Nano User Guide

Limitations and known issues

Affecting streaming and recordingl

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 issometimes 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.

Affecting the Admin panellCropping a video source to 16:9 using the layout editor may not scale correctly and can appear as a thinline in the layout editor. This happens when the device or web browser you're using with the admininterface 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.

l

The Status section of the HDMI video input page does not indicate when the video input signal isinterlaced.

lVertically oriented images display horizontally in the layout editor. There is no workaround for this issue.

Affecting CMS integrationsl

If the Pearl Nano channel is not selected when setting up the Pearl Nano remote recorder in Panopto, you
can still create an ad hoc event using Pearl's Admin panel or front screen; however, the ad hoc event isn't
actually created on Pearl Nano or recorded.
Workaround: Enable the channel for the Pearl Nano remote recorder in Panopto.

l

If the SD card is removed while a recorded event is uploading to Panopto, uploading is interrupted and thefile does not upload; however, the event in Panopto appears as upload complete. If the SD card isimmediately re-inserted, Pearl Nano must be rebooted before Pearl Nano will detect it.
Workaround: Wait a minimum of 5 minutes before re-inserting the SD card and rebooting Pearl Nano if
the SD card is ejected while files are uploading to Panopto.

l

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.

lPearl Nano starts a Panopto VOD event without warning that an SD card or an M.5 SSD is not installed
and no recording is uploaded after the event ends. Workaround: Ensure that Pearl Nano has theappropriate storage medium installed before use.

402

Pearl Nano User Guide

Limitations and known issueslWhen using an external keyboard with Pearl Nano, pressing the Space bar to pause and then resume aPanopto event generates an error message; however, the event does pause and resume as expected.
Workaround: Press the Enter key to pause and resume a Panopto event when using an external
keyboard.

l

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.

l

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 eventand then manually Stop the event.

403

Terms and conditions
This document, the Epiphan web site, and the information contained therein, including but not limited to the text, videos andimages as well as Epiphan System Inc.’s trademarks, trade names and logos are the property of Epiphan Systems Inc. andits affiliates and licensors, and are protected from unauthorized copying and dissemination by Canadian copyright law, UnitedStates copyright law, trademark law, international conventions and other intellectual property laws.
Epiphan, Epiphan Video, Epiphan Systems, Epiphan Systems Inc., and Epiphan logos are trademarks or registeredtrademarks of Epiphan Systems Inc., in certain countries. All Epiphan product names and logos are trademarks or registeredtrademarks of Epiphan. All other company and product names and logos may be trademarks or registered trademarks of theirrespective owners in certain countries.
Copyright © 2024 Epiphan Systems Inc. All Rights Reserved.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE
INFORMATION PACKET OR PRODUCT INSTALLATION SOFTWARE PACKAGE THAT SHIPPED WITH THE PRODUCTAND ARE INCORPORATED HEREIN BY REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSES
OR LIMITED WARRANTY, CONTACT YOUR EPIPHAN REPRESENTATIVE FOR A COPY.
PRODUCT DESCRIPTIONS AND SPECIFICATIONS REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECTTO CHANGE WITHOUT NOTICE. EPIPHAN PERIODICALLY ADDS OR UPDATES THE INFORMATION AND
DOCUMENTS ON ITS WEB SITE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION AND RECOMMENDATIONSARE BELIEVED TO BE ACCURATE AT TIME OF WRITING BUT ARE PRESENTED WITHOUT WARRANTY OF ANY
KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY
PRODUCTS.
LIMITATION OF LIABILITYUNDER NO CIRCUMSTANCES SHALL EPIPHAN BE LIABLE FOR ANY INCIDENTAL, SPECIAL, CONSEQUENTIAL,
EXEMPLARY OR OTHER INDIRECT DAMAGES THAT RESULT FROM THE USE OF, OR THE INABILITY TO USE, THISPRODUCT OR THE INFORMATION CONTAINED IN THIS DOCUMENT OR PROVIDED ON EPIPHAN’S WEB SITE, EVENIF EPIPHAN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT SHALL EPIPHAN’S TOTAL
LIABILITY TO YOU FOR ALL DAMAGES, LOSSES, AND CAUSES OF ACTION RESULTING FROM YOUR USE OF THISPRODUCT, WHETHER IN CONTRACT, TORT (INCLUDING, BUT NOT LIMITED TO, NEGLIGENCE) OR OTHERWISE,
EXCEED THE AMOUNTS YOU PAID TO EPIPHAN DURING THE MOST RECENT THREE-MONTH PERIOD INCONNECTION WITH AMOUNTS WHICH YOU PAID FOR USING THIS PRODUCT.
INFORMATION AND DOCUMENTS, INCLUDING PRODUCT SPECIFICATIONS, PROVIDED IN THIS DOCUMENT OR
THE EPIPHAN WEB SITE ARE PROVIDED “AS IS”. SPECIFICALLY, BUT NOT WITHOUT LIMITATION, EPIPHAN DOES
NOT WARRANT THAT: (i) THE INFORMATION IS CORRECT, ACCURATE, RELIABLE OR COMPLETE; (ii) THE
FUNCTIONS CONTAINED ON THE EPIPHAN WEB SITE WILL BE UNINTERRUPTED OR ERROR-FREE; (iii) DEFECTS
WILL BE CORRECTED, OR (iv) THIS WEB SITE OR THE SERVER(S) THAT MAKES IT AVAILABLE ARE FREE OF
VIRUSES OR OTHER HARMFUL COMPONENTS. EPIPHAN SPECIFICALLY DISCLAIMS ALL REPRESENTATIONS,WARRANTIES, AND CONDITIONS, EITHER EXPRESS, IMPLIED, STATUTORY, BY USAGE OF TRADE OR
OTHERWISE INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT, TITLE, SATISFACTORY QUALITY OR FITNESS FOR A PARTICULAR PURPOSE.
For additional terms and conditions, see additional sections in this document.

404

Software license
ATTENTION: THE SOFTWARE AND DOCUMENTATION PROVIDED UNDER THIS AGREEMENT ARE BEING LICENSEDTO YOU BY EPIPHAN SYSTEMS INC. ("LICENSOR") AND ARE NOT BEING SOLD. THIS AGREEMENT CONTAINSLIMITATIONS ON REPRESENTATIONS, WARRANTIES, CONDITIONS, REMEDIES, AND LIABILITIES THAT ARE
APPLICABLE TO THE SOFTWARE AND DOCUMENTATION.
Epiphan Systems Inc.
Software License
IMPORTANT: BEFORE DOWNLOADING, INSTALLING, OR USING THE SOFTWARE AND DOCUMENTATION,
PLEASE CAREFULLY READ THIS AGREEMENT WHICH CONTAINS THE TERMS AND CONDITIONS UNDER
WHICH YOU ARE ACQUIRING A LICENSE TO USE THE SOFTWARE AND DOCUMENTATION. IF YOU DO NOTACCEPT THE TERMS AND CONDITIONS OF THIS AGREEMENT PLEASE DO NOT DOWNLOAD, INSTALL, OR USE
THE SOFTWARE AND DOCUMENTATION AND PROMPTLY RETURN OR DESTROY THE SOFTWARE AND
DOCUMENTATION. IF YOU DOWNLOAD, INSTALL, OR USE THE SOFTWARE AND/OR DOCUMENTATION, YOU
WILL HAVE ACCEPTED AND AGREED TO THESE TERMS AND CONDITIONS. THE SOFTWARE, HARDWARE AND
DOCUMENTATION ARE ALSO PROTECTED BY COPYRIGHT LAWS AND INTERNATIONAL COPYRIGHTTREATIES, AS WELL AS OTHER INTELLECTUAL PROPERTY LAWS. IF YOU ARE AN AGENT OR EMPLOYEE OF
AN ENTITY, YOU REPRESENT AND WARRANT THAT (I) THE INDIVIDUAL ACCEPTING THIS AGREEMENT IS
DULY AUTHORIZED TO ACCEPT THIS AGREEMENT ON SUCH ENTITY'S BEHALF AND TO BIND SUCH ENTITY,
AND (II) SUCH ENTITY HAS FULL POWER, CORPORATE OR OTHERWISE, TO ENTER INTO THIS AGREEMENT
AND PERFORM ITS OBLIGATIONS UNDER THIS AGREEMENT.
1. Definitions: In this Agreement:"Agreement" means this Epiphan Systems Inc. Software License;"API" means an application programming interface;"Documentation" means the technical publications delivered to You with the Software relating to the installation andoperation of the Software and/or Hardware, such as reference, user, installation and technical guides and release notes;"Epiphan" means Epiphan Systems Inc;
"Epiphan Hardware Product" means an Epiphan hardware product (including enclosure and mechanical parts, circuitry andelectrical and electronic components contained therein) purchased by You, which is intended to be used in conjunction withthe licensed Software and Documentation;"License Key" means a series of computer-generated characters used for the purpose of controlling the operation of Epiphan
Hardware Products and/or related Software;"Software" means the Licensor binary and/or bytecode software and/or firmware programs that are (i) specified in Your Orderor that are included with or in the Epiphan Hardware Products specified in Your Order, (ii) are made available to You fordownload after acceptance of this Agreement, (iii) are packaged with this Agreement, (iv) pre-installed on Epiphan Hardware
Products, (v) embed this Agreement in their installer(s) and which are installed after acceptance of this Agreement, or (vi)embed this Agreement in their product documentation. Software also includes the related Documentation;"You" or "Your" means the individual acquiring the Software license or any entity on whose behalf such individual is acting. In
the case of an entity, "You" includes any entity that by majority voting interest controls, is controlled by, or is under common
control with You; and"Your Order" means (i) the web forms provided by Epiphan or its applicable reseller or distributor for ordering Epiphan
Hardware Products and related Software licenses, or (ii) written documents executed by Epiphan, or one of its resellers or
distributors, and You in respect to Your purchases of Epiphan Hardware Products and/or related Software licenses.
2. Grant of Software License: Subject to the terms and conditions of this Agreement, including payment of any applicable
fees specified in Your Order, Licensor grants You a non-exclusive, non-transferable, non-sublicensable, internal license to
use the number of copies of the Software specified in Your Order and to use the Software functions specified in Your Ordersolely for operation on the Epiphan Hardware Products for which such Software has been designed as specified in theDocumentation for such Software. If the number of copies of Software is not specified in Your Order, then the number ofcopies shall be a reasonable number of copies. You acknowledge and agree that the ability to use certain Software functions
is controlled by a Licensing Key and that You will not be able to use such functions unless You have paid the applicable fees
charged by Epiphan for the right to use such functions and to receive a Licensing Key to enable such functions. For functions

405

that are controlled by a Licensing String You shall only use that Licensing String with the copy of the Software for which it wasissued and You shall not use that copy of the Licensing String with any other copies of the Software that You may have or
make. All copies of the Software made by You shall include all trademarks, copyright notices, restricted rights legends,
proprietary markings and the like exactly as they appear on the copy of the Software originally provided to You. No otherrights in the Software or Documentation are granted to You.
3. Open Source Software: Binary, bytecode and source code versions of certain open source software packages may beembedded in or distributed with the Software ("Open Source Software"). If a separate license agreement for an item of open
source software is: delivered to You with the Software; included in the download package for the Software; referenced in any
material (including the Documentation) that is included in the download or distribution package for the Software; or listed atwww.epiphan.com/opensource, then such open source software shall be Open Source Software and such separate license
agreement shall govern Your use of that item or version of such open source software. The Open Source Software may
include free software (i.e. software licensed under the GNU Lesser General Public License or other free software licenses) for
which the applicable free software license may also require that the source code for such free software be made available tothose receiving only executable versions of such free software. If the source code for any free software distributed with theSoftware is not provided with the Software, then upon request, within a three (3) year period from the original receipt of thebinary or bytecode version of such Open Source Software from Licensor, for a fee that shall not exceed Licensor's costs
associated with the shipping of the source code for such free software, Licensor will provide a copy of the source code forsuch free software to You.
4. Restrictions: The terms set forth in this Section 4 are additional conditions to the licenses granted in Section 2. Your rightto use the Software is conditioned upon Your timely payment of the full amount of fees due for: (i) the Epiphan Hardware
Product(s) on which You want to use the Software; (ii) all support agreements You have entered into with Licensor or any of
its distributors and/or resellers; (iii) licensed Software and Documentation.
You shall not reverse engineer, disassemble, reverse translate, decompile or in any other manner decode any Epiphan
Hardware Product or Software except to the extent the Software is distributed with any Open Source Software that prohibits
the imposition of such a restriction or to the extent the foregoing restriction is expressly prohibited by applicable law
notwithstanding a contractual obligation to the contrary. You acknowledge and agree that no rights in respect to the sourcecode of the Software are granted to You. You acknowledge and agree that the rights in respect to use of the Software andDocumentation are granted only for use in conjunction with Epiphan Hardware Products. You shall not distribute, lease, rent,
grant a security interest in, assign, or otherwise transfer the Software except as expressly provided in this Agreement. You
shall not modify or create any derivatives works of the Software or merge all or any part of the Software with another program.
Notwithstanding the foregoing, You may call public APIs made available by Epiphan in the Software from applications
developed by or on Your behalf provided that such applications do not embed any of the Software other than the minimum
linkage materials required to call separately running instances of the Software. You shall not use the Software or make theSoftware available to any third parties as part of any service bureau, time sharing service, application service provider
offering, software-as-a-service offering or any other managed service offering. You shall not disclose any performance,
benchmarking, or feature-related information about the Software. You further agree not to disclose, transfer or otherwise
provide to any third party any portion of the Software, except as expressly permitted herein.
Some Epiphan Hardware Products and Software embed third-party APIs that integrate with third-party party services (“ThirdParty Services”) to allow users of such Epiphan Hardware Products and Software to interact with such Third-Party Services
for various capabilities offered by such Third-Party Services, such as, and without limitation, authentication, uploading anddownloading of video content and other features made available by such Third-Party Services. If You access or use any
Third-Party Service and/or related APIs using an Epiphan Hardware Product and/or the Software then You shall comply withall of the terms and conditions for such Third-Party Service and/or related APIs.
5. Disclaimer of Warranties: EXCEPT FOR ANY WARRANTIES THAT MAY BE PROVIDED IN ANY COMMERCIAL
AGREEMENT EXECUTED BETWEEN YOU AND LICENSOR (OR BETWEEN YOU AND ONE OF LICENSOR’SRESELLERS OR DISTRIBUTORS), THE EPIPHAN HARDWARE PRODUCTS, SOFTWARE AND/OR
DOCUMENTATION ARE PROVIDED “AS IS”, WITHOUT ANY REPRESENTATIONS, CONDITIONS, AND/OR
WARRANTIES OF ANY KIND. WITHOUT LIMITATION, LICENSOR AND ITS AFFILIATES AND ITS AND THEIR
LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND DISTRIBUTORS DISCLAIM ANY AND ALL
IMPLIED REPRESENTATIONS, CONDITIONS AND/OR WARRANTIES OF MERCHANTABILITY, MERCHANTABLEQUALITY, NON-INFRINGEMENT, DURABILITY, COMPATIBILITY, TITLE, SATISFACTORY QUALITY AND/OR
FITNESS FOR A PARTICULAR PURPOSE WHETHER ARISING BY STATUTE, COURSE OF DEALING, USAGE OF
TRADE OR OTHERWISE. EXCEPT AS OTHERWISE EXPRESSLY PROVIDED IN ANY COMMERCIAL AGREEMENTEXECUTED BETWEEN YOU AND LICENSOR (OR BETWEEN YOU AND ONE OF LICENSOR’S RESELLERS OR
DISTRIBUTORS), THE ENTIRE RISK OF THE USE OF THE EPIPHAN HARDWARE PRODUCTS, SOFTWARE
AND/OR DOCUMENTATION SHALL BE BORNE BY YOU. EXCEPT AS OTHERWISE EXPRESSLY PROVIDED IN
ANY COMMERCIAL AGREEMENT EXECUTED BETWEEN YOU AND LICENSOR (OR BETWEEN YOU AND ONE OF
LICENSOR’S RESELLERS OR DISTRIBUTORS), NEITHER LICENSOR NOR ANY OF ITS AFFILIATES NOR ANY OF

406

ITS OR THEIR LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND/OR DISTRIBUTORS MAKE ANY
REPRESENTATIONS OR PROVIDE ANY CONDITIONS AND/OR WARRANTIES ABOUT THE SUITABILITY OF THE
EPIPHAN HARDWARE PRODUCTS, SOFTWARE, SERVICES AND/OR DOCUMENTATION. NEITHER LICENSORNOR ANY OF ITS AFFILIATES NOR ANY ITS OR THEIR LICENSORS, SUPPLIERS, SUBCONTRACTORS,RESELLERS AND/OR DISTRIBUTORS MAKE ANY REPRESENTATIONS OR PROVIDE ANY CONDITIONS AND/OR
WARRANTIES WHATSOEVER ABOUT ANY INFORMATION AND/OR DATA THAT MAY BE PROCESSED BY OR
MADE AVAILABLE USING ANY EPIPHAN HARDWARE PRODUCT AND/OR SOFTWARE OR ABOUT ANY THIRDPARTY SERVICE THAT MAY BE ACCESSIBLE USING ANY EPIPHAN HARDWARE PRODUCT AND/OR
SOFTWARE.
6. LIMITATION OF LIABILITY: NEITHER LICENSOR NOR ANY OF ITS AFFILIATES NOR ANY OF ITS OR THEIR
LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND/OR DISTRIBUTORS SHALL HAVE ANY
LIABILITY TO YOU OR ANY OTHER PERSON OR ENTITY FOR ANY DAMAGES ARISING FROM THISAGREEMENT, RELATING TO THE HARDWARE, SOFTWARE OR DOCUMENTATION, OR RELATING TO ANYSERVICES PROVIDED TO YOU BY LICENSOR (INCLUDING ITS AFFILIATES AND ITS AND THEIR LICENSORS,
SUPPLIERS, SUBCONTRACTORS, RESELLERS AND/OR DISTRIBUTORS) IN RELATION TO THE EPIPHAN
HARDWARE PRODUCTS, SERVICES, SOFTWARE AND/OR DOCUMENTATION FOR ANY INDIRECT, RELIANCE,INCIDENTAL, SPECIAL, PUNITIVE, EXEMPLARY OR CONSEQUENTIAL DAMAGES, INCLUDING, BUT NOT
LIMITED TO, LOSS OF REVENUE OR PROFIT, LOSS OF OR DAMAGE TO DATA, BUSINESS INTERRUPTION,
LOSS OF DATA, REPLACEMENT OR RECOVERY COSTS, OR OTHER COMMERCIAL OR ECONOMIC LOSS,WHETHER ARISING FROM CONTRACT, EQUITY, TORT (INCLUDING NEGLIGENCE OR STRICT LIABILITY) OR
ANY OTHER THEORY OF LIABILITY, EVEN IF LICENSOR (INCLUDING ITS AFFILIATES AND ITS AND THEIR
LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND/OR DISTRIBUTORS) HAVE BEEN ADVISED OF
THE POSSIBILITY OF SUCH DAMAGES, OR THEY ARE FORESEEABLE. THE LIMITATIONS IN THIS SECTION
SHALL APPLY WHETHER OR NOT THE ALLEGED BREACH OR DEFAULT IS A BREACH OF A FUNDAMENTAL
CONDITION OR TERM OR FUNDAMENTAL BREACH. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THESE LIMITATIONS MAY
NOT APPLY TO YOU. IN NO EVENT SHALL THE TOTAL CUMULATIVE LIABILITY OF LICENSOR (INCLUDING ITSAFFILIATES AND ITS AND THEIR LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND
DISTRIBUTORS) TO YOU OR ANY OTHER PERSON OR ENTITY FOR ANY DAMAGES ARISING FROM THISAGREEMENT, RELATING TO THE EPIPHAN HARDWARE PRODUCTS, SOFTWARE, DOCUMENTATION AND/OR
RELATING TO ANY SERVICES PROVIDED TO YOU BY LICENSOR (INCLUDING ITS AFFILIATES AND ITS AND
THEIR LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND DISTRIBUTORS) IN RELATION TO THE
EPIPHAN HARDWARE PRODUCTS, SOFTWARE AND/OR DOCUMENTATION, EXCEED THE LICENSE FEES PAIDBY YOU FOR THE SOFTWARE.
NOTWITHSTANDING ANY OTHER PROVISION IN THIS AGREEMENT, NEITHER LICENSOR NOR ANY OF ITS
AFFILIATES OR ITS OR THEIR LICENSORS, SUPPLIERS, SUBCONTRACTORS, RESELLERS AND/OR
DISTRIBUTORS SHALL HAVE ANY LIABILITY TO YOU OR ANY OTHER PERSON OR ENTITY WHATSOEVER INRESPECT TO ANY DIRECT, INDIRECT, RELIANCE, INCIDENTAL, SPECIAL, PUNITIVE, EXEMPLARY OR
CONSEQUENTIAL DAMAGES, INCLUDING, BUT NOT LIMITED TO, LOSS OF REVENUE OR PROFIT, LOSS OF ORDAMAGE TO DATA, BUSINESS INTERRUPTION, LOSS OF DATA, REPLACEMENT OR RECOVERY COSTS, OR
OTHER COMMERCIAL OR ECONOMIC LOSS, ARISING FROM OR RELATING TO ANY INFORMATION AND/ORDATA THAT MAY BE PROCESSED BY OR MADE AVAILABLE USING ANY EPIPHAN HARDWARE PRODUCTAND/OR SOFTWARE OR ARISING FROM OR RELATING TO ANY THIRD-PARTY SERVICE THAT MAY BE
ACCESSIBLE USING ANY EPIPHAN HARDWARE PRODUCT AND/OR SOFTWARE.
THE DISCLAIMER OF REPRESENTATIONS, WARRANTIES AND CONDITIONS AND LIMITATION OF LIABILITYCONSTITUTE AN ESSENTIAL PART OF THIS AGREEMENT. YOU ACKNOWLEDGE THAT BUT FOR THE
DISCLAIMER OF REPRESENTATIONS, WARRANTIES AND CONDITIONS AND LIMITATION OF LIABILITY,
NEITHER LICENSOR NOR ANY OF ITS AFFILIATES OR ITS OR THEIR LICENSORS, SUPPLIERS, RESELLERS OR
DISTRIBUTORS WOULD GRANT THE RIGHTS GRANTED IN THIS AGREEMENT.
7. Term and Termination: This Agreement shall continue for as long as You use the Software, however, it may be terminatedsooner as provided in this Section 7. You may terminate this Agreement by destroying all copies of the Software andDocumentation under Your control and providing certification of such destruction to Licensor or by returning the Software to
Licensor. Licensor may terminate this Agreement immediately by providing You with written notice if: (a) You are in material
breach of any provision of this Agreement, which breach, if capable of being cured, is not cured within thirty (30) days afterLicensor gives You written notice thereof; or (b) You have committed a non-curable material breach of this Agreement. Upon
termination You shall destroy all copies of the Software and Documentation. In addition to this Section, the Sections entitledDefinitions, Disclaimer of Warranties, Limitation of Liability, Title, Indemnities, High-Risk Activities, Intellectual Property, andGeneral shall continue in force even after any termination of this Agreement. No termination of this Agreement will entitle You
to a refund of any amounts paid by You to Licensor or any reseller or distributor or affect any obligations You may have to pay

407

any outstanding amounts owing to Licensor or any reseller or distributor. Upon any termination of this Agreement, Yourlicense to the Software and Documentation will terminate and You shall destroy all copies of the Software and Documentation
under Your control and certify such destruction to Licensor.
8. Support and Updates: This Agreement does not grant You the right to any updates or enhancements of the Software or
the right to receive any technical support for the Software. Such updates and other technical support services, if available,
may be purchased separately from Licensor or one of Licensor’s resellers or distributors. Use of any updates orenhancements to the Software provided pursuant to any technical support You may procure from Licensor or one ofLicensor’s resellers or distributors shall be governed by the terms and conditions of this Agreement. Licensor reserves theright at any time not to release or to discontinue the release of any Software and to alter prices, features, specifications,capabilities, functions, licensing terms, release dates, general availability or other characteristics of the Software.
9. Title: All right, title, and interest (including all intellectual property rights) in, to, and under the Software (including all copies
thereof) shall remain with Licensor and its licensors.
10. Indemnities: You shall indemnify, defend and hold Licensor, its affiliates, its and their licensors, suppliers,
subcontractors, resellers and/or distributors and all of the directors, officers, employees of all of the foregoing (collectively the“Indemnified Parties”) harmless from and against any damages, losses, liabilities, expenses, costs, claims, demands,
actions, suits and/or proceedings incurred by the Indemnified Parties as a result of (i) Your use of the Epiphan Hardware
Products, Software and/or Documentation, (ii) any use of the Epiphan Hardware Products, Software and/or Documentation
on Your behalf, (iii) the use of the Epiphan Hardware Products, Software and/or Documentation by anyone to whom You givethe Epiphan Hardware Products, Software and/or Documentation, and/or (iv) the use of the Epiphan Hardware Products,
Software and/or Documentation on behalf of anyone to whom You give the Epiphan Hardware Products, Software and/orDocumentation, including, without limitation, in all of the foregoing cases, any damages, losses, liabilities, expenses, costs,
claims, demands, actions, suits and/or proceedings arising from or relating to any information and/or data that may beprocessed by or made available using any Epiphan Hardware Product and/or Software or arising from or relating to any ThirdParty Service that may be accessible using any Epiphan Hardware Product and/or Software (collectively, each matter fallingwithin any of the foregoing, a “Claim”), including, without limitation, indemnifying, defending and holding the Indemnified
Parties harmless from and against any settlements agreed by You in connection with any Claims and/or any damages, costs
or other amounts (including reasonable attorneys' fees) awarded to a third party against any of the Indemnified Parties by acourt or tribunal of competent jurisdiction in respect to any Claim. If You do not timely defend against or resist a Claim after
notice from Licensor, Licensor shall be entitled to investigate, defend, compromise, settle, or otherwise dispose of the Claim,
and incur costs in connection therewith, at Your expense, in such manner as Licensor deems in its best interests until areasonable time after You comply with its obligations under this Section 10. You shall not enter into a settlement of any Claim
without the Licensor’s written consent unless such settlement is solely for monetary payment by You and contains an
express, complete, unconditional release of all of the Indemnified Parties and which does not impose any obligations or
restrictions on any of the Indemnified Parties.
11. High-Risk Activities: The Software and Epiphan Hardware Products are not fault-tolerant and are not designed,
manufactured or intended for use in or in conjunction with on-line control equipment in hazardous environments requiring failsafe performance, such as in the operation of nuclear facilities, aircraft navigation systems, air traffic control, or direct life
support machines. Licensor, its licensors, suppliers, subcontractors, resellers and distributors specifically disclaim any
express or implied representations, warranties and/or conditions for such uses.
12. U.S. Government End-Users: The Software and Documentation are each a "commercial item" as that term is defined at
FAR 2.101, consisting of "commercial computer software" and "commercial computer software documentation" as suchterms are defined in FAR 12.212, and are provided to the U.S. Government only as commercial end items. Government end
users acquire the rights set out in this Agreement for the Software, Epiphan Hardware Products and Documentationconsistent with: (i) for acquisition by or on behalf of civilian agencies, the terms set forth in FAR12.212; or (ii) for acquisition by
or on behalf of units of the Department of Defense, the terms set forth in DFARS 227.7202. Use of the Epiphan Hardware
Products, Software and Documentation is further restricted by the terms and conditions of this Agreement and the applicablecommercial purchase agreement for the Epiphan Hardware Products. For the purposes of any applicable government use,the Epiphan Hardware Products, Software and Documentation were developed exclusively at private expense, and are trade
secrets of Epiphan Systems Inc. for the purpose of any Freedom of Information legislation or any other disclosure statute,regulation or provision.
13. Export Restrictions: The Epiphan Hardware Products, Software, Documentation and related information are subject toexport and import restrictions. By downloading, installing, or using the Software, Epiphan Hardware Products, Documentation
and/or related information, You are representing and warranting that You are not located in, are not under the control of, andare not a national or resident of any country to which the export of the Epiphan Hardware Products, Software, Documentation
and/or related information would be prohibited by the laws and/or regulations of Canada or the United States. You are also
representing and warranting that You are not an individual to whom the export of the Epiphan Hardware Products, Software,
Documentation or related information would be prohibited by the laws and/or regulations of Canada or the United States. You

408

shall comply with the export laws and regulations of Canada and the United States that are applicable to the Epiphan
Hardware Products, Software, Documentation and related information and You shall also comply with any local laws and/or
regulations in Your jurisdiction that may impact Your right to export, import, or use the Epiphan Hardware Products, Software,
Documentation or related information, and You represent and warrant that You have complied with any such applicable laws
and/or regulations. The Epiphan Hardware Products, Software, Documentation and related information shall not be used forany purposes prohibited by export laws and/or regulations, including, without limitation, nuclear, chemical, or biologicalweapons proliferation. You shall be responsible for procuring all required permissions for any subsequent export, import, or
use of the Epiphan Hardware Products, Software, Documentation or related information.
14. Intellectual Property: Epiphan, Epiphan Systems and Epiphan Video are tradenames, trademarks or registeredtrademarks of Epiphan Systems Inc. in certain countries. All Licensor product names and logos are trademarks or registeredtrademarks of Epiphan Systems Inc. in certain countries. All other company and product names and logos are trademarks orregistered trademarks of their respective owners in certain countries. You shall not disclose, transfer or otherwise provide to
any third party any portion of the Software, except as expressly permitted in this Agreement.
15. General: This Agreement is the entire agreement between You and Licensor in respect to the Software, superseding anyother agreements or discussions, oral or written. The terms and conditions of this Agreement shall prevail over any preprinted terms on any quotes, orders, purchase orders, or purchase order acknowledgements, and shall prevail over any othercommunications between the parties in relation to the Software. You may not assign this Agreement whether voluntarily, by
operation of law, or otherwise without Licensor's prior written consent. Licensor may assign this Agreement at any time
without notice. The failure of a party to claim a breach of any term of this Agreement shall not constitute a waiver of suchbreach or the right of such party to enforce any subsequent breach of such term. If any provision of this Agreement is held tobe unenforceable or illegal, such decision shall not affect the validity or enforceability of such provisions under othercircumstances or the remaining provisions of this Agreement and such remaining provisions shall be reformed only to theextent necessary to make them enforceable under such circumstances. This Agreement shall be governed by the laws of theProvince of Ontario and the laws of Canada applicable therein. No choice or conflict of laws rules of any jurisdiction shallapply to this Agreement. You shall only be entitled to bring any action or proceeding arising out of or relating to thisAgreement, the Epiphan Hardware Products, Software, Documentation or any services provided in respect to the Epiphan
Hardware Products, Software and/or Documentation in a court in Ottawa, Ontario, Canada, and You consent to thejurisdiction of such courts for any such action or proceeding. You waive all rights that You may have or that may hereafterarise to contest the jurisdiction of such courts for any action or proceeding brought by You. You hereby waive any right You
may have to request a jury trial with respect to any action brought by You in connection with this Agreement, the Epiphan
Hardware Products or Software or any services provided in respect to the Epiphan Hardware Products or Software. The
application of the United Nations Convention on Contracts for the International Sale of Goods to this Agreement is expressly
excluded.
February 26, 2024
© 2006-2024. Epiphan Systems Inc. All Rights Reserved.
Environmental Information
The equipment that you bought has required the extraction and use of natural resources for its production. It may containhazardous substances that could impact health and the environment. In order to avoid the dissemination of those substancesin our environment and to diminish the pressure on the natural resources, we encourage you to use the appropriate take-backsystems. Those systems will reuse or recycle most of the materials of your end life equipment in a sound way. The crossedout wheeled bin symbol invites you to use those systems. If you need more information about collection, reuse and recycling
systems, please contact your local or regional waste administration. You can also contact us for more information on theenvironmental performance of our products.
Important Safety Warnings
Model numbers covered by this document: ESP1442, ESP1474, ESP1556, ESP1610, and ESP1882
WARNING: Risk of explosion if the power supply is replaced by an incorrect type.
WARNING: This product has no user-serviceable parts and the battery used in this device is not replaceable. Do not attempt
to disassemble. Return the device for service.
CAUTION, RISK OF ELECTRIC SHOCK: This device may have multiple AC power cords installed. All power sources shallbe disconnected before servicing to avoid shock hazard.
ATTENTION: Risque d'explosion si la source de courant est remplacée par un type incorrect.
ATTENTION: Cet appareil ne contient aucun composant pouvant être entretenu ou réparé par l'utilisateur. En cas de panne,
retourner l'appareil pour réparation.

409

ATTENTION, RISQUE DE CHOC ÉLECTRIQUE: Cet appareil peut être équipé de multiples cordons d'alimentation en
courant alternatif. Pour placer cet appareil hors tension, débrancher tous les cordons d'alimentation sans exception.
FCC Compliance Statement
47 CFR Section 2.1077 Compliance Information
Unique identifier: Pearl Nano
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
1. This device may not cause harmful interference
2. This device must accept any interference received, including interference that may cause undesired operation.
Responsible party (US contact):
Epiphan Video
3150 Almaden Expressway
Suite 233
San Jose, CA 94301
USA
Toll free: +1 (877) 599-6581
Phone: +1 (650) 644-4684
Email: info@epiphan.com
www.Epiphan.com
FCC CAUTION
Changes or modifications not expressly approved by the party responsible for compliance could void the user’s authority tooperate the equipment.
Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of
the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment
is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not
installed and used in accordance with the instruction manual, may cause harmful interference to radio communications.
Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required
to correct the interference at his own expense.
Innovation, Science and Economic Development Canada:This device complies with ICES-003 of the ISED rules. Operation is subject to the following two conditions:(1) This device may not cause harmful interference, and(2) this device must accept any interference received, including interference that may cause undesired operation.
Cet appareil est conforme à la norme ISED NBM-003 pour les appareils radio agréés. Son fonctionnement est sujet aux deux
conditions suivantes:(1) Le dispositif ne doit pas produire de brouillage préjudiciable, et(2) ce dispositif doit accepter tout brouillage reçu, y compris un brouillage susceptible de provoquer un fonctionnement
indésirable.
CE Compliance Statement
Marking by the symbol
indicates compliance of this device with the applicable directives of the European Community andmeets or exceeds the following technical standards.
Directive 2014/30/EU - Electromagnetic Compatibility
Directive 2014/35/EU - Low Voltage Directive
Directive 2011/65/EU - RoHS, restriction of the use of certain hazardous substances in electrical and electronicequipment
Warning: Operation of this equipment is not intended for a residential environment and could cause radio interference.

410

Other Jurisdictional Issues
Epiphan makes no representation that its products or information in this document or its web site is appropriate or available
for use in your jurisdiction. Those who choose to access the Epiphan web site or use Epiphan products do so on their own
initiative and are responsible for compliance with local laws, if and to the extent local laws are applicable
Submissions to Epiphan and Affiliated Servers
Any information, including but not limited to remarks, suggestions, ideas, graphics, or other submissions, communicated to
Epiphan through their Epiphan web site is the exclusive property of Epiphan. Epiphan is entitled to use any information
submitted for any purpose, without restriction (except as stated in Epiphan's Privacy Statement) or compensation to theperson sending the submission. The user acknowledges the originality of any submission communicated to Epiphan andaccepts responsibility for its accuracy, appropriateness, and legality.
Third Parties and Links to Third-Party Web Sites
Mention of non-Epiphan Systems Inc. products or services on their website, or this document site is for informational
purposes and does not constitute an endorsement or recommendation.
This document may contain links to non-Epiphan web sites. These links are provided to you as a convenience, and Epiphan
is not responsible for the content of any linked web site. Any outside web site accessed from the Epiphan web site isindependent from Epiphan, and Epiphan has no control over the content of that web site. In addition, a link to any nonEpiphan web site does not imply that Epiphan endorses or accepts any responsibility for the content or use of such a web
site.
In no event shall any reference to any third party or third party product or service be construed as an approval or endorsement
by Epiphan of that third party or of any product or service provided by a third party.
Miscellaneous
It is the user's responsibility to ascertain whether any information downloaded from the Epiphan web site or other websites isfree of viruses, worms, trojan horses, or other items of a potentially destructive nature.
Enforcement of Terms and Conditions
These Terms and Conditions for use of this document and the associated Epiphan Product are governed and interpreted
pursuant to the laws of the province of Ontario, Canada, notwithstanding any principles of conflicts of law.
All disputes arising out of or relating to these Terms and Conditions shall be finally resolved by arbitration conducted in the
English language in Ottawa, Ontario, Canada under the commercial arbitration rules of the Canada. The parties shall appoint
as sole arbitrator a retired judge who presided in the province of Ontario. The parties shall bear equally the cost of thearbitration (except that the prevailing party shall be entitled to an award of reasonable attorneys' fees incurred in connection
with the arbitration in such an amount as may be determined by the arbitrator). All decisions of the arbitrator shall be final andbinding on both parties and enforceable in any court of competent jurisdiction. Notwithstanding this, application may be madeto any court for a judicial acceptance of the award or order of enforcement. Notwithstanding the foregoing, Epiphan shall beentitled to seek injunctive relief, security, or other equitable remedies from any court of competent jurisdiction.
If any part of these terms is unlawful, void, or unenforceable, that part will be deemed severable and will not affect the validity
and enforceability of the remaining provisions. Epiphan may, at its sole discretion and without notice, revise these terms at
any time by updating this posting.
Copyright © 2024 Epiphan Systems Inc.
All Rights Reserved.

411

Thank you for choosing Epiphan!
At Epiphan Video (“Epiphan”), building reliable video systems with pro features that perform above yourexpectations is our mission.
We value your feedback! Email us your suggestions and let us know how you think we're doing and where you'd
like to see our products improve: info@epiphan.com

Warranty
All Epiphan Video systems have a 100% return to depot warranty for one year from the date of purchase.

Technical support
Epiphan’s products are backed by our professional support team. You can reach our team several ways:l

Email support@epiphan.com

lLive chat from our support site https://www.epiphan.com/support/lPhone toll free at 1-877-599-6581 or call +1-613-599-6581

Gather as much information about your problem as you can before you contact us so we can help you better,
including:l

A description of the probleml

Details about your video or audio source (type, connection, resolution, refresh rate, etc.)l

Product serial numberlProduct firmware version (using the admin interface)l

Product LED lights

412