Epiphan ... User Guide Release 3.14.0c September 12, 2014

Epiphan          ... User Guide Release 3.14.0c September 12, 2014
User Guide
Epiphan Pearl
Release 3.14.0c
September 12, 2014
UG100-002
Terms and Conditions
This document, the Epiphan web site, and the information contained therein, including but not limited to the
text, videos and images as well as Epiphan System Inc.’s trademarks, trade names and logos are the property of
Epiphan Systems Inc. and its affiliates and licensors, and are protected from unauthorized copying and
dissemination by Canadian copyright law, United States copyright law, trademark law, international
conventions and other intellectual property laws.
Epiphan, Epiphan Systems, Epiphan Systems Inc., and Epiphan logos are trademarks or registered trademarks
of Epiphan Systems Inc., in certain countries. All Epiphan product names and logos are trademarks or
registered trademarks of Epiphan. All other company and product names and logos may be trademarks or
registered trademarks of their respective owners in certain countries.
Copyright © 2014 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
PRODUCT AND 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 SUBJECT
TO CHANGE WITHOUT NOTICE. EPIPHAN PERIODICALLY ADDS OR UPDATES THE INFORMATION AND
DOCUMENTS ON ITS WEB SITE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION AND
RECOMMENDATIONS ARE 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 LIABILITY
UNDER 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, THIS
PRODUCT OR THE INFORMATION CONTAINED IN THIS DOCUMENT OR PROVIDED ON EPIPHAN’S WEB SITE,
EVEN IF 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 THIS PRODUCT, 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 IN CONNECTION 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, NON-INFRINGEMENT,
TITLE, SATISFACTORY QUALITY OR FITNESS FOR A PARTICULAR PURPOSE.
For additional terms and conditions, please refer to additional sections in this document.
i
Thank You for Choosing Epiphan!
At Epiphan Systems Inc. (“Epiphan”), product function and quality are our top priority. We make every effort to
make sure that our products exceed your expectations.
Product Feedback
Your feedback is important! We regularly contact our customers to ensure our products meet your
performance and reliability requirements. We strive to continually enhance our products to accommodate your
needs. Please let us know how you think we can improve our products by emailing your suggestions to
[email protected]
Specifications
Go to the Broadcasters or Recorders page of the Epiphan website to get the most recent product
specifications and additional information about Epiphan Pearl.
Warranty
All Epiphan Systems products are provided with 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. If you are having issues with your product,
please gather details about your system and contact our team by:
l Emailing [email protected]
l Live chat via the link on our support site http://www.epiphan.com/support/
l Phone toll free at 1-877-599-6581 or call +1-613-599-6581
Be sure to include as much information about your problem as possible. Including:
l Problem description
l Details of the video or audio source (type, connection, resolution, refresh rate, etc.)
l Product serial number
l Product firmware version (if applicable, from web admin interface)
Copyright © 2014 Epiphan Systems Inc. All Rights Reserved.
ii
What's New in Release 3.14.0
Release 3.14 is a special inaugural release for Epiphan Pearl. Although Pearl is an all-new product for Epiphan,
you may be familiar with other Epiphan products. The following list outlines what's new for Pearl compared to
other streaming and recording products from Epiphan.
New Physical Features
Touch screen display
Pearl's front panel is equipped with a front screen display for confidence monitoring and easy access to system
information. View exactly what your channels are capturing and control recording directly from the touch
screen.
HDMI input
In addition to SDI, VGA and TRS input ports, Pearl has two HDMI input ports to capture HDMI video and audio
or DVI video with the provided DVI to HDMI adapter.
New Encoding / Streaming Features
Automatic channels
For quick and easy setup, Pearl is configured with two automatic channels (Auto A and Auto B).To get started,
simply plug a source into row A on the back of the system and optionally, another into row B. Pearl immediately
calculates the best settings based on your source and is ready to capture, stream and record your audio/video
feed.
Hardware acceleration for H.264 encoding
Part of what makes Pearl so special is its ability to do so much in such a small package. Its impressive encoding
and streaming throughput are possible due to hardware-accelerated encoding. Hardware encoding is the
default for all H.264 channels, but you may still use software encoding if needed for compatibility reasons.
Stream access control improvements
Choose which channels to share to streaming viewers with a new toggle to enable or disable streaming. Also
new are per-channel access control for UPnP sharing and per-channel viewer password and allow/deny lists.
iii
Release 3.14: Limitations and known issues
This section includes known issues or limitations that affect functionality or usability and ways that you can
work around these limitations.
Affecting encoding
l Encoding with MPEG-4 sometimes results in poor quality.
Workaround: From the channel's stream setup, increase the video bitrate to improve picture quality.
l Video bitrate for MJPEG streams are approximately one and a half to two times the configured value.
Workaround: Verify the actual bitrate on the channel's channel status page and adjust until the correct
value is achieved.
l In multiple source channel layouts, sources cannot overrun the top or left edges of the screen.
Workaround: Avoid using negative values for x and y axis coordinates.
l Encoding is unavailable if a branding logo is placed outside the frame size. i.e. if the frame is 1024x768
and the logo is placed with an x-axis margin of 1200.
Workaround: Always keep the branding logo within the frame.
l For VGA sources only, some wide-mode resolutions are not correctly identified and result in a slightly
squished image (e.g. for a 1360x768 source, the detected resolution may be 1024x768).
Workaround: This issue is related to the video output hardware. Test your source to see if it exhibits the
issue. If possible, avoid using wide-mode for VGA displays that exhibit this issue.
Affecting streaming
l You may see video artifacts when creating multiple source layouts where sources are partially
overlapped.
Workaround: Avoid overlapping sources in multiple source channels or disable the Keep Aspect Ratio
parameter.
Affecting recording
l You may see video artifacts when creating multiple source layouts where sources are partially
overlapped.
Workaround: Avoid overlapping sources in multiple source channels or disable the Keep Aspect Ratio
parameter.
l Rebooting the device during a recording may cause green boxes to appear in the recording.
Workaround: Avoid rebooting the device while recording..
Affecting the web interface
l It is possible to name two or more channels with the same value. Use of automatic file transfer and UPnP
is unpredictable if this occurs.
Workaround: Ensure each channel has a unique name.
iv
l Recording time and service status times are sometimes incorrect in the Web UI after very long uptime.
When this happens, the counters are reset and show values lower than the acutal recording time or
uptime.
Workaround: View the list of recorded files to verify length of recordings.
l Progress is sometimes incorrectly reported when extracting individual tracks from a multi-track recorder.
Workaround: None, wait for the extraction to complete. If desired, reload the page every few seconds
until the process is complete.
Affecting other areas
l Tethered USB devices (i.e. for networking) are not recognized if connected prior to system boot up. This
issue does not affect USB drives.
Workaround: Disconnect and reconnect the USB device to resolve the issue. No work-around for
remote access.
v
Table Of Contents
Thank You for Choosing Epiphan!
Product Feedback
Specifications
Warranty
Technical Support
Welcome
About this Guide
ii
ii
ii
ii
ii
1
2
Pearl Overview
3
Specifications
4
What's in the Box?
Front and back view
Quick Start
Using auto channels
Creating a new custom channel
What’s Next?
Using Pearl's touch screen
Overview
View system information
Channel monitoring and switching
Control recording
7
8
10
10
12
20
22
22
23
25
27
PART 1: Setup
29
1-1 Connect to the Admin Interface
30
Connect via DNS-based Service Discovery
31
Connect via the Epiphan Discovery Utility
Connect via Persistent Static IP Address
32
34
1-1 Configure the Touch Screen
Disable (and enable) the touch screen
Hide (or show) channel previews on the touch screen
Disable (or enable) system information on the touch screen
Block (or allow) recording control from the touch screen
Set touch screen timeout
1-2 User Administration
Understanding User Privileges
Setting and Changing User Passwords
Removing User Passwords
Overcoming Lost Passwords
35
35
36
37
37
38
40
40
43
44
45
vi
Changing the logged-in user
1-3 Configure Network Settings
Verify IP Address and MAC address via the touch screen
Verify IP Address and MAC address
Configure a Static IP Address
Configure DHCP
Tether to a Mobile Network
Perform Network Diagnostics
1-4 Configure Date and Time
Verify Date and Time via the touch screen
Verify Date and Time Settings
Change the Time Zone
Configure Synchronized Time (NTP, PTP v1, and RDATE)
Configure a Local NTP Server
Manually Configure the Date and Time
1-5 Restrict Viewers by IP Address
Examples
45
46
46
47
47
49
51
52
54
54
55
56
56
58
58
59
60
PART 2: Sources
63
2-1 Identify sources
64
Connecting sources
Previewing captured stream from sources
2-2 Configure a video source
Configure the video source's frame grabber parameters
Change a source name
2-3 Configure an audio source
Add an audio source to a channel
Configure audio settings
Set audio volume
2-4 Fine-tune source configuration
Video is not centered on the screen (VGA sources only)
Video is too bright, too dark or washed out (VGA sources only)
Video looks squished (VGA sources only)
Remove the combing effect on images (VGA sources only)
64
65
66
66
68
70
70
71
72
74
74
75
76
77
PART 3: Channels
79
3-1 Configure channels
80
Use the automatic channels Auto A and Auto B
Create a single source channel
Merge/include multiple video sources into a single channel
Delete a channel
80
83
86
90
vii
Rename a channel
91
3-2 Identify a channel
92
3-3 Preview a channel
93
Preview a channel from the Info page
Preview a channel from the Status page
Preview all channels at once
3-4 Fine-tune channel configuration
Choose a codec to maximize your stream quality
Codec and file format compatibility
Adjust video quality
Upscale or downscale your video image
Control the matte (black bars) in the video output
Unstretch the output video
Limit the frame rate
Adjust key frame interval
3-5 Customize your channel
Add your logo and company information to your channel
Add a time stamp to your channel
Select the background color for your channel
Add a customized background to a multiple source channel
93
93
94
95
95
97
98
100
101
104
105
106
107
107
112
113
114
PART 4: Stream
118
4-1 Stream your video
119
View available video formats
Choose a streaming option
Disable (and enable) streams for viewers
Restrict access to streams for viewers
Stream content using HTTP or RTSP
Configure streaming ports
Stream content using HTTP Live Streaming (HLS)
119
120
123
124
126
127
128
Stream content using UPnP
Stream content using a Content Distribution Network
Stream content using multicast streaming
129
135
142
4-2 Samples of stream settings
Streaming video content
Streaming slide content
147
147
148
PART 5: Record
149
5-1 Recorders
150
Add a recorder
Rename a recorder
Change the channels recorded by a recorder
Delete a recorder
150
151
151
152
viii
5-2 Create Recordings
Recording basics
Control recording with the touch screen
Record a channel via the web interface
Record with a recorder via the web interface
Configure the type and length of recording files
Close the current recording file while recording
Control recording with a mouse
5-3 File Maintenance
View the List of Stored Files
Rename Stored Files
Download Files Manually
Delete Files Manually
Pick Specific Tracks from a Multi-track Recorder File
5-4 File and Recording Transfer
Configure Automatic File Upload (Part 1 of 2)
Configure Automatic File Upload to an FTP Server (Part 2 of 2)
Configure Automatic File Upload using RSync (Part 2 of 2)
Configure Automatic File Upload using CIFS (Part 2 of 2)
Upload to an External USB Drive
5-5 Use the Local FTP Server
Configure the Local FTP Server
Downloading Files from the Local FTP Server
154
154
155
156
158
160
162
163
164
164
165
166
167
168
170
170
172
173
175
176
183
183
184
PART 6: View
187
6-1 View your video
188
View the live broadcast and retrieve stream URLs
Viewing with a web browser
Viewing with a media player
Viewing with UPnP
188
191
192
193
Viewing with Session Announcement Protocol (SAP)
194
PART 7: Maintenance
196
7-1 Mobile / Tablet Operator Interface
197
Connect to the tablet interface
Confidence monitoring using the tablet interface
Verify disk space via the tablet interface
Control recording via the tablet interface
Switch to the full admin interface
7-2 Power Down and System Restart
Restarting the Device via the Web Interface
Shutting down the Device via the Web Interface
Shutting down the Device Manually
197
199
201
201
202
203
203
204
204
ix
7-3 Save and Restore Device Configuration
Save device configuration
Load a saved device configuration
7-4 Restoring Factory Configuration
Restore Factory Configuration via the Web Interface
7-5 Firmware Upgrade
Check for Firmware Updates
Install firmware
7-6 Remote Support
Configure Remote Support
Disable Remote Support
7-7 Storage Disk Maintenance
Check disk storage space
Check disk storage space via the touch screen
Schedule disk check
Perform disk check
7-8 Control with RS-232 / Serial Port
Connect and configure the RS-232 cable
Control Pearl with RS-232
RS-232 / Serial port command examples
7-9 Control with HTTP Commands
HTTP command syntax
HTTP command examples
7-10 Configuration Keys for Third Party APIs
206
206
207
209
209
211
211
211
216
216
218
219
219
220
220
221
222
222
223
226
228
228
229
231
System-level Settings Keys(Read-only)
System-level Settings Key (Read/Write)
Recording Configuration Keys
232
232
233
HTTP Server Configuration Keys
IP-Based Access Control Configuration Keys
UPnP Configuration Keys
Frame Grabber Configuration Keys
Broadcast Configuration Keys
Channel Encoder Configuration Keys
Channel Logo Configuration Keys
Audio Configuration Keys
Stream Publishing Configuration Keys
RTSP Announce Configuration Keys (Publish Type 2)
RTP/UDP Configuration Keys (Publish Type 3)
MPEG-TS Configuration Keys (Publish Types 4 and 5)
RTMP Push Configuration Keys (Publish Type 6)
Content Metadata Configuration Keys
233
234
234
234
235
236
237
238
239
239
240
240
241
241
x
7-11 Troubleshooting
243
Software and Documentation License
246
Environmental Information
FCC & CE Compliance Statement
Other Jurisdictional Issues
Submissions to Epiphan and Affiliated Servers
Third Parties and Links to Third-Party Web Sites
Miscellaneous
Enforcement of Terms and Conditions
250
250
251
251
251
251
252
xi
Pearl User Guide
Welcome
Welcome
Welcome, and thank you for buying Epiphan’s Pearl™. This guide will help you configure your new system.
To get started, review the Pearl Overview and What's in the Box? sections. Next, a Quick Start guide walks you
through the basic steps to get a single video (and optional audio) source configured as a streamable,
recordable output from Pearl.
Following the quick start section, a set of task-based procedures help you to tweak the system exactly how you
want it. These procedures are broken into seven categories: Setup, Sources, Channels , Stream, Record, View,
and Maintenance.
1
Pearl User Guide
Welcome
About this Guide
Warnings are depicted as follows.
This is a warning.
Tips and Notes are depicted as follows.
This is a tip.
Throughout this guide there are situations where more than one solution will complete a task. In those cases
the guide describes the simplest or most common variation first.
2
Pearl User Guide
Pearl Overview
Pearl Overview
Pearl is a small, silent, portable video recording and video streaming device that captures and streams audio
and HD video sources with resolutions up to 2048×2048. You can capture, record and stream computer
monitors, radar displays, or anything that outputs to SDI, HDMI, DVI-I (single link), VGA or component.
Accompanying audio is supported via SDI, HDMI and TRS.
Simultaneously capture two audio visual sources and choose how you want to record and stream them. Keep
them separate, configure them in a multi-source layout, or do both!
The resulting streams can be viewed a number of ways through media players, browsers, on mobile devices and
through Content Distribution Networks (CDNs). Recorded files can be downloaded via FTP or set to
automatically upload via FTP, RSYNC, or CIFS and can be integrated into your Content Management System
(CMS).
The following table describes the types of inputs supported by Pearl.
When using Pearl it is recommended you use a maximum of three channels and a maximum of two
sources. For simplicity, keep one source plugged into Row A and the other plugged into Row B.
Table 1 Inputs for Pearl
SDI
SDI Audio
HDMI /
DVI-I (single link)
HDMI Audio
VGA
Left/Right TRS
Audio
(Unbalanced)
2
ü
2
ü
2
2
3
Pearl User Guide
Pearl Overview
Specifications
The following table outlines specifications for the Pearl. Go to www.epiphan.com/pearl to get the most recent
product specifications and additional information about Pearl.
Table 2 Specifications for Pearl
Video Inputs
Connectors
(2) SDI
(2) HDMI / DVI¹
(2) VGA / Component²
Resolutions
VESA modes: 640×480 to 2048×2048 (or 2650×1600);
Custom HDMI/VGA/DVI/SDI modes up to 1920x1200
HD Video Format
Options
3G-SDI; HD-SDI; SD-SDI;
DVI single link;
HDMI;
R, G, B plus separate HSync and VSync signals;
R, G, B plus CSYNC signal;
R, G, B with Sync-on-Green synchronization
Audio Input
Connectors
(2) ¼" left/right TRS audio (balanced; or line/unbalanced)
SDI audio
HDMI audio
Video Output
Connectors
(2) Displayport (software selectable content)*
(to be implemented in a future release)
Video Encoding
Built-In Display
Front touch screen display used for system information,
confidence monitoring and recording control
Video Codecs
H.264, MPEG-4, Motion JPEG
Video Bit Rates
100 - 9,999 kbit/sec
Key Frame Intervals
Programmable
Color Resolution
4:2:0
Output Frame Size
Configurable up to 3840x2160
Frame Rates
(per output stream)
60 fps at 1920×1080
4
Pearl User Guide
Audio Encoding
IP Network Interfaces
Video / Audio Recording
and File Management
Pearl Overview
Audio Codecs
Encoder
Bitrate
Sample Frequencies
MP3
32-192 kbps
22 kHz, 44 kHz
PCM
-
22 kHz, 44 kHz
AAC
32-192 kbps
16 kHz, 22 kHz, 44 kHz
Connector
10/100/1000 Ethernet RJ45
Streams
MPEG-TS, FLV, ASF and MJPEG
RTSP over TCP/UDP
Publish to Streaming Server / CDN (RTSP, RTMP)
HLS - Native Apple HTTP stream for iPad, iPhone and iPod
Touch
Multicast Streams
RTP, MPEG-TS & RTP and MPEG-TS over UDP
Network Discovery /
Announce
UPnP, SAP
Internal Storage
1 TB³
Automatically removes oldest recordings from internal
storage as space is required.
File maintenance through admin interface (Web UI)
Administration
Local Storage
Automatic or manual copy to local USB drives via the (2)
USB 2.0 ports
Network Storage
FTP server and FTP client capabilities (automatic and
manual)
Playback and
Recorded Formats
Download recorded videos (AVI, MOV or MPEG-TS) using
the Web UI and playback through any compatible player.
Web UI for full administration. On-screen display and mobile UI for confidence
monitoring and simple administration.
Multiple user accounts/passwords.
Included API for integration into existing environments (executed via HTTP or RS232). RS-232 API integration requires a USB to RS-232 adapter (not included).
Time Synchronization
NTP, TIME (RFC 868), PTP v1 (IEEE-1588-2002 V1)
5
Pearl User Guide
Pearl Overview
Product Dimensions
10⅝" x 3¼" x 7⅜" (270mm x 82mm x 187mm)
Product Weight
3.4 lbs (1.54kg)
Country of Origin
Made in North America (Canada)
¹Using HDMI port, with the supplied adapter
²Requires component to VGA adapter (not included)
³The Internal 1TB HDD provides approximately 900GB of space for recording. Recording space can be virtually
unlimited with the use of networked storage.
6
Pearl User Guide
What's in the Box?
What's in the Box?
Pearl is a compact, portable system weighing only 3.4 lbs ( 1.54 kg) and measuring 187 mm (D) × 270 mm (W) ×
82 mm (H) (7.4” × 10.6” × 3.25”).
In addition to the power cable, the following items are shipped with the system.
1. One SDI cable
2. One HDMI cable
3. One VGA cable
4. One DVI (male) to HDMI (female) adapter
5. One Ethernet cable
Table 3 Description of Included Cables
Image
Name
Description
SDI cable
Connects SDI sources to Pearl's SDI
ports.
HDMI cable
Connects HDMI or DVI sources to Pearl's
HDMI ports.
VGA Cable
Connects VGA (or Component, if used
with a converter) signals to Pearl's VGA
ports.
DVI (male) to HDMI (female)
adapter
Connects DVI sources to Pearl. Connect
the adapter to the output on your
screen or device, then connect the
provided HDMI cable to the adapter and
one of the HDMI ports on Pearl's back
panel.
7
Pearl User Guide
Image
What's in the Box?
Name
Description
RJ-45 Ethernet cable
Connects the system to your network.
Front and back view
Pearl's front panel hosts a power light and touch screen display for confidence monitoring and simple
configuration. The rear has an array of familiar computer connections. See below for a complete listing of
Pearl's physical features.
8
Pearl User Guide
What's in the Box?
Table 4 Pearl Front and Back Panel Descriptions
Label
Name
Description
Touch screen front panel
display
Used for confidence monitoring and simple configuration such as
obtaining system information and starting/stopping recordings.
Power light
Glows when the system is powered on.
Power Button
Press to turn on; press and release to initiate a graceful system
shutdown.
Power jack
The power supply is plugged in here. The port requires a 19 V centerpositive DC power source. Alway use the provided power supply.
USB 2.0 Ports
For connection of external hard drives, flash drives, or control
interfaces.
DisplayPort connectors
Mirrors the touch screen output. Will be updated in a future firmware
release.
RJ-45 Ethernet
Auto-sensing gigabit Ethernet 10/100/1000 Base-T network port.
SDI in
Connects SDI signals to Pearl.
VGA in
Connects VGA and other analog video signals to Pearl.
HDMI in
Connects HDMI and DVI signals to Pearl.
TRS Audio in
Connects balanced or unbalanced (line) left/right TRS audio to Pearl.
Lock
Allows Pearl to be locked to a desk or surface using a laptop lock cable.
Row A/B designators
This manual and Pearl's web admin interface refer to row A and row B.
Ports above the line are part of row A, ports below form row B.
9
Pearl User Guide
Quick Start
Quick Start
This section covers two methods to help you get up and running quickly with your Pearl. You can plug and play
directly with auto channels, or, with a bit of extra work you can create a custom channel that uses TRS audio.
l Using auto channels
l Creating a new custom channel
Before you get started, make sure you have:
l a video source (i.e. a camera, a computer, a tablet, or a phone) (for SDI and HDMI, the source must not
be HDCP protected)
l for SDI or HDMI sources, accompanying audio over the same source cable
l the appropriate cables or adapters to convert the output to SDI, HDMI or VGA (if needed)
l optionally (for custom channel configuration), a separate TRS audio source such as a microphone
l ideally, a network with Dynamic Host Configuration Protocol (DHCP)
l a computer with a web browser connected to the same network (this is referred to as the “admin”
computer in the steps below)
These instructions include steps for setting up and configuring audio. Skip these optional steps if
you do not want to configure an audio source at this time.
Using auto channels
Pearl is pre-configured with two plug and play channels: Auto A and Auto B.
To set up the auto channels:
1. Turn on your HD source and connect the output cable to a port in Row A on the back of Pearl (if needed,
use an adapter such as the DVI to HDMI adapter).
2. If desired, plug a second source into one of the Row B inputs on the back of the system.
3. Connect the Ethernet cable to the Pearl. Connect the Ethernet cable to your network.
4. Attach the power cable to the system and plug it into a power source.
5. Press the power button on the back panel to turn on the system.
6. Wait for the Pearl to complete the power up sequence. The system is ready a few moments after the
power LED illuminates.
10
Pearl User Guide
Quick Start
The system automatically configures the channel's frame size to match the source resolution and calculates the
best bit rate for the default frame rate of 30 fps. If the source is SDI or HDMI and includes unencrypted audio,
audio is automatically detected and added to the channel.
Pearl's front screen, if enabled (it is enabled by default), updates to show you previews of your channel(s) with
audio meters so you can verify that both audio and video are being captured.
See Configure the Touch Screen to enable Pearl's touch screen, if needed.
To view the auto channels:
You can start viewing the channel(s) immediately by using a browser on a computer on the same LAN or
network.
1. Find the system’s serial number. It is printed on a sticker on the back of the system, or avialable on the
system information display on the touch screen. To access the serial number:
l from the "no channels" screen, touch the screen anywhere to move to the system information
screen; or
l from a single channel view or grid view, touch the system information (i) button.
2. Open a browser window on a computer on the same LAN or network
3. Browse to one of the following URLs:
11
Pearl User Guide
Quick Start
For Auto A: http://<serial>.local/preview.cgi?channel=1
For Auto B: http://<serial>.local/preview.cgi?channel=2
For example:http://d560515f.local/preview.cgi?channel=2
4. Or, if Bonjour services are not installed on the computer, use Pearl's IP Address, available from the same
system information page of the touch screen, and browse to:
For Auto A: http://<IP Address for Pearl>/preview.cgi?channel=1
For Auto B: http://<IP Address for Pearl>/preview.cgi?channel=2
You'll find alternate connection streams (i.e. RTSP or MPEG-TS) for these channels by logging into the admin
interface and accessing Auto A and Auto B by the links under the Channels menu. See View available video
formats .
Creating a new custom channel
The automatic channels Auto A and Auto B always use audio from the video source for SDI and HDMI, and
from TRS for VGA. If you want to create a channel that uses SDI, DVI, or HDMI video with TRS audio, or simply
want to do a bit more configuration to the channel, follow these steps.
l Step 1: Physical Setup and Power On
l Step 2: Admin Discovery and Login
l Step 3: Setup the Video Source
l Step 4: Configure the Channel
l Step 5: Testing the Stream
l Step 6: Recording the Channel
Step 1: Physical Setup and Power On
Complete the following steps to prepare and power on the system. Refer to the Front and back view section to
locate the appropriate input ports.
1. Turn on your HD source and connect the output cable to the matching port on the back of Pearl (if
needed, use an adapter such as the DVI to HDMI adapter).
2. (optional) Attach a set of left/right TRS audio cables from your audio source to the TRS audio input
ports on the back of Pearl.
3. Connect the Ethernet cable to Pearl. Connect the Ethernet cable to your network.
4. Attach the power cable to the system and plug it into a power source.
5. Press the power button on the back panel to turn on the system.
12
Pearl User Guide
Quick Start
6. Wait for Pearl to complete the power up sequence. The system is ready a few moments after the power
LED illuminates.
Step 2: Admin Discovery and Login
Pearl is managed from a web interface. This interface acts as a configuration utility and system monitor. You can
access the web interface via either the device's IP address on your network or via DNS-based discovery if you
have Bonjour services installed. Perform one of the following two procedures to access the web interface.
To access the system by IP address:
1. Find the system’s IP Address:
l from the "no channels" screen, touch the screen anywhere to move to the system information
screen; or
l from a single channel view or grid view, touch the system information (i) button.
2. Type the following string into the address bar of your web browser on your admin computer (where <ip
address> is the ip address of your Pearl):
http://<ip address>/admin
For example: http://192.168.1.163/admin
3. Enter the user name and password then click OK. The administrative user is ‘admin’. Initially no
password is set. To set a password follow the procedure outlined in Setting and Changing User
Passwords.
13
Pearl User Guide
Quick Start
To access the system by DNS-based discovery:
The steps below use DNS-based service discovery (a type of zero-configuration networking) to access the
system. Depending on the operating system on your admin computer you may need to install some software
before you can used DNS-based discovery.
Table 5 Installing Bonjour Print Services
System
Action Needed
Microsoft Windows
You must install Bonjour Print Services:
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 in to the Mac OS. No special
actions 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.
You are able to access the system web interface on the local network by specifying its serial number in a web
browser on your admin computer.
1. Find the system’s serial number. It is printed on a sticker on the back of the unit, and is also available on
the system information page on the touch screen.
2. Type the following string into the address bar of your web browser on your admin computer (where
<serial> is the serial number of your Pearl):
http://<serial>.local/admin
For example: http://95dd40d5.local/admin
3. Enter the user name and password then click OK. The administrative user is ‘admin’. Initially no
password is set. To set a password follow the procedure outlined in Setting and Changing User
Passwords.
14
Pearl User Guide
Quick Start
4. Optionally, navigate to the Network link under the Configuration heading and note the IP address of
the system.
Step 3: Setup the Video Source
The web interface has a pre-configured list of the system's video and audio inputs in the Sources section. The
sources are conviniently labelled to indicate the type and the input row in which they are located. Video
sources are labeled <input type>-A or <input type>-B. Audio sources are listed as either SDI/HDMI audio or
Analog audio for the TRS inputs.
1. From the web interface, scroll to the Sources section
15
Pearl User Guide
Quick Start
2. Click the video source for which you have connected a cable and check the video preview that appears
on right side of the screen.
3. Make note of the name of the source, or optionally, change the source name to reflect the data it is
capturing.
To rename the input source:
a. Click on the source name at the top of the source configuration window. The name text becomes
red.
b. Edit the name. The following characters are supported: a-z; A-Z; 0-9; + (plus); - (hyphen); _
(underscore); , (comma), . (period); ~ (tilde); # (hash); [ ]; ( ). Although spaces are also supported, it
is suggested you use underscores to separate words.
c. Press Enter on the keyboard. The name is updated at the top of the screen and in the list of
sources at the left side.
Source setup is complete. The system automatically detected and adjusted the image capture settings at start
up and will continue to adjust every 60 seconds during operation (interval is configurable). The system’s goal is
to produce the best quality captured image given the source equipment used. Generally no further
configuration tweaks are needed.
Step 4: Configure the Channel
Now that you have confirmed the system sees your source it is time to add and configure a channel for output
of your source. Channels expose your sources to your streaming users and prepare the sources for recording.
16
Pearl User Guide
Quick Start
By default, when you add a channel, the system names it the same name as its source. If you changed the
source name in previous steps, your new channel's name will reflect the new name.
To add a channel for your source:
1. In the web interface, click Add channel from the Channels section; a new channel is created and the
channel configuration page opens.
2. From the Use video source drop-down list, select your source; the audio selections list appears.
17
Pearl User Guide
Quick Start
3. Select the audio source you wish to use.
4. Click Apply.
5. Click Encoding for your channel; the Encoding page is displayed.
6. Scroll to the bottom of the encoding page and click the Enable audio checkbox.
7. Leave the default MP3 format and audio bitrate.
8. Click Apply.
Review other channel configuration items:
1. From your channel's Encoding page, review some of the default settings. The five most useful settings to
know about are codec, recording preset, frame size, frame rate and bitrate.
Setting
Description
Codec
Set to H.264 by default. Unless you know you want something
different, use this setting.
Encoding Preset
Only available with the H.264 codec. Hardware codecs are strongly
reocmmended for maximum performance. Balanced (HW) is the
default and is a good starting point. If you know you have a
compatibility issues with our hardware H.264 encoding mechanism,
select the one of the software-based presets.
Frame size
The frame size should reflect the resolution provided by your source.
You can set it to something different by typing in the fields or
selecting an option from the different sizes shown. It’s always best to
leave this at the value detected by the system unless you know it is
wrong or know you need to scale the size and cannot scale it at the
source.
Frame rate
The frame rate limit is set to 30. This means the system won’t spend
extra computing time to attempt to receive more than 30 frames per
second. For perspective, NTSC TV signals use 24 frames per second
and most hand-drawn animations show only 12 unique frames per
second. You can change this later and notice how it affects
performance and quality.
Bitrate
The default bitrate is automatically calculated based on the resolution
and frame rate. If needed, you can raise or lower the bitrate. Higher
bitrates will use more network bandwidth.
2. Click Status for your channel.
18
Pearl User Guide
Quick Start
3. Notice the Stream Info section has an item named Video that reflects four of the settings reviewed in
prior steps (the frame rate is specified as <resolution size>@30 for 30 frames per second). It also
provides an indication of the current actual frame rate.
Step 5: Testing the Stream
Use the system's touch screen for confidence monitoring and notice what is being captured for your new
channel.
To preview your channel on the touch screen:
1. As soon as your channel is configured, it appears on the touch screen.
2. If more than one channel is configured, your channels appear in a grid. Touch any channel in the grid to
view the channel full-screen. Touch the grid button to return to the grid view.
Additionally, you can test the stream through a browser. The Status page contains a link to the live broadcast
stream for your channel.
To preview the channel in a browser:
1. From the web interface, scroll to the Channels section.
2. Click the link for your channel.
3. Click the Status link for your channel.
4. Right-click on the Live broadcast link for your channel and select Open in a new tab or Open in a new
window.
5. The new tab or window opens with the stream displayed.
6. If the signal is not detected, reseat the video and audio cable connections and try again.
Your stream setup is complete. Since most of the steps are pre-configured; you are up and running with a
stream very quickly. You can share the live broadcast link with your users.
19
Pearl User Guide
Quick Start
Step 6: Recording the Channel
The channel is set up and streaming. This may be all you need, but if you like, you can also record the stream.
You can choose to initiate and control channel recording from either the touch screen or the web interface.
To control recording from the touch screen:
1. If viewing the grid view, touch the channel for which you wish to control recording; the channel view is
displayed.
2. If necessary, touch the screen once to display the controls for the channel.
3. Touch the recording control button; the touch screen will start a timer to indicate the length of the
recording. Touch the control again to stop recording. (If the button is not visible, recording control via
the touch screen is not enabled; see Block (or allow) recording control from the touch screen.)
To control recording from the web interface:
1. From the web interface, scroll to the Channels section.
2. Click Recording for your channel; the Recording page is displayed.
3. Click the red Start button; the text at the top of the screen changes to indicate the recording is starting,
then indicates the length of time since the recording started.
4. Click the black Stop button; the recorder stops.
5. Refresh the page by clicking Recording again; the page reloads and a file list appears that shows your
newly recorded stream snippet.
6. Click the file name to download and view your recording.
What’s Next?
Now that you have a source setup and ready to stream, you can fine-tune the system to your exact
requirements. You can look at topics such as:
l Merge/include multiple video sources into a single channel
l Stream your video
20
Pearl User Guide
Quick Start
l File and Recording Transfer
l User Administration
When you have completed system tuning, make sure to back up the system configuration using the procedure
described in:
l Save and Restore Device Configuration
Refer to the table of contents for a complete list of the topics covered.
21
Pearl User Guide
Using Pearl's touch screen
Using Pearl's touch screen
Pearl's front panel includes a touch screen display used for confidence monitoring and basic configuration. By
default, the screen and all its features are enabled. You can configure whether or not the touch screen is active
and which features are enabled. See Configure the Touch Screen.
This section describes how to use the touch screen and provides an overview of the functionality available
through the screen.
l Overview
l View system information
l Channel monitoring and switching
l Control recording
Overview
While Pearl is booting, the following image appears on the touch screen (if the screen is enabled).
After boot up is complete, Pearl displays a grid view providing an overview of all configured channels.
If you have no sources plugged in, or if no plugged in source is sending a signal, the grid view shows the two
auto channels with no signal (see Use the automatic channels Auto A and Auto B for more details on auto
channels):
22
Pearl User Guide
Using Pearl's touch screen
With sources plugged into at least one input of row A and row B, the grid view looks more like this:
From this screen, touch either channel to go to the individual channel screen, or touch the i symbol to go to
the system information screen. From the single channel screen touch the i to go to system information or
touch the button with four squares to return to the grid..
If you change your automatic channels to use No source instead of Auto A or Auto B, and have no other
channels configured, Pearl shows a no channels screen. Touch anywhere on this screen to go to the system
information screen.
View system information
Useful when first setting up Pearl, for finding the system serial number or to check the installed firmware
version, the touch screen shows you basic information about your Pearl. If desired, you can choose to hide this
screen. See Configure the Touch Screen.
23
Pearl User Guide
Using Pearl's touch screen
Label
Description
Device Information
l Serial number
l Firmware version
Network Information
l IP Address
l MAC Address
Device Status
l System date
l System time
l Uptime
l temperature
Storage Information (when available)
l Disk space available
l Pictogram of available disk space To show system information on the touch screen:
1. If the system information button (i) does not appear on the screen, tap the screen once to turn on the
control buttons.
2. If the system information button is still not visible, it is disabled in the system's Touch screen
configuration. See Configure the Touch Screen to enable system information.
3. Touch the system information button (i)on the screen.
24
Pearl User Guide
Using Pearl's touch screen
To close the system information screen:
1. Touch anywhere on the screen to return to the previous screen.
Channel monitoring and switching
Use Pearl's front-panel screen to have complete confidence about what you're capturing. View audio levels and
a preview of the captured video for each channel. Change between channels or view a grid of all channels using
on-screen navigation buttons.
Individual channel monitoring
Label
Description
Channel Name
Recording button/indicator
Total recording time (since recording started, not
only for current file of a multi-part recording).
Select previous channel.
25
Pearl User Guide
Using Pearl's touch screen
Label
Description
Select next channel.
Audio level indicator (semi-transparent bar).
Displayed only if the channel has audio.
Grid view button. Use to switch to grid view.
System Information button. Use to switch to system
information.
To switch between available channels:
1. If necessary, tap the screen once to turn it on.
2. If necessary, tap the screen once to display controls on the channel view.
3. Touch the left or right controls on at the side of the channel display; the screen displays the next
channel.
To change from grid view to an indivifual channel view:
1. If necessary, tap the screen once to turn it on.
2. Touch any channel in the grid view; the screen displays the selected channel.
Grid-view channel monitoring
Depending on the number of configured channels, the grid view will show 2, 3, 4, 5 or 6 channels at once.
Label
Description
Channel Name
26
Pearl User Guide
Using Pearl's touch screen
Label
Description
Recording indicator, if applicable. (Recording
control only accessible from individual channel view.)
Audio level indicator. Dispalyed only if the channel
has audio.
System Information button. Use to switch to system
information.
To change from individual channel view to grid view:
1. If necessary, tap the screen once to turn it on.
2. If necessary, tap the screen once to display controls on the channel view.
3. Touch the grid view button; the screen displays the grid view
Control recording
Pearl's touch screen gives you freedom to start and stop recording without needing to log in to the web
interface.
Simply scroll to the channel you wish to control and press the start or stop recording button.
To start recording:
1. If necessary, tap the screen once to turn it on.
2. If the grid view is showing, tap the channel for which you wish to control recording; the screen displays
the channel.
3. If necessary, tap the screen once to display controls on the channel view.
4. Touch the red record button (see above) at the top right of the screen; recording starts and a timer is
displayed to show the length of the recording.
27
Pearl User Guide
Using Pearl's touch screen
To stop recording:
1. If necessary, tap the screen once to turn it on.
2. If the grid view is showing, tap the channel for which you wish to control recording; the screen displays
the channel.
3. If necessary, tap the screen once to display controls on the channel view.
4. Touch the red record button (see above) at the top right of the screen; recording stops and the timer
disappears.
28
Pearl User Guide
PART 1: Setup
PART 1: Setup
If you followed through the quick start guide, you already have a basic configuration and possibly a recording
of an input. Before you tweak the channel or configure more, this part of the manual helps you to get your
Pearl properly configured for your network.
Topics covered:
l Connect to the Admin Interface
l User Administration
l Configure Network Settings
l Configure Date and Time
l Configure the Touch Screen
l Restrict Viewers by IP Address
29
Pearl User Guide
1-1 Connect to the Admin Interface
1-1 Connect to the Admin Interface
Pearl is managed from a web interface. If you know the IP address of the system you may type it into the
address bar of your web browser.
http://<IP Address of Pearl>/admin
The first time you access the web interface you may not know the IP address of the system. Pearl supports a
number of ways to determine the IP address. The simplest way is to use the touch screen, if it is enabled.
1. Determine the IP address using the touch screen:
l from the "no channels" screen, touch the screen anywhere to move to the system information
screen; or
l from a single channel view or grid view, touch the system information (i) button.
2. Type the following string into the address bar of your web browser on your admin computer (where <ip
address> is the ip address of your Pearl)
http://<ip address>/admin
For example: http://192.168.1.163/admin
3. Enter the user name and password then click OK. The administrative user is ‘admin’. Initially no
password is set. To set a password follow the procedure outlined in User Administration.
30
Pearl User Guide
1-1 Connect to the Admin Interface
The remainder of this section covers two alternate system discovery methods that work with networks that
support Dynamic Host Configuration Protocol (DHCP) and a method that works for networks that do not
support DHCP.
For networks with DHCP use one of the following procedures:
l Connect via DNS-based Service Discovery
l Connect via the Epiphan Discovery Utility
For networks without DHCP, use the following procedure:
l Connect via Persistent Static IP Address
You can also connect to a reduced Operator tablet interface. See Connect to the tablet interface
Connect via DNS-based Service Discovery
Pearl uses DNS-based messages to advertise details about itself, including its domain name. With a compatible
utility installed on your computer, you can access the system simply by typing its serial number and the suffix
“.local” into the address bar of your browser.
To ensure you have compatible software, refer to the following table.
Table 6 Installing Bonjour Print Services
System
Action Needed
Microsoft Windows
You must install Bonjour Print Services:
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.
To access Pearl's web interface via DNS service discovery:
1. Find the system’s serial number. It is printed on a sticker on the back of the system, or avialable on the
system information display on the touch screen. To access the serial number:
31
Pearl User Guide
1-1 Connect to the Admin Interface
l from the "no channels" screen, touch the screen anywhere to move to the system information
screen;
l from a single channel view, touch the system information button; or
l from the grid view, select a channel, then touch the system information button.
2. Type the following string into the address bar of your web browser on your admin computer (where
<serial> is the serial number of your Pearl):
http://<serial>.local/admin
For example: http://95dd40d5.local/admin
3. Enter the user name and password then click OK. The administrative user is ‘admin’. Initially no
password is set. To set a password follow the procedure outlined in Setting and Changing User
Passwords.
4. Optionally, navigate to the Network link under the Configuration heading and note the IP address of
the system.
Connect via the Epiphan Discovery Utility
Epiphan provides a utility for discovering Epiphan systems on your network. The Epiphan network discovery
utility is a 32-bit Windows executable that works on most 32-bit and 64-bit Windows operating systems.
Download and install the utility via the download link on this web page:
http://www.epiphan.com/products/broadcasting/resources.
To access the Pearl's web interface via the Epiphan discovery utility:
32
Pearl User Guide
1-1 Connect to the Admin Interface
1. Launch the discovery utility.
2. Click Search to find all the Epiphan systems on the network; a list similar to the following appears.
3. If more than one system appears, select the one you wish to configure by matching the serial number
listed with the serial number marked on the back of the system.
4. Optionally, note the IP Address shown in the stream properties. Use this for quicker access to the
system on future configuration sessions.
5. Click the Web config button; your browser will open and point to the web interface page.
http://<IP Address for Pearl>/admin
6. Enter the user name and password then click OK. The administrative user is ‘admin’. Initially no
password is set. To set a password follow the procedure outlined in User Administration.
33
Pearl User Guide
1-1 Connect to the Admin Interface
Connect via Persistent Static IP Address
This section discusses how to directly connect to Pearl using the factory default persistent network settings.
Use this method if your network does not have a DHCP server or if you prefer to connect directly to the system
for initial configuration.
To perform this procedure you will need a workstation computer for which you are able to modify network
settings.
Pearl is pre-configured with the following static address defaults:
l IP Address:
192.168.255.250
l Netmask:
255.255.255.252
l User Name:
admin
l Password:
your admin password (by default set to no password)
To access Pearl's web interface via the persistent static IP address:
1. Establish an Ethernet connection between Pearl and the workstation by one of the following methods:
a. Connect the system to a local Ethernet network shared with the workstation.
b. Connect the system directly to the workstation’s Ethernet port using either a regular or a
crossover Ethernet cable.
2. Record the network settings of the workstation being used to connect to Pearl so that they can be
restored later.
3. Temporarily change the network configuration on the workstation to the following:
a. Use Static IP assignment
b. IP address: 192.168.255.249
c. Subnet mask: 255.255.255.252
4. Start a web browser on the workstation and browse to: http://192.168.255.250/admin/
5. Log in as the administrator user with the user name admin and the admin password (by default there is
no password); the web interface page opens.
6. Click the Networking link in the Configuration menu.
7. Select the radio button to use a static address and configure the system with a static IP address and
network settings relevant to the network being used. For specific details about the settings presented,
see Configure Network Settings.
8. Restore the previously saved network configurations on the workstation.
34
Pearl User Guide
1-1 Configure the Touch Screen
1-1 Configure the Touch Screen
By default, Pearl's touch screen is enabled and all its features are available. Depending on your circumstances,
you may wish to disable the screen, or disable just some of its features.
This section covers the following touch screen configuration items:
l Disable (and enable) the touch screen
l Hide (or show) channel previews on the touch screen
l Disable (or enable) system information on the touch screen
l Block (or allow) recording control from the touch screen
l Set touch screen timeout
Disable (and enable) the touch screen
You can prevent Pearl from displaying anything on the touch screen, or you can re-instate this feature by
toggling the Enable display configuration option.
The display is always touch-sensitive. This control indicates whether or not the display is on
or off.
To disable (or enable) the touch screen display:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Touch Screenlink in the Configuration menu; the touch screen configuration page opens.
35
Pearl User Guide
1-1 Configure the Touch Screen
4. Uncheck Enable display to disable the display (or check the box to enable the display).
5. Click Apply.
Hide (or show) channel previews on the touch screen
By default, Pearl shows previews of each configured channel. If this isn't suitable for your needs, you may
disable channel preview.
To hide (or show) the channel previews on the touch screen:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Touch Screenlink in the Configuration menu; the touch screen configuration page opens.
36
Pearl User Guide
1-1 Configure the Touch Screen
4. Uncheck Show previewto disable channel previews (or check the box to enable previews).
5. Click Apply.
Disable (or enable) system information on the touch screen
Once you've configured, Pearl its possible you may no longer wish to show the system information dispaly on
the touch screen. .
To hide (or show) system information on the touch screen:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Touch Screenlink in the Configuration menu; the touch screen configuration page opens.
4. Uncheck Show system informationto prevent the system information screen from being accessible on
the touch screen (or check the box to enable system information).
5. Click Apply.
Block (or allow) recording control from the touch screen
By default, Pearl permits recording control from the individual channel view. You can disable this control to
prevent unwanted interruptions in recordings.
Channel preview must be on for recording control to work.
To block (or allow) the channel previews on the touch screen:
37
Pearl User Guide
1-1 Configure the Touch Screen
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Touch Screenlink in the Configuration menu; the touch screen configuration page opens.
4. Uncheck Allow start/stop recordingto disable recording control from the touch screen (or check the
box to enable recording control).
5. Click Apply.
Set touch screen timeout
Initially, the touch screen is always on for easy monitoring. However, if you'd like, you can modify its
configuration to cause it to shut off after a given amount of time. To re-enable it after timeout, simply touch
anywhere on the screen.
To set a timeout for the touch screen:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Touch Screenlink in the Configuration menu; the touch screen configuration page opens.
38
Pearl User Guide
1-1 Configure the Touch Screen
4. Enter a value in the Timeout field. The values is in seconds. Use 0 to keep the screen on whenever the
system is on.
5. Click Apply.
39
Pearl User Guide
1-2 User Administration
1-2 User Administration
Pearl has three configured users:
l admin
l operator
l viewer
By default, none of these users have passwords. For security purposes you should add passwords to the admin
and operator accounts.
This section describes the following user administration topics:
l Understanding User Privileges
l Setting and Changing User Passwords
l Removing User Passwords
l Overcoming Lost Passwords
l Changing the logged-in user
Understanding User Privileges
Pearl's three user accounts are admin, operator and viewer. The user account names cannot be changed and
the accounts cannot be disabled. By default, none of the accounts have passwords.
Admin
The admin account is the main operator used for all system configuration. This user has access to all options in
the web interface.
Operator
The operator account is a subclass of the admin account. The operator can log in and view all configuration
items but may only make changes to a small number of options. This account is intended for an operator to
start and stop recordings, download recordings, or perform network diagnostics.
Viewer
The viewer account is for all end-users who are permitted to view the streamed channels. By default, when
there is no password, users are not prompted for a username and password when viewing a channel. The
viewer username and password prompt appears only when there is a viewer password set.
40
Pearl User Guide
1-2 User Administration
In addition to the global viewer account, each channel can set a viewer password that overrides the global
value. See Restrict access to streams for viewers.
Current User
When logged in to the web interface, the current username is displayed at the top right corner of the screen.
User Privileges
The following table outlines the privileges for each user:
Table 7 User Privileges in the Web Interface
Action or Menu Option
View channel output
viewer
operator
admin
ü
ü
ü
ü
ü
Channel Operations
View Channel Configuration
Rename a Channel
ü
Configure Stream Channel
ü
Configure Stream Sources
ü
Publish a Stream
ü
Configure Branding for a Channel
ü
Start the Stream Recorder
ü
ü
Stop the Stream Recorder
ü
ü
View Recorded Files List
ü
ü
Download Recorded Files
ü
ü
Delete Recorded Files
ü
ü
ü
ü
Source Operations
View Source Configuration
41
Pearl User Guide
1-2 User Administration
Action or Menu Option
viewer
operator
admin
Rename Source
ü
Configure Source
ü
ü
View Source Snapshot
ü
ü
ü
ü
System Configuration Operations
View System Configuration
Configure Automatic File Upload
ü
Select External USB Drive Behavior
ü
Configure FTP Server
ü
Configure UPnP Sharing
ü
Configure Network Address
ü
Configure USB Tethering
ü
Perform Network Diagnostics
ü
ü
Configure Date and Time preferences
ü
Set or Change User Passwords
ü
Configure the Touch Screen
ü
Configure Serial Port Flow Control
ü
Upload Branding Images
ü
Upload Branding Templates
ü
Select Branding Template
ü
Enable Remote Support
ü
Backup Device Configuration
ü
Restore Device Configuration
ü
Restore Factory Configuration
ü
Reboot Device (via Web Interface)
ü
Shutdown Device (via Web Interface)
ü
42
Pearl User Guide
Action or Menu Option
1-2 User Administration
viewer
operator
admin
Configure Time Until Next Disk Check
ü
Perform Disk Check
ü
View Disk Information
ü
ü
Upgrade Firmware
ü
View System Information
ü
ü
Setting and Changing User Passwords
None of admin, operator or viewer have passwords assigned by default, but since both the admin and the
operator user have access to the web admin interface, you should always set a password for both admin and
operator accounts. Refer to your system administrator for your organization’s specific password requirements.
In addition to setting global passwords for viewers, you can also set access passwords and IP restrictions on a
per-channel basis from the channel's Streaming page. See Restrict access to streams for viewersRestrict
Viewers by IP Address.
Passwords are case sensitive and can use all alpha-numeric keys in the ASCII range. Your password can be up
to 255 characters long, but should not include any spaces.
Setting a user’s password causes the user to be logged out. Be ready to log back in with the new
admin password or have operators and viewers log in with the appropriate new password. Viewers
may need to refresh their browser window or press play in their media player.
If you lose the admin password, refer to the section Overcoming Lost Passwords.
To set a user password:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Access passwords link in the Configuration menu; the password configuration page opens.
4. Highlight and delete the current password for your selected user (the password is currently masked as
dots).
For security reasons, the current password appears as eight dots regardless of password
length, and even if there is no password set.
43
Pearl User Guide
1-2 User Administration
5. Highlight and delete the confirmation password for the selected user.
6. Select the user’s password field and type a new password for the user.
The new password must have between 1-255 alpha-numeric characters or special characters
with no spaces. Passwords are case sensitive.
7. Select the user’s password confirmation field and confirm the new password.
8. Click Apply.
9. If you were logged in as the user whose password you just changed, you are logged out and must log
back in with the new password. If you added or changed the viewer’s password, all viewer’s stream will
pause until they log in with the new password.
If desired, you may specify multiple account passwords on the same page before clicking Apply.
Removing User Passwords
If you want to remove passwords for one or more user accounts, you may do so via the web interface. If you
don’t remember the admin password, refer to the section Overcoming Lost Passwords.
Note that viewer passwords can be set on a per-channel basis.
Clearing a user’s password will cause that user to be logged out. Be ready to log back in with the
new admin password. If viewers are watching the broadcast when the viewer password is cleared
they will be logged out. Viewers may need to refresh their browser window or press play in their
media player to trigger the login prompt.
To clear a user’s password:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Access passwords link in the Configuration menu; the password configuration page opens.
4. Highlight and delete the current password for your selected user (the password is currently masked as
dots).
For security purposes, the current password appears as eight dots regardless of password
length, and even if there is no password set.
5. Highlight and delete the confirmation password for the selected user.
6. Click Apply.
44
Pearl User Guide
1-2 User Administration
7. If you were logged in as the user whose password you just cleared, you are logged out and must log
back in without a password. If you cleared the viewer’s password, all viewers’ stream will pause until they
log in without a password.
To clear a user’s password on a specific channel:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the Streaming link for the channel; the channel's Streaming configuration page opens.
4. From the Access control section do one of the two following things:
a. clear the viewer password field; or
b. select Use global settings from the access control drop down.
5. Click Apply.
Overcoming Lost Passwords
If you have lost the password for the operator or viewer account, you can log in to the web interface as admin
and reset the password using the procedure described in Setting and Changing User Passwords.
If you have lost the admin password and you have remote support enabled on the system, you can contact
Epiphan support to request a remote password change. See Remote Support. If remote support is disabled,
you will need to return the system to Epiphan for password recovery. Contact Epiphan support to discuss this
option.
Changing the logged-in user
When you log in to the web interface as admin or operator, your browser remembers this configuration and
automatically logs you in as the same user when you go back to the site.
Sometimes you need to change from operator to admin, or vice versa.
To change the logged-in user:
1. Exit your browser completely, or open a different browser (i.e. Internet Explorer, Chrome, and Safari are
different browsers).
2. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
3. You are prompted for a username and password.
45
Pearl User Guide
1-3 Configure Network Settings
1-3 Configure Network Settings
By default Pearl uses DHCP to obtain an IP Address via an Ethernet-based network. If you want to change the
network settings, or if you’re having network-related issues, this section covers the following related topics:
l Verify IP Address and MAC address via the touch screen
l Verify IP Address and MAC address
l Configure a Static IP Address
l Configure DHCP
l Tether to a Mobile Network
l Perform Network Diagnostics
Verify IP Address and MAC address via the touch screen
Pearl's touch screen interface, if enabled, can quickly and easily show you the system's IP Address and
MAC address.
To show system information on the touch screen:
1. If the system information button (i) does not appear on the screen, tap the screen once to turn on the
control buttons.
2. If the system information button (i) is still not visible, it is disabled in the system's Touch screen
configuration. See Configure the Touch Screen to enable system information.
3. Touch the system information button (i) on the screen; the system information screen appears.
To close the system information screen:
1. Touch anywhere on the screen to return to the previous screen.
46
Pearl User Guide
1-3 Configure Network Settings
Verify IP Address and MAC address
The web interface shows you the system’s MAC address and current IP Address via the Network configuration
page.
To view settings on network configuration page:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Network link in the Configuration menu; the network configuration page opens.
4. Note the MAC address and Current IP address listed at the top of the page.
Table 8 Network Information Fields
Label
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
to share 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 supports IPv4 addresses. It does not support IPv6
addresses.
Configure a Static IP Address
Your network administrator may require you to use a static IP address for your Pearl.
To configure a static IP address:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Network link in the Configuration menu; the network configuration page opens.
47
Pearl User Guide
1-3 Configure Network Settings
4. Select the radio button use static address, if not already selected.
5. Enter the desired IP Address and Network Mask.
Only IPv4 addresses are supported.
6. Enter the Default Gateway address. If you do not have a default gateway for your network, enter the
same static IP address as in the previous step.
The default gateway cannot be left blank. If no default gateway is specified, unexpected
behavior occurs.
7. Enter the DNS Server address. If you do not have a DNS server, enter the new static IP address of the
system.
The DNS Server address cannot be left blank. If no DNS Server is specified, unexpected behavior
occurs.
8. Change the MTU Size value only if needed. See the table below for information on maximum
transmission unit (MTU) values.
9. Click Apply to save the changes; the changes are saved and a message appears asking you to reboot.
48
Pearl User Guide
1-3 Configure Network Settings
10. Select the Maintenance link under the Configuration menu; the maintenance page appears.
11. Click the Reboot Now button near the bottom of the page.
12. Wait for the system to reboot.
13. Open the Web interface using the new IP address.
14. Log as admin and reload the Networking page to verify all changes were applied.
The following table describes applicable fields when setting a static IP address.
Table 9 Static IP Address Fields
Label
Description/Options
Use DHCP
Select this radio button to dynamically obtain an IP address at boot up.
Use static address
Select this radio button to use the configured static IP address.
IP Address
The internet protocol address (IP Address) to assign. This value is may be obtained
from your system administrator. Pearl supports IPv4 addresses. It does not support
IPv6 addresses.
Network Mask
Also called the subnet mask, this value denotes a range of IP addresses. This value may
be obtained from your system administrator, determined from another computer on
the same subnet, or calculated 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 if all nodes in your network use the same value,
so only change this value if you know other nodes use a different value.
Configure DHCP
Occasionally, such as when moving your system to a new network, your Pearl must switch from static IP address
allocation to dynamic allocation via DHCP. You can accomplish this three ways:
49
Pearl User Guide
1-3 Configure Network Settings
l Restore factory settings, clearing all your custom settings. See Restoring Factory Configuration.
l Load a configuration file that uses DHCP networking. See Load a saved device configuration.
l Change the network settings. See the procedure below.
To configure use of DHCP for networking:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Network link in the Configuration menu; the network configuration page opens.
4. Select the radio button use DHCP, if not already selected.
5. Change the MTU Size value only if needed. See the table below for information on maximum
transmission unit (MTU) values.
6. Click Apply to save the changes; the changes are saved and a message appears asking you to reboot.
7. Select the Maintenance link under the Configuration menu; the maintenance page appears.
8. Click the Reboot Now button near the bottom of the page.
9. Wait for the system to reboot.
10. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
11. Log as admin and reload the Networking page to verify all changes were applied.
The following table describes the fields applicable when configuring DHCP on Pearl.
Table 10 DHCP Fields
Label
Description/Options
Use DHCP
Select this radio button to dynamically obtain an IP address at boot up.
Use static
address
Use static address Select this radio button to use the configured static IP address.
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 if all nodes in your network use the same value, so only change this
value if you know other nodes use a different value.
50
Pearl User Guide
1-3 Configure Network Settings
Tether to a Mobile Network
Pearl supports tethering to a mobile device via USB. Tethered networking can work side-by-side with Ethernet
routing and either networking system can be a back-up for the other.
When the system falls over to the backup network type (i.e. from Ethernet to mobile, or vice versa)
all streaming sessions with clients or servers directly connected to the system are closed and the
clients will need to reconnect. You may need to provide a new stream URL (containing the new
IP address) to your viewers. See the channel information page to get the new stream URL.
By contrast, actively published streams are closed and reconnected via the secondary network
(mobile or Ethernet) automatically, permitted the required publishing server is accessible from the
new network.
To configure tethering to a mobile network:
1. Configure the mobile device to allow tethering via USB.
2. Connect the mobile device to Pearl with a USB cable.
3. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
4. Login as admin.
5. Select the Network link in the Configuration menu; the network configuration page opens.
6. Click the dropdown box next to Use phone/tablet connection in the USB phone/tablet section; the
following choices appear:
Table 11 Mobile Tethering Options
Label
Description/Options
Disabled
Specifies that no USB tethering is permitted.
No tethering
Specifies that USB tethering is available for connecting a mobile device as a
configuration utility (i.e. using the web browser), but no mobile data is used.
Prefer ethernet
When chosen, the system tries to use the Ethernet network first. It switches to use
the mobile network (tethering) when the Ethernet network is no longer available.
To prevent viewer interruptions, mobile data will continue to be used until the
mobile network is down or publishing is restarted.
51
Pearl User Guide
1-3 Configure Network Settings
Label
Description/Options
Prefer
tethering
When chosen, the system tries to use the mobile network (tethering) first. It
switches to use Ethernet (hard-wired) when the mobile network is no longer
available. To prevent viewer interruptions, Ethernet data will continue to be used
until the Ethernet network is down or publishing is restarted.
Select this setting if you only have a mobile network.
7. Select your choice based on the table above.
8. Click Apply.
Perform Network Diagnostics
If your Pearl has network trouble, you can perform basic network troubleshooting tasks from the Network
configuration page. In addition to providing the system’s IP address and MAC address to your network
administrator (See Verify IP Address and MAC address), you can also ping an IP address or use traceroute to
determine the path taken to an address.
Note: Not all networks support ping and traceroute.
To ping or traceroute an IP address:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Network link in the Configuration menu; the network configuration page opens.
4. Click ping or traceroute; an animation appears to the left of the address to indicate processing is
underway.
5. Upon completion of the command, read the results from the console-like display is shown below the
Network Diagnostics setting.
52
Pearl User Guide
1-3 Configure Network Settings
53
Pearl User Guide
1-4 Configure Date and Time
1-4 Configure Date and Time
Pearl 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 interface lets
you specify date and time settings to ensure they are correctly configured for your time zone and your
network. This section covers the following date and time-related topics:
l Verify Date and Time via the touch screen
l Verify Date and Time Settings
l Change the Time Zone
l Configure Synchronized Time (NTP, PTP v1, and RDATE)
l Configure a Local NTP Server
l Manually Configure the Date and Time
Verify Date and Time via the touch screen
Pearl's touch screen interface, if enabled, can quickly and easily show you the system's date and time settings.
To show system information (including date and time) on the touch screen:
1. If the system information button (i) does not appear on the screen, tap the screen once to turn on the
control buttons.
2. If the system information button (i) is still not visible, it is disabled in the system's Touch screen
configuration. See Configure the Touch Screen to enable system information.
3. Touch the system information button (i) on the screen; the system information screen appears.
To close the system information screen:
1. Touch anywhere on the screen to return to the previous screen.
54
Pearl User Guide
1-4 Configure Date and Time
Verify Date and Time Settings
The current date, time, time zone, and synchronized time protocol settings are shown when the Date and Time
configuration page is loaded in the Pearl web interface.
To view settings on the date and time configuration page:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Date and Time link in the Configuration menu; the date and time configuration page opens
and the following information is displayed:
The date and time configuration page also indicates whether the system is currently using synchronized or
manually set time, and whether or not a local network time protocol (ntp) server is running.
The following table describes the date and time configuration fields.
Table 12 Date and Time Options
Label
Description/Options
Time Zone
The currently selected time zone.
Enable time
synchronization
Whether or not a time synchronization protocol is being used for setting time. (If not
selected, time is set manually.)
Protocol
The 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 time
synchronization protocol is used.)
Date
The current date. (This is the current date even if the radio button Set time manually is
not selected.)
55
Pearl User Guide
1-4 Configure Date and Time
Label
Description/Options
Time
The current time. (This is the current time even if the radio button Set time manually is
not selected.)
Change the Time Zone
By default the system has the Canada/Eastern time zone set. Configuration of the time zone is necessary to
ensure synchronized time servers provide the correct time to the system.
To select another time zone:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Date and Time link in the Configuration menu; the date and time configuration page opens.
4. Select the new time zone from the Time Zone drop down box.
5. Click Apply.
Configure Synchronized Time (NTP, PTP v1, and RDATE)
By default Pearl uses the network time protocol server (NTP server) protocol and a time server from National
Research Council Canada. You can continue to use this time server or configure a new server that is more
appropriate for your network and location. Your system administrator can provide the correct time
synchronization server settings.
To set the time synchronization method:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Date and Time link in the Configuration menu; the date and time configuration page opens.
4. Click the Enable time synchronization radio button if it is not already selected.
5. Choose one of the following choices from the Protocols drop down:
56
Pearl User Guide
1-4 Configure Date and Time
Table 13 Synchronized Time Options
Label
Description/Options
NTP
Network Time Protocol (NTP) is used for clock synchronization over the internet.
There are many publicly available NTP servers you can use, or your company may
have its own NTP server. For more information about NTP and to find NTP servers,
refer to http://support.ntp.org/bin/view/Servers/WebHome.
RDATE
RDATE is a tool for querying the current time from the network. It is generally
considered obsolete and has been replaced by NTP. It's offered here for
backwards compatibility with older timekeeping systems.
PTP v1
The 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.
6. Tailor the synchronization protocol with the required parameters as described below.
7. If NTP is selected:
a. Enter the IP address or server name for the NTP server in the Server IP Address field.
NTP uses UDP packets and port 123. If the system is behind a firewall and accessing an
external NTP server, UDP packets must be permitted on port 123.
8. If RDATE is selected:
a. Enter the IP address or server name for the RDATE server in the Server IP Address field.
b. Select an update interval from the drop down box.
9. If PTP v1 is selected:
a. Select the multicast address of PTP v1 server from the PTP domain dropdown.
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
PTP uses UDP packets and ports 319 and 320 . If the system is behind a firewall and
accessing an external PTP server, UDP packets must be permitted on ports 319 and 320.
57
Pearl User Guide
1-4 Configure Date and Time
10. Click Apply.
Configure a Local NTP Server
Pearl can run a local NTP server.
To configure a local NTP server:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Date and Time link in the Configuration menu; the date and time configuration page opens.
4. Select the check box Enable local NTP server.
Manually Configure the Date and Time
By default Pearl uses NTP for time synchronization. If your system does not have access to a time
synchronization server, or if you do not wish to use one, you can choose to manually set the date and time.
To manually set the date and time:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Date and Time link in the Configuration menu; the date and time configuration page opens.
4. Type the desired date in the Date field. Use the format yyyy-mm-dd.
5. Type the desired time in the Time field. Use the format hh:mm:ss.
6. Click Apply.
58
Pearl User Guide
1-5 Restrict Viewers by IP Address
1-5 Restrict Viewers by IP Address
Pearl permits you to restrict which computers can access broadcasts by building a list of allowed and/or denied
IP addresses. You can do this at a global level for the system and can also override these settings on a perchannel basis. Both global and per-channel configuration procedures are described below.
IP address restriction is valid for the viewer only and does not affect the web admin interface or the
mobile configuration interface.
If your viewer account has a password, your viewers must connect to the system from a computer (or gateway)
with a permitted IP address and must also supply the username and password before they can view the
broadcast.
IP Address restriction is not configurable per channel. Restrictions affect all broadcasts / streams
from the system.
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 you’re not familiar with creating allow/deny lists, refer to the examples below this procedure for assistance
with crafting your lists.
To restrict viewers by IP address:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Access passwords link in the Configuration menu; the password configuration page opens.
4. Type allowed IP addresses or address ranges in the Allow IP’s field. Separate addresses with a comma.
5. Type denied IP addresses or address ranges in the Deny IP’s field. Separate addresses with a comma.
6. Click Apply.
To restrict viewers of a specific channel by IP address:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
59
Pearl User Guide
1-5 Restrict Viewers by IP Address
3. Select the Streaming link for the desired channel; the streaming configuration page opens.
4. From the Access Control dropdown, select Use these Settings; local password and Allow/Deny IP lists
are enabled.
5. If desired, type a password for the viewer in the Viewer Password field.
6. Type allowed IP addresses or address ranges in the Allow IP’s field. Separate addresses with a comma.
7. Type denied IP addresses or address ranges in the Deny IP’s field. Separate addresses with a comma.
8. Click Apply.
If a user attempts to connect to the stream from a disallowed IP address, access is denied. If connecting by
internet browser, the message "IP address rejected." is displayed.
The following table describes the applicable fields.
Table 14 IP Based Restriction Fields
Label
Description/Options
Allow IP's
Enter individual IP Addresses or IP Address ranges, separated by commas. To specify a
range, use a hyphen (-). Optional spaces improve readability.
Users connecting from addresses in this list are permitted to view broadcasts from the
system, provided their IP address is not in the Deny IP’s list.
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
to a rule in the allow list.
Deny IP's
Enter individual IP Addresses or IP Address ranges, separated by commas. To specify a
range, use a hyphen (-). Optional spaces improve readability.
Users connecting from addresses in this list are not allowed to view broadcasts from the
system, 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
to a rule in the allow list.
Examples
Allow List with Distinct IP Addresses
The simplest allow/deny list is to use the list of known IP addresses to craft a list of allowed IP addresses. All
other addresses are denied access to the broadcast.
60
Pearl User Guide
1-5 Restrict Viewers by IP Address
For example if your system is accessible on your local area network (LAN) and you 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 your system. 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) and another 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 to broadcasts 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.200-192.168.1.250) and also want to add the desktop, laptop and tablet computers of 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.
Deny List with Distinct IP Addresses
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 the broadcast.
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 all computers except
the boardroom computer:
61
Pearl User Guide
1-5 Restrict Viewers by IP Address
Deny: 192.168.1.211
As with Allow lists, your deny list can specify a range of IP addresses, and can specify multiple ranges or distinct
IP addresses in a comma-separated list.
Allow List with a Range of IP Addresses, Distinct IP Addresses, and an
Exception
Building on the previous examples, consider the 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: 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.
Deny List with a Range of IP Addresses
Converse to the previous examples, consider the situation where you want every computer on the network to
access the broadcast, with the exception of the CEO’s desktop, laptop, and tablet computers. Additionally,
boardroom computers should not be permitted with the exception of the cafeteria computer (IP address
192.168.1.222).
The deny list is an "exception" list for the allow list. So to craft the rule described above we need to allow all the
computers in the local subnet, then deny specific sub-ranges including two groups of boardroom computers
ensuring the cafeteria 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
62
Pearl User Guide
PART 2: Sources
PART 2: Sources
Now that you know how to connect to the admin interface, you are ready to configure your input sources. The
following sections provide an overview of the types of sources you can connect to your Pearl and how to
configure each source.
The following topics are covered:
l Identify sources
l Configure a video source
l Configure an audio source
l Fine-tune source configuration
63
Pearl User Guide
2-1 Identify sources
2-1 Identify sources
A source can be an image, video, or audio from a camera, a computer screen or any device that provides a VGA,
SDI, DVI or HDMI video signal and audio signal output.
This chapter covers the following sections:
l Connecting sources
l Previewing captured stream from sources
Connecting sources
You can connect sources to Pearl at any time, either before or after the system is powered on. Similarly you can
disconnect a source from a port and even connect a different source at any time.
Changing the source connected to a port that is being streamed or recorded can result in the
recording stopping or the stream frame size changing depending on how your channel is
configured.
If the frame size changes, viewers may be disconnected and need to re-connect to the stream.
Connect the input sources to the following input ports on the system:
Table 15 Cable and port connections
Cable
Input Port
SDI
SDI port
VGA
VGA port
HDMI or DVI
HDMI port
audio
Audio Input port
The web interface automatically discovers all input sources and displays them in the Sources section of the web
admin interface.
Each video input on the back of the system is identified by its row (A or B) and input type (SDI, HDMI, or VGA).
For example the SDI input from row A is labeled SDI-A. Input sources display their captured images at the
bottom their respective source page. It is a good practice to view the images from each source to confirm what
is captured. See below.
64
Pearl User Guide
2-1 Identify sources
When a source is connected, the system automatically detects and adjusts the image capture settings at start
up and continues to adjust every 60 seconds during operation (interval is configurable). The system’s goal is to
produce the best quality captured image given the source equipment used. Generally no further configuration
is needed.
Previewing captured stream from sources
You can preview the images captured from your sources in the web admin interface. No extra configuration is
needed.
To preview the captured stream/images:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Ensure a source is connected to the input port, see Table Cable and port connections.
4. From the web interface, click the source name from the Sources menu; the source configuration page
opens.
5. Scroll to the bottom of the source configuration page to see the preview.
65
Pearl User Guide
2-2 Configure a video source
2-2 Configure a video source
This section covers the following video source configuration topics:
l Configure the video source's frame grabber parameters
l Change a source name
Configure the video source's frame grabber parameters
Generally the captured stream doesn't require any additional configuration, but if needed, you can log into the
web interface to make configuration changes.
To configure a source:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Ensure a source is connected to the input port, see Table Configure a video source.
4. From the web interface, scroll to the Sources menu option.
5. Click the HDMI, SDI or VGA source link; the source configuration page opens.
6. If desired, scroll to the bottom of the source configuration page to see the video Snapshot.
66
Pearl User Guide
2-2 Configure a video source
7. Make note of the name of the source, or optionally, change the source name to reflect the data it is
capturing. You'll need to know this name to add the source to a channel. See Create a single source
channel.
8. In most cases the video is ready to add to a channel and broadcast. If fine adjustments are required,
refer to the table below to make minor configuration changes. (The only configurable item for SDI
and HDMI sources is rotation.)
Value
Description
Autoadjustments
interval (sec)
When a source is setup, the system automatically detects and adjusts the image
capture settings at start up and continues to adjust every 60 seconds during
operation. To change the number of seconds between update, enter a value, or
0 to disable the feature, otherwise the default of 60 seconds is set.
(VGA Sources
Only)
Vertical shift
(VGA Sources
Only)
Horizontal shift
(VGA Sources
Only)
Phase
(VGA Sources
Only)
PLL adjustment
(VGA Sources
Only)
Offset
(VGA Sources
Only)
Gain
(VGA Sources
Only)
When an image is not aligned in the window, use this feature to move an image
up or down on the screen. The values range from 20 (moves the image up) to –
20 (moves the image down).
When an image is not aligned in the window, use this feature to move an image
left or right on the screen. The values range from -999 (moves the image to the
left) to 999 (moves the image to the right).
Specifies phase adjustments for VGA signals. Generally not used unless value is
provided by Epiphan support.
Changing the value adjusts the horizontal resolution of the image. Adjust the
value using small increments until the image is sharper. The value ranges from 0999 to 999.
The Offset and Gain parameters function as contrast control for an image. The
Offset controls the darker parts of the image and the gain controls the bright
parts of the image. Adjust both values to optimize image quality. Adjust the
values using small increments until the image is sharper. If you set Offset to a
high value, set a high value for the gain to balance the two.
The Gain and Offset parameters function as contrast control for an image. The
Gain controls the bright parts of the image and Offset controls the darker parts
of the image. Adjust both values to optimize image quality. Adjust the values
using small increments until the image is sharper. If you set Offset to a high
value, set a high value for the Gain to balance the two.
67
Pearl User Guide
2-2 Configure a video source
Value
Description
Aspect Ratio
Sets the aspect ratio of the captured image. The default is 4:3. Set the value to
Wide mode when capturing images that have a wide aspect ratio. Using the
incorrect setting causes the image to be distorted or stretched.
Configurable for DVI and VGA sources only.
HSync threshold
Adjust horizontal sync detection.
(VGA Sources
Only)
VSync threshold
Adjust vertical sync detection.
(VGA Sources
Only)
Rotate
This feature is useful when a source captures video that is rotated 90⁰ or is
displayed upside down. Choose one of the following values to change the video
orientation while streaming:
l No rotation
l 90⁰ clockwise
l 90⁰ counter clockwise
l 180⁰
Change a source name
Source names are used when adding sources to channels, therefore it is important that you know the name of
the source you wish to use. If a channel has only one source, it's name will automatically be the same as its
source. Sometimes it's helpful to configure the source name to match the data it's capturing so it's clear what
the channel is capturing too. Alternately you can change the channel's name. See Rename a channel.
To change a source name:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
68
Pearl User Guide
2-2 Configure a video source
3. From the web interface, scroll to the Sources menu option.
4. Click the HDMI, SDI or VGA source link; the source configuration page opens.
5. Click the source name at the top of the page; the name turns red.
6. Highlight and delete the existing source name.
7. Type a new source name.
8. Press Enter (on your keyboard) to save the new name.
You must press Enter to save the new name. The Apply button will not save the source
name change.
69
Pearl User Guide
2-3 Configure an audio source
2-3 Configure an audio source
Pearl's web interface automatically discovers all input sources and displays them in the Sources section of the
web interface. Audio sources are identified by the word audio in the source name. Audio input devices such as
a microphone and portable music players can send audio signals to Pearl using the TRS audio input ports.
Audio is also supported via HDMI and SDI.
All available video formats support audio except Motion JPEG.
Use the following sections to configure the audio settings that control the audio input:
Add an audio source to a channel
Configure audio settings
Set audio volume
Add an audio source to a channel
To add an audio source to a channel:
1. Ensure an audio input source is connected to the system.
2. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
3. Login as admin.
4. From the web interface, scroll to the channel section and click the channel to which you want to add an
audio source; the menu expands.
5. Click Sources; the channel's Sources page opens.
6. Scroll to Audio Sources. A list of audio sources connected to the system is displayed.
70
Pearl User Guide
2-3 Configure an audio source
7. Select an audio source.
8. Click Apply.
Configure audio settings
To configure audio settings:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, scroll to the channel section and click the channel for which you want to
configure audio settings; the menu expands.
4. Click ; the configuration page opens.
5. Scroll to Audio settings.
71
Pearl User Guide
2-3 Configure an audio source
6. Check Enable audio check box.
7. If the default audio format AAC 44KHz, 160Kbps is not desired, click the Audio format drop-down menu
to elect an audio codec. See Fine-tune channel configuration for help choosing one of the supported
audio codecs.
8. Click the Audio bitrate drop-down menu to choose the audio transmission speed. Increasing this value
produces better sound quality but uses more system processing power and bandwidth.
9. Click Apply.
Set audio volume
To set audio volume:
1. Ensure an audio input source is connected to an audio input port.
2. Connect to the admin interface using your preferred connection method. See Connect to the Admin
Interface.
3. Login as admin.
4. From the web interface, scroll the Sources section.
5. Select an audio source; the audio configuration page opens.
6. For Analog audio sources (TRS), select the Input source from the drop-down menu. Choose Line
(default setting, unbalanced audio), to capture system audio, or choose Balanced to capture audio from
a microphone or other balanced source connected to the audio input port.
7. Click the volume drop-down menu. A list of percentages is displayed. Choose to amplify the volume by a
percentage of the original volume. The default setting is 50%. Decrease the percentage if the output
volume is too loud. Increase the percentage if the output volume is not loud enough.
Adjusting the Capture volume adjusts the recorded and streamed output audio.
72
Pearl User Guide
2-3 Configure an audio source
8. Click Apply.
73
Pearl User Guide
2-4 Fine-tune source configuration
2-4 Fine-tune source configuration
In addition to fine tuning channel settings such as frame rate, resolution and bit rate to ensure optimal use of
resources while streaming a quality video, there may be circumstance when you must fine tune the video input
source.
Changing how source images are displayed may cause undesired results, for example
experimenting with the PLL setting may result in the image not being displayed properly. It is a
good practice to backup your configuration settings so that you can revert back to a good
configuration if the changes that you made are not desirable. See Save and Restore Device
Configuration.
This section covers the following fine tuning topics:
l Video is not centered on the screen (VGA sources only)
l Video is too bright, too dark or washed out (VGA sources only)
l Video looks squished (VGA sources only)
l Remove the combing effect on images (VGA sources only)
l Fine-tune source configuration
Video is not centered on the screen (VGA sources only)
The image from the source is displayed too high or low, or too far to the left or right.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
74
Pearl User Guide
2-4 Fine-tune source configuration
3. From the web interface, scroll to the Sources menu option.
4. Click the desired video source ; the source configuration page opens.
5. To move the video horizontally to the left or right, scroll to Horizontal shift .
6. Enter incremental values to shift the video image to the left (use a negative value) or right (use a positive
value).
7. Click Apply. View the output in the Snapshot preview below . You may need to make further
adjustments to move the video left or right.
8. Make further adjustments and click Apply after each change to confirm the results.
9. To move the video up or down, scroll to Vertical shift .
10. Enter incremental values to shift the video image down (use a negative value) or up (use a positive
value).
11. Click Apply. View the output in the Snapshot preview below. You may need to make further adjustments
to move the video up or down.
Video is too bright, too dark or washed out (VGA sources only)
If the video from the source is too light, too dark or washed out, use the offset and gain controls together to
optimize image quality. Increasing the gain amplifies weak signals but also increases noise, you must balance
offset and gain values to achieve the best quality image.
Adjust these settings by the smallest values possible; compensate for a large change to one by making a large
change to the other. Setting both offset and gain to high values can result in poor video quality.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
75
Pearl User Guide
2-4 Fine-tune source configuration
2. Login as admin.
3. From the web interface, scroll to the Sources menu option.
4. Click the desired video source; the source configuration page opens.
5. Scroll to Gain.
6. Enter a small value, for example 1 to 25 in the field to brighten the image.
7. Scroll to Offset.
8. Enter a small value, for example 1 to 15 , to balance the gain setting . The Offset value behaves as a
contrast to the Gain value.
9. Click Apply. View the output in the Snapshot preview below. You may need to make further
adjustments to fine tune the brightness and contrast.
Video looks squished (VGA sources only)
The image is squeezed horizontally on the screen. This distortion occurs when there's a mismatch between the
aspect ratio Pearl detects and the aspect ratio that is sent from the source signal. To compare the two signal
values, you must know the aspect ratio that the source is sending.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click Info; the info window opens with a list of all configured channels.
76
Pearl User Guide
2-4 Fine-tune source configuration
4. Compare the aspect ratio from the source with the aspect ratio from the Pearl info window. Confirm if
there is a mismatch.
5. If there is a mismatch, go to the Encoding page for the channel and change the frame size to match the
frame size that is sent from the source. See Configure channels.
6. If the video is still squeezed horizontally on the screen, follow the steps below.
7. From the web interface, scroll to the Sources menu option.
8. Click on the source for which you want to change the aspect ratio; the source configuration page opens.
9. Scroll to the Aspect ratio setting.
10. Select Wide mode from the drop-down menu, when the source is wider than what is being displayed in
the preview or Live View.
11. Click Apply. View the output in the Snapshot preview below.
Remove the combing effect on images (VGA sources only)
When frames are interlaced, artifacts from one frame may appear on the next frame. This occurs when a fast
motion video is interlaced. Since each frame is captured from a different point in time, the action captured in
one frame is carried over to the next frame. The result is a blurred image and horizontal lines running across
the video.
To convert an interlaced source signal to a non-interlaced signal.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
77
Pearl User Guide
2-4 Fine-tune source configuration
3. From the web interface, scroll to the Sources menu option.
4. Click on the desired video source ; the source configuration page opens.
5. Enable the Enable deinterlace setting.
6. Click Apply. View the output in the Snapshot preview below.
78
Pearl User Guide
PART 3: Channels
PART 3: Channels
Channels organize and display content captured from DVI, VGA, HDMI, SDI, and audio. A channel can be set up
to display the content from one input source, or may capture, stream and record content from multiple input
sources. You can identify your channel by adding a corporate logo, company information, corporate color and
time stamps.
Through channel configuration and fine tuning you can maximize your stream quality, minimize your
processing requirements and bandwidth and specify how the video is presented and streamed to a sharing
destination/viewer.
This section discusses the following topics related to channel configuration:
l Configure channels
l Identify a channel
l Preview a channel
l Fine-tune channel configuration
l Customize your channel
79
Pearl User Guide
3-1 Configure channels
3-1 Configure channels
Channels make your sources available for viewing and recording. You choose how you want to configure the
sources to make a channel.
This section covers the following topics for creating channels:
l Use the automatic channels Auto A and Auto B
l Create a single source channel
l Merge/include multiple video sources into a single channel
l Delete a channel
l Rename a channel
While configuring a channel, consider opening a live preview of the channel in another tab or browser window
so you can see the changes as they are applied, refer toPreview a channel.
Use the automatic channels Auto A and Auto B
To get you started as quickly as possible, Pearl comes pre-configured with two channels: Auto A and Auto B.
To use these channels, simply plug a source into one of the Row A inputs and, if desired, a second source into
one of the Row B inputs. The system automatically configures the channel's frame size to match the source
resolution and calculates the best frame rate and bit rate. Audio, if present, is added to the channel.
Audio for the auto channels is always as follows:
Video Source
Audio Source
SDI
SDI Audio
HDMI (DVI)
HDMI Audio (no audio for DVI)
VGA
TRS Audio
You can start viewing the channel immediately on the touch screen display (if enabled) or by using a browser
on a computer on the same LAN or network. Browse to the following URL:
For Auto A: http://<serial>.local/preview.cgi?channel=1
For Auto B: http://<serial>.local/preview.cgi?channel=2
For example:http://d560515f.local/preview.cgi?channel=2
80
Pearl User Guide
3-1 Configure channels
Or, if Bonjour services are not installed on the computer and you know the IP address of the system (available
on the touch screen display, if enabled) browse to:
For Auto A: http://<IP Address for Pearl>/preview.cgi?channel=1
You find alternate connection streams (i.e. RTSP or MPEG-TS) or further configure these channels by logging
into the admin interface and accessing Auto A and Auto B by the links under the Channels menu.
Auto A and Auto B are permanent channels that always take channel positions 1 and 2. To avoid
accidental removal of the automatic channels, there is no way to delete them.
Know which signal is used in an auto channel
Pearl has video input sensing, meaning it knows when there is a video signal coming through from an attached
source.
If you attach more than one source to a row prior to powering on Pearl, the following priority is used:
Priority
Connector Type
1
HDMI (with HDMI Audio)
2
SDI (with SDI Audio)
3
VGA (with TRS Audio)
The auto channel uses a source until the source has no signal, then switches to the highest priority signal
found.
For example, if you attach SDI, then VGA and TRS cables to Row A of your Pearl, Auto A will show
SDI and use SDI audio until such time as the SDI video signal is lost. At that time Auto A switches to VGA
video with TRS audio.
If you then connect HDMI to Row A (so you now have something connected to each video/audio port
on Row A) and the VGA signal is lost, Auto A displays HDMI and uses HDMI audio as it is the highest
priority signal.
If all the connected sources lose signal at the same time (i.e. for the example above when SDI loses video signal,
no video signal is found on the VGA source) no change is made and the auto channel continues to use the
current source. In this case, the selected no signal image is displayed for viewers. See Add your logo and
company information to your channel for more information on setting no signal images.
To see which source is currently used for an auto channel:
81
Pearl User Guide
3-1 Configure channels
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click Info from the Configuration menu; the info page appears.
3. Note the video and audio sources listed for the auto channels.
Configure auto channels
Auto channels are included with Pearl 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.
To further configure automatic channels Auto A and Auto B:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Scroll to the Channels section.
4. Click Auto A or Auto B from the Channels section; the channel's status page opens.
5. Configure the channel as you would any other channel. See below.
82
Pearl User Guide
3-1 Configure channels
You can change the source used for the two auto channels by selecting a different source from the
Sources page. When you do this, the channel name changes to reflect the new source, and only
input from that source is used for the channel. No auto switching is performed.
This is desirable if you know, for example, that you will always use SDI video with TRS audio and you
never need the automatic switching capabilities of the auto channels.
Create a single source channel
A single source channel displays the output from one source in one viewing screen. By default, channels are
automatically configured with the same name as their source. If you change the name of a source, the channel
name will reflect the new source name. Best practice is to rename the sources as required and leave the
channels to reflect the name. However, to change a channel’s name see Rename a channel In this section you
can choose settings that maximize your stream quality, while minimizing your processing requirements and
bandwidth by adjusting frame rate, resolution and bit rate.
Procedures to select a codec for compression, add a time stamp to the stream, and select a layout when two
sources are configured are described in separate procedures.
To add a single source channel:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Ensure a DVI, HDMI, VGA or SDI input source is connected to Row A or Row B inputs on the back of
Pearl. Be sure you know the name of the source. See Identify sources for assistance.
4. From the web interface, scroll to the Channels menu option. A list of existing channels is displayed.
5. Click Add channel located at the bottom of the list; the Sources page opens.
6. Click the Use video source drop-down menu; a list of available sources appears. 83
Pearl User Guide
3-1 Configure channels
7. Choose a video source from the list; the name of the source is displayed.
8. Choose an audio source from the displayed list, if required.
9. Click Apply. The channel name is updated to display the source’s name.
10. Click the Encoding link for your channel; the stream configuration page opens.
84
Pearl User Guide
3-1 Configure channels
11. If you're not sure what Codec to pick, keep the default, H.264. For help selecting a codec, refer to Finetune channel configuration
12. Keep the default video encoding preset and video encoding profile for help selecting these values,
refer to Fine-tune channel configuration
13. Check the checkbox for HTTP Live Streaming to enable HLS streaming. When this feature is enabled
the Stream info section on the Status page displays an HLS stream link. Using the HLS link, viewers can
access the stream using a tablet or smart phone device.
14. Set the Frame size to reflect the same dimensions as your source or as sharing destination. Default
values cover popular resolutions of cameras and display devices such as monitors or choose one of the
following:
a. Type a frame size in the field; or
b. Select an option from the sizes shown, the dimensions will appear in the frame size field.
Making the dimensions larger, smaller, or a different aspect ratio than the source takes
some processing power, so it’s always best to leave at the value detected by the system
unless you want to specify a particular size.
15. Click on the Key frame interval drop-down box to choose how often a key frame (a frame that contains
all the pixels) is used when streaming the video. The longer the key frame interval the smaller the video
file size, and vice versa. The higher the value the faster a user moves through the frames of the video
when using the search function of their media player. For more information on adjusting this feature to
reduce bandwidth and system resources, see Fine-tune channel configuration .
16. Change the Limit frame rate. The default should be adequate in most applications. While decreasing
the limit may improve system performance, you may need to test different values to balance video
smoothness and processing power.
85
Pearl User Guide
3-1 Configure channels
17. Increase or decrease image quality by increasing or decreasing the target Bitrate value when H.264 and
MPEG4 codecs are used. Video with a high level of motion and high resolution, such as a sporting event,
requires a high bitrate.
Raising this value uses more system processing power and bandwidth.
18. To configure the Show time label, see Creating a time stamp in the Customize your channel
19. Click Apply.
Merge/include multiple video sources into a single channel
A multiple source channel displays the output from multiple sources in one viewing screen. When a channel
displays multiple sources you can specify how video streams are positioned on the screen. You can display each
source side by side, or position one over the other in a more traditional picture in picture layout.
To add a multiple source channel:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Ensure two video input sources are connected to the system. Generally one should be in Row A and the
other in Row B.
4. From the web interface, scroll to the Channels menu option.
5. Click Add channel located at the bottom of the list; a new channel is created and its Sources page
opens.
A multiple source channel is named Channel 1, Channel 2, etc. by default; you must specify a
name during configuration. Refer to Rename a channel
6. Click the Use video source drop-down menu; a list of available sources appears.
7. Select Multiple sources; a source drop-down menu and source preview window appears.
86
Pearl User Guide
3-1 Configure channels
8. Configure the following for each source:
a. If needed (e.g. for all but the first source), click Add source to add a source to the layout.
b. Click the Source drop-down menu for the source you're arranging. A list of configured sources
appears.
c. Choose a source from the drop-down menu.
d. Enter the position coordinates. Position coordinates are based on where the source’s image will
appear. Each axis represents 100 percent. The first value is the image’s position along the x axis
(horizontal axis). The second value is the image’s position along the y axis (vertical axis).
Coordinate 0,0 is the top left corner of the stream. The x axis continues along the top
to the right side. The y axis continues down to the bottom. The right side is 100 % on
the x axis and the bottom is 100 % on the y axis.
e. Click Apply.
See the examples below to learn how to create side by side and picture in picture layouts.
Example: Side by side sources
You can arrange the sources so they each occupy a part of the screen , but none overlap. Using this option, the
background matte (image or color) will be visible if the sources don't occupy the full size of the frame.
87
Pearl User Guide
3-1 Configure channels
To place sources side by side:
1. Add the source by clicking Add Source, then selecting the source from the drop down list.
2. Enter the size of the image based on the percent of the x and y axis the image will span.
In the example above the left image is positioned at the 0, 0 coordinates and spans 50 %of
the x axis and 100 % of the and y axis.
The right image is positioned at 50, 0 and it also occupies 50% of the x axis and 100 % of
the y axis. (Note this distorts boths sources, they are now narrower than they should be.
An alternative would be to use y-axis %s that match the x-axis %s, thus maintaining aspect
ratio.)
3. Click Apply.
Example: Picture in picture
The multi-source layout provides flexibility for you to position the sources in any way you like, including a more
traditional picture in picture layout where one source is displayed over the other.
88
Pearl User Guide
3-1 Configure channels
To create a picture in picture layout:
1. Configure the following for the main source:
a. Click the Source drop-down menu. A list of configured sources appears.
b. Choose a source from the drop-down menu. The source’s image appears in the window.
c. Enter the position coordinates. In the example above, the main source is HDMI-A. It's positioned
at 0,0 so the top left corner of the image is at the top left corner of the screen.
d. Enter the image size. For the example, the image spans the entire screen, the values used are
100% x 100%.
2. For the second image, configure the following:
a. Click Add source to add a source to the list of sources.
b. Click the Source drop-down menu. A list of configured sources appears.
c. Choose a source from the drop-down menu. The source’s image appears in the window.
d. Enter the position coordinates. In the example above, the secondary image spans only part of the
screen. It starts at 50% on the x axis and y-axis (e.g. half the way in, from both directions) and
spans 50% of both axis.
Images can be located anywhere on the screen, for example if you want the second image to
appear near the top right corner of the screen, choose the position 60,5 and adjust the sizes
so it fits in the corner (for example, 35% for x and y-axis size).
3. Click Apply.
89
Pearl User Guide
3-1 Configure channels
Delete a channel
From time to time you may want to clean up the list of channels, and remove channels that are no longer used.
The following steps describe how to delete a channel. Deleting a channel does not delete the input source
configuration, however it deletes any recorded files for the channel.
You cannot delete auto channels Auto A and Auto B.
Although you can configure each auto channel to use a non-automatic input and you can change
the channel name, the Status page for auto channels has no delete option.
To delete a channel, follow the steps below.
1. From the web interface, scroll to the Channels menu option.
2. Click the channel you want to delete; the menu expands.
3. Click Status; the Status page opens displaying the service state and stream info for the channel.
4. Click Delete this channel; a confirmation dialog box appears to remind you that all recorded files for this
channel will be removed.
You cannot undo this command.
5. Click OK to continue or Cancel to stop. If you proceed, a message indicating that the channel was
successfully deleted appears at the top of the page.
90
Pearl User Guide
3-1 Configure channels
Rename a channel
By default, channels are automatically configured with the same name as their source, however there may be
circumstances when you want to create a distinct name for the channel to reflect the source(s) it contains.
Channels that contain multiple sources are not automatically named to reflect the source and can be named
during configuration.
Auto channels initially have the channel name Auto A and Auto B, but if you change the source to
something other than an automatic source, the name of the channel changes to reflect the new
source.
To rename a channel:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. From the web interface, scroll to the Channels menu option.
4. Click on the channel you want to rename; the menu expands.
5. Click any link for the channel; the corresponding channel status or configuration page opens.
You can change a channel's name from any of it's configuration pages.
3. Click the channel name at the top of the channel configuration page; the name text becomes red to
indicate that it is editable.
4. Highlight the old name and press backspace or delete on the keyboard.
5. Type the new name, using alphanumeric characters. It's recommended (but not mandatory) that you
use underscores to separate words, if needed.
6. Press Enter on the keyboard. The name is updated at the top of the screen and in the list of Channels in
the navigation menu.
You must press the Enter key on the keyboard for the change to take effect.
91
Pearl User Guide
3-2 Identify a channel
3-2 Identify a channel
Pearl captures video and audio signals from input sources. Sources are configured into channels with one or
more video and audio sources.
If not changed by the administrator, channels are labeled according to the input source type configured for
the channel. Channels with a single video source are labeled either by the name of the source, or, in the case of
automatic channels are named Auto A and Auto B.
92
Pearl User Guide
3-3 Preview a channel
3-3 Preview a channel
While configuring a channel, consider opening a live preview of the channel in another tab or browser window
so you can see the changes as they are applied. Choose one of the following options to preview your channel:
l Preview a channel from the Info page
l Preview a channel from the Status page
l Preview all channels at once
Preview a channel from the Info page
The system's Info page displays links for previewing your channel(s). This fast and simple method allows you to
see link for all the streams in a single location.
To preview a channel from the Info page:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click Info from the Configuration menu option; the information window opens .
4. Scroll to the channel you want to preview.
5. Click View; the corresponding channel is displayed in the window.
Preview a channel from the Status page
The channel's status page gives a wealth of information about the channel, including bit rate, frame size, and
links to preview the channel.
To preview a channel from the Status page:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the link for Channel you want to preview, the menu expands.
4. Click Status; the channel's Status page opens.
93
Pearl User Guide
3-3 Preview a channel
5. Right-click the Live Broadcast link and select Open in a new Tab or Open in a new Window; a tab or
window opens displaying a preview of the channel.
Preview all channels at once
Pearl has a special preview mode that lets you see all configured channels at once.
The resulting web page can be very large. You may wish to be aware of your web browser's zoom
hot keys. Many browsers will zoom out with Ctrl-- (control minus) and zoom in with Ctrl-= (control
equals).
To preview all channels at the same time:
1. Open a new browser window.
2. Type the following string into the address bar of your web browser on your admin computer (ipaddress
is the IP address of your Pearl).
http://<ip address of Pearl>/preview.cgi
For example: http://172.20.1.33/preview.cgi
3. Press Enter, the preview web page appears displaying the content of all active channels.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
94
Pearl User Guide
3-4 Fine-tune channel configuration
3-4 Fine-tune channel configuration
In addition to adjusting typical features such as frame rate, resolution and bit rate to reduce bandwidth and
system resource usage, choose the following settings to maximize your stream quality, while minimizing your
processing requirements and bandwidth:
l Choose a codec to maximize your stream quality
l Codec and file format compatibility
l Adjust video quality
l Upscale or downscale your video image
l Control the matte (black bars) in the video output
l Unstretch the output video
l Limit the frame rate
l Adjust key frame interval
Choose a codec to maximize your stream quality
Before you begin recording and streaming content from a channel, you must select the codec that will be used
to compress the channel’s video and audio content. Deciding on which codec to use depends on how you
prioritize the following criteria:
l Compatibility with streaming formats and file playback options
l Size of the compressed file
l Compression speed
l Image quality
l Number of simultaneous channels recorded and/or streamed
For example, if you require a high quality image, the trade-off might be a larger file size, or slower compression
speed. If you require live streaming and therefore cannot tolerate slow compression, the trade-off might be a
lower resolution.
If you want to stream and/or record three channels with a combined total of up to 150 frames per
second, you must choose the H.264 codec with hardware encoding (i.e. any encoding preset with
the suffix (HW)).
The table in Select a video codec, below, highlights the advantages and disadvantages of supported codecs.
95
Pearl User Guide
3-4 Fine-tune channel configuration
Once you select video and audio codecs a list of available video format and standards specific to the selected
codec is generated and displayed. You can provide the URLs and files to participants to view the broadcast, see
Stream your video.
Select a video codec
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click the Encoding menu option; the Encoding page opens.
5. Click the Codec drop-down menu to change the size and speed of the compression and decompression
and the quality of the image. Choose one of the following options from the Codec drop-down menu.
Value
Description
H.264
H. 264 is the default value and provides high quality video while using low
bandwidth. This is the preferred codec for the system.
Motion JPEG
This is suitable for live streaming and video, however may have low quality images
while using high bandwidth. Motion JPEG does not support audio.
MPEG-4
This may be suitable for presentations. Provides good image quality, while using
moderate bandwidth.
6. Click Apply.
Select an audio codec
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click the Encoding menu option; the Encoding configuration page opens.
4. From the web interface, click a Channel; the menu expands.
5. Click the Encoding menu option; a Encoding page opens.
6. Click on the drop-down menu next to Audio format.
7. Choose one of the following codec options from the Audio format drop-down menu.
96
Pearl User Guide
3-4 Fine-tune channel configuration
Value
Description
MP3
MP3 is the default value and provides a common audio format for audio
storage. The 22 and 44KHz values define sound clarity. 44KHz provides higher
sampling of the analog signal.
PCM
Pulse Code Modulation (PCM) is a standard for digital audio in computer and
other devices such as, digital telephone systems. The 22KHz and 44KHz values
define sound clarity. 44KHz provides higher sampling of the analog signal.
AAC
This codec is comparable with MP3, and may have better sound quality with a
similar bit rate. The 16, 22 and 44KHz values define sound clarity. 44KHz
provides higher sampling of the analog signal. Most devices support AAC.
Codec and file format compatibility
The following table displays the compatibility between the video/audio codecs and formats supported for
streaming.
Video Codec selected
Audio Codec selected
RTSP
FLV
ASF
MPEG-TS
MJPEG
H.264
No audio codec
ü
ü
ü
ü
H.264
LPCM
ü
ü
ü
H.264
MP3
ü
ü
ü
ü
H.264
AAC
ü
ü
ü
ü
MPEG-4
No audio codec
ü
MPEG-4
LPCM
ü
MPEG-4
MP3
ü
MPEG-4
AAC
ü
MJPEG
No audio codec
ü
The following table displays the compatibility between the video/audio codecs and formats supported for
recording.
Video Codec selected
Audio Codec selected
H.264
No audio codec
AVI
MOV
MPEG-TS
ü
ü
ü
97
Pearl User Guide
3-4 Fine-tune channel configuration
Video Codec selected
Audio Codec selected
AVI
MOV
MPEG-TS
H.264
LPCM
ü
ü
H.264
MP3
ü
ü
ü
H.264
AAC
ü
ü
ü
MPEG-4
No audio codec
ü
ü
MPEG-4
LPCM
ü
ü
MPEG-4
MP3
ü
ü
MPEG-4
AAC
ü
ü
MJPEG
No audio codec
Adjust video quality
After sources are connected and channels are created, adjustments can be made to address the different
bandwidth and devices used by the sharing destinations. Ideally you want to choose formats that will reach the
majority of your participants.
Default values have been carefully selected to provide maximum performance in most
environments. In most cases it is not necessary to change the encoding settings.
If you want to stream and/or record three channels with a combined total of up to 150 frames per
second, you must choose the H.264 codec with hardware encoding (i.e. any encoding preset with
the suffix (HW)).
To encode your video stream:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, select a channel; the menu expands.
4. Click Encoding: the Encoding page opens.
5. If the selected codec is H.264, click Video encoding preset to define how a video stream is encoded.
Choose one of the following:
98
Pearl User Guide
3-4 Fine-tune channel configuration
Value
Description
Balanced (HW)
This is the default H.264 encoding preset. It's a balance between speed and
quality. If you're not getting enough fps with this setting, move to Speed (HW).
Quality (HW)
The Quality encoding preset attempts to create the best quality image, but may be
at the sacrifice of frames per second. Try this setting, but if you don't get enough
fps to meet your needs, move to Balanced (HW).
Speed (HW)
This is the fastest encoding preset (resulting in the most frames per second), but
at the cost of some quality. Try this preset if you're not getting enough frames per
second from the other hardware presets.
High quality (SW)
Choose this option when you are streaming content such as slides or slow moving
video and need X.264 encoding for compatibility reasons.
High speed (SW)
Choose this option when you are streaming medium to fast moving video and
need X.264 encoding for compatibility reasons.
Default (SW)
This matches the default from previous generations of Epiphan products. Choose
this only if you need software encoding or X.264 encoding for compatibility
purposes.
6. If the selected codec is H.264, click Video encoding profile to limit or include video formats that are
supported. Choose one of the following:
Value
Description
Baseline
Choose this option when streaming to an application that requires robustness
and cannot tolerate data loss, for example video-conferencing.
Main
Choose this option for standard-definition broadcasts. This is the default.
High
Choose this option when video is viewed for broadcast and disk storage
applications, particularly for high definition television application such as Blu-ray
disk storage format and HDTV broadcast service.
Video encoding profile and preset can be set only when the H.264 codec is selected.
7. If the selected codec is H.264 or MPEG4, set the Rate control mode . The values define how strictly the
codec adheres to the specified bitrate. Choose one of the following options from the Rate control mode
drop-down menu.
99
Pearl User Guide
3-4 Fine-tune channel configuration
Value
Description
Relaxed
Choose Relaxed when streaming multimedia content and there is available
bandwidth, the quality of the multimedia stream must be constant and the bit
rate can vary.
Balanced
Choose Balanced when streaming multimedia content that has periods of high
and low bit rates. The target bit rate is met by averaging the bit rate.
Strong
Choose Strong when streaming multimedia content when limited bandwidth is
available and a constant frame rate is required. There may be a decrease in video
quality if there is a lot of motion.
8. Click Apply.
Upscale or downscale your video image
If your source input is larger than your desired output frame size or if you want to stream a less bandwidthhungry version of the content, you can downscale the source by specifying a frame size that uses the same
aspect ratio. By contrast you can also enlarge the image by selecting a value that is larger than the source
resolution.
Pearl conveniently provides a list of common aspect ratios and different frame sizes at each ratio on the
Encoding page.
For example:
l input signal resolution is 1920×1080 (a 16:9 aspect ratio)
l select another 16:9 frame size such as 1280×720
The smaller frame size will downscale the image and use less bandwidth to transmit.
If you select a frame size that is not the same aspect ratio as your source, the result is one of having a matte (bars) appear around the image, or the image is stretched. See Control the matte (black bars) in the video
output for details.
100
Pearl User Guide
3-4 Fine-tune channel configuration
Resizing a video can be more resource intensive than leaving the video at the native resolution.
Although you can change the resolution output by Pearl, it is less of a burden on your system
resources if you change the resolution incoming from the source.
To change the frame size of your video, follow the steps below.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select a channel; the menu expands.
4. Click Encoding ; the Encoding page opens.
5. Scroll to the frame size parameter.
6. Deselect Use current signal resolution as frame size, if it is selected; the Frame size text entry boxes
become editable.
7. Choose a resolution from the links on the right, or type a frame size into the Frame size fields.
8. Click Apply.
Control the matte (black bars) in the video output
By default, Pearl makes sure that the aspect ratio of input signals is preserved when the output is streamed. If
an input video signal doesn't match the encoded frame aspect ratio, bars are added to the sides or top and
bottom of the encoded stream when the output is streamed and recorded. The color of the bars is defined by
the Background color selected on theEncoding page. See Select the background color for your channel.
101
Pearl User Guide
3-4 Fine-tune channel configuration
For example:
l Input signal resolution is 720×480 (a 3:2 aspect ratio)
l encoded 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:
l Input signal resolution is 720×480 (a 3:2 aspect ratio)
l encoded 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.
If you are seeing bars on your image but would rather have the image fill the whole screen you have to options:
1. Change the output frame size to match the aspect ratio of the input.
2. Stretch the image to fit the output frame size aspect ratio.
These two options are described below.
Match the output frame size to the aspect ratio of the source signal
To change the output frame size to match the aspect ratio of the source:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
102
Pearl User Guide
3-4 Fine-tune channel configuration
3. Select a channel; the menu expands.
4. Click Sources; the Sources page opens.
5. Find the name of the media source used for the channel.
6. Click this source under the Sources menu.
7. Make note of the input signal resolution.
8. Click the channel's Encoding ; the Encoding page opens.
9. Scroll to the frame size parameter.
10. The simplest option is to select Use current signal resolution as frame size and click Apply. You can
alternatively select it briefly to note the current video signal resolution, then deselect it and follow the
steps below.
11. Look for the source aspect ratio in the list of aspect ratios provided.
a. If the source resolution is on the list, choose another resolution on the same line (i.e. with the
same aspect ratio).
b. If the source resolution is not on the list, use a calculator to get a factor of the source resolution
and enter it in the Frame size fields.
12. Click Apply.
103
Pearl User Guide
3-4 Fine-tune channel configuration
Stretch the image
To remove the matte (black bars) by stretching the image to fit your output frame size:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select a channel; the channel menu expands.
4. Click Sources; the Sources page opens.
5. Deselect Keep aspect ratio.
6. Click Apply.
Unstretch the output video
By default, Pearl makes sure that the aspect ratio of input signals is preserved when the output is streamed. If
this default was overridden the image is stretched to match the output frame size. The effect may be subtle and
may not be problematic for you, but if you want to resolve this it is very simple to do.
To preserve the source aspect ratio:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click Sources; the Sources page opens.
4. Select Keep aspect ratio.
104
Pearl User Guide
3-4 Fine-tune channel configuration
5. Click Apply.
Unstretching the image causes a matte (black bars) to appear on the sides or top and bottom of
the output. To remove these see Control the matte (black bars) in the video output.
Limit the frame rate
Limiting the frame rate sets a frame rate value that is lower than the maximum frame rate at which the device
can encode images. Reducing the frame rate reduces the number of images captured by the device and
reduces bandwidth usage.
The device's ability to maintain a set frame rate is based on several factors, for example:
l overall system load affects the ability for the device to process pixels;
l available bandwidth;
l the resolution value;
l the type of motion that is captured; and
l number of users accessing the stream.
When adjusting the frame rate, you may need to try different values to achieve the best outcome. The following
table provides the performance expectations when typical settings are used.
To change the frame rate:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
105
Pearl User Guide
3-4 Fine-tune channel configuration
2. Login as admin.
3. From the web interface, select a channel; the menu expands.
4. Click Encoding; the Encoding page opens.
5. Enter a value in the Limit frame rate field.
6. Click Apply.
Adjust key frame interval
The key frame interval feature specifies how often a key frame (a frame that contains all the pixels) is used 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.
Increasing the number of seconds between key frames can significantly reduce your bandwidth and system
resource usage with minor impact to your video quality. A good rule of thumb is to keep the interval between 2
to 3 seconds and decrease the key frame interval as the motion increases. Try different settings and note
changes in the video quality. If your video quality is poor and jittery 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.
To adjust the key frame interval:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, select a channel; the menu expands.
4. Click Encoding; the Encoding page opens.
5. Scroll to the Key frame interval drop-down menu. Choose the number of seconds before the system
streams a key frame.
Choosing Key frames only option increases bandwidth and system resource usage.
106
Pearl User Guide
3-5 Customize your channel
3-5 Customize your channel
Adding a corporate logo, company information, corporate color and time stamps are easy ways to identify your
broadcast. This section describes the following topics for customizing your channel:
l Add your logo and company information to your channel
l Add a time stamp to your channel
l Select the background color for your channel
l Add a customized background to a multiple source channel
Add your logo and company information to your channel
This section describes the following topics for uploading the logo file, applying the file to a channel and adding
presentation and company related information:
To upload a logo or image
To apply company information and logo to a channel
To add a no signal image to a channel
To remove a logo or no signal image from the system
To remove metadata from a channel
To upload a logo or image
You can customize your broadcast and display information to your viewers with either a logo or a custom no
signal image.
Transparency is not supported for logo and no signal images.
107
Pearl User Guide
3-5 Customize your channel
To upload an image for use as a logo or no signal image on a channel:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click Branding Content under the Configuration menu; the configuration page opens.
4. Click Choose File; a browser page opens.
5. Navigate to the folder on your admin computer that contains the logo.
6. Select the file, the following file formats are supported: PNG, TIFF, JPEG.
7. Click Open; the file is added to the File/template to upload field.
8. Click Upload; the file is uploaded and displayed in the Other files section.
108
Pearl User Guide
3-5 Customize your channel
9. See below to learn how to apply the logo or no signal image to a channel as well as how to add
metadata information such as presentation title, presenter’s name, and other corporate information.
To apply company information and logo to a channel
Using the Branding feature, you can apply a logo to your channel and specify the following meta data that the
media player displays for your viewers:
l title of the presentation;
l company logo;
l company website;
l presenter’s name;
l copyright date or other labels such as proprietary information, preliminary etc; and
l additional information about the broadcast, such as time of the broadcast, or change to the schedule.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, select a channel; the menu expands.
4. Click the Branding link for your channel; the Branding configuration page opens.
5. Enter metadata such as: presentation title, presenter name(s), any copyright dates and additional
information about the broadcast that you want the viewer to know.
How metadata is displayed depends on the media player. For example VLC stores the
metadata in a media information file, while other media players scroll the text
horizontally from right to left along the bottom of the media player window, similar
to a ticker message bar.
109
Pearl User Guide
3-5 Customize your channel
6. Click the Image drop-down menu; a list of files appears. These are the files that you uploaded earlier in
an earlier procedure.
7. Choose a file. A sample of the image appears in the page.
8. Select where the image appears on the broadcast page using Position and Margin values.
a. Choose a corner of the broadcast page where the image is placed:
l left top or right top for logo placement at the top of the screen; or
l left bottom or right bottom for placement at the bottom
b. Set margins to specify how far you want the image from the edges of the screen. For
example if you chose the starting position of left top and you want the image closer to the
center of the broadcast page, enter margin values to move the image.
If location settings are incorrect and cause the image to be cropped, the system overrides
the incorrect settings and reduces the margins so the whole image is displayed, if possible.
9. Click Apply.
To add a no signal image to a channel
This image is displayed for the channel when a signal is not detected. Setting this feature lets you communicate
broadcast information to your viewers. For example if a viewer logs in early, or if you are experiencing delays.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Follow the instructions above (To upload a logo to a channel) to upload an image via the Branding
page.
110
Pearl User Guide
3-5 Customize your channel
4. From the web interface, select a channel; the menu expands.
5. Click the Branding link for your channel; the Branding configuration page opens.
6. Choose a “No signal” image. This image is displayed for the channel when a signal is not detected.
7. Click Apply. Go to the live broadcast page to confirm the message location on the broadcast page.
To remove a logo or no signal image from the system
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click Branding under the Configuration menu; the configuration page opens.
4. Click Remove; a confirmation dialog box opens.
5. Click OK; the dialog box closes and the image file is removed from the configuration page.
111
Pearl User Guide
3-5 Customize your channel
To remove metadata from a channel
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, select a channel; the menu expands.
4. Click the Branding menu option; the Branding configuration page opens.
5. Scroll to the Content metadata section.
6. Click the Author, Copyright or Comments field.
7. Highlight the text and press delete on the keyboard. The field is empty.
8. Click Apply.
Add a time stamp to your channel
Adding a date and time to your video is an easy way to confirm that the information that you are streaming is
current.
To add a time label or timestamp your video:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, select a channel; the menu expands.
4. Click Encoding; the channel's Encoding page opens.
5. Scroll to Show time label.
6. Choose one of the following:
a. Type a date or time in the field; or
b. Click Show substitutions; a list of options appears, from the list choose the format you want to date to
appear on the recording and type in the specific date and time. The following table describes the values.
Table 16 Time Format options
Field
Value
Example
date
%F
2012-01-26
year
%G
2012
month (01)
%m
01
112
Pearl User Guide
3-5 Customize your channel
Field
Value
Example
month (Jan)
%b
Jan
month (January)
%B
January
day of the month
%d
26
weekday (Thu)
%a
Thu
weekday (Thursday)
%A
Thursday
time
%T
08:40:45
hour
%k
08
minute
%M
40
second
%S
45
millisecond
%#m
378
8. Click Apply.
Select the background color for your channel
When you choose a multiple source layout, you can select the background color to fill the unused space. For
example you can add a color from your your corporate color scheme.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, scroll to the channel where you want to add a background color.
4. Click the channel; the menu expands.
5. Choose Encoding for the channel; the Encoding configuration page opens.
6. Scroll to Common settings.
7. Choose a color from the Background color drop-down menu.
8. Click Apply; color is added to the unused space.
9. To confirm the color, click Sources for the channel. In the example below, purple was selected.
When a background image is set for the muliple source channel, the background color is
ignored.
113
Pearl User Guide
3-5 Customize your channel
Add a customized background to a multiple source channel
The background feature on the Branding page allows you to apply a customized background for your multiple
source channel. You can create a background that is consistent with your corporate branding or provide
additional information to your viewer such as presenter’s name, company name etc. You can apply any PNG,
TIFF, JPEG file as a background.
To add a customized background:
Before you can upload and apply a customized background, save a PNG, TIFF, JPEG file to a location
to which you can browse.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click Branding under the Configuration menu; the configuration page opens.
114
Pearl User Guide
3-5 Customize your channel
3. Click Choose File from the Upload files/templates heading. A browser dialog box opens.
4. Navigate to the folder on your admin computer that contains the PNG, TIFF, or JPEG file.
5. Click Open. The file is added to the File/template to upload field.
6. Click Upload. The file is added to the list of files under the Other files heading. Now you can apply the
background to a multiple source channel.
7. Click the multiple source channel where you want to apply the customized background; the menu
expands.
115
Pearl User Guide
3-5 Customize your channel
3. Choose Branding; the Branding configuration page for the channel opens.
4. Scroll to the Background heading.
5. From the Image dropdown menu, select the file that you saved in the previous steps. The background
image is displayed in the window.
6. Click Apply.
7. Click the Sources menu option. The Sources window opens with the background displayed. In the
example below one source captures the lecturer; the second captures the presentation. Both sources
are displayed on a customized background.
116
Pearl User Guide
3-5 Customize your channel
8. You may need to adjust the position and size for each source to fit within your customized background,
refer to Merge multiple videos into a single channel.
Ensure your background closely matches the aspect ratio and size of the display area,
otherwise the background image may be squeezed, shrunk, grainy or may not cover the
display area.
Background images are applied to multisource channels only. To display a background as a
matte around a single source, create a multi-source channel and select just one source for
it. Offset the source so it isn't at the top left corner of the screen and set the size so it
doesn't take the full x and y axis.
117
Pearl User Guide
PART 4: Stream
PART 4: Stream
Streaming provides powerful and flexible approaches to delivering to your users. Offering an easy to use
interface, users can stream video using multiple formats to multiple users and devices such as web browsers,
media players, set-top-boxes, Smart TVs and Content Distribution Networks. The tool's flexibility is further
enhanced by its ability to support standard codecs used by most sharing destinations and media players.
This section discusses the following topic related to publishing your content:
l Stream your video
l Samples of stream settings
118
Pearl User Guide
4-1 Stream your video
4-1 Stream your video
After you have configured your media and channels, decided on the content and layout of your broadcast, it’s
time to share your broadcast. The following sections provide a description of the available streaming options,
insight into why you would choose each option, and procedures to stream your content using each option.
o View available video formats
o Choose a streaming option
Streams for viewers:
o Disable (and enable) streams for viewers
o Restrict access to streams for viewers
o Stream content using HTTP or RTSP
o Configure streaming ports
o Stream content using HTTP Live Streaming (HLS)
o Stream content using UPnP
Stream to a server:
o Stream content using a Content Distribution Network
o Stream content using multicast streaming
View available video formats
When you select video and audio codecs for streaming, the system generates and displays a list of available
video formats and standards specific to the selected codec.
To view the video formats and standards specific to your selected codec:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Status: the following page opens displaying the stream protocol that is supported based on the
selected codecs.
119
Pearl User Guide
4-1 Stream your video
Choose a streaming option
Each method of streaming media has strengths and weaknesses depending on your audience location,
hardware resources and bandwidth. To help you to decide how to publish your content, you must first identify
the number of viewers and how viewers will access your content. Are you streaming live video, or recorded
video. Do you need to stream the content to one client (peer-to-peer), deliver a single stream to multiple clients
(multicast), or provide web-based streaming where multiple clients can access the broadcast (Content
Distribution Network).
Your Pearl can stream to individual viewers through HTTP, HTTP Live Streaming, UPnP and RTSP and can also
simultaneously stream to a server such as a multicast server or CDN.
The following tables provide a brief outline of the distribution options. A procedure to configure each
distribution option follows the tables.
Streaming for viewers
Streaming for viewers allows viewers to connect to your Pearl and view the live stream.
You can configure whether or not streaming is enabled for viewers. See XXXX.
Publishing Options
Use this option to...
HTTP
Quickly stream content to viewers simultaneously. No set up is required.
Pearl is ready to stream content as soon as it is has power and a configured
channel. No other settings are required. Your audience need only access the
URL of the broadcast and they are instantly connected. This viewing method
is ideal for a small number of viewers since streaming uses your system
resources and bandwidth. However a small amount of overhead is used for
each viewer. For more information about using a HTTP streaming, refer to
Stream content using HTTP or RTSP.
120
Pearl User Guide
4-1 Stream your video
Publishing Options
Use this option to...
RTSP
Quickly stream content to viewers. No set up is required. Pearl is ready to
stream content as soon as it has power and a configured channel. No other
settings are required. Your audience need only copy and paste the URL of
the stream into a media player. For more information about using a RTSP
and HTTP streaming, refer to Stream content using HTTP or RTSP.
HTTP Live Streaming
(HLS)
Stream live over the standard HTTP port 80, making it possible to cross
firewalls and proxies that are normally accessible to other HTTP traffic and
facilitates content delivery to CDNs.
There is approximately a 30 second delay when streaming using HLS.
Stream to a server
Your Pearl streams to a server when you want to use a CDN or Multicast. By default, this is not configured. See
Stream content using a Content Distribution Network and Stream content using multicast streaming for
details on configuring one of these two options.
121
Pearl User Guide
4-1 Stream your video
Publishing Options
Use this option to...
Content Distribution
Network
Stream web content to many viewers simultaneously to any geographical
location. A viewer accesses the broadcast from a website using a user name
and password, if required. Using a CDN to host your broadcast is highly
scalable and makes financial sense to website owners since you do not pay
for additional server hardware or routing should your network traffic
increase or decrease.
Using a CDN to stream live content allows you to reach a large
geographically diverse audience and because CDNs perform format
conversion, the stream is platform independent.
For more information about streaming to a CDN, see Stream content using a
Content Distribution Network.
The following options are available to stream video to a CDN:
Epiphan TV - test your video stream using Epiphan’s portal
using RTSP announce - stream live video to a content delivery network
using RTMP push - stream live video to a content delivery network
RTSP and RTMP streaming provides the following advantages:
l viewers can watch the action as it unfolds;
l video quality automatically changes to adjust to changes in
bandwidth;
l reduced bandwidth usage since the player maintains a smaller buffer;
and
l viewers can scroll back through later sections of the video while the
video is streaming.
122
Pearl User Guide
4-1 Stream your video
Publishing Options
Use this option to...
Multicast Streaming
Stream content to a multicast IP address where it can be shared with
multiple viewers within the same LAN. All viewers receive the same stream at
the same time. Similar to turning on a radio station, all listeners hear the
same music at the same time.
This delivery method relies on network equipment that supports
multicasting and is usually used in high bandwidth corporate LANs and not
on Internet-based architectures.
This delivery method is useful for training sessions, when there is a specific
timeframe when the audience will view the content. For more information
about using multicasting for streaming your content, see: Stream content
using multicast streaming
l RTP/UDP transport standard is used to stream H.264 video when
unicast or multicast streaming is used. Each viewer retrieves an SDP
file. SDP files can be stored on a streaming server, or opened by a
media player. For multicast, the destination address is where the
broadcast can be viewed.
l MPEG-TS UDP transport standard is used to stream MPEG-4 video
when unicast or multicast streaming is used. Each viewer retrieves a
UDP address to add to their media player.
l MPEG-TS RTP/UDP transport standard is used to stream video when a
single port is used to stream video and audio via unicast or multicast.
Each viewer retrieves a RTP address to add to their media player.
This option can be used to stream video and audio to an IP TV or set top box
playlist.
To stream video outside of your LAN, use a CDN or configure port forwarding on your router. Refer
to your Network Administrator; network configuration is beyond the scope of this guide.
The Streaming feature, used for CDNs and multicast streaming, is available only when the H.264
codec is selected.
Disable (and enable) streams for viewers
When you create a channel it's available by default for viewing by stream viewers who have the stream URL. You
can choose to disable streaming to viewers through the channel's streaming configuration.
123
Pearl User Guide
4-1 Stream your video
Disabling streams for viewers disables all viewer formats including HTTP, RTSP, HLS and UPnP.
To disable (or enable) streams for viewers:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click Streaming for the desired channel; the streaming page opens.
3. Uncheck Enabled to disable streaming to viewers (or check to enable).
4. Click Apply at the bottom of the page.
Restrict access to streams for viewers
Pearl can restric access to all viewer streams using global viewer passwords and IP allow/deny lists. See Setting
and Changing User Passwords and Restrict Viewers by IP Address
To restrict viewers for a channel:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
124
Pearl User Guide
4-1 Stream your video
3. From the web interface, click Streaming for the desired channel; the streaming page opens.
4. Scroll to the Stream access control section of the page.
3. Select Use these settings from the drop down list; the configuration fields are enabled.
4. If desired, specify a password for viewers of this channel; the password appears masked as you type 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 and
leaving all the fields blank.
3. If desired, specify allow and deny IPs for viewers of this channel. See Restrict Viewers by IP Address for
more information about allow and deny lists.
4. Click Apply at the bottom of the page.
To return a channel to the default (global) access control settings:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click Streaming for the desired channel; the streaming page opens.
4. Scroll to the Stream access control section of the page.
5. Select Use global settings from the drop down list; the configuration fields are disabled (any changes
to the configuration fields are not saved).
6. Click Apply at the bottom of the page.
125
Pearl User Guide
4-1 Stream your video
Stream content using HTTP or RTSP
The quickest and simplest way to deliver your content is to send the broadcast's URL to your viewers. You can
provide separate URLs for each channel being streamed.
The format of the URL provided to you by the admin interface depends on the method you used to access the
system, either through network discovery using the serial number or IP address.
The system must be accessible on the viewer's LAN for the viewer to use access by serial discovery.
Table 17 URL options
Access Method
URL Format
serial discovery
http://<serial>.local/preview.cgi?channel=<channel number>
rtsp://<serial>.local:<port>/stream.sdp
Where serial is the serial number of the system and channel number
is the provided from the GUI (see below).
IP address
http://<IP Address of Pearl>/preview.cgi?channel=2
rtps://<IP Address of Pearl>:<port>/dtream.sdp
Where the IP address is the IP address of the system and the port
and channel number informationis provided on the channel's status
page.
To retrieve the stream URL for your viewers:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Status: the following page opens displaying the stream protocol that is supported based on the
selected codecs.
126
Pearl User Guide
4-1 Stream your video
5. Jot down the either the Live Broadcast , RTSP stream or other web streaming address. This is the
address you can send to viewers or to create a link to your broadcast.
Users must install Bonjour Print Services on their Windows or Mac computer to access the live
Preview using the serial number. Log into the admin interface by IP address to see the URL with the
IP address instead of the serial number.
Configure streaming ports
For RTSP streaming the only information required to view the broadcast is the URL and the port number used
to stream the broadcast. Port numbers are also used for HTTP streaming methods such as FLV, ASF and MPEGTS. By default, each channel has a unique HTTP and RTSP port number. If needed,you can modify these port
numbers. Be sure to always use unique numbers for each channel.
To set the HTTP and RTSP streaming ports, follow the steps below.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
127
Pearl User Guide
4-1 Stream your video
5. Set the HTTP Streaming port to specify the port used to stream the HTTP broadcast. This value along
with the URL is used by viewers to access the FLV, ASF and MPEG-TS streams.
The port number must be higher than 500 for HTTP. In the case of RTSP streaming this value
is ignored.
6. 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 is
554.
7. Click Apply.
Stream content using HTTP Live Streaming (HLS)
Stream live over the standard HTTP port 80, making it possible to cross firewalls and proxies that are normally
accessible to other HTTP traffic .
HLS is supported with the H.264 codec and MP3 or AAC audio encoding. When streaming using
HLS there is approximately a 30 second delay.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
128
Pearl User Guide
4-1 Stream your video
3. From the web interface, select the channel containing video you want to stream; the menu expands.
4. Click Streaming; the channel's Streaming configuration page opens.
5. Enable HTTP Live Streaming by selecting the HTTP Live Streaming checkbox.
6. Click Apply.
7. Click Status for the channel. The status page opens.
8. Provide the HLS stream link to your viewers.
Stream content using UPnP
Using the Universal Plug and Play (UPnP) networking protocol, your Pearl can be discovered and can stream to
software and hardware media players, set-top-boxes and Smart TVs with ease. If UPnP is enabled, the system
automatically establishes communication with media players on the network.
UPnP uses MPEG-TS over HTTP with the H.264 codec and MP3 or AAC audio encoding (or no audio). You can
only access live streams or recordings that meet these requirements.
For security reasons the default behavior prevents UPnP access to live streams and recorded files.
129
Pearl User Guide
4-1 Stream your video
This section covers the following topics:
l Enable UPnP
l Disable UPnP
l Stream your video
l Auto-restart playback to a UPnP Device
l Change UPnP device name
Some players will not be able to access the stream or saved recordings if a view password is set. If
needed, see Removing User Passwords to clear the viewer password.
The topics in this chapter include how to enable and disable UPnP and how to control media players from Pearl.
To choose recordings or live streams from your media player, see Viewing with UPnP .
Enable UPnP
Enable UPnP to allow digital media players on the network to browse for media or live streams from your
system. There are two steps required to enabled UPnP, enabling UPnP for the system (including setting a share
name) and enabling UPnP per channel or recorder. By default, UPnP is disabled at the system level and for each
channel.
Streams and MPEG-TS recorded files must use the supported codecs: H.264 with MP3 or AAC
audio. Having a viewer password could prevent the ability to use UPnP.
To enable UPnP:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the UPnP link in the Configuration section; the UPnP configuration page opens.
130
Pearl User Guide
4-1 Stream your video
4. Enter a name in the Server name field. If no name is provided the server name will be the system's serial
number.
5. Select whether you want to share live video and recorded files.
6. Click Apply.
7. If no live stream is available that meets the criteria for UPnP, a message is displayed in the Play on
service start section of the page.
8. Otherwise, the Play on service start section shows a drop-down list of what can be streamed.
Enable UPnP sharing for the channels or recorders you want to share:
1. For channels (live streaming):
a. Click the Streaming link for the desired channel; the Streaming page opens.
131
Pearl User Guide
4-1 Stream your video
a. Click the Share via UPnP check box (if not checked).
b. Click Apply
2. For channels (recorded files):
a. Click the Recording for the desired channel; the channel's recording page opens.
b. Click the word change next to the list of what is being recorded; the recording options expand.
c. Click the Share via UPnP check box (if not checked).
d. Click Apply.
3. For recorders:
a. Click the link for the recorder from the Recorders menu; the recorder's configuration page opens.
b. Click the word change next to the list of what is being recorded; the recording options expand.
132
Pearl User Guide
4-1 Stream your video
c. Click the Share via UPnP check box (if not checked).
d. Click Apply.
You can now browse for your server from your digital media player. See below.
Disable UPnP
By default, UPnP sharing is enabled for the device, but sharing is disabled for each channels and recorder. If you
enabled UPnP sharing it for a particular broadcast, you may want to disable UPnP sharing after the broadcast is
complete. You can choose to disable access to live streams, recorded files, or to the whole system.
To disable UPnP for a channel or recorder:
1. For channels:
a. Click the Streaming link for the desired channel; the Streaming page opens.
b. Deselect the Share via UPnP check box (if checked).
c. Click Apply
2. For recorders:
a. Click the link for the recorder from the Recorders menu.
b. Click the word change next to the list of what is being recorded; the recording options expand.
a. Deselect the Share via UPnP check box (if not checked).
b. Click Apply.
To disable UPnP globally (for the whole system):
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the UPnP link in the Configuration section; the UPnP configuration page opens.
4. Deselect Share live video through UPnP to stop sharing live video.
5. Deselect Share recorded files through UPnP to stop sharing recorded files.
6. Click Apply; UPnP sharing is disabled.
133
Pearl User Guide
4-1 Stream your video
Play directly to a media player
If your digital media player is UPnP enabled, Pearl can play direct the media player to play recorded files, without
browsing through menus in the player.
Recorded files must be in MPEG-TS format and use the supported codecs: H.264 with MP3 or AAC
audio. Having a viewer password could prevent the ability to use UPnP.
To play directly to a media player:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Ensure Share recorded files through UPnP is enabled on your Pearl and for the channel or recorder you
wish to share. (See Enable UPnP.)
4. Go to the recorded files list for the desired channel or recorder. (See View the List of Stored Files.)
5. From the list of files, select the file you want to play and click on the Play To icon for the file; a list of
visible digital media players is displayed.
6. Select a media player; the recording plays on the screen(s) connected to the media player.
Auto-restart playback to a UPnP Device
In unmanned situations such as industrial applications and digital signs, it is useful to automatically have a
stream played to a digital media player, even if Pearl restarts.
To configure auto-restart of a stream to a media player:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the UPnP link in the Configuration section; the UPnP configuration page opens.
4. Scroll to the Play on service start section.
5. Select a stream to use from the Live stream drop-down list.
6. Select a digital media player from the Player drop-down list.
7. Click Apply.
Only a single stream and player combination can be configured for auto play. The channel's UPnP
configuration must be enabled for it to appeear
134
Pearl User Guide
4-1 Stream your video
Change UPnP device name
You can configure the UPnP server name that appears for your Pearl. By default, if you left the server name field
blank when enabling UPnP, the server name is the system's serial number.
To change the UPnP server name:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the UPnP link in the Configuration section; the UPnP configuration page opens.
4. Highlight and delete the text in the Server name field, if any.
5. Type a new server name. Use characters A-Z, a-z, 0-9, _, :, @, ^, #, -. {}, [], ().
6. Click Apply; the name changes.
Stream content using a Content Distribution Network
A Content Delivery Network 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.
You can test how your content is streamed by sending your content to Epiphan’s CDN or choose one of
Epiphan’s preferred CDN providers http://epiphan.tv/cdn-partners.php.
Test content distribution using Epiphan CDN
Epiphan.tv is a service provided by Epiphan to help our customers to experiment with content
distribution networks, bandwidth, performance limits and viewer limits are applied. To upgrade to
135
Pearl User Guide
4-1 Stream your video
a full service, select one of Epiphan’s preferred CDN provider at http://epiphan.tv/cdnpartners.php.
To hear audio content from Epiphan TV ensure audio is set to MP3 in Encoding configuration.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
5. Scroll to the Stream to a server section of the page.
6. Click the Publish drop-down menu.
7. Choose to <serial>. Epiphan.tv.Where <serial> is the serial number of the system.
8. Click Apply; connection through the media tunnel is established. The system streams to the Epiphan’s
portal – epiphan.net.
You must set audio format to MP3 when streaming through epiphan.net, see Select an
audio codec.
View content from Epiphan TV
Before viewing content from Epiphan TV ensure you have:
136
Pearl User Guide
4-1 Stream your video
l a current browser;
l a current flash player;
l select the H.264 codec from the channel's Encoding page; and
l set the stream bitrate lower than 500 kbits/s in the channel's Encoding setup.
To view content:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
3. Click the link to view the broadcast.
4. A web page opens displaying the broadcast.
137
Pearl User Guide
4-1 Stream your video
Specify a multimedia player to view your Epiphan TV broadcast
1. From the Epiphan TV portal, click Switch To on the bottom of the screen; the following options appear.
2. Choose a plug-in from the list, the stream is displayed using the selected multimedia player.
Add a link to your website to stream your Epiphan TV broadcast
Follow the steps below to embed code for the broadcast in a web page.
1. Go to the Epiphan TV portal.
2. Click Embed on the bottom of the screen; a dialog box opens displaying the code.
3. Highlight and right-click on the code in the dialog box. A drop-down menu appears.
4. Choose Copy.
5. Paste the content into the HTML code for your website. A link to your broadcast on Epiphan TV is added
to your web page.
Retrieve a list of addresses based on video stream encapsulation
1. Go to the Epiphan TV portal.
2. Click Direct URLs on the bottom of the screen; a dialog box opens displaying a list of URLs for different
types of streams.
3. Use the copy and paste function to provide viewers with the URL to view the stream.
138
Pearl User Guide
4-1 Stream your video
Stream content to a CDN provider
Publish to any CDN provider that supports incoming streams sent via RTSP announce or RTMP push. Both RTSP
and RTMP can be used for live streaming, however not all CDNs or media servers support both formats. Choose
the streaming format that your CDN or media server supports. Epiphan has tested with the CDN providers
listed here: http://epiphan.tv/cdn-partners.php. Contact your CDN for a list of supported audio codecs and
ensure your Encoding configuration uses one of the supported codecs.
To publish content to a CDN provider ensure you have:
l a path to the mount point or an XML configuration file (provided by the CDN provider);
l verify which transport protocols your CDN supports:
l a current flash player; and
l select the H.264 codec from the channel's Encoding page.
To stream content to a CDN using an XML profile
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
3. Click the Choose File button next to use profile XML; a file browser window opens.
4. Select the XML profile supplied by your CDN and click OK; the configuration is read from the XML file and
applied.
139
Pearl User Guide
4-1 Stream your video
3. Click Apply.
To stream content to a CDN using RTSP announce
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
5. Scroll to the Stream to a server section of the page.
3. Click the Publish drop-down menu.
4. Choose using RTSP announce from the drop-down menu.
140
Pearl User Guide
4-1 Stream your video
5. Enter the host name or IP address of the CDN or media server.
6. Enter the server's RTSP port number. Usually for RTSP streaming the value is 554.
7. Enter a value in the Mount Point field. This is the full path to the location of the live steam or the media
server. The path starts with the application name. The path is provided by the CDN provider.
8. Check the Use TCP for RTP stream checkbox. Verify which transport protocols your CDN provider
supports.
9. Enter a user name and password.
10.
The CDN provider assigns a user name and password to authenticate the publisher.
Contact the CDN provider for your log in credentials.
11. Click Apply.
To stream content to a CDN using RTMP push
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
3. Click the Publish drop-down menu.
4. Choose using RTMP push from the drop-down menu.
3. Enter the host name or IP address of the media server or CDN.
4. Enter the port number which is used for streaming to the media server or CDN. Usually for RTMP
streaming the value is 1935.
141
Pearl User Guide
4-1 Stream your video
5. Enter a value in the Mount Point field. This is the full path to the location of the live steam or the media
server. The path starts with the application name. The path is provided by the CDN provider. The RTMP
publish stream is displayed as rtmp.publish in the Connections window.
3. 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.
4. Click Apply.
Stream content using multicast streaming
A multicast stream consists of one stream distributed to many viewers via a multicast-capable network. Pearl
supports the following multicast streaming options:
l Using RTP/UDP push
l Using MPEG-TS UDP push
l Using MPEG-TS RTP/UDP push
Pearl supports multicast streaming content to an IP TV or a set-top box playlist when the file format is MPEGTS. The following procedures outline the steps to distribute your content using multicast streaming.
Multicast streaming using RTP/UDP
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
3. Click the Publish drop-down menu.
4. Choose using RTP/UDP push.
142
Pearl User Guide
4-1 Stream your video
5. Enter the destination multicast IP address.
6. Enter the port number through which the audio will stream.
7. Enter the port number through which the video will stream.
Both audio and video use adjacent ports (port and port+1). The minimum distance between audio
and video ports should 2.
8. Click Apply; an SDP file is generated and available from the Status page of the web interface.
9. Select a name and location for the SDP file and save it.
10. Share the link to the file with viewers.
Multicast streaming for MPEG-TS file format using UDP push
To configure the MPEG-TS stream, ensure the following codecs are configured:
l Video – H.264
l Audio – MP3 or AAC, if audio is configured.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
143
Pearl User Guide
4-1 Stream your video
5. Click the Publish drop-down menu.
6. Choose using MPEG-TS UDP push.
7. 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.
8. Enter the destination port number through which the media will stream.
9. Perform one of the following:
a. If you do not want to advertise your stream to a media player over a local network, go to the last
step of this procedure; or
b. To advertise your stream to a media player over a local network, follow the steps below.
10. Enable the SAP announcement checkbox to advertise your stream over a local network. When the
checkbox is enabled and a multicast IP address is configured, your stream is displayed in the playlist of
local media players.
11. 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.
12. 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.
144
Pearl User Guide
4-1 Stream your video
When a channel number value is not specified, viewers cannot select a channel from the settop box or Smart TV .
13. 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 in cases where
folders are not displayed, use dot separator hierarchy to help your viewers filter out unwanted streams
by category.
14. Click Apply. To view the stream, open the URL in a media player, for example:
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 SAP Announce.
Multicast streaming for MPEG-TS file format using RTP/UDP push
To configure the MPEG-TS stream, ensure the following codecs are configured:
l Video – H.264
l Audio – MP3 or AAC, if audio is configured.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. From the web interface, click a Channel; the menu expands.
4. Click Streaming; the channel's Streaming page opens.
5. Click the Publish drop-down menu.
6. Choose using MPEG-TS RTP/UDP push.
7. 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.
145
Pearl User Guide
4-1 Stream your video
8. Enter the destination port number through which the media will stream.
9. Perform one of the following:
a. If you do not want to advertise your stream to a media player over a local network, go to the last
step of this procedure; or
b. To advertise your stream to a media player over a local network, follow the steps below.
10. Enable the SAP announcement checkbox to advertise your stream over a local network. When the
checkbox is enabled and a multicast IP address is configured, your stream is displayed in the playlist of
local media player.
11. 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.
12. 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 settop box or Smart TV .
13. 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 in cases where
folders are not displayed, use dot separator hierarchy to help your viewers filter out unwanted streams
by category.
14. Click Apply.
15. Click the Info menu option of the web interface. An Info page opens displaying stream information.
To view the stream from a media player, open the URL in a 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-topbox or Smart TV, refer to Viewing with SAP Announce.
146
Pearl User Guide
4-2 Samples of stream settings
4-2 Samples of stream settings
When choosing your stream settings it is important to consider the stream content. When streaming fast
moving video it's best to choose a higher bitrate and frame rate versus streaming a slide presentation where
you can save on bandwidth and system processing by lower the bitrate and frame rate. Stream setup is a
matter of balancing quality and system resource usage.
To help you to achieve this balance the following tables list the recommended settings when streaming video
and slide content from a PC, Mac or tablet.
Streaming video content
The table below provides suggested settings to maximize your video quality while minimizing system resource
usage when streaming video content from a PC, Mac or tablet.
Setting
PC and Mac
Tablet
Codec
H.264
Motion JPEG
Video encoding preset
High Speed
High Speed
Video encoding profile
Main
Enhanced compatibility mode
(h.264 slicing for RTP)
Key frame interval
Limit frame rate
Bitrate
Disable for PC
Enable for Mac
2 sec
30
30
2000 Kbits for HD
3000 Kbits for Full HD
3000 kbits for ~ HD; 4000 kbits
for ~ Full HD (Mac)
Rate control mode
Audio format
Balanced
PCM 22 KHz
147
Pearl User Guide
4-2 Samples of stream settings
Streaming slide content
The table below provides suggested settings to maximize your stream quality while minimizing system resource
usage when streaming slide content from a PC, Mac or tablet.
Setting
PC and Mac
Tablet
Codec
H.264
Motion JPEG
Video encoding preset
High Quality
High Quality
Video encoding profile
High
Disable for PC
Enhanced compatibility mode (h.264
slicing for RTP)
Key frame interval
Limit frame rate
Enable for Mac
2 sec
15
15
Bitrate
Rate control mode
Audio format
Balanced
PCM 44 KHz
148
Pearl User Guide
PART 5: Record
PART 5: Record
Your Pearl encodes the video and audio it captures. If you choose to record the resulting streams, it stores the
recorded files on the system and provides a variety of automatic or manual mechanisms to download the files.
This section discusses the following topics related to recording:
l Recorders
l Create Recordings
l File Maintenance
l File and Recording Transfer
l Use the Local FTP Server
149
Pearl User Guide
5-1 Recorders
5-1 Recorders
Your Pearl can record the output from each channel and can also record multiple channels together in a single
multi-track file.
This section describes the following topics for creating and managing multi-channel recorders.
l Add a recorder
l Rename a recorder
l Change the channels recorded by a recorder
l Delete a recorder
See Create Recordings to learn how to create recordings and configure recording file sizes.
Add a recorder
Each channel has its own built-in recorder that is accessible from the Recording link. If you want to record
several channels simultaneously to a multi-track file, create a new recorder.
To add a new recorder:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Click the Add recorder link from the Recorders section; a new recorder is created and the recorder
configuration page opens. By default this recorder uses the next available number and records all
channels.
150
Pearl User Guide
5-1 Recorders
Rename a recorder
To rename a recorder:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the desired recorder link from the Recorders section; the recorder configuration page opens.
4. Click the recorder name to make it editable.
5. Highlight the old name and press backspace or delete to delete it.
6. Type the new name for the channel.
7. Press Enter to save the change; the new name is reflected in the web interface.
You must press Enter to save the recorder name change.
Change the channels recorded by a recorder
By default when you create a new recorder, it records all the channels configured on the system. If new
channels are added, they are automatically added to the recorder.
If you wish to record a subset of channels to a single multi-track file, you can edit the channels recorded by a
recorder.
To change the channels recorded by a recorder:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the desired recorder link from the Recorders section; the recorder configuration page opens.
4. Click change next to the list of what is currently being recorded.
151
Pearl User Guide
5-1 Recorders
5. If the all channels box is selected, click it to deselect it; the other check boxes are enabled.
6. Click the check boxes for the desired channels.
Channels with no active video source are displayed in italics. You can include these channels
in your channel selections for the recorder.
7. Click Apply; the changes are reflected in the recorder configuration page.
Delete a recorder
When you no longer need a recorder, you can delete it.
Deleting a recorder deletes all the recorded files for the recorder. Be sure you have a copy of any
important recorded files.
To delete a recorder:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the desired recorder link from the Recorders section; the recorder configuration page opens.
152
Pearl User Guide
5-1 Recorders
4. Click the Delete this recorder button at the top of the page; a confirmation dialog reminds you that
deleting the recorder will delete all recorded files.
5. Click OK on the confirmation dialog; the recorder is removed from the list and all its related files are
deleted from the system.
153
Pearl User Guide
5-2 Create Recordings
5-2 Create Recordings
Your Pearl can record the output from each channel and can also record multiple channels together in a single
multi-track file. See Recorders for information on creating multi-track recorders using multiple channels.
This section describes the following topics for creating and configuring recordings via the web interface.
l Record a channel via the web interface
l Control recording with the touch screen
l Record with a recorder via the web interface
l Create Recordings
l Configure the type and length of recording files
l Close the current recording file while recording
l Control recording with a mouse
See Control with HTTP Commands and Control with RS-232 / Serial Port for information on controlling
recordings with third party tools. See File Maintenance to learn how to download the recorded files.
Recording can also be controlled via the tablet interface. See Control recording via the tablet
interface.
Recording basics
While recording a channel or recorder, a new file is created each time the maximum time or size limit is met.
Additionally, when recording a multi-channel recorder or a multi-view channel, a new file is created if an
additional source is added to the recorder.
Physically removing the source (e.g. unplugging it) or otherwise interrupting the signal to the source does not
affect recording, and the recording will include the configured No Signal image. When recording auto
channels, a new recording is made when the input changes from one to another due to signal loss. Recording
is stopped if the channel, or all channels in a recorder, are made inactive by changing the channel configuration
to "no source" via the admin interface.
Each channel that has a source present uses some CPU power to encode the stream. You can avoid CPU
overload by setting up channels you intend to use but setting the source to "No Source" in the admin
interface. When you are ready to use the channel again, simply set the source and all your other configuration
is already set. This doesn't apply for multi-view channels which always need at least one source to keep their
configuration settings.
154
Pearl User Guide
5-2 Create Recordings
You can choose to create AVI, MOV or MPEG-TS recordings. See Configure the type and length of recording
files to learn how to change the recorded file type.
The MOV file type created by Pearl requires a relatively newer player for playback. Epiphan has tested with the
following players.
Operating System
Mac OS
Tested Players
l QuickTime 10.3 (for 1080p streams)
l QuickTime 10.3 (for streams less than 1080p)
l VLC 1.0.0+ (for all streams)
Windows
l QuickTime 7.6.6+
l VLC 2.1.5+
l Windows Media player 12+
Linux
l MPlayer
l VLC 2.0.8+
Android
l DICE 2.0.21
Control recording with the touch screen
Pearl's touch screen gives you freedom to start and stop recording without needing to log in to the web
interface.
Simply scroll to the channel you wish to control and press the start or stop recording button.
To start recording:
1. If necessary, tap the screen once to turn it on.
2. If the grid view is showing, tap the channel for which you wish to control recording; the screen displays
the channel.
3. If necessary, tap the screen once to display controls on the channel view.
155
Pearl User Guide
5-2 Create Recordings
4. Touch the red record button at the top right of the screen; recording starts and a timer is displayed to
show the length of the recording.
To stop recording:
1. If necessary, tap the screen once to turn it on.
2. If the grid view is showing, tap the channel for which you wish to control recording; the screen displays
the channel.
3. If necessary, tap the screen once to display controls on the channel view.
4. Touch the red record button at the top right of the screen; recording stops and the timer disappears.
Record a channel via the web interface
Each channel has a configuration page that allows you to start, stop and configure recordings.
To start and stop channel recording:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. Click the name of the desired channel; the channel menu expands.
156
Pearl User Guide
5-2 Create Recordings
4. Click the Recording link for the channel; the Recording page appears.
5. To Start Recording:
a. Click the Start button; the recording starts and a timer indicates how long it has been recording.
If the start button is not active, there are no active sources for this channel or recorder.
Check your inputs to ensure signals are working as expected.
b. You may browse away from the page without affecting the recording. When the page refreshes,
the channel number is displayed in red to indicate recording is underway.
157
Pearl User Guide
5-2 Create Recordings
c. The system continues to record this channel (and any concurrent recordings) until it is stopped. If
the system runs out of storage space, the oldest recorded file is deleted to make room for the
new recording. The recording is broken into multiple files as defined by the channel
configuration. See Configure the type and length of recording files.
6. To Stop Recording:
a. Click the Stop button on the given channel’s Recording page. The channel number changes to
black next time the web interface is refreshed (by clicking a link or refreshing the page).
Record with a recorder via the web interface
Recorders are stopped and started via their configuration page. Multiple recorders and channel recordings can
occur concurrently.
A new recording file is generated each time a configured source in the recorder comes online. For example if
the recorder has two configured sources but when the recording starts and only one source is active, it will
start a single-track recording. When a second source starts sending signal, the first recording file is closed and
a new multi-track file is opened. If a source that is being recorded becomes inactive, the recorder continues to
record the source with the no signal image.
The number of active sources is displayed above the recording stop/start buttons during recording.
To start and stop recorder:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
158
Pearl User Guide
5-2 Create Recordings
2. Login as admin or operator.
3. Click the name of the desired recorder; the recorder configuration page appears.
4. To Start Recording:
a. Click the Start button; the recording starts and a timer indicates how long it has been recording.
b. You may browse away from the page without affecting the recording. When the page refreshes,
the recorder number is displayed in red to indicate recording is underway.
c. The system continues to record this recorder (and any concurrent recordings) until it is stopped.
If the system runs out of storage space, the oldest recorded file is deleted to make room for the
new recording. The recording is broken into multiple files as defined by the recorder
configuration. See Configure the type and length of recording files.
5. To Stop Recording:
159
Pearl User Guide
5-2 Create Recordings
a. Click the Stop button on the given recorder's configuration page. The recorder number changes
to black next time the web interface is refreshed (by clicking a link or refreshing the page).
Configure the type and length of recording files
By default, recorders and channels record to AVI files. When the recording reaches 30 minutes in length or a
file size of 500 MB (whichever occurs first), the system closes the current recording file and opens a new one.
This is done seamlessly with no loss in recorded data.
You may find it useful to have recordings divided this way for ease of download, but you may also want to
change the recording limits to be larger or smaller to meet your individual situation.
Additionally you can configure the prefix for all recordings (the suffix is the date and time of the recording) and
you can exclude a channel or recorder’s recordings from automatic upload.
To change the recording configuration:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. For a channel recording:
a. Click the desired channel; the channel menu expands.
b. Click the Recording link for the channel; the Recording page opens.
4. For a recorder:
a. Click the desired recorder link from the Recorders section; the recorder configuration page
opens.
5. Click the change link under Recorder Setup; the recorder setup section expands. (The setup page looks
slightly different for Recorders, but the options are the same.)
160
Pearl User Guide
5-2 Create Recordings
6. Select a time limit for the recording from the Time limit drop down.
7. Select a file size limit from the Size limit drop down.
Tip: 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 file size that is far larger than you saw in your tests.
8. Select a file type from the File type drop down.
9. If desired, enter a prefix for the recordings. All new recording files for this channel or recorder will be
prefixed with the text you enter.
Tip: It’s best to avoid spaces in file names. Use underscores or hyphens to separate words.
10. If desired, click the check box to exclude this channel or recorder from automatic file uploads. (See File
and Recording Transfer for information on automatic uploads.)
11. Click Apply; the changes are saved and the recorder setup displays the new configuration.
The table below describes the options available for recording file configuration.
Table 18 Recording File Configuration Fields
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 six hours.
Size limit
Specifies the file size a recording can become before it is saved and a new one is started
(assuming the time limit has not yet been reached). Values range from 50 MB to 64 GB.
161
Pearl User Guide
5-2 Create Recordings
Label
Description / Options
File type
Specifies the recording file type. Select from AVI, MPEG-TS, or MOV. Choose MPEG-TS for
UPnP playback.
Filename prefix
Specifies how the recordings are named. Recording files start with the given prefix
followed by the date and time. The channel or recorder name is used if no prefix is given.
Allowed characters: A-Z, a-z, 0-9, _, , #, -, [], ().
Automatic file
upload
Select this if you want this channel or recorder to be part of any scheduled automatic
uploads. (See File and Recording Transfer for information on automatic uploads.)
Share via UPnP
Select this if you want this channel or recorder to be avialable via UPnP. If global UPnP is
not enabled when you select this checkbox, a link appears to let you to fix it. Click the
link and click Apply to make the global UPnP change save your recording configuration
changes.
Close the current recording file while recording
Recording files are automatically saved and new ones opened for writing when they reach the configured time
or size limit, when the channel or recorder name is changed, or when changes are made to the stream. You
cannot download files from the system while they are being recorded, so from time to time you may need to
close the current recording to facilitate file downloads. The system supports this through the recording reset
option, which closes the current recording file and opens a new one without missing any frames.
To close the current recording and start a new file:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. For a channel recording:
a. Click the desired channel; the channel menu expands.
b. Click the Recording link for the channel; the Recording page opens.
4. For a recorder:
a. Click the desired recorder link from the Recorders section; the recorder configuration page
opens.
162
Pearl User Guide
5-2 Create Recordings
5. Click the Reset button next to the stop button; the current file is stopped and a new one begins.
6. Refresh the page to see the new recorded files list.
Control recording with a mouse
You can physically control recording start/stop by connecting a USB mouse to your Pearl.
To control recordings with a mouse:
1. Power on the system.
2. Connect a USB mouse to a USB port on the system.
3. Click the left mouse button once to start recording; recording starts (on all channels). If desired, check
the web interface to see that recording is started.
4. Click the left mouse button again to stop recording. If desired, check the web interface to see that
recording is stopped. See View the List of Stored Files
163
Pearl User Guide
5-3 File Maintenance
5-3 File Maintenance
Pearl has a finite amount of storage. Though this storage space holds a lot of recordings, it will eventually run
out of space if recordings are added but never removed. When this happens, the system deletes the oldest
recorded files to make room for new recordings.
You can use a variety of methods to automatically transfer files from the system to local network storage.
Alternatively you can manually select individual recordings to transfer or delete. This section discusses the
following manual file management topics.
l View the List of Stored Files
l Rename Stored Files
l Download Files Manually
l Delete Files Manually
l Pick Specific Tracks from a Multi-track Recorder File
For information on automatic file transfers, see File and Recording Transfer.
View the List of Stored Files
Recordings for Pearl are stored for each channel and each recorder separately. To view all the recordings
stored, follow the procedures below for all channels and all recorders you have configured.
To view the recordings for a channels or recorders:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. To view files recorded for a channel:
a. Select a channel from the Channels section; the channel menu expands.
b. Select the Recording link for your channel; the Recording page appears.
4. To view files recoded for a recorder:
a. Select the recorder from the Recorders section; the recorder page appears.
5. If there are no files:
a. A message indicates there are no recorded files (for this channel).
164
Pearl User Guide
5-3 File Maintenance
6. Otherwise:
a. All files for this channel are listed, 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.
Rename Stored Files
Recording files are named based on the filename prefix specified during configuration. See Configure the type
and length of recording files for more details about setting prefixes.
To rename recordings:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Find the recordings by channel or by recorder. See View the List of Stored Files.
4. Select the pencil and paper icon next to the filename you wish to change.
165
Pearl User Guide
5-3 File Maintenance
5. Type the new file name and press enter when finished.
The web interface keeps track of the filename extension (i.e. .avi) so you do not need to
include it when renaming the file.
Download Files Manually
Recordings can be manually downloaded from the web interface. You should consider deleting them from
internal storage after you complete the download. See Delete Files Manually, below.
This procedure explains how to download files to your admin computer. See File and Recording Transfer for
information on transferring files to a USB drive connected to the system.
To download recordings to your admin computer:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. Find the recordings by channel or by recorder. See View the List of Stored Files.
4. To download an individual file:
a. Click the name of a recording file to download it.
166
Pearl User Guide
5-3 File Maintenance
5. To download multiple files:
a. Select the check box next to the recordings you wish to download from this channel or recorder.
b. Click Download Selected to download a zip file containing the selected recordings.
Delete Files Manually
Recordings can be manually deleted via the web interface. You can delete one file at a time, select multiple files
for a given recorder or channel and delete those, or you can delete all recordings for a channel or recorder.
If you want to delete all the files on the system, follow this procedure for each channel and recorder listed in
the web interface.
To delete recordings:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. Find the recordings by channel or by recorder. See View the List of Stored Files.
4. To delete an individual file:
a. Click the X icon to the right of a file entry to request deletion; a confirmation dialog appears.
b. Click OK on the confirmation dialog.
5. To delete multiple files for the current channel or recorder:
a. Select the check box next to the recordings you wish to delete from this channel or recorder.
b. Click Delete Selected; a confirmation dialog appears.
167
Pearl User Guide
5-3 File Maintenance
c. Click OK on the confirmation dialog.
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).
6. To delete all files for the current channel or recorder:
a. Click Delete All; a confirmation dialog appears.
b. Click OK on the confirmation dialog.
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).
Pick Specific Tracks from a Multi-track Recorder File
Recorders combine multiple channels and audio sources together in a single multi-track file. If desired, you can
create a copy of a recording with only select tracks. This feature is supported for .AVI and .MOV recordings
only.
Specific track versions of recorded files are not included in any automatic file transfers. See
Download Files Manually
To create a duplicate recording file with only select tracks:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. Select the recorder from the Recorders section; the recorder page appears.
4. Find the file you want to duplicate and click the up arrow icon next to it; a list of tracks appears.
168
Pearl User Guide
5-3 File Maintenance
5. Select the track(s) you want to extract.
Tip: To deselect all tracks, click the check box for the top track, then hold SHIFT and click the
check box for the bottom track.
6. Click Extract tracks; a duplicate of the recording is made with only the selected tracks.
169
Pearl User Guide
5-4 File and Recording Transfer
5-4 File and Recording Transfer
Your Pearl can be configured to automatically upload recordings from local storage to a network storage
location or an attached USB drive.
This section discusses the following generic automatic upload topic:
l Configure Automatic File Upload (Part 1 of 2)
And the following specific configurations based on the location of upload:
l Configure Automatic File Upload to an FTP Server (Part 2 of 2)
l Configure Automatic File Upload using RSync (Part 2 of 2)
l Configure Automatic File Upload using CIFS (Part 2 of 2)
l Upload to an External USB Drive
l Automatically (part 2 of 2)
l As a one-time copy
l Manually
Configure Automatic File Upload (Part 1 of 2)
Pearl can automatically upload files to an accessible off-system storage location. Four types of off-system
storage are supported (FTP, CIFS, RSync, and USB Drive); only one can be used at once.
Files are uploaded once (i.e. are automatically not re-uploaded during future sessions) and a log is kept
showing the file transfers. The first transfer occurs after the configured amount of time expires, or after the
current file completes recording.
Files saved before you complete automatic file upload configuration are not part of the automatic
upload. Manual file transfer is required for these files. See File Maintenance.
To configure automatic uploads:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select Automatic File Upload from the Configuration section; the Automatic File Upload configuration
page opens.
170
Pearl User Guide
5-4 File and Recording Transfer
4. Select the Enable Automatic File Upload checkbox.
5. Specify how often automatic updates should happen.
The first transfer occurs after the specified amount of time expires, or after the current file completes
recording. I.e. if the value is set to every hour and five videos are saved the first hour, those five videos
are uploaded after the first hour, and one hour later the videos saved in the second hour are uploaded.
The following table describes the available options.
Table 19 Automatic File Upload Interval Options
Name
Description
On file rotation
The system uploads each file after it stops recording it. You can control file size
and length to determine when files are done recording. You can also use the
reset button to close the current file and open a new one. See Create Recordings.
Every hour
The system uploads completed recordings every hour.
Every 6 hours
The system uploads completed recordings every six hours.
Every 12 hours
The system uploads completed recordings every 12 hours.
Every 24 hours
The system uploads completed recordings every 24 hours.
6. Indicate the remote path, if desired. If no path is specified, the files are copied to the root folder of the
destination file system.
If the remote path does not exist on the remote server or USB drive, the file transfer fails.
171
Pearl User Guide
5-4 File and Recording Transfer
7. If desired, check Remove after upload to have the files deleted from local storage when upload
completes.
8. If desired, check Mark file as downloaded to have the color of the file link in the recording list change
to show the files are downloaded. This only applies if the files are not deleted after upload is complete.
9. Select the protocol or destination for upload. The following table describes the options.
Table 20 Automatic File Upload Interval Options
Name
Description
FTP Client
The system uploads to an FTP server.
RSync Client
The system uploads to a network location using RSync to copy the file.
CIFS Client
The system uploads to a network location using CIFS (also known as SMB or
samba) such as a shared folder on a Windows machine.
External USB Drive The system uploads to a USB drive connected directly to the system.
10. Follow the procedure below for configuring your selected protocol.
Configure Automatic File Upload to an FTP Server (Part 2 of 2)
This procedure assumes you have completed the steps in Configure Automatic File Upload (Part 1 of 2) and
wish to continue with configuration of upload to an FTP Server.
To configure upload to an FTP server:
1. Select FTP Client from the protocol drop down list in the Automatic File Upload configuration page; the
lower half of the page reflects the selection.
172
Pearl User Guide
5-4 File and Recording Transfer
2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure Network Settings), you can use the server’s fully qualified domain name
instead of the IP address.
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
is complete.
7. Click Apply; if there are any problems the system notifies you with a message: One or more parameter
values are not valid and those were not applied!
The following table describes the options applicable to configuring upload to an FTP server.
Table 21 FTP Automatic Upload Configuration Options
Name
Description / Options
Server address
The 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
Username 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 or .avi).
Configure Automatic File Upload using RSync (Part 2 of 2)
This procedure assumes you have completed the steps in Configure Automatic File Upload (Part 1 of 2) and
wish to continue with configuration of upload using RSync.
To configure upload using RSync:
1. Select RSync Client from the protocol drop down list in the Automatic File Upload configuration page;
the lower half of the page reflects the selection.
173
Pearl User Guide
5-4 File and Recording Transfer
2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure Network Settings), you can use the server’s fully qualified domain name
instead of the IP address.
3. Specify the Server module. This is the name of the shared folder on the server. If needed, request this
value from your network administrator.
4. Specify a username for the RSync Server in the Login field. The user must have write permissions for the
module.
5. Specify the password for the user in the Password field; the value is masked by dots.
6. If desired, select the Checksum check box to add a checksum validation to the transfer between the
system and the recipient server.
7. Click Apply; if there are any problems the system notifies you with a message: One or more parameter
values are not valid and those were not applied!
The following table describes the options applicable to configuring upload to an RSync server.
Table 22 RSync Automatic File Upload Configuration Options
Name
Description / Options
Server address
The 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.
Checksum
Select to enable checksum checking during file transfer. This increases the time taken to
transfer, but also increases reliability of the transfer.
174
Pearl User Guide
5-4 File and Recording Transfer
Configure Automatic File Upload using CIFS (Part 2 of 2)
This procedure assumes you have completed the steps in Configure Automatic File Upload (Part 1 of 2) and
wish to continue with configuration of upload using CIFS (also known as SMB or samba).
To configure upload using CIFS:
1. Select CIFS Client from the protocol drop down list in the Automatic File Upload configuration page; the
lower half of the page reflects the selection.
2. Specify the target Server address. If your system is configured with DHCP or has a valid DNS
configuration (see Configure Network Settings), you can use the server’s fully qualified domain name
instead of the IP address.
3. Enter the target Server port, if you have configured the server to use something non-standard. Leave
this value 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 Domain
name of the CIFS server.
6. Specify a username for the CIFS Server in the Login field. The user must have write permissions for the
share folder.
7. Specify the password for the user in the Password field; the value is masked by dots.
8. Select Use temp file file to name files with a temporary filename extension (.part) on the server until
upload is complete.
9. Click Apply; if there are any problems the system notifies you with a message: One or more parameter
values are not valid and those were not applied!
The following table describes the options applicable to configuring upload to a CIFS server.
175
Pearl User Guide
5-4 File and Recording Transfer
Table 23 CIFS Automatic File Upload Configuration Options
Name
Description / Options
Server Port
The CIFS server port. Leave blank to use the default port, or enter the port used for your
CIFS server.
Server address
The IP address (or fully qualified domain name) of the CIFS server.
Server share
The name of the shared folder on the CIFS server.
Domain
The 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 or .avi).
Upload to an External USB Drive
The system is equipped with USB ports that can be used to copy files from internal storage to external USB
flash drives or hard drives. An example use of this feature is to provide speakers with a copy of their
presentation before they leave the presentation venue.
The external drive must be formatted with one of the following file systems:
l FAT16
l FAT32
l XFS
l EXT2
l EXT3
l EXT4
Only the first attached USB drive is used for automatic file upload. If more than one USB drive is
attached before system power up, behavior is unpredictable.
File transfer to a USB drive occurs in one of the following ways. This section describes the procedures.
l Automatic File Upload to a USB Drive (Part 2 of 2)
l One-Time Copy/Move of All Recorded Files to USB Drive
l Manually Copy Recorded Files to USB Drive
l View Available USB Storage Space
l Safely Eject the USB Drive
176
Pearl User Guide
5-4 File and Recording Transfer
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.
Automatic File Upload to a USB Drive (Part 2 of 2)
This procedure assumes you have completed the steps in Configure Automatic File Upload (Part 1 of 2) and
wish to continue with configuration of upload to a USB drive.
To configure automatic upload to a USB drive:
1. Insert the properly formatted USB drive into one of the system’s USB ports.
2. Select External USB Drive from the protocol drop down list in the Automatic File Upload configuration
page; the lower half of the page reflects the selection.
3. If your Automatic File Upload setting conflicts with your new USB drive setting, a message is displayed.
4. Click the fix link.
177
Pearl User Guide
5-4 File and Recording Transfer
Using the fix 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 and re-configure FTP, RSYNC, or CIFS.
5. Select Create a subfolder for each channel to have recordings organized by channel.
6. Click Apply; the changes are saved.
One-Time Copy/Move of All Recorded Files to USB Drive
When configured to make a one-time copy of files, the system will automatically begin to copy files to an
inserted USB drive, starting with the newest recording. Files will continue to copy until all are copied, the
specified maximum number of files is copied, or the target drive runs out of storage space.
The file currently being recorded (if any) cannot be transferred until recording is completed.
This procedure is separate from automatic file upload and does not need any pre-configuration in the
automatic file upload page.
Ideally only USB drives with visible activity indicators should be used.
To configure a one-time copy of all recorded files to a USB drive:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the External USB Drive link in the Configuration section; the External USB Drive configuration
page is displayed.
4. Select used for one-time move/copy of the recorded files (upon insertion) from the drop down list.
178
Pearl User Guide
5-4 File and Recording Transfer
5. Select the appropriate check boxes based on the descriptions provided in the following table. If your
USB drive does not have activity indicators it is suggested you select either remove after copying or mark
file as downloaded so you know when the transfer is complete.
Table 24 One-Time Transfer/Copy to External USB Drive 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 collect recordings from multiple systems and want to know which
system they came from.
create subfolder for each
channel
If checked, the transfer process creates a sub-folder for each channel and
recorder (within the subfolder for the serial number, if that option is also
selected). Files are copied to their respective folders.
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 when viewing file lists. This has no effect if remove after copying is
checked.
ignore already
downloaded files
If checked, files that were previously marked as downloaded are not
included in subsequent downloads.
6. Click Apply; the changes are saved.
If a conflict is reported regarding the Automatic file upload, go to the Automatic File Upload
configuration page and disable automatic file upload or switch it to a non-USB based
upload type. Repeat the steps above.
7. Insert the properly formatted USB drive into one of the system’s USB ports; the drive is recognized and
the transfer begins. If the drive has an activity indicator light, it flashes during the transfer.
8. When the activity light stops flashing, remove the USB drive.
9. If your USB drive does not have activity indicators:
a. Check the Recording list for each channel and the Recorded Files list for each recorder to verify if
there are files that have yet to be copied.
b. Safely Eject the USB Drive when you are satisfied all files have been copied, or if you see the USB
drive is out of storage space (View Available USB Storage Space).
179
Pearl User Guide
5-4 File and Recording Transfer
Manually Copy Recorded Files to USB Drive
You can manually copy recorder files to a USB drive connected to Pearl.
This procedure is separate from automatic file upload and does not need any pre-configuration in the
automatic file upload page.
To manually copy recorded files to a USB drive:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the External USB Drive link in the Configuration section; the External USB Drive configuration
page is displayed.
4. Select used to manually move/copy selected files via web interface from the drop down list.
5. Click Apply; the changes are saved.
If a conflict is reported regarding the Automatic file upload, go to the Automatic File Upload
configuration page and disable automatic file upload or switch it to a non-USB based
upload type. Repeat the steps above.
6. To download files for a specific channel:
a. Select the desired channel from the Channels list
b. Click the Files Archive link for the selected Channel
7. To download files for a recorder:
a. Select the desired recorder from the Recorders list
8. Select the check box next to the files you wish to download. In the example below the topmost file is still
recording and cannot be downloaded.
180
Pearl User Guide
5-4 File and Recording Transfer
9. To copy the files to the USB drive:
a. Click Copy Selected to external drive
10. To move the files to the USB drive (i.e. erase the files after the copy)
a. Click Move Selected to external drive
11. Repeat the steps to select a channel or recorder and copy or move files to the external drive until you
have copied all the files you wish.
12. Follow the steps to Safely Eject the USB Drive.
View Available USB Storage Space
When you insert a USB drive in an available port of Pearl, the total and free space are calculated and displayed
in the Web Interface.
To see the available USB storage space:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Insert your USB drive in an available USB port on the system. (It is recommended you only use one USB
drive at a time.)
4. Scroll to the bottom of the Web Interface page; external USB storage is displayed under internal storage
space.
181
Pearl User Guide
5-4 File and Recording Transfer
Safely Eject the USB Drive
When you have completed work with the USB drive you can safely eject it by using the link at the bottom of the
Web Interface page.
To safely eject the USB drive:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Scroll to the bottom of the Web Interface page; click the eject link below external storage space.
4. When prompted, click OK to confirm that you want to eject the USB drive.
5. Disconnect the USB drive from the system.
182
Pearl User Guide
5-5 Use the Local FTP Server
5-5 Use the Local FTP Server
Pearl can act as an FTP server, allowing you to manually or automatically connect to the system and download
recordings. Depending on configuration of the FTP server, you may also be able to remotely delete files after
download, maximizing available system storage.
This section discusses the following FTP Server topics.
l Configure the Local FTP Server
l Downloading Files from the Local FTP Server
Configure the Local FTP Server
To configure the FTP server:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the FTP Server link in the Configuration menu; the FTP Server configuration page opens.
4. To enable the FTP server:
a. Select the Enable FTP access check box.
b. Select a user from the FTP user name drop down.
The ftp password is the regular access password for the selected user. See User
Administration for details on user names and passwords.
183
Pearl User Guide
5-5 Use the Local FTP Server
c. Click Apply.
5. To allow the FTP user to delete files:
a. Select the Enable FTP DELETE command check box.
b. Click Apply.
Any currently logged in ftp users must log out and back in again to have access to
the command.
6. To disable the FTP server:
a. De-select the Enable FTP access check box.
b. Click Apply.
7. To disable file deletion by FTP:
a. De-select the Enable FTP DELETE command check box.
b. Click Apply.
Any currently logged in users will continue to have access to the delete command
until they log out and log in again.
The following table summarizes the options for configuring the local FTP server.
Table 25 FTP Server Configuration Options
Name
Description / Options
Enable FTP access
The check box controls whether or not the system acts as an FTP server. By default this is
disabled.
FTP user name
Select one of the system users: admin, operator, or viewer. The ftp password will be the
access password for the selected user. By default the admin user is selected.
Enable FTP
DELETE command
Controls whether or not FTP users can delete files. By default file deletion is not
permitted.
Downloading Files from the Local FTP Server
Once you have configured a local FTP server, you can use the tool of your choice to download files from the
system.
The system stores files in a folder structure with a folder for each channel and a folder for each recorder.
Channel folders are labeled video<channel number> (i.e. video3 for channel 3). Recorder folders are labeled
184
Pearl User Guide
5-5 Use the Local FTP Server
videom<recorder number> (i.e. videom1 for the first recorder). Channel and recorder numbers are discoverable
via the URL of the channel and recorder configuration page. See Configure channels and Recorders.
To get started you will need:
l The IP address of your system (found in the Network configuration menu)
l An FTP tool
l The username and password for your FTP user (See Configure the Local FTP Server)
In the example below, the IP address of Pearl is 192.168.1.210, the username is admin, there is no password, and
the Windows command line ftp utility is used.
To connect to the FTP server:
1. Open a command window on Windows (alternatively open a terminal window on Linux/Mac, or open
your FTP utility of choice).
2. Establish an ftp connection using the command: ftp 192.168.1.210
3. Provide the username: admin (provide the username of your FTP user)
4. Provide the password: (provide the correct password for your FTP user); the connection is opened.
5. Use the dir command to see the file structure.
6. Use dir or your tool’s GUI to look in each folder for recordings.
7. Use get or your tool’s transfer mechanism to transfer files to your computer.
185
Pearl User Guide
5-5 Use the Local FTP Server
8. If enabled in the FTP configuration page, delete the file after downloading it by issuing the delete
command, or using your tool’s delete mechanism.
If the delete command is not enabled, attempting to delete a file will result in an Unknown
Command error.
186
Pearl User Guide
PART 6: View
PART 6: View
Now that you have perfected your stream, identified the medium to publish your stream, it's time to view the
video stream from a media player or a web browser.
This section discusses the following topic related to viewing your content:
l View your video
187
Pearl User Guide
6-1 View your video
6-1 View your video
This chapter describes factors to consider when choosing a streaming URL and steps to view the video stream
from a media player or a web browser. Refer to the following sections:
l View the live broadcast and retrieve stream URLs
l Viewing with a web browser
l Viewing with a media player
l Viewing with UPnP
l Viewing with Session Announcement Protocol (SAP)
View the live broadcast and retrieve stream URLs
There are two methods to view the current broadcast and to retrieve the stream URLs:
l Live broadcast link on the channel's status page.
l Info page from the configuration menu
View your broadcast using the View link on the Info menu
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. From the web interface, click Info menu option; the info window opens with a list of all configured
channels.
4. Click on the channel you want to preview. A page opens displaying the live broadcast and broadcast
URL.
188
Pearl User Guide
6-1 View your video
5. Copy the URL and provide to viewers. Based on their media player, viewers can access the broadcast
using a URL specific to their media player.
View your broadcast using the Live broadcast link on the Status page
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. From the web interface, click the channel that you want to view; the menu expands.
4. Click Status; the status page opens displaying the live broadcast and stream URL.
5. When HTTP live streaming for the channel is enabled the status page also shows the HTTP Live
Streaming link. See, Fine-tune channel configuration
189
Pearl User Guide
6-1 View your video
When HLS is enabled, viewers can accessing the stream using a tablet or smart phone device .
6. Click on the Live broadcast or HTTP Live Stream link, if it configured. The window opens displaying the
live broadcast and broadcast URL.
7. Copy the URL and provide to viewers. Based on their media player, viewers can access the broadcast
using a URL specific to their media player.
Sending stream URLs to viewers
For participants to log in and view a stream, you must provide a stream URL. The URL that you send depends
on the device the participant uses to view the stream. You can provide separate URLs for the stream coming
from each channel, or one URL that includes all the streams for the channel.
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
190
Pearl User Guide
6-1 View your video
3. From the web interface, click the channel that you want to view; the menu expands.
4. Click Status; the Status page opens displaying the stream protocols supported based on the selected
codecs. For more information on compatibility between codec and file formats, see View your video.
5. Copy the URL and provide to viewers. Based on their media player, viewers can access the broadcast
using a URL specific to their media player.
Viewing with a web browser
If a viewer password is configured, provide participants with the password to log in, along with the IP address
or the URL to be used by the participant's browser.
1. Open a web browser.
2. Enter the IP address of the broadcast stream, refer to the example below. To locate the IP address for
the broadcast, refer to View your video
If the IP address of the broadcast is 172.20.1.33, then browse to: http:// 172.20.1.33
3. Enter the user name and password at the prompt:
User Name: viewer
Password: (enter the viewer password)
4. Press Enter. The stream is played in the browser window.
191
Pearl User Guide
6-1 View your video
Viewing with a media player
If a viewer password is configured, provide participants with the password to log in, along with the IP address
or the URL to be copied to the media player. For example purposes the following procedure describes the steps
using a VLC media player.
1. Launch a media player.
2. Click the Media tab, a drop-down menu opens.
3. Choose Open Network Stream; a dialog box opens.
4. Enter the stream URL .
rtsp://96377.local:554/stream.sdp
192
Pearl User Guide
6-1 View your video
5. Press Play. The stream is played in the media player window.
Viewing with UPnP
Using a software or hardware media player, you can browse for files or streams with Universal Plug and Play
(UPnP). UPnP uses MPEG-TS over HTTP with the H.264 codec and MP3 or AAC audio encoding (or no audio). You
can only access live streams or recordings that meet these requirements.
For security reasons the default behavior prevents UPnP access to live streams and recorded files.
To enable UPnP, see Stream content using UPnP
Some players cannot access the stream or saved recordings if a viewer password is set. If needed,
see Removing User Passwords to clear the viewer password.
When browsing via UPnP your Pearl is displayed by the server name you set, or it's product serial number.
For example, when browsing from a Windows computer, you will see a list of media devices that includes Pearl:
193
Pearl User Guide
6-1 View your video
Live Streams
When you open the device from Windows Media Player, you'll see a list of the available channels you can stream
under the Videos tab. From other digital media players, the channel list can be under a Live Streams folder.
With Windows Media Player, double click to open any channel and press Play to start the stream. Using your
digital media player, select a live stream and press play.
Recorded Files
Recorded files are shown in the Recorded Files folder. Files are organized by the channel or recorder from
which they were recorded. Windows Media Player shows the recorder files side by side with the channels and
other digital media players show the recorded files in a file tree format, see below.
UPnP can also be used to directly play a recording to the digital media player, or to set a media player to
automatically play a particular live stream after reboot of Pearl. See Stream content using UPnP and Autorestart playback to a UPnP Device.
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 is streamed to their desktop, mobile or tablet. To configure SAP announce, go to Stream content
using multicast streaming.
194
Pearl User Guide
6-1 View your video
Your stream is advertised by the metadata title, if one was configured under Branding, otherwise it is identified
by it's channel identifier. For a description of how to set the metadata, refer to Add your logo and company
information to your channel.
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.
1. Ensure the stream has SAP announcement enabled, otherwise it is not advertised in the media player's
playlist.
2. Ensure the SAP announcement IP is a multicast IP address.
3.
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 your
stream, you must change the SAP announcement IP address to 239.255.255.255.
4. Launch a media player. The following steps are based on a VLC media player and may be different for
other media players.
5. Click View from the menu; a drop-down menu opens.
6. Select Playlist. A Playlist window opens. The right-hand panel indicates the playlist is empty.
7. From the side menu, click Network streams (SAP). The playlist is populated with all streams in your
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.
In the example below, two streams D2P83658.vga and D2P83658 are organized in a folder by their group name.
8. Click on a live stream; the stream plays in the media player window.
195
Pearl User Guide
PART 7: Maintenance
PART 7: Maintenance
This section covers topics that will keep your Pearl running smoothly. It also covers a new tablet operator
interface and ways to configure and operate your system using third party tools via HTTP or RS-232.
Specific topics covered are:
l Mobile / Tablet Operator Interface
l Power Down and System Restart
l Save and Restore Device Configuration
l Restoring Factory Configuration
l Firmware Upgrade
l Remote Support
l Storage Disk Maintenance
l Control with RS-232 / Serial Port
l Control with HTTP Commands
l Configuration Keys for Third Party APIs
196
Pearl User Guide
7-1 Mobile / Tablet Operator Interface
7-1 Mobile / Tablet Operator Interface
Epiphan's tablet interface is designed for touch-screen devices. Use your tablet or mobile device to perform
confidence checks and basic operator tasks such as verifying disk space or starting and stopping recording.
This section describes procedures for the following topics:
l Connect to the tablet interface
l Confidence monitoring using the tablet interface
l Verify disk space via the tablet interface
l Control recording via the tablet interface
l Switch to the full admin interface
Connect to the tablet interface
To get started with the tablet interface you can connect to it in one of the following ways.
The device connecting to the tablet interface must be on the same network as the Pearl or must be
physically connected to it via USB.
l Use the browser over Ethernet
l Use tethering on your device
l Use the mobile version of Epiphan Connect
Use the browser over Ethernet
You can connect to the tablet interface with a browser on your admin computer, tablet, or touch-screen device.
To connect to the tablet interface:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. Modify the URL in the browser to have /m after the existing text and press Enter; the tablet interface
opens. (If you forget the /m, the system will direct you to the mobile or standard interface, depending on
information sent by your device's browser).
197
Pearl User Guide
7-1 Mobile / Tablet Operator Interface
http://<ip address of system>/admin/m
or
http://<serial number of device>.local/admin/m
For example: http://192.168. 1.163/admin/m or http://95dd40d5.local/admin/m
In the future you can go directly to the IP address above and login from the mobile interface without ever
seeing the usual admin interface.
Use tethering on your device
You can use tethering on your mobile device or tablet to connect to the tablet interface. This option requires
some configuration through the full admin interface.
To configure use of tethering (perform this once):
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Network link in the Configuration menu; the network configuration page opens.
4. Select No tethering or any option except Disabled from the Use phone/tablet connection. See Tether
to a Mobile Network for descriptions of the options.
5. Click Apply.
To use your mobile device or tablet via tethering:
1. Turn on tethering on your device. (See device user manual for instructions.)
2. Connect the device to your Pearl via USB.
3. Use the EpiphanConnect utility (from the Google Play or Apple App store) to find the system and open
the tablet admin interface.
Use the mobile version of Epiphan Connect
Epiphan has iOS and Android versions of the Epiphan Connect discovery utility. The mobile versions of the
discovery utility automatically open the tablet interface when connecting to the Pearl for administration.
See instructions below for installing the application. The iOS version is available from the Apple App Store and
the Android version, currently in beta, is available from the Epiphan web site.
To install the application on your iOS or Andriod device (perform this once):
1. Open the App Store (for Apple devices) or Google Play store (for Android devices).
2. Search for EpiphanConnect (all one word).
198
Pearl User Guide
7-1 Mobile / Tablet Operator Interface
3. Download and install the free Epiphan Connect application.
To connect to the device:
1. Once Epiphan Connect is installed, connect to the wifi network where you can access your Pearl.
2. Launch Epiphan Connect; the application searches your network and shows you a list of available
Epiphan systems.
3. Find your system in the list. If you have several Epiphan systems, look for the serial number of the one to
which you'd like to connect.
4. Select the system by touching the system name; a login prompt is presented.
5. Login as admin or operator; the tablet interface appears.
Confidence monitoring using the tablet interface
When connected to the tablet interface, you can use the INPUTS section to monitor the inputs to your system.
An auto-updating snapshot of video inputs and an audio level meter is provided for each source.
The top of the tablet interface gives you a warning if there are video inputs with no signal. In the example
below, 4 video inputs have no signal.
For more detailed information, you can look at each input individually.
To monitor each input:
1. Connect to the tablet interface. See Connect to the tablet interface.
2. Login as admin or operator.
3. Scroll to the INPUTS section.
199
Pearl User Guide
7-1 Mobile / Tablet Operator Interface
4. For audio inputs without signal, nothing appears in the audio input bars.
5. For audio inputs with signal, the level is shown next to the source name in the audio input bar.
6. If a video source has no signal, the name appears red and a note next to the name says NO SIGNAL.
200
Pearl User Guide
7-1 Mobile / Tablet Operator Interface
7. If the source has a signal, it's frame size and frame rate are displayed beside the source name.
8. View a preview of the source by clicking the down arrow in the row for source. (The names of the
sources match the names set in the main admin interface. )
Verify disk space via the tablet interface
The INFO section of the tablet interface lets you know the firmware version, serial number and IP Address of
your system. It also shows you the currently available disk space.
To monitor inputs:
1. Connect to the tablet interface. See Connect to the tablet interface.
2. Login as admin or operator.
3. Scroll to the INFO section; the currently available disk space is shown.
4. If disk space is low, the green bar will be nearly full.
Control recording via the tablet interface
The tablet interface provides a simple way to control recording for your Pearl. You can control recordings for
both channels and recorders from the same interface.
To control recording from the tablet interface:
201
Pearl User Guide
7-1 Mobile / Tablet Operator Interface
1. Connect to the tablet interface. See Connect to the tablet interface.
2. Login as admin or operator.
3. Scroll to the CHANNELS section.
4. Find the channel or recorder from the list under CHANNELS. (The names of the channels and recorders
match the names set in the full admin interface.)
5. Click the down arrow in the row for the desired channel or recorder
6. Use the START, STOP, and RESET buttons to control recording.
Switch to the full admin interface
To switch from the tablet interface to the full admin interface:
1. Connect to the tablet interface. See Connect to the tablet interface.
2. Login as admin or operator.
3. Click the arrow button at the top right of the screen. Depending on the width of the screen, the button
may say extended view.
202
Pearl User Guide
7-2 Power Down and System Restart
7-2 Power Down and System Restart
This section covers the following topics:
l Restarting the Device via the Web Interface
l Shutting down the Device via the Web Interface
l Shutting down the Device Manually
Restarting the Device via the Web Interface
Pearl's web interface allows you to reboot the system.
To restart the system:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
4. Click the Reboot Now button; a confirmation dialog appears.
5. Click OK.
203
Pearl User Guide
7-2 Power Down and System Restart
Shutting down the Device via the Web Interface
The Pearl web interface allows you to shut down the system.
To shut down the system:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
4. Click the Shutdown Now button; a confirmation dialog appears.
5. Click OK.
Shutting down the Device Manually
You can manually shut down the Pearl via the button physically located on the system.
To shut down the system manually:
204
Pearl User Guide
7-2 Power Down and System Restart
1. Press and release the power button on the system to initiate a safe power down; the system shuts
down.
If the system is unresponsive, press and hold the power button for 4 seconds to force an
immediate power down.
205
Pearl User Guide
7-3 Save and Restore Device Configuration
7-3 Save and Restore Device Configuration
After completing configuration of your Pearl, it is good practice to save the system configuration so you may
restore it at a later date (i.e. after a change that wasn’t wanted, or after a factory reset) or so you may load it
onto another system to provision it with the same configuration.
This section covers the following topics:
l Save device configuration
l Load a saved device configuration
Save device configuration
Pearl's web interface allows you to save the current system configuration to your admin computer's hard drive.
It’s good practice to do this before making any major changes to a working configuration and before doing a
firmware update.
The resulting backup file includes all non-default configuration settings for the system, except the
user passwords which are reset when a configuration is restored.
To save the current system configuration:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
4. Click the Backup button next to Backup Current Configuration; the system performs a backup and
depending on your browser the file is either automatically downloaded or you are asked to save the file.
206
Pearl User Guide
7-3 Save and Restore Device Configuration
5. Save the file in a secure location.
6. Rename your saved configuration file to indicate the specifics of the configuration, if desired.
Load a saved device configuration
After making changes to the system configuration, you may find that the results are not what you expected or
that they serve a different need and you wish to return to a previous configuration. Via Pearl's web interface
you can load a previously saved configuration file.
Configuration files are by default named <serial number>.cfg. You may have more than one configuration file
saved from the system. Select the correct configuration file and know where it is accessible from your local
computer before starting this procedure.
Backup files include all non-default configuration settings for the system, except the user
passwords. All passwords are reset to blank after the configuration is loaded.
To load a saved system configuration:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
4. Click the Choose File button beside Restore Configuration from File; you are prompted to choose the
configuration file.
5. Select the desired configuration file from storage on your local computer and click Open.
6. Click the Restore button; the system configuration is restored and a new page appears asking you to
reboot the system.
207
Pearl User Guide
7-3 Save and Restore Device Configuration
7. Reboot the system by clicking the link in the message on the web page, or by using the power button
on the system; when the system comes back up the restoration is complete.
8. Login as admin (with no password).
9. Reset your user passwords. See Setting and Changing User Passwords.
208
Pearl User Guide
7-4 Restoring Factory Configuration
7-4 Restoring Factory Configuration
If you’ve been testing with your Pearl and are ready to restore back to the factory configuration to start again
with a clean slate, you can do this through the web interface.
This section covers the following topics:
l Restore Factory Configuration via the Web Interface
Restore Factory Configuration via the Web Interface
The web interface allows you to restore the factory configuration to return your Pearl back to the original
settings it had when you purchased it.
Restoring the factory settings erases everything on the system. This includes all your source
settings, channels, network settings, and all saved files.
Only proceed if you know this is what you want to do.
To restore the factory configuration via the web interface:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
4. Click the Restore button next to Restore Factory Configuration; a warning dialog appears asking you to
confirm the restoration.
209
Pearl User Guide
7-4 Restoring Factory Configuration
5. Click OK on the warning dialog; the system applies the factory configuration and reboots.
6. Wait for the system to reboot and begin re-configuration.
210
Pearl User Guide
7-5 Firmware Upgrade
7-5 Firmware Upgrade
Epiphan will from time to time issue an updated firmware revision to bring new features to your Pearl. To take
advantage of these new features, you will need to install the new firmware on the system. This section covers:
l Check for Firmware Updates
l Install firmware
Check for Firmware Updates
When you register your product with Epiphan you are given a choice to be notified of firmware updates for
your system. If you selected this choice, you will be notified of updates applicable to Pearl.
If your Pearl has internet access, you can check for updates directly by following the procedure below.
To check for new firmware:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Firmware Upgrade link in the Configuration menu; the firmware upgrade page opens.
4. Click the check for updates link next to your current firmware version; the system connects to Epiphan
servers to look for updates.
5. If an update is found a red box appears in the top left side of the web interface with a link to download
and install the firmware.
6. Follow the steps below to download and install the firmware.
Install firmware
When you’ve received a new firmware file from Epiphan’s support team, schedule a time where you can update
the firmware without negatively impacting viewers or file recordings.
211
Pearl User Guide
7-5 Firmware Upgrade
Installing new firmware takes a few minutes. Broadcasting and recording is not available until the
upgrade is complete.
There are two ways to install new firmware: from a the download link via the web interface, or from a file
provided by Epiphan.
While the firmware update is applied, the touch screen displays a firmware update in-progress notice and no
other interaction is possible.
Install Firmware Directly from the Web Interface:
If your Pearl has internet access, the easiest method of installing new firmware is to use the download link
provided when you check for new firmware.
To download new firmware directly:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Save a copy of the current system configuration, if desired. See Save and Restore Device Configuration.
4. Select the Firmware Upgrade link in the Configuration menu; the firmware upgrade page opens.
5. Click the check for updates link next to your current firmware version; the system connect to Epiphan
servers to look for updates.
6. Click download from the red box that appears at the top left of the admin interface; the firmware is
downloaded and immediately starts to install and the firmware update box changes to have a cancel
button.
7. The touch screen, if enabled, also displays a notice that the firmware update is in progress.
212
Pearl User Guide
7-5 Firmware Upgrade
Do not interrupt power to the system during the firmware upgrade.
8. When the firmware update is complete, the message lets you know it is going to reboot.
9. Wait for the system to restart. Depending on the upgrade, a disk rebuild may be required, causing the
restart process to take much longer than usual.
10. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
11. Login as admin.
12. Select the Firmware Upgrade link in the Configuration menu; the firmware upgrade page opens.
13. Verify that the firmware version is the expected new version.
Although unexpected, it is possible the firmware update fails. In this case, the touch screen reports the failure.
Please collect system information such as device serial number and, if known, the previous firmware version
along with the new firmware version and contact [email protected]
Install Firmware from a file
Before getting started, ensure you have the firmware file accessible from your admin computer.
213
Pearl User Guide
7-5 Firmware Upgrade
To install new firmware from a file:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Save a copy of the current system configuration, if desired. See Save and Restore Device Configuration.
4. Select the Firmware Upgrade link in the Configuration menu; the firmware upgrade page opens.
5. Note the current firmware version listed.
6. Click the Choose File button next to Select firmware upgrade file; a file selection box opens.
7. Select the firmware upgrade file from your local computer.
8. Click Apply; the file is uploaded. The system unpacks and verifies the file. If the file is valid, the upgrade
begins.
9. The touch screen, if enabled, also displays a notice that the firmware update is in progress.
Do not interrupt power to the system during the firmware upgrade.
10. Wait for the system to restart.
11. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
12. Login as admin.
13. Select the Firmware Upgrade link in the Configuration menu; the firmware upgrade page opens.
14. Verify that the firmware version is the expected new version.
Although unexpected, it is possible the firmware update fails. In this case, the touch screen reports the failure.
Please collect system information such as device serial number and, if known, the previous firmware version
along with the new firmware version and contact [email protected]
214
Pearl User Guide
7-5 Firmware Upgrade
215
Pearl User Guide
7-6 Remote Support
7-6 Remote Support
Pearl supports remote troubleshooting by Epiphan’s support team. Remote support allows Epiphan to assist in
troubleshooting issues you experience with the system and can also assist with resetting lost admin
passwords. No private information is sent to the Epiphan maintenance server.
Remote support is on by default.
This section describes procedures for the following topics:
l Configure Remote Support
l Disable Remote Support
Configure Remote Support
Remote support is configured by default to connect to the Epiphan maintenance server with the domain name
epiphany.epiphan.com. The system must be able to resolve this domain name to connect to the server and
permit remote support. Remote support uses port 30, therefore this port must be available for communication.
If your system is protected from the Internet by a firewall, speak to your network administrator to configure
the firewall appropriately.
To configure remote support:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
216
Pearl User Guide
7-6 Remote Support
4. Click Enable remote support if the check box is not selected. This setting controls incoming links from
Epiphan.
5. Click Enable connection to maintenance server if the check box is not selected. This setting configures
outgoing links to Epiphan.
6. Ensure the server address is epiphany.epiphan.com, unless Epiphan support directs you to change it.
7. Ensure the port is 30, unless Epiphan support directs you to change it.
8. Click Apply.
9. Test that the system can access the maintenance server:
a. Select the Network link under Configuration.
b. Type epiphany.epiphan.com Network Diagnostics box.
c. Click ping.
d. Ensure the result shows an IP address for epiphany.epiphan.com and report any packet loss to
Epiphan support.
10. If the system cannot reach the maintenance server, check the network settings (see Configure Network
Settings) to ensure DHCP is selected or a DNS server is listed and try again. Consult with your network
administrator if problems persist.
11. If the system reaches the maintenance server, ensure your firewall, if you have one, has port 30 open for
the system.
12. Confirm with Epiphan support that they are able to access your Pearl for remote troubleshooting.
217
Pearl User Guide
7-6 Remote Support
Disable Remote Support
By default, remote support is on. If you want to turn it off, you may use the following procedure.
Disabling remote support for Pearl removes the ability for Epiphan to reset a lost admin password.
If you forget the admin password and remote support feature is off, you will need to return the
system to Epiphan for reprogramming.
To disable remote support:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Maintenance link in the Configuration menu; the maintenance page opens.
4. Click Enable remote support check box to deselect it. This prevents incoming links from Epiphan.
5. Click Enable connection to maintenance server to deselect it. This prevents outgoing links to Epiphan.
6. Click Apply.
218
Pearl User Guide
7-7 Storage Disk Maintenance
7-7 Storage Disk Maintenance
Your Pearl is equipped with a hard drive for storage of recordings. Occasionally, maintenance is required for
these disks. This section describes procedures for the following topics:
l Check disk storage space
l Check disk storage space via the touch screen
l Schedule disk check
l Perform disk check
Check disk storage space
Pearl has a finite amount of storage This storage space holds a lot of recordings, but it can get full. It’s a good
idea to monitor your current disk usage.
If available storage is low, consider removing some unneeded recordings or setting up an automatic file
transfer with deletion after transfer. See File Maintenance and File and Recording Transfer.
Disk space can also be checked via the tablet interface. See Verify disk space via the tablet
interface.
To check disk storage space:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin or operator.
3. Check the Internal Storage section at the bottom of the menu column. The bar will be mostly green if
there is lots of space left, or mostly red if storage space is nearly full.
4. If available storage is low, take action to remove files as discussed in File Maintenance and File and
Recording Transfer.
219
Pearl User Guide
7-7 Storage Disk Maintenance
Check disk storage space via the touch screen
Pearl's touch screen can show you the system's disk space on the system information screen.
To show system information on the touch screen:
1. If the system information button does not appear on the screen, tap the screen once to turn on the
control buttons.
2. If the system information button is still not visible, it is disabled in the system's Touch screen
configuration. See Configure the Touch Screen to enable system information.
3. Touch the system information button (i)on the screen
.
To close the system information screen:
1. Touch anywhere on the screen to return to the previous screen.
Schedule disk check
A disk maintenance schedule is used to check the system storage drives for errors. Two values are supplied,
one to specify the number of system restarts that should occur before disk check, and the second to specify
the number of months before performing a disk check. The disk check happens based on whichever event
occurs first.
For example, the restart setting is set to 50 and the months setting is set to 6. If six months pass and less than
50 restarts happened, a disk check will occur on the next restart. However if you do 50 restarts in one month,
the disk check will happen after the fiftieth restart.
Disk check occurs during start up and can cause a lengthy delay in starting up the system.
To set the disk check schedule:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
220
Pearl User Guide
7-7 Storage Disk Maintenance
3. Select the Disk Check link in the Configuration menu; the disk maintenance page opens.
4. Set the number of restarts to occur before the next check. Set to 0 if you don’t want to force a disk
check after a specific number of restarts.
5. Set the number of months to pass before the next check. Set to 0 if you don’t want to force a disk
check after a specific number of months.
6. Click Save.
Perform disk check
A disk maintenance schedule is used to periodically check the system storage drives for errors. If you prefer,
you can run the disk check manually at a time that is convenient for you.
Running the disk check manually resets the timers for the scheduled disk check (i.e. next check won’t happen
automatically until either the number of restarts or months passes).
If the system is recording when you start a disk check, it will stop recording and resume after the
check is complete. Frames presented during the disk check are not captured and are not part of
any recording.
To start a manual disk check:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Disk Check link in the Configuration menu; the disk maintenance page opens.
4. Click the Check Now button; a new page opens showing you the progress of the disk check.
Do not interrupt power to the system during the disk check.
5. When the disk check is complete, the main page returns and a summary is shown.
6. If any unrecoverable errors are detected, contact Epiphan support.
221
Pearl User Guide
7-8 Control with RS-232 / Serial Port
7-8 Control with RS-232 / Serial Port
Pearl presents an RS-232 / serial port control interface (via USB) for integration with existing control room and
board room equipment. This section covers the following topics:
l Connect and configure the RS-232 cable
l Control Pearl with RS-232
l RS-232 / Serial port command examples
Connect and configure the RS-232 cable
To connect your control equipment to Pearl you will need a standard RS-232 null-modem cable and a USB to
RS-232 serial adapter cable. Adapter cables are not included with Pearl. Only certain adapter chipsets are
supported, Epiphan recommends this adapter cable from Startech.
To connect the serial port cable:
1. Attach the null modem cable to the control interface.
2. Connect the USB to RS-232 serial adapter to the null-modem cable.
3. Connect the USB to RS-232 serial adapter to one of the system’s USB ports.
The only configuration available for the serial port is flow control. Flow control changes the rate of data
transfer over the cable. Some communication settings are static and cannot be changed. The static settings
are:
l Baud rate set at 19200
l Parity set to none
l Stop bits set to one
To configure serial port flow control:
1. Connect to the admin interface using your preferred connection mechanism. See Connect to the Admin
Interface.
2. Login as admin.
3. Select the Serial Port link in the Configuration menu; the serial port configuration page opens.
4. Select Hardware, Software, or None from the drop-down menu. Refer to the table below for a
description of the options.
222
Pearl User Guide
7-8 Control with RS-232 / Serial Port
Table 26 Serial Port Flow Control Options
Label
Description / Options
Hardware
A hardware handshake mechanism is used for flow control. This is also called RTS / CTS flow
control. Select this when your control terminal requires it (see control terminal manual).
Software
A software handshake that uses XON/XOFF characters to control the flow of data. Select this
when your control terminal requires it (see control terminal manual).
None
No flow control is used. Only select this if your control terminal requires it (see control
terminal manual).
5. Click Apply.
Control Pearl with RS-232
You can use the null-modem cable and your control terminal software to issue commands to Pearl such as
when to start or stop recording, or to retrieve or set the value for various settings.
Each command sent to the Pearl via RS 232 must be terminated with a line feed (LF) character
(ASCII code 10). Your software may need to be configured to add the line feed to each command.
Some commands require a channel or recorder name as an argument. In those commands, the channel or
recorder name is separated from the command name by a period, as shown in the table. The channel name
value can be either the name or the index of the recorder or channel. Use of the index is recommended. A
channel’s index is found on the Status page. In the screen capture below, the channel index is 2.
For commands requiring a recorder index, determine your recorder's index by combinging the recorder's
number with the prefix m. The recorder's number is found in the URL of the Recorder page. In the example
below, the recorder's number is 1. To access this recorder via RS232 commands, use the index m1.
223
Pearl User Guide
7-8 Control with RS-232 / Serial Port
Channel and recorder numbers can also be seen in the web interface next to the channel or recorder name. For
example, in the example below where channel 1 is recording, the red number 1 is the channel number.
The table describes the RS-232 commands supported by Pearl.
Table 27 Supported RS-232 Commands
Command Name
Description
Recording Commands
START.<channel>
START.<recorder>
Starts recording for the provided channel or recorder. This can alternatively be
accomplished with the following set commands:
SET.<channel>.rec_enabled=on
SAVECFG
If the channel is already recording, the current recording file is closed and a new file
is started.
START
Starts recording for all channels and recorders.
For channels already recording, the current recording file is closed and a new file is
started.
224
Pearl User Guide
7-8 Control with RS-232 / Serial Port
Command Name
Description
STOP.<channel>
Stops recording for the provided channel or recorder. This can alternatively be
accomplished with the following set commands:
START.<recorder>
SET.<channel>.rec_enabled=""
SAVECFG
STOP
Stops recording for all channels and recorders.
SNAPSHOT.<channel> Takes a snapshot image of the current channel (supported only if the channel is
configured to use the Motion JPEG codec). Snapshots are saved with recording files
on the system.
SNAPSHOT
Takes a snapshot image of all channels (supported only for channels configured to
use the Motion JPEG codec). Snapshots are saved with recording files on the
system.
Configuration Commands (see Configuration Keys for Third Party APIs for available keys)
GET.<channel>.<key>
Gets the saved value of a given parameter for the specified channel.
SET.<channel>.<key>
Sets the value of a given parameter for the specified channel. The value is not saved
until the SAVECFG command is sent.
SAVECFG
Saves the parameters modified by the SET command.
Status Commands
STATUS.<channel>
Reports the recording status of the specified channel or recorder.
STATUS.<recorder>
Status is one of:
l RUNNING
l STOPPED
l UNINITIALIZED
STATUS
Reports the recording status of each channel.
Status is one of:
l RUNNING
l STOPPED
l UNINITIALIZED
FREESPACE
Reports the free storage space, in bytes.
RECTIME.<channel>
Reports the elapsed recording time for the current file on the specified channel.
225
Pearl User Guide
7-8 Control with RS-232 / Serial Port
Command Name
Description
RECTIME
Reports the elapsed recording time for the current file on each channel.
Additionally, the system reports its status changes back along the RS-232 connection using the following
messages:
Table 28 RS-232 Status Changed Messages
Command Name
Description
STATUS.<channel> <status>
Provides the status of the recording service for the channel's as one of:
l Running
l Stopped
l Uninitialized
The Uninitialized status is sent when there is an internal error. Check the
system for more details.
RS-232 / Serial port command examples
The following examples demonstrate how to use some of the RS-232 commands supported by the system. The
list of supported SET and GET parameters are found in Configuration Keys for Third Party APIs .
For values with spaces, enclose the value in quotation marks. For empty values, use empty quotation marks
with nothing between.
1. To start recording on channel 2:
START.2
2. To stop recording on channel 2:
STOP.2
3. To start recording on all channels:
START
4. To get the value of the frame size (resolution) for channel 2:
GET.2.framesize
226
Pearl User Guide
7-8 Control with RS-232 / Serial Port
5. To set the frame size (resolution) on channel 2, enclose the parameter in quotes to preserve the spaces:
SET.2.framesize="640 x 480"
SAVECFG
6. To enable broadcasting audio on channel 2:
SET.2.audio=on
SAVECFG
7. To disable broadcasting audio on channel 2:
SET.2.audio=""
SAVECFG
227
Pearl User Guide
7-9 Control with HTTP Commands
7-9 Control with HTTP Commands
Pearl has an HTTP API interface for configuration and control by a third party application or with a script that
sends commands to the system as a series of URLs. This section covers the following topics:
l HTTP command syntax
l HTTP command examples
HTTP command syntax
Control of Pearl by HTTP is done by sending commands to one of two URLs and specifying the target
configuration item. Syntax for the get and set commands follows.
To Get configuration settings:
http://<address>/admin/channel<N>/get_params.cgi?key
To Set configuration settings:
http://<address>/admin/channel<N>/set_params.cgi?key=value
Where <address> is the IP address of the system, channel<N> is the channel number (i.e. channel2 for channel
number two), key is the key for the configuration item being checked or changed (see the list in
Configuration Keys for Third Party APIs ), and value is the value to set for the configuration item.
Multiple Requests at Once
You can include multiple key/value pairs in a single command by separating the statements with &.
For example, the key for product name is product_name and the key for firmware version is firmware_version.
To send a request for both the product name and the firmware version, use the following command:
http://<address>/admin/channel1/get_params.cgi?product_name&firmware_version
Or, to set the stream type (streamtype) to ASF and the bitrate (vbitrate) to 256,000:
http://<address>/admin/channel1/set_params.cgi?streamtype=2&vbitrate=256K
228
Pearl User Guide
7-9 Control with HTTP Commands
Third party applications like wget
If you’re using a third party application like wget to send commands to the system, always include the admin
username and password when viewing or setting configuration items.
The syntax for wget commands is shown below. Specify your system’s IP address, password and the key(s) or
value(s) you wish to query. Note your system may require use of single quotes around the password to handle
special characters such as exclamation marks.
get_param using wget:
wget --http -user=admin --http-password=<password> http://<address>/admin/channel<N>/get_
params.cgi?<key>[&<key>]
set_param using wget:
wget --http -user=admin --http-password=<password> http://<address>/admin/channel<N>/set_
params.cgi?<key>=<value>[&<key>=<value>]
HTTP command examples
Some configuration of Pearl can be done by non-interactive http commands. The following examples
demonstrate how to use wget to exercise some of the HTTP commands supported by the system.
For values with spaces, encode space as %20. i.e.: set_params.cgi?framesize=640%20x%20480
The examples assume a system IP address of 192.30.23.45 and admin password pass123.
1. To get the broadcast stream type and frame size for channel 1:
wget --http-user=admin --http-passwd=pass123 http://192.30.23.45/admin/channel1/get_
params.cgi?streamtype&framesize
2. To set the broadcast stream to ASF and at the title “System Stream” for channel 2:
wget --http-user=admin --http-passwd=pass123 http://192.30.23.45/admin/channel2/set_
params.cgi?streamtype=2&title=System%20Stream
3. To start recording on channel 2:
229
Pearl User Guide
7-9 Control with HTTP Commands
wget --http-user=admin --http-passwd=pass123 http://192.30.23.45/admin/channel2/set_
params.cgi?rec_enabled=on
4. To stop recording on channel 2:
wget --http-user=admin --http-passwd=pass123 http://192.30.23.45/admin/channel2/set_
params.cgi?rec_enabled=""
230
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
7-10 Configuration Keys for Third Party APIs
Using HTTP or RS-232, you can send commands to the system to query or configure the system. For the RS-232
and HTTP syntax see Control with RS-232 / Serial Port and Control with HTTP Commands.
When setting keys to values with spaces use the following syntax.
For RS-232:
Enclose in quotes: SET.2.framesize="640 x 480"
For HTTP:
Encode each space as %20: set_params.cgi?framesize=640%20x%20480
The following sections describe the API keys supported by the system in each of these categories:
l System-level Settings Keys(Read-only)
l System-level Settings Key (Read/Write)
l Recording Configuration Keys
l Configuration Keys for Third Party APIs
l IP-Based Access Control Configuration Keys
l UPnP Configuration Keys
l Frame Grabber Configuration Keys
l Broadcast Configuration Keys
l Channel Encoder Configuration Keys
l Channel Logo Configuration Keys
l Configuration Keys for Third Party APIs
l Audio Configuration Keys
l Stream Publishing Configuration Keys
l Configuration Keys for Third Party APIs
l RTP/UDP Configuration Keys (Publish Type 3)
l MPEG-TS Configuration Keys (Publish Types 4 and 5)
l Content Metadata Configuration Keys
231
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
The list of supported keys is also available for viewing from your system. Browse to the following URL (where
<address> is the IP address of the system):
http://<address>/admin/http_api.cgi
System-level Settings Keys(Read-only)
The following read-only system-level setting keys are supported. The channel number can be omitted from the
command when requesting the value for these keys.
Table 29 Supported Read-Only System-level Settings Configuration Keys
Key
Values
Description
firmware_version
String, including the
text FIRMWARE_
VERSION=.
The system’s firmware version.
The value is read-only.
mac_address
String
The system’s mac address. Useful for debugging.
The value is read-only.
product_name
String
The product’s name.
Useful to confirm you are communicating with the right product
or for debugging purposes.
The value is read-only.
vendor
Epiphan Systems Inc.
Name of the vendor.
The value is always “Epiphan Systems Inc.”.
The value is read-only.
System-level Settings Key (Read/Write)
The following read/write system-level setting keys are supported. The channel number can be omitted from the
command when requesting the value for these keys.
Table 30 Supported Read/Write System-level Settings Configuration Keys
Key
Values
Description
frmcheck_
enabled
on
empty string ("")
Enables or disables automatic firmware update checking.
To enable firmware update checking, set to on.
To disable firmware update checking, set to an empty string ("").
232
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Recording Configuration Keys
The following recording settings are supported.
Table 31 Supported Recording Configuration Keys
Key
Values
Description
rec_enabled
on
empty string ("")
Enables or disables recording.
To enable recording, set to on.
To disable recording, set to an empty string ("").
rec_format
avi
mov
ts
Specifies the format of the saved file.
rec_prefix
string
Specifies a prefix for the recording files.
rec_sizelimit
integer
Specifies the file size limit, in kilobytes (kB).
rec_stop_if_no_
signal
on
empty string ("")
Specifies whether the recording should stop if no signal is
detected.
To auto-stop when no signal, set to on.
To continue recording even if there is no signal, set to an empty
string ("").
rec_timelimit
integer
Specifies the time limit, in seconds, before a new recording file is
created.
HTTP Server Configuration Keys
The following settings are supported for configuration of the HTTP server run by the system.
Table 32 Supported HTTP Server Configuration Keys
Key
Values
Description
http_port
integer
Specifies the HTTP server port.
http_sport
integer
Specifies the HTTP server SSL port (HTTPS port).
http_usessl
integer
Enables or disables HTTPS (SSL Server)
To enable SSL, set to on.
To disable SSL, set to an empty string ("").
233
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
IP-Based Access Control Configuration Keys
The following settings are supported for configuring allowed and denied IP addresses for the system. See
Configure Network Settings for more information on Allow and Deny lists.
Table 33 Supported IP-Based Access Configuration Keys
Key
Values
Description
allowips
string: commaseparated list of
IP addresses and/or
ranges.
empty string("")
Specifies the IP addresses to permit access.
To restrict access, provide a list of permitted IP addresses.
To clear allowed IP restriction, set to an empty string ("").
denyips
string: commaseparated list of
IP addresses and/or
ranges.
empty string("")
Specifies the IP addresses to deny access.
To restrict access, provide a list of denied IP addresses.
To clear denied IP restriction, set to an empty string ("").
UPnP Configuration Keys
The following settings are supported for UPnP streaming.
Table 34 Supported UPnP Streaming Configuration Keys
Key
Values
Description
share_archive
on
empty string ("")
Enables sharing of recorded files via UPnP.
To enable sharing files over UPnP, set to on.
To disable sharing files over UPnP, set to an empty string ("").
share_livestreams
on
empty string ("")
Enables sharing of the live stream via UPnP.
To enable stream sharing over UPnP, set to on.
To disable stream sharing over UPnP, set to an empty string ("").
server_name
string
Specifies the UPnP server name.
To use the system name, set to an empty string ("").
Frame Grabber Configuration Keys
The following configuration settings are supported by the system. See Configure a video sourcefor more
information on each variable.
234
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Table 35 Supported Frame Grabber Configuration Keys
Key
Values
Description
gain
0...255
Specifies ADC gain adjustments.
0 is brightest, 255 is darkest.
hshift
-999...999
Specifies horizontal shift.
For shifts to the left, use positive values.
For shifts to the right, use negative values.
offset
0...63
Specifies ADC offset.
0 is brightest, 63 is darkest.
phase
0...31
Specifies phase adjustments for VGA signals. Generally not used
unless value is provided by Epiphan support.
pll
-999...999
Specifies PLL adjustment.
Changes the number of pixels in the line.
tune_interval
0...9999
Specifies the number of auto-adjustments in the interval.
To disable auto-adjustments, set to 0.
vshift
-20...20
Specifies vertical shift.
For shifts up, use positive values.
For shifts down, use negative values.
Broadcast Configuration Keys
The following broadcast configuration settings are supported.
Table 36 Supported Broadcast Configuration Keys
Key
Values
Description
bcast_disabled
on
empty string ("")
Enables or disables the broadcast.
To disable broadcast, set to on.
To enable broadcast, set to empty string ("").
rtsp_port
1000...65535,
but not 5557
Specifies the port for RTSP streaming. Note port 5557 is used for
network discovery and cannot be used for streaming.
streamport
1000...65535,
but not 5557
Specifies the port used for streaming. Note port 5557 is used for
network discovery and cannot be used for streaming.
235
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Channel Encoder Configuration Keys
The following channel encoder configuration settings are supported. For more information on individual items
listed, see Configure channels.
Table 37 Supported Channel Encoder Configuration Keys
Key
Values
Description
autoframesize
on
empty string ("")
Enables or disables use of the current signal’s resolution as the
frame size. Is switched to off if a frame size is manually specified.
To use current signal’s frame size, set to on.
To specify frame size directly, set to empty string ("").
codec
h.264
mpeg4
mjpeg
Specifies the stream codec.
fpslimit
1-60
Specifies the frame per second limit.
Set to your desired limit.
framesize
640 x 480
720 x 400
720 x 480
720 x 576
768 x 576
1024 x 768
1152 x 864
1280 x 720
1280 x 768
1280 x 960
1280 x 1024
1360 x 768
1360 x 1024
1600 x 1200
1920 x 1200
2048 x 2048
2560 x 1600
Specifies the frame size in pixels.
on
filename
empty string ("")
Enables or disables the “No Signal” message if no signal is
found.
To use the default no signal message, set to on.
To use a custom no signal message, specify the filename (file
must already be uploaded to the system ).
To disable the no signal message, set to empty string ("")
nosignal
Set to desired size, refer to description above on handling white
space in the value.
236
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Key
Values
Description
timelabel
none (no date)
date (date alone)
hms (time alone)
date_hms (date and
time)
hms_ms (time to ms)
date_hms_ms (date
and time to ms)
Specifies the time label on the stream.
To have no time label, set to ‘none’.
slicemode
on empty string ("")
Enables or disables h.264 slicing for RTP. To enable slicing, set to
on. To disable slicing, set to empty string ("").
vbitrate
Integer
integerK (i.e. 64K)
integerM (i.e. 1M)
Gets or changes the video bit rate in kbit/s.
Short forms such as 64K or 1M can be used.
vbufmode
1 (low delay)
2 (storage)
Specifies the broadcast compression level.
For low delay when streaming, specify 1.
For best results or recording, set to 2.
vencpreset
0 (default)
1 (High quality)
2 (High speed)
Specifies a video encoding preset.
For the default (balanced) setting, set to 0.
To prioritize quality over speed, set to 1.
To prioritize speed over quality, set to 2.
videosource
string
Video source string for multi-channel systems.
vprofile
66
77
100
Specifies the h.264 video profiles.
For Baseline profile, select 66.
For Main profile, select 77.
For High profile, select 100.
qvalue
0...100
Specifies quality for M-JPEG videos.
Channel Logo Configuration Keys
The following options are supported for querying or modifying channel logo settings.
237
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Table 38 Supported Channel Logo Configuration Keys
Key
Values
Description
logo_margin_x
0…frame width
Specifies the horizontal offset in pixels from the position in
logo_position.
To offset 10 pixels from the left (when using a top-left logo
position), set to 10.
logo_margin_y
0…frame height
Specifies the vertical offset in pixels from the position in logo_
position.
To offset 20 pixels from the top (when using a top-left logo
position), set to 20.
logo_position
lt
lb
rt
rb
Specifies the logo position on the screen (prior to tweaks from
margins x and y).
To have the logo at the left-top, set to lt.
To have the logo at the left-bottom, set to lb.
To have the logo at the right-top, set to rt.
To have the logo at the right-bottom, set to rb.
logo_src
string
Specifies the logo source file name. The file must already be
uploaded to the system.
Audio Configuration Keys
The following audio configuration keys are supported. For more information on individual items listed, see
Configure channels.
Table 39 Supported Audio Configuration Keys
Key
Values
Description
audio
on
empty string ("")
Enables or disables audio for the stream.
To enable audio, set to on.
To disable audio, set to an empty string ("").
audiochannels
1 (mono)
2 (stereo)
Specifies the number of audio channels.
For mono, set to 1.
For stereo, set to 2.
238
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Key
Values
Description
audiopreset
CODECS:
pcm_s161e (PCM)
pcm_alaw (G.711 a-law)
pcm_mulaw (G.711 u-law)
libmp3lame (MP3)
libfacc (AAC)
Specifies an audio code preset in the format CODEC;RATE.
i.e. libfaac;128
RATES:
32
64
96
112
128
160
192
Stream Publishing Configuration Keys
The system supports the following stream publishing settings. For more information on publishing the stream,
see Stream your video.
Table 40 Supported Stream Publishing Configuration Keys
Key
Values
Description
publish_type
0 (do not publish)
1 (via Epiphan.tv)
2 (RTSP Announce)
3 (multicast RTP/UDP)
4 (multicast MPEG-TS
over UDP)
5 (multicast MPEG-TS
over RTP/UDP)
6 (RTMP push)
Specifies the type of stream publishing, if any.
RTSP Announce Configuration Keys (Publish Type 2)
The following settings are supported when the publish type is set to RTSP Announce. For more information on
RTSP and these settings, see Stream your video.
239
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Table 41 Supported RTSP Announce Configuration Keys
Key
Values
Description
announce_by_tcp
on
empty string ("")
Enables or disable RTSP over TCP. To enable TCP transport, set
to on. Otherwise, set to empty string ("").
announce_host
string
Specifies the RTSP server address. Set to the appropriate IP
address.
announce_name
string
Specifies the RTSP resource name.
announce_
password
string
Specifies the password for the RTSP server's user.
announce_port
1000...65535,
but not 5557
Specifies the RTSP server port to connect to for streaming. Note
port 5557 is used for network discovery and cannot be used for
streaming.
announce_
username
string
Specifies the username for the RTSP server. Value is provided by
the RTSP server.
RTP/UDP Configuration Keys (Publish Type 3)
The following settings are supported when the publish type is set to RTP/UDP. For more information on
RTP/UDP and these settings, see Stream your video.
Table 42 Supported RTP/UDP Configuration Keys
Key
Values
Description
unicast_address
string (IP address)
Specifies the unicast/multicast address.
unicast_aport
1000...65535,
but not 5557
Specifies the UDP port for RTP/UDP audio streaming. Note port
5557 is used for network discovery and cannot be used for
streaming.
unicast_vport
1000...65535,
but not 5557
Specifies the UDP port for RTP/UDP video streaming. Note port
5557 is used for network discovery and cannot be used for
streaming.
MPEG-TS Configuration Keys (Publish Types 4 and 5)
The following settings are supported when the publish type is set to MPEG-TS. For more information on MPEGTS and these settings, see Stream your video.
240
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Table 43 Supported MPEG-TS Configuration Keys
Key
Values
Description
unicast_address
string (IP address)
Specifies the unicast/multicast address.
unicast_mport
1000...65535,
but not 5557
Specifies the UDP port for MPEG-TS streaming. Note port 5557 is
used for network discovery and cannot be used for streaming.
RTMP Push Configuration Keys (Publish Type 6)
The following settings are supported when the publish type is set to RTMP Push. For more information on
RTMP and these settings, see Stream your video.
Table 44 Supported RTMP Annouce Configuration Keys
Key
Values
Description
announce_host
string
Specifies the RTMP server address. Set to the appropriate IP
address.
announce_name
string
Specifies the RTMP resource name.
announce_
password
string
Specifies the password for the RTMP server's user.
announce_port
1000...65535,
but not 5557
Specifies the RTMP server port to connect to for streaming.
Note port 5557 is used for network discovery and cannot be
used for streaming.
announce_
username
string
Specifies the username for the RTMP server. Value is provided by
the RTMP server.
Content Metadata Configuration Keys
The following keys are available for configuration of the content's metadata.
Table 45 Supported Content Metadata Configuration Keys
Key
Values
Description
author
string
Specifies the name of the author for the broadcast video. Refer
to description above on handling white space (spaces) in the
string.
241
Pearl User Guide
7-10 Configuration Keys for Third Party APIs
Key
Values
Description
comment
string
Specifies a comment for the broadcast video. Refer to
description above on handling white space (spaces) in the
string.
copyright
string
Specifies the copyright for the broadcast video. Refer to
description above on handling white space (spaces) in the
string.
title
string
Specifies the title for the broadcast video. Refer to description
above on handling white space (spaces) in the string. (This
string can be displayed by certain viewing applications by
looking at the stream's metadata information.)
242
Pearl User Guide
7-11 Troubleshooting
7-11 Troubleshooting
Use the follow table for help if you are experiencing problems or unexpected behavior from your Pearl.
Problem
Action(s) to Resolve
Not sure if the connected video inputs are Check each source's input from the source preview in the Web
being captured.
Interface. See Configure a video source.
OR
Check the touchscreen interface to view confidence monitoring
for each channel. See Channel monitoring and switching.
No sound is coming from an audio
source.
Verify that you are using the correct audio input by following
the steps in Configure an audio source.
OR
Check the touchscreen interface for audio monitoring. See
Channel monitoring and switching
Too much noise is present in the audio
output.
Modify the Input Amplifier Volume parameter in the Audio
menu. Start with setting it to 40% and reduce until the noise is
no longer present. See Set audio volume for details on this
setting.
Image quality is poor or insufficient.
The following tips can help improve image quality:
1. Ensure the source resolution is used as the output or
recorded resolution. Up-scaling and down-scaling can
affect picture quality. See Upscale or downscale your
video image.
2. Increase the Bitrate value and/or decrease the Limit
frame rate value in the Encoding menu. See Adjust video
quality .
243
Pearl User Guide
7-11 Troubleshooting
Problem
Action(s) to Resolve
Frames per second are lower than
expected.
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 Adjust video
quality .
2. Reduce the number of actions happening simultaneously
on 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.
4. Reduce the number of channels encoding data.
5. Ensure a hardware-accelerated H.264 encoding preset is
chosen for allchannels.
Stream won't play in my media player or
browser.
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
Viewing with a web browser and Viewing with a media player.
If you still cannot see the stream, try disabling your local
computer firewall.
If the issue is still not resolved, contact Epiphan Support at
[email protected]
The stream interrupts or the image
breaks up.
The following tips can help diagnose image problems:
1. Ensure the source resolution is used as the output or
recorded resolution. Up-scaling and down-scaling can
affect picture quality. See Upscale or downscale your
video image.
2. Increase the Bitrate value and/or decrease the Limit
frame rate value in the Encoding menu. See Adjust video
quality .
3. Check network settings including filters, routers and
application settings. Packet loss can result in stream
failure.
Recording issues.
If recording will not start, check the Disk Status Information to
see if the system is out of disk space. See Check disk storage
space and File Maintenance.
244
Pearl User Guide
7-11 Troubleshooting
Problem
Action(s) to Resolve
Firmware upgrade fails.
Reboot the system and try again. If the problem persists,
contact Epiphan support at [email protected]
245
Software and Documentation License
ATTENTION: THE SOFTWARE AND DOCUMENTATION PROVIDED UNDER THIS AGREEMENT ARE BEING
LICENSED TO YOU BY EPIPHAN SYSTEMS INC. (“LICENSOR”) AND ARE NOT BEING SOLD. THIS AGREEMENT
CONTAINS LIMITATIONS 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 NOT ACCEPT 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 AND
DOCUMENTATION ARE ALSO PROTECTED BY COPYRIGHT LAWS AND INTERNATIONAL COPYRIGHT TREATIES,
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 Software License;
“Documentation” means the technical publications delivered to You with the Software relating to the
installation and operation of the Software, such as reference, user, installation and technical guides and
release notes;
“Epiphan” means Epiphan Systems Inc.;
“Software” means the Licensor binary and/or bytecode software programs that (i) are made available to You
for download after acceptance of this Agreement, (ii) are packaged with this Agreement, or (iii) pre-installed on
Epiphan products, or (iv) embed this Agreement in their installer(s) and which are installed after acceptance of
this Agreement, and which binary and/or bytecode software programs include any Documentation; and
“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.
2. Grant of Software License: Subject to the terms and conditions of this Agreement, Licensor grants You a
non-exclusive, non-transferable, non-sublicensable, internal license to use a reasonable number of copies of
the Software. 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 other rights 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 be embedded in or distributed with the Software (“Open Source Software”). If a separate license
246
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 at www.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 to those receiving only executable versions of such free software. If the source code for any free
software distributed with the Software is not provided with the Software, then upon request, within a three (3)
year period from the original receipt 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 for such free software to You.
4. Restrictions: The terms set forth in this Section 4 shall constitute conditions to the licenses granted in
Section 2. You shall not reverse engineer, disassemble, reverse translate, decompile or in any other manner
decode the 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 source code of the Software are granted to You. You acknowledge and agree that
the rights in respect to use of the Software and Documentation are granted only for use in conjunction with
Epiphan hardware. 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. You shall not use the
Software or make the Software 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.
5. Disclaimer of Warranties: Licensor does not make any representations or provide any warranties or
conditions in respect to the Software. EXCEPT FOR ANY WARRANTIES THAT MAY BE PROVIDED IN ANY
COMMERCIAL AGREEMENT BETWEEN YOU AND LICENSOR, THE SOFTWARE AND DOCUMENTATION
ARE PROVIDED “AS IS”, WITHOUT ANY REPRESENTATIONS, CONDITIONS, OR WARRANTIES OF ANY
KIND. WITHOUT LIMITATION, LICENSOR AND ITS LICENSORS, SUPPLIERS, SUBCONTRACTORS AND
DISTRIBUTORS DISCLAIM ANY EXPRESS OR IMPLIED REPRESENTATIONS, CONDITIONS, AND/OR
WARRANTIES OF MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, DURABILITY,
TITLE, SATISFACTORY QUALITY, 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 AGREEMENT, THE ENTIRE RISK OF THE USE OF THE SOFTWARE AND
DOCUMENTATION SHALL BE BORNE BY YOU. EXCEPT AS OTHERWISE EXPRESSLY PROVIDED IN ANY
COMMERCIAL AGREEMENT, NEITHER LICENSOR NOR ANY OF ITS LICENSORS, SUPPLIERS,
SUBCONTRACTORS AND/OR DISTRIBUTORS MAKE ANY REPRESENTATIONS OR PROVIDE ANY
CONDITIONS AND/OR WARRANTIES ABOUT THE SUITABILITY OF THE SOFTWARE AND/OR
DOCUMENTATION OR ABOUT ANY INFORMATION AND/OR DATA THAT MAY BE PROCESSED BY OR
MADE AVAILABLE USING THE SOFTWARE.
6. LIMITATION OF LIABILITY: NEITHER LICENSOR NOR ANY OF ITS LICENSORS, SUPPLIERS,
SUBCONTRACTORS AND/OR DISTRIBUTORS SHALL HAVE ANY LIABILITY TO YOU OR ANY OTHER
247
PERSON OR ENTITY FOR ANY DAMAGES ARISING FROM THIS AGREEMENT, RELATING TO THE
SOFTWARE OR DOCUMENTATION, OR RELATING TO ANY SERVICES PROVIDED TO YOU BY LICENSOR
(INCLUDING ITS LICENSORS, SUPPLIERS, SUBCONTRACTORS AND/OR DISTRIBUTORS) IN RELATION TO
THE 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 INTERUPTION, 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 LICENSORS, SUPPLIERS,
SUBCONTRACTORS AND DISTRIBUTORS) HAS 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 ITS
LICENSORS, SUPPLIERS, SUBCONTRACTORS AND DISTRIBUTORS) TO YOU OR ANY OTHER PERSON OR
ENTITY FOR ANY DAMAGES ARISING FROM THIS AGREEMENT, RELATING TO THE SOFTWARE,
DOCUMENTATION AND/OR RELATING TO ANY SERVICES PROVIDED TO YOU BY LICENSOR
(INCLUDING ITS LICENSORS, SUPPLIERS, SUBCONTRACTORS AND DISTRIBUTORS) IN RELATION TO
THE SOFTWARE AND/OR DOCUMENTATION, EXCEED THE LICENSE FEES PAID BY YOU FOR THE
SOFTWARE.
THE DISCLAIMER OF REPRESENTATIONS, WARRANTIES AND CONDITIONS AND LIMITATION OF
LIABILITY CONSTITUTE 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 LICENSORS OR SUPPLIERS 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 terminated sooner as provided in this Section 7. You may terminate this Agreement by destroying all copies
of the Software and Documentation 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 after Licensor 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. In addition to this Section, the Sections entitled Definitions, Disclaimer
of Warranties, Limitation of Liability, Title, High-Risk Activities, Intellectual Property, and General 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 affect any obligations You may have to pay any outstanding
amounts owing to Licensor. Upon any termination by Licensor, 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. Use of any updates or enhancements
to the Software provided pursuant to any technical support You may procure from Licensor shall be governed
by the terms and conditions of this Agreement. Licensor reserves the right at any time not to release or to
248
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. High-Risk Activities: The Software is not fault-tolerant and is not designed, manufactured or intended for
use in or in conjunction with on-line control equipment in hazardous environments requiring fail-safe
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 and distributors specifically
disclaim any express or implied representations, warranties and/or conditions for such uses.
11. 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 such terms 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 and
Documentation consistent 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 Software and Documentation is further restricted by the terms and conditions of
this Agreement. For the purposes of any applicable government use, the 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.
12. Export Restrictions: The Software, Documentation and related information are subject to export and
import restrictions. By downloading, installing, or using the Software, Documentation and/or related
information, You are representing and warranting that You are not located in, are not under the control of,
and are not a national or resident of any country to which the export of the 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 Software,
Documentation or related information would be prohibited by the laws and/or regulations of Canada or the
United States. You shall comply with the export laws and regulations of Canada and the United States that are
applicable to the 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 Software,
Documentation or related information, and You represent and warrant that You have complied with any such
applicable laws and/or regulations. The Software, Documentation and related information shall not be used for
any purposes prohibited by export laws and/or regulations, including, without limitation, nuclear, chemical, or
biological weapons proliferation. You shall be responsible for procuring all required permissions for any
subsequent export, import, or use of the Software, Documentation or related information.
13. Intellectual Property: Epiphan is a trademark or a registered trademark of Epiphan Systems Inc. in certain
countries. All Licensor product names and logos are trademarks or registered trademarks of Epiphan Systems
Inc. in certain countries. All other company and product names and logos are trademarks or registered
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.
14. General: This Agreement is the entire agreement between You and Licensor in respect to the Software,
superseding any other agreements or discussions, oral or written. The terms and conditions of this Agreement
shall prevail over any pre-printed terms on any quotes, orders, purchase orders, or purchase order
acknowledgements, and shall prevail over any other communications between the parties in relation to the
249
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 timewithout notice. The failure of a
party to claim a breach of any term of this Agreement shall not constitute a waiver of such breach or the right
of such party to enforce any subsequent breach of such term. If any provision of this Agreement is held to be
unenforceable or illegal, such decision shall not affect the validity or enforceability of such provisions under
other circumstances or the remaining provisions of this Agreement and such remaining provisions shall be
reformed only to the extent necessary to make them enforceable under such circumstances. This Agreement
shall be governed by the laws of the Province of Ontario and the laws of Canada applicable therein. No choice
or conflict of laws rules of any jurisdiction shall apply to this Agreement. You shall only be entitled to bring any
action or proceeding arising out of or relating to this Agreement, the Software, Documentation or any services
provided in respect to the Software and/or Documentation in a court in Ottawa, Ontario, Canada, and You
consent to the jurisdiction of such courts for any such action or proceeding. You waive all rights that You may
have or that may hereafter arise 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 Software or any services provided in respect to the Software. The
application of the United Nations Convention on Contracts for the International Sale of Goods to this
Agreement is expressly excluded.
March 28, 2014
Environmental Information
The equipment that you bought has required the extraction and use of natural resources for its production. It
may contain hazardous substances that could impact health and the environment. In order to avoid the
dissemination of those substances in our environment and to diminish the pressure on the natural resources,
we encourage you to use the appropriate take-back systems. Those systems will reuse or recycle most of the
materials of your end life equipment in a sound way. The crossed-out 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 the environmental
performance of our products.
FCC & CE Compliance Statement
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.
Marking by the symbol
indicates compliance of this device with EMC directive of the European Community
and meets or exceeds the following technical standard.
EN 55022 - Limits and Methods of Measurement of Radio Interference Characteristics of Information
Technology Equipment.
250
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 the person sending the submission. The user acknowledges the
originality of any submission communicated to Epiphan and accepts 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 is independent from Epiphan, and Epiphan has no control over the content of that web site.
In addition, a link to any non-Epiphan 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 is free of viruses, worms, trojan horses, or other items of a potentially destructive nature.
251
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 the arbitration (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 and binding on both parties and
enforceable in any court of competent jurisdiction. Notwithstanding this, application may be made to any court
for a judicial acceptance of the award or order of enforcement. Notwithstanding the foregoing, Epiphan shall
be entitled 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 © 2014 Epiphan Systems Inc.
All Rights Reserved.
252
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement