SelenioFlex
TM
Live Manager
Product Version 2.1.0
06/11/2014
Publication Information
© 2014 Imagine Communications.Proprietary and Confidential.
Imagine Communications considers this document and its contents to be proprietary and confidential. Except for making a reasonable number of copies for your own internal use, you may not reproduce this publication, or any part thereof, in any form, by any method, for any purpose, or in any language other than English without the written consent of Imagine Communications. All others uses are illegal.
This publication is designed to assist in the use of the product as it exists on the date of publication of this manual, and may not reflect the product at the current time or an unknown time in the future. This
publication does not in any way warrant description accuracy or guarantee the use for the product to which it refers. Imagine Communications reserves the right, without notice to make such changes in equipment, design, specifications, components, or documentation as progress may warrant to improve the performance of the product.
Trademarks
SelenioFlex, SelenioFlex Live Manager, SelenioFlex Live, StreamZ, StreamZHD and Xenio are a trademarks or trade names of Imagine Communications or its subsidiaries.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation. All other trademarks and trade names are the property of their respective companies.
Contact Information
Imagine Communications has office locations around the world. For domestic and international location and contact information, visit our Contact page:
http://www.imaginecommunications.com/company/contact-us.aspx
Support Contact Information
To create a Technical Support case for SelenioFlex Live Manager please use the following link: http://www.digitalrapids.com/en/Support/SupportTicket.aspx
Technical Support is available during regular business days from 10am to 6pm based on the time zone of the following regional Imagine Communications Support Offices.
North and South America
25 Dyas Road | North York, Ontario | Canada | M3B 1V7 t: 416-443-3146
Europe, Africa, Middle East
Passfield Business Centre | Lynchborough Road | Passfield, Hampshire | GU30 7SB | UK t: +44-1428-751-012
Asia Pacific
Unit 7, 23rd Floor, Prosperity Center | No. 25 Chong Yip Street | Kowloon | Hong Kong t: +852-2951-0250
Table of Contents
Live Manager Overview ... 7
Features ... 7
Live Manager System ... 7
Installation ... 9
System Requirements ... 9
Installation Overview ... 9
The Number of Systems in a Live Manager Setup ... 9
Live Manager Setup with No Backup Server ... 9
Live Manager Setup with a Backup Server ... 9
With Backup/Redundancy ... 9
Before Running the Live Manager Installer ... 10
Running the Live Manager Installer ... 10
License Server Installation ... 11
Additional Instructions for a Backup License Server Setup ... 12
The License Server Console ... 13
The Live Manager Installer... 14
Configuration Wizard ... 15
License Server ... 15
System Address ... 15
Live Manager Domain Name ... 16
Live Manager Server Security ... 16
Discovery Method ... 16
Database ... 17
Backup server ... 17
Live Manager Server ... 18
Stream Server ... 18
SNMP Monitoring ... 18
Router Control Services ... 18
Installation Information ... 18
Agent Monitor ... 19
Managing the Services ... 19
Managing Services Using the Control Panel ... 19
Licensing ... 22
Licensing for Live Manager Server ... 22
Licensing for SelenioFlex Live Encoders ... 22
Licensing for StreamZ and StreamZ Live Encoders ... 22
Additional Installation Notes ... 23
General ... 23
Networking ... 23
Firewalls and Network Ports ... 23
Paths and Permissions ... 23
Upgrading Live Manager Software ... 24
Installing New Builds on the Live Manager System ... 24
Installing New Builds on non-SelenioFlex Live Resources Using the Console ... 24
Getting Started ... 25
Create the SelenioFlex Live or Stream Project ... 25
SelenioFlex Live Projects ... 25
Stream Projects ... 26
Launch the Live Manager Console ... 26
Bring Resources Online ... 26
Create Groups and Assign Resources ... 26
Schedule a Task ... 27
Set up Alerts ... 28
Monitor Jobs ... 28
Monitor Network Resources ... 28
Status Summary ... 28
Test Your Setup ... 29
SelenioFlex Live Projects ... 30
SelenioFlex Live Overview ... 30
Configuring a Channel ... 30
Stream Projects for Live Manager ... 32
Creating a Steam Project ... 32
Create or Add Codec Profile(s) ... 32
Select Input Type and Source Profile ... 32
Adjust Preprocessing and Plugins ... 33
Using Live Manager ... 34
Connect to the Live Manager Server ... 34
Check the Agent Systems ... 34
Agent System Monitor (non-SelenioFlex Live systems) ... 36
Resources ... 36
Groups ... 38
Creating Basic Groups ... 39
Setting up Groups with Routers ... 40
Setting up a New Router... 40
Service URL ... 41
Router ... 41
Routers - General ... 42
Routers - Input Labels ... 42
Routers - Output Resources ... 42
Routers - Matrix View ... 42
Router Resources on the Groups Tab ... 43
Schedule ... 44
Alerts ... 48
Monitoring Jobs ... 49
Monitoring Network Resources ... 50
Status Summary ... 52
Server Managed Files ... 52
Testing Your Setup ... 52
Remote Software Upgrades (Stream Encoders) ... 52
SNMP Monitoring ... 54
Advanced User Security ... 54
System Requirements ... 58
Installing and Configuring Third Party Databases ... 59
PostgreSQL 8 ... 59
Install PostgreSQL 8 ... 59
Configure PostgreSQL 8 ... 59
Configure the Server ... 60
Confirm Connectivity to the Database ... 61
Automatic Index Creation ... 61
Oracle 10g ... 61
Oracle Requirements ... 61
Configure Live Manager Server ... 61
Automatic Index Creation ... 62
Backup the Database ... 62
Microsoft SQL ... 62
SQL Server 2005 Requirements ... 62
Configure Live Manager Server ... 62
Automatic Index Creation ... 63
Backup the Database ... 63
Troubleshooting ... 64
Live Manager ... 64
Network Issues ... 65
Remote Software Upgrade Issues ... 66
Additional Operating System Considerations ... 66
Log Files ... 67
Stream Project Issues ... 67
Network Ports ... 70
Live Manager Overview
Features
Live Manager is an application that allows you to manage multiple SelenioFlex Live, SelenioFlex Ingest, StreamZ Live ABR, StreamZ or StreamZHD encoders. It includes the following functions:
monitor the encoders status
set up failover for live channels (attempt “self-healing”, assign a backup system per channel, or using a router to assign a backup group)
set up scheduled encoding jobs
monitor encoding jobs
generate alerts based on your criteria
Live Manager System
The Live Manager system consists of:
Live Manager Server: This is the application that controls all of the management functions. The Server maintains its own database to keep track of the information required to manage all of the functions. It is normally installed on a dedicated system. If you install a backup Server it will also be on its own dedicated system.
Live Manager Console: This is the application that is used to connect to a Server. It is the user interface that gives access to all of the functions of the Server. It can be installed on any machine on the same network as the Server. The Console software does not require a license in order to run. It can be installed and run on multiple systems, without restriction.
Encoders: These are the systems that are used to receive live video and to encode the video into media output formats. Each encoding system includes a Live Manager Agent. The Agent is the communication channel between the Server and the local encoder. You will need to connect directly to a licensed Encoder system in order to set up the projects that will be used as scheduled Live Manager jobs. For SelenioFlex Live systems
Encoder systems which include a Live Manager Agent
Live Manager Console Live
Manager Server
you will be able to connect to the system using a browser-based web portal to create projects. For non-SelenioFlex Live encoding systems you can use Remote Desktop to connect to the encoder.
License Server: The License Server controls the authorization of the Live Manager Server, including setting the number of resources (channels) which can be controlled by the Live Manager Server.
Encoders are not licensed through the License Server that is used to authorize the Live Manager Server. Encoders require a license per host system to authorize the encoding channels.
The Live Manager Agent does not require a license. The system will appear as an offline resource to the Live Manager Server as soon as the Agent has established communication with the Server. The resource can only be brought online if it is licensed.
Installation
System Requirements
Server and Console operating system: Windows 7 or Windows 2008 Server, 32-bit or 64-bit. The SelenioFlex Live systems are delivered as a fully configured encoding system.
For system requirements for non-SelenioFlex Live systems please refer to the encoding software User's Guide.
Installation Overview
The Number of Systems in a Live Manager Setup
The number of host systems required for a Live Manager setup will vary, depending on the backup/redundancy schemes that are required.
Live Manager Setup with No Backup Server
One system will be dedicated to the Live Manager Server software. For the simplest setup the following software can all be installed on the Live Manager Server host system:
Live Manager Server (can also include the Live Manager Console)
License Server: Used to authorize the Live Manager Server
Database: Used by the Live Manager Server (by default, PostgreSQL)
Live Manager Setup with a Backup Server
When a Live Manager Backup Server is required at least three systems will be required for the management software as follows:
1. Primary SFX-LM Server System:
Primary Live Manager Server
License Server 1
2. Backup SFX-LM Server System:
Backup Live Manager Server
License Server 2 3. SFX-LM Database System:
Database used by SFX-LM (should also be backed up independently)
License Server 3
With Backup/Redundancy
When a Live Manager Backup Server is required, the primary and backup SFX-LM Server will each be installed on its own system. For this type of setup the database used by the Live Manager Server is also installed on its own system, so that both the primary and backup server can use the data from the same database even when the system hosting the primary server goes down. The primary server updates the database with its health status approximately every minute. If the primary does not update its status, then the backup server will take over until the primary server comes online again and updates its status.
When a redundant License Server setup is also required, at least three systems will be required, each with its own installation of the License Server software and its own HASP. Two of the three systems must be up and running for an active License Server to be enabled. There is no "primary" license server, instead one is considered "active" and the other two are on standby.
Before Running the Live Manager Installer
Install the License Server. (See the instructions in the following section.)
If you are updating from a previous installation that used PostgreSQL 8, and you do plan to use the default PostgreSQL 9 database that is included with the Live Manager installer, then first change the port that is being used by PostgreSQL 8 from the default port (5432) to a different port. That way the PostgreSQL 9 database that will be installed can use the default port, making setup and subsequent upgrades simpler.
The port that is being used can be changed by editing the postgresql.conf file (found in the PostgreSQL data folder). After changing the port number in the config file the Postgres service must be restarted.
If you install PostgreSQL 9 without changing the PostgreSQL 8 port, then it will be installed using a different port (normally by incrementing the default port number by 1). If that occurs it is possible to use the non-default port by specifying it in the JDBC URL when using the Config Wizard, for example if port 5433 was used with a password of “SFXLM” the JDBC URL would be jdbc:postgresql://localhost:5433/SFXLM.
If you plan to use the default PostgreSQL database on a different system from the Live Manager Server, then use the Live Manager installer with the Custom Setup option to install just the default PostgreSQL 9 database before you install the other Live Manager components. In this case the default username and password will be the PostgreSQL default of postgres. Do not change the default username and password set by the installer. When you later install the Live Manager Server, and run the Live Manager Configuration Wizard on the Server system, the Config Wizard will configure the remote PostgreSQL 9 database for use with SFX-LM, and it will set the username and password to SFXLM for the SelenioFlex Live Manager database.
If you are using another supported database, configure it according to the instructions in Installing and Configuring Third Party Databases on page 59.
If you will be using StreamZ or StreamZ Live encoders use the Stream or Stream Live installer to install the software on the Encoding systems. Note that a Stream install includes 2 msi files: a side-by-side installer and a Stream application installer.
Running the Live Manager Installer
The Live Manager has different options depending on which type of software is being installed: Server, Agent or Console. There is also a Custom option to allow you to further refine what you are installing on each system. See the The Live Manager Installer section on page 14 for more information.
License Server Installation
Obtain the License Server HASP from Imagine Communications before you begin the installation. Double click on the License Server msi file to launch the License Server installer.
The Welcome screen will open. Click Next.
Read and accept the license agreement and click Next.
Select the destination folder for the install and click Next.
Click Next to begin the installation.
The HASP drivers will be installed (if they were not installed during a previous installation) and you will see a small additional window. A notification window will open once these drivers have been installed. Click the OK button to continue.
The installation will continue. Once it has finished the License Server service will start and the License Server Console window will open in your default browser.
Click the Finish button to exit the installer wizard.
After the License Sever has been installed the License Sever Console will open in your default web browser to the registration page (http://localhost:15080/console/#Register). There are 3 sections on this page:
HASP ID: Insert the HASP you received from Imagine Communications into the system’s USB port (if you have not already done so) and click on the Read HASP button.
Register: Click the Register Online button to go to the Registration page on the web site. Once you have registered your product you will be emailed the License Package for your product. Save the license package file on the system where you installed the License Server.
Login: Click the Login button. The License Server's Login page will be shown on your browser. Type in the default password (which is "password") and click the Login button. The main page of the License Server Console will be shown with the License Package tab enabled. In the left navigation bar the “Load” option will be selected. In the lower half of the window, in the License Package Load section, you will see a Browse button. Click the browse button, browse to the license package file, and click Open. The license package file name will appear in the box. Click the Load button to load the license package.
While the package is uploading the status will change to “Load Status: In Progress”. Once the package has been loaded the message will change to “License package loaded successfully”.
Additional Instructions for a Backup License Server Setup
In a backup license server setup there are three license servers, each with their own HASP. Install the License Server software on all 3 systems, and insert a HASP in each system.
One of the HASPs will be marked as the "primary" HASP. Use this HASP ID to register your
product. The license package that you receive will include the HASP IDs of all three HASPs in use. When you load a license package for a backup license server setup, you will see a message telling you that "Backup License Servers must be configured". A "Configure Backup Servers" button will also appear below the "Load" button. Click the "Configure Backup Servers" button.
Enter the IP addresses or host name of all three systems which are hosting the license servers, then click the Update Servers button. The license package will then be pushed to the other two license server systems, and information about all three license servers will be pushed to all applications which contact the active license server.
One of the three license servers will be the currently "active" license server. If the active license server can no longer be contacted, then one of the remaining two license servers will become the active license server. That is, there is no "primary/backup" role as there is with the SFX-LM Server, all of the license servers have equal status, and any of them can take over the "active" server role. Two license servers must be online in order for one of them to be an "active" license server. Once the three license servers have come on line you can use the License Server Console to access the Backup Servers page to check the status of the three license servers.
The License Server Console
After the license server has loaded the package you can select “Features List” in the left navigation bar to see what has been uploaded to the license server, to verify your license package.
Note that the “DRC License Server” has been installed as a Windows service running on your system. Should you ever need to restart this service you can launch the “License Server Console” and click on the “Restart Server” button. You can also start and stop this service by launching the Windows Control Panel (Start > Settings > Control Panel), double clicking on Administrative Tools, double clicking on Services, then scrolling down the list of services to the DRC License Server service.
The Live Manager Installer
When you run the Live Manager installer you will have to install different components, depending on whether you are setting up a Live Manager Server or an Encoder system.
Live Manager Server Install:
Use the Live Manager installer to install the Server component.
Optional: If you plan to use the Router Control to manage backup resources, then pick the Custom setup type so that you can enable Router Control Services as part of the
installation.
Optional (recommended for troubleshooting): Use the Live Manager installer to also install the Console component.
The PostGreSQL database is included in the Live Manager installer. If you plan to use a different database then install and configure that database according to the instructions in the appendix.
You should not normally install the Agent component on Live Manger Server systems. The Agent component should only be installed on Encoders.
Live Manager Console Install:
Install the Console (this component does not require a license to run). Encoder and Live Manager Agent Install:
SelenioFlex Live: The SFX-Live system is preconfigured and includes the encoder and the agent system. No further installation is necessary.
There is a configuration settings page for Live Manager Agent settings on the SelenioFlex Live Web Portal's System tab.
Non-SelenioFlex Live Encoders:
Install the Stream or Stream Live software before installing the Agent on each Encoder; also install any media players required by Stream for your codecs.
Note that if your encoder includes a Flux capture card then you will have to accept the “certificate” when you install the Flux driver. In order to do that you must initially install it locally (that is, you cannot use the Agent’s remote software upgrade feature).
Use the Live Manager installer to install the Agent.
You will not normally install the Server on Stream Encoder systems.
Optional: Install the Console app.
To launch the Live Manager installer, double click the installer file (the msi file). You will be given a choice of which components to install on the system. Follow the guide above to determine which components to install. If you want to install more than one component at the same time, pick the “Custom” button, and disable the components that you do not want to install.
Router Control Services option: This option is only intended for use with Live Manager installations where you plan to use a video router.
Configuration Wizard
After you select the components, you will be given the option to “Run config wizard after install.” This is recommended. The Live Manager Configuration Wizard has several steps. Depending on which components you have chosen to install, different steps will be shown.
You can also run the Configuration Wizard any time after the installation, in case you need to reconfigure your software. It will be available in the Windows Start menu in the Imagine Communications > Live Manager folder.
License Server
Enter the License Server IP address.
If you are using a Redundant/Backup scheme do not use "localhost" even if your license server is on the same system as the Live Manager Server, as the backup systems will not be able to find the License Server without the IP address.
Enter the License Server Port. Normally you will not change this from the default value of 15000. If you need to change this port then your license package will also need to be modified by Imagine Communications Support.
Click the Test button to verify the connection to the License Server.
System Address
The System Address is the address used to identify the system during Live Manager
communications. Live Manager uses the RMI (Remote Method Invocation) address. The options are:
IP Address of this system. This can be used for systems with a single IP address (e.g., systems with a single network card). If you have more than one IP address assigned to the
system (for example, if you have more than one network adapter active in the system) you should not use this option, since any of the active addresses could be picked up, even if they are not the appropriate address.
Local system’s hostname. This can be used if your network is configured so that machines can be contacted by name.
Specify a hostname/IP address. Note that if you choose this option and you do specify the hostname/IP address, and at a later date the machine’s address is changed, then Live Manager will not be able to communicate with that system until the Config Wizard is re-run, and the new address is supplied.
Specify network interface: Select your network interface, and whether or not to use IPv6.
Live Manager Domain Name
The Live Manager Domain Name is not related to the Windows domain name.
Servers that use a particular Live Manager Domain setting will only be able to control Encoder resources whose Agent uses the same Live Manager Domain name. This will be useful if you intend to set up more than one Live Manager Server, each with their own Encoders under their exclusive control. For example, you may want to set up one domain for testing, and a second domain for your day-to-day operations. By giving each server/encoders group its own domain, they will be isolated from each other.
On a SelenioFlex Live encoder, the Live Manager Domain name can be set for each encoder using the SFX-Live Web Portal. The System tab includes a Live Manager settings page.
Live Manager Server Security
If you enable security on the Live Manager Server, then users attempting to connect to the server using a Live Manager Console will have to provide the Username and Password that you set up here (for Administrative access) or the username and password that you set up for them later with specific user privileges. If you do not enable security in this step, then users will be able to connect to the server using the Live Manager Console without providing any authentication.
If you plan to use the advanced security options to set up user lists with permissions, then you must enable the basic Live Manager Server Security in this step. When you log in using a Live Manager Console with the Admin Username and Password that you set up here you will then be able to access the advanced security options.
On a SelenioFlex Live encoder, a unicast Live Manager Server List can be set for each encoder using the SFX-Live Web Portal (if multicast is not supported). The System tab includes a Live Manager settings page. (See the section above on "Live Manager Domain Name".)
Database
The settings at the top of the Database page provides the information that the Live Manager Server needs to communicate with the database.
The default database that is installed by the Live Manager 2 installer is PostgreSQL 9. If you installed this database on the same system as your Live Manager Server then you can use the defaults provided and the Config Wizard will automatically configure the database.
If you installed the database on a different system than the Live Manager Server, then you will need to modify the JDBC URL to point to the host system (that is, change localhost to the address of the system hosting the PostgreSQL server, and if the port is not the default port of 5432 then also specify the port, for example, jdbc:postgresql://192.168.0.155:5433/SFXLM, where SFXLM is the password used by the database).
If you installed a different database, then you have to install and configure it before you can use the Live Manager Configuration Wizard. Select it from the drop-down list and provide the JBDC URL, the Username and the Password.
Once you have selected your Database and provided the JDBC URL and credentials you can click the Test button to verify that you can connect to the database.
If you previously installed Live Manager and you were using another database you can migrate your SFX-LM settings from the previous database to the newly installed database. This will migrate settings such as group settings, server managed files locations, router settings, etc. It will not migrate historic job data. Please backup your source database before you start the migration. In the "Migrate Settings" section click the "Select" link. Use the drop-down to select the database you are migrating the data from, enter the JDBC URL of the source database, and the Username and Password (if the source database used a Username and Password).
Backup server
If you purchased the option to use a Backup Live Manager Server you will have access to the Backup Server configuration page. If the system that you are currently setting up is the Live Manager backup server, then enable this option. This backup server will automatically take over all server functions if the primary Live Manager Server fails for any reason. (If the system that you are currently setting up is the primary server, then do not enable this option.)
The active server (normally the primary server) updates its health status in the database
approximately every minute. The backup server watches the database for the health of the active server. If the active server does not update the database with a “healthy” status, then after a few minutes the backup server will take over all server functions, becoming the active server. If the
primary server then comes back on line and updates the database with a “healthy” status, then the server functions will be taken over by the primary server once again.
The backup server must have access to the same database as the primary server. Therefore, if you are setting up a primary/backup server installation, you should not install the database on the same system as the primary server or the backup server. Set the same database JDBC URL when you are configuring the backup server and the primary server.
Live Manager Server
The Live Manager Server runs as a service on the Server system. The startup type should be set to automatic, and you should enable the Edit checkbox and change the Account from the default LocalSystem to an Account name and password that has full administrative rights on the system, with read/write access to any network file shares to be used as watch folders or for output media.
Stream Server
For non-SelenioFlex Live encoders the Stream Server runs as a service on the Stream Encoding systems (systems that have an Agent installed). The startup type should be set to automatic, and you should enable the Edit checkbox and change the Account from the default LocalSystem to an Account name and password that has full administrative rights on the system, with read/write access to any network file shares to be used as watch folders or for output media.
SNMP Monitoring
If you plan to use SNMP (Simple Network Management Protocol) to monitor your Live Manager server, then you will need to enable and configure this component.
If you would like to use an HTML Adaptor to use an html browser to monitor SNMP variables, then you can enable this component and set a port.
Router Control Services
The Router Control Services run as a service and provides remote control of attached video routers. Normally this service will be installed on the same system as the Live Manager Server, but it could be installed on another system on the network.
The only setting is the Port used for communication by the service.
Installation Information
The final page is a list of additional steps you should take after the software has been installed. These are also covered in the “Additional Installation Notes”.
When you finish the final step, if you changed any of the service settings (e.g., username and password) you will be asked if you want to start/restart the services that changed. This is
necessary in order to use the new settings, so if you plan to start using Live Manager you should say Yes.
Agent Monitor
On non-SelenioFlex Live encoding systems you will also see the Agent Monitor has been installed. Until you finish configuring the services the Monitor will not be able to contact the Agent, but once you have set up the services correctly the Agent Monitor should automatically detect your
resources.
Managing the Services
Normally you will set up the required services using the Configuration Wizard as part of the installation process. This section describes how to check on the installed services, and manually change them if needed.
Managing Services Using the Control Panel
Open the Control Panel, double click on Administrative Tools and double click on Services.
Once the SelenioFlex Live Manager Server is installed and configured the following Services will be present with the status set to “started” and startup type set to ”automatic”:
DRC License Server DRC RMI Registry Jini Services
SelenioFlex Live Manager
On encoding systems which include the Stream Encoding and Agent software the following Services will be present with the status set to “started” and startup type set to ”automatic”:
DRC Hypersonic DRC RMI Registry DRC Stream Server
If the Router Control Services are installed (and configured) you will see the following service: DRC Router Control Services
In the “Log On As” column, the SelenioFlex Live Manager and the DRC Stream Server must be an account that has administrator privileges on the local system and appropriate network privileges (not Local System).
If you need to change the Log On information, you can run the Live Manager Configuration Wizard again at any time. Alternatively, you can find the SelenioFlex Live Manager and the DRC Stream Server entry and double click on it to open the Properties panel for that service.
On the Log On tab, Select “This account” and enter a username and password that has
administrator privileges on the local system and appropriate network privileges. For Live Manager, this account will need to have Read and Write permission on Network Shares where project files (and other required files used by the project, for example, graphics) will be located.
If your computer is connected to the Network as part of a Domain, then you will need to enter your domain\username.
If your computer is connected to the Network as part of a Workgroup, then you will need to enter hostname\username, where the username is for an account that has administrator privileges on the local machine, and access to the Network Shares where your watch folders (and other files) will be located.
Note that if you are connected as part of a Workgroup, it is possible that someone changed the “Full Name” being used by your computer after it was set up. In order to start and stop services, you will have to Log On using the original Name. To see the original user name, right click on My Computer and choose Manage. Expand Local Users and Groups, and click on the Users folder. This will show you the user Name and the Full Name (or alias) on this local system.
If you have administrator privileges, you can also right click on the user, and use the “Rename” option to make the Name match the Full Name.
If you make any changes to the services, you will need to restart the service for the changes to take effect. If you are manually stopping and starting services on the Live Manager Server system, please note that the DRC RMI Registry service MUST be started before the SelenioFlex Live Manager service.
Managing DRC Stream Server Service Using the Console
Note that for non-SelenioFlex Live systems you can also access the DRC Stream Server service remotely, using the Live Manager Console software.
Launch the Live Manager Console software. When you launch the software you will be able to select your Server from a list of the “Found Servers”, and then click the Connect button. Once the Console software has successfully connected to the Server, you will see a tabbed interface. Use the main menu and select Server > Agents. This will show you a list of all of the systems with Agents that the Server can detect. Click on an Agent system to select it (or multi-select many Agent systems to change them all at once).
Click the Config Stream Service button found to the right of the window.
For the Startup type choose Automatic.
Enable the Service Log On Edit box
For Account enter a username (e.g., domain\username if you are part of a network domain, or hostname\username if you are part of a workgroup) and password that has administrator
privileges on this machine. For Live Manager this account will also need to have Read and Write permission on Network Shares where your project files will be located.
Click the Save button. The service will be restarted automatically as a background task. It may take a few seconds for the changes to be made.
If you ever need to manually stop or start the service, you can select the Agent system in the list (or multi-select the Agent systems) and use the buttons to the right in the Stream section to Start Service and Stop Service.
Licensing
The Live Manager Server and each Encoding system require a license.
Licensing for Live Manager Server
The Live Manager Server uses the License Server. This License Server requires a HASP. The HASP ID is used in the corresponding License Package file.
The License Package file includes the following Live Manager Server features:
Live Manager – Authorizes the Live Manager Server service to run.
SelenioFlex Live Resource – Each SelenioFlex Live channel will check out one of these license features.
Stream resource – Each StreamZ or StreamZ Live channel will check out one of these license features.
Backup Server Enabled (optional) – Enables a Live Manager Backup server to run.
Licensing for SelenioFlex Live Encoders
Each SelenioFlex Live Encoder has its own license which uses the License ID for the system. Please see the "SelenioFlex Live User's Guide" for more information about licensing the SFX-Live encoding systems.
Licensing for StreamZ and StreamZ Live Encoders
Each encoder has its own license which uses the capture board ID installed the encoding system. When you purchased the Stream Live, StreamZ or StreamZHD encoder along with the Stream software, a license was generated for that system. Register online with your hardware ID in order to get the required Stream software license.
You can also see the hardware ID for a system using the Console application. Select the Resources tab, and right click a resource, then select Bring Online. Once the resource’s status change has changed to Available, you can right click on the resource again and select Properties. This will show you the Hardware Devices installed in the system, and the ID for each device. Once you receive the encoder license key, you will need to copy the file to the system, rename it from *.txt to *.reg, and then double click on the *.reg file. You will then need to reboot the encoder system to restart all the DRC services.
Additional Installation Notes
General
The information in this section is for SFX-LM Server systems and Stream Encoders. It does not apply to SelenioFlex Live Encoders.
All machines should have proper Network Time synchronization
Ensure Windows machines have their Firewalls turned OFF. This is found in Control Panel > Security Center.
Disable Windows Automatic Update installation (it can reboot the machine). This is found in Control Panel > Security Center
Disable Windows Automatic error reporting. It will prevent the encoding process from being restarted or the machine from being rebooted by Live Manager in the event of a job failure. If you are running Windows 7 you must run the Local Group Policy Editor
(C:\Windows\System32\gpedit.msc), expand the left navigation tree to show “Computer Configuration > Administrative Templates > Systems > Internet Communication
Management > Internet Communication Settings”, then in the right hand panel find “Turn Off Windows Error Reporting” and edit the policy setting and enable it.
Always reboot after installing Stream Encoder software on a system
Networking
The Agent and Console locate the Server using a Multicast discovery mechanism by default. If the machines are on different subnets, then the networking equipment in between will need to
propagate multicast traffic in order for the automatic discovery to work. If this is not an option, you should configure the system for unicast communication. See the section on “Discovery Method” on page 16.
Firewalls and Network Ports
Live Manager requires various ports to be open for communication between components. If all of the systems in a Live Manager installation are installed on a LAN with unrestricted communication between systems, then you will not need to worry about which ports are being used.
However, if some of the components are behind a firewall, then some ports will need to be opened for communication. Depending on which components have been installed, and which functionality is desired, different ports will need to be opened.
Please see Network Ports on page 70 for detailed information on the ports used for each service component.
Paths and Permissions
Use of UNC paths is strongly recommend (e.g. \\host\dir\file ) for folders and output files. That is, do not use Mapped Network Drive letters when specifying a path.
If projects do not start, ensure that the server can read the folder where the project is located (the path is valid and accessible). Also ensure that the SelenioFlex Live Manager process is running as an appropriate network enabled user on the Live Manager Server system. If using a non-SelenioFlex Live system ensure that the DRC Stream Server process is running as an appropriate network enabled user on the Stream Encoding systems.
If projects fail immediately, check that the project output paths are appropriate (e.g., UNC paths that are valid and are accessible, for live streaming check to make sure that the streaming Media Server’s information is valid).
Upgrading Live Manager Software
Before you upgrade to a new build please read the build’s release notes. There may be instructions about incompatibilities between builds, or instructions for migrating data, or other critical
information.
Installing New Builds on the Live Manager System
Before installing a new build you should uninstall the old build and reboot your system. Do not skip the reboot step. You must reboot, as some services will only be fully uninstalled the next time you reboot. If you do not reboot, this “uninstall on next reboot” command will still be present, and the new installation will have critical files removed the next time you reboot.
To uninstall the software when using Windows 7, use the Control Panel’s “Programs and Features” function to uninstall the SelenioFlex Live Manager software.
Uninstalling the Selenio Live Manager software will not remove your settings or database. If you plan to migrate data from a previous database to a new database, you should not uninstall your database software until the data migration step has completed. The Live Manager Configuration Wizard includes a "Migrate Data" function, to allow you to migrate data from an existing Live Manager database to a new database.
Note: The embedded Hypersonic database which was an option for Live Manager 1 is no longer supported. If you were using Hypersonic then you must update your database in order to use Live Manager 2.
Installing New Builds on non-SelenioFlex Live Resources Using the Console
Once you have upgraded the Live Manager Server to version 2, and at least one Console to version 2, you will be able to manage remote upgrades of Live Manager Agent and Stream software on Encoders from the Console.
Getting Started
After installing the required software, applying the license to each component, and hooking up the video and audio feeds to each encoder as appropriate, follow these basic steps to get started.
Create the SelenioFlex Live or Stream Project
This is the project (or projects) you intend to use for your encoding jobs.
SelenioFlex Live Projects
You can create SelenioFlex Live projects by accessing the Encoder using the browser based web portal. On a computer on the same network as the encoding system, open a browser and enter the IP Address of the encoder to connect. Once you have connected to the system you will see a tabbed interface.
Home: A summary of the status of all of the channels
Channel 1 – 4: Used to configure projects. Start/stop for each channel.
Projects: A list of the saved projects. Import/Export and Edit/Delete/Download projects.
System: System configuration, logs, licensing, upgrade, reboot, other system settings. Moving the mouse pointer over titles, headings, text and icons will display tool tips.
Note that if the system was being controlled as a resource by Live Manager you will have to return control to the web browser. On each Channel page, in the upper right hand corner there is a setting for "Channel Control". Click the cogwheel button to change the control mode. After you have finished creating your project be sure to return control to Live Manager if you want the channel to be seen as a resource by Live Manager.
After creating a SZL project, saving it will save it to the local encoder system. Go to the Projects tab, find the project you created in the list of projects, and download using the Download link for the project. Save the project to a location on your network that will be accessible to the Live Manager server.
If your project uses any other files, such as a graphic overlay file, make sure you copy it to a shared location that can be accessed by all of the encoders and by the Live Manager Server.
Stream Projects
You can create Stream projects by accessing the Stream software on a system locally, or by accessing the encoder remotely using Windows Remote Desktop. In order to use the Stream software installed on an encoder system to create a project you must first take the encoder Offline using the Live Manager Console. You will be prompted to do this when you use the Console to connect to a resource using Remote Desktop. Please see the following section for a basic guide to creating a Stream project, or the Stream Software User’s Guide for more details on creating a project.
Note that if you would like your project to run for a set time, you should not specify a duration trigger in the project. The Live Manager scheduler should be used to set a stop time for tasks. Once you have created a project, save it to a shared location that can be accessed by all of the encoders and by the Live Manager Server. The project will also reference a Source Profile. When you schedule your encoding tasks to run, you will need to select the source profile that will be used, whether it is a local copy or a source profile file managed by the Live Manager server.
If your project uses any other files, such as a graphic overlay file or GPI trigger configuration, make sure you copy it to a shared location that can be accessed by all of the encoders and by the Live Manager Server.
Launch the Live Manager Console
Launch the Live Manager Console software. When you launch the software you will be able to select your Server from a list of the “Found Servers”, and then click the Connect button. (There may only be one Server for your organization, or there may be many, depending on your setup.) Once you are connected you will see a tabbed interface that gives you access to all of the management features of the Live Manager Server. If the tabs you need are not displayed in your Live Manager Console, right click on the tab bar, unlock the tab bar and add the tabs.
You will see all of the Encoder systems that can be managed by the server you are connected to currently on the Agents tab. (Note that during installation, you can set up different Live Manager domains for different tasks, and only the Server and the encoder resources that use the same domain will be able to communicate with each other. For example, this would allow you to set up one domain for a test lab, and a separate domain for the live-to-air encoders.)
Bring Resources Online
After you have used the Console app to connect to a Server, click on the Resources tab. You will see a list of the resources that the server can communicate with, where each channel on the encoder is listed as a separate resource.
Right click on a resource. The right click menu will give you a list of possibilities. Choose “Bring online”. After you have done this, the resource should be listed as “available”. Multi-select all of the remaining resources, right click on the selected group, and choose “Bring online”. This will change the status of all of the remaining resources to “available”. Note that it will take a short time for each resource to come on line, it will not be instantaneous.
Create Groups and Assign Resources
Click on the Groups tab. You will need to create new groups to handle encoding resources. You can also set up resources as primary and backup encoders, where the backup resource will take over automatically if the primary resource fails.
Click the “New Group” button found to the right of the interface. Assign a group Name and choose a Role. For StreamZ or StreamZ Live systems choose a Role of either Stream: Live Stream H/W or Stream: Live Stream IP. For SelenioFlex Live systems choose the model of the encoders that will be in the group.
To assign a primary resource to the group, click and drag an unassigned resource from the list at the bottom of the Groups tab and drag it on to the group. To assign a backup resource, select an unassigned resource from the list and then drag it on top of the primary resource you want it to back up. You will be given a choice about which type of backup you would like to use (active failover or standby failover).
If you do not assign a backup resource, and Live Manager detects that the primary resource has failed, it will attempt to “self-heal” the resource. First it will attempt to restart the encoding process. If that does not succeed, then it will attempt to reboot the machine and restart the encoding process (as long as you have enabled the system to attempt a reboot).
Note that for Stream Encoding systems, Live Manager does not know which resources are licensed for which specific codecs. If all of your Stream resources are authorized to use the same codecs, then you can assign all of your resources to just one group. If you have licensed an additional optional codec for just some of your resources, you should make a group for just those resources. That way you will be able to assign projects that use that specific codec to the group that is authorized to use that codec. (This does not apply to SFX-Live Encoders.)
Schedule a Task
Click on the Schedule tab. Click on the “New” button to add a new scheduled task. On the New Schedule Task window pick which one of the 3 types of tasks that you want to schedule:
Configure Resource: bring it online or offline, or to reassign it to a different group.
Reboot Host: reboot, normally for maintenance purposes
Run Project: normally used by Live Manager to schedule a live encoding project Select “Run Project” and click OK.
Give the Task a name, and optionally a description.
Select the Targets tab, and assign the resources you want to use to run the task. Note that you can target individual resources, or entire groups of resources.
On the Tasks tab, add the specific project that you want to use for this task, and specify where the Source Profile used by the project is located.
Select the Schedule tab and set when you would like the task to start, and how often the task should repeat. Set the “Stop duration” for the job. If you leave the Stop duration field blank, the task will continue until it is manually stopped.
Click Save to save the job and to add it to the Scheduled Tasks list. If you selected “immediately” when you set your schedule, then the encode will start when it is saved. You can add as many new Scheduled Tasks as you need.
If you set up an encode to start later, but you now want it to start immediately, you can select the task, then click the Edit button, go to the schedule tab, click the Reschedule button in the upper right hand corner, revise the schedule, and then Save the job again.
You can also disable a task, to pause it temporarily. Select the task that you want to disable and click the Disable button found to the right. This will stop the encode without deleting the job from the list, so you will be able to resume the job again later without needing to recreate the same job.
When you select a job the status of the job, including any error messages, will be displayed in the panel at the bottom. As with all tables in the Live Manager Console, you can right click on a column heading and select Export to export the data to a CSV file.
Note that there are two Schedule view types, Calendar view or Task Entries view, selected using the drop-down box at the top of the Schedule tab.
Set up Alerts
All Live Manager Server activity is automatically logged on the Alerts tab. You can use the Alerts functions to set up recognized activities into categories, and to set up rules that define which person should be emailed a message each time the selected activity has occurred.
To use the email notification feature, click on the Email Servers button, and then enter in your email server information. Then click on the Address Book button and enter the email addresses you would like to use when you send out notifications. Click on the Categories button to create the types of activities you would like to group together when you are generating notifications. Click on the Rules button to assign which people in your address book will receive notification of which categories of activities.
Monitor Jobs
Once a job has started, even if it has since completed, you can see it listed on the Jobs tab. If you have a lot of jobs started or completed, you can filter which ones are shown in the list using the categories at the top of the Jobs tab.
When you select a job in the top half of the window, all of the events associated with the selected job will be shown at the bottom of the window.
Monitor Network Resources
The Network tab gives you a quick overview of the status of all of the encoding resources that can be accessed by Live Manager. There are two views:
Show Status: a list of resources with status indicators
Monitor Streams: a grid view of a video preview of the selected resources
When you are using the “Show Status” mode a resource that does not have a backup will have 2 status indicators. The first one is for the encoder status and the second one is for the primary encoder status.
A resource that has a backup will have 3 status indicators. The first one is for the encoder status, the second one is for the primary encoder status, and the third one is for the backup encoder status. The status indicator can show the following states:
white: resource is available
green: resource is encoding
yellow: failover in progress or attempting to establish/re-establish contact
red: failure or lost contact with the resource
When you are using the Monitor Streams mode you will be able to choose which group you want to monitor and which layout to use in the grid view. If there is more than one page in the preview video mode, then you will be able to choose which page to view.
Test Your Setup
It is generally useful to test your failover scheme, and to verify that alerts are being logged and notifications are being sent out. There are many ways to simulate an encoder failure, for example powering off an individual encoder or disconnecting it from the network.
For SelenioFlex Live encoding systems a simple way to force a failure is to stop the SFX-LM Agent on the encoding system. This can be found using the Web Portal, on the System tab.
For StreamZ encoding systems a simple way to force a failure is to use the console’s main meun to select File > Agents, then click on a system to select it, and then right click on the selected system and stop the Stream Service. This will cause the Live Manager Server to lose control over the Encoding resource without losing communication with the resource.
For StreamZ encoding systems you may also force a failure by accessing the system (either locally or using remote desktop), and then launching Windows Task Manager, and on the Processes tab looking for “encoder.exe”. If you use the End Process function to kill the encoder.exe process, this will stop the encode, and Live Manager will respond to it as a failure.
SelenioFlex Live Projects
Creating a SelenioFlex Live project for use with Live Manager is exactly the same as creating a project for use when the encoder is under local control.
SelenioFlex Live Overview
The system is operated using a web portal. On a computer on the same network as the encoding system, open a browser and enter the IP Address of the encoder to connect. Once you have connected to the system you will see a tabbed interface.
Home: A summary of the status of all of the channels
Channel 1 – 4: Used to configure projects. Start/stop for each channel.
Projects: A list of the saved projects. Import/Export and Edit/Delete/Download projects.
System: System configuration, logs, licensing, upgrade, reboot, other system settings. Moving the mouse pointer over titles, headings, text and icons will display tool tips.
Configuring a Channel
Add at least one Streaming Group to the channel using the Group "Add" button.
Each group can contain multiple video and audio encodes, which can be used by multiple outputs.
Once the Streaming group (or groups) have been setup with video, audio and outputs, use the Channel "apply" (the checkmark button, see above) to configure the encoder. After the settings have been applied, the "start" and "stop" buttons can be used to start/stop all encoding groups. Each group has its own apply, start and stop buttons, to allow multiple groups to be controlled independently. The same is true for each Output Destination, giving even more granular control.
Add Streaming Group
Apply settings to the channel using the "apply" checkmark button.
When you are satisfied with your channel setup use the Save Project button (upper right hand corner) to save your settings. Use the Load Project button to load a previously saved project.
For detailed information about setting up projects and using the encoding system please see the "SelenioFlex Live User's Guide".
Stream Projects for Live Manager
Live Manager assigns settings to encoding jobs by assigning Stream projects to scheduled Live Manager tasks. The projects contain all of the settings that will be used to encode the video input and deliver the live stream.
You can create projects using Stream or Stream Live, and these projects can use a capture board to provide the video source or a Stream Live IP input to provide the video source.
Note that you will not be able to use an unlicensed copy of Stream to create a project. The following instructions are intended to be used when running a licensed copy of Stream.
Creating a Steam Project
There are 5 basic steps to creating a project for use with Live Manager.
Create or Add Codec Profile(s)
The codec profiles tell Stream what format to use for the output files.
There are a number of pre-created codec profiles installed when you install Stream. You can access them by clicking on the Add button (the blue + button). You can also create your own codec profiles by clicking on the Codec Profile menu at the top of the interface.
“From Project” uses the one saved in the project
“Local File at Resource” lets you pick which one to use from the console rather than using the one that was set in the project
“Live Manager File” uses a source profile that is managed by the MM Server replacing the one that was set in the project
When you are using an encoding resource with an IP Source, you will need to specify whether you want the Transport Stream Input used to be the one set in the project or the one set in the Task.
Adjust Preprocessing and Plugins
Stream has audio and video hardware pre-processing controls that can be used to adjust your video before it is encoded. For example, if you are encoding a video source, and your intended playback device is a media player on a computer, then it may improve the resulting video if you adjust the gamma up slightly to compensate for the difference in a TV monitor vs. a computer monitor.
Stream also has a number of optional software video processing plugins that you can add to your project. If you add a plugin, it will be used by Live Manager when encoding the media.
Select Outputs
Stream’s output options are used by Live Manager. For live streaming you will normally use the outputs to send the encoded data stream to a media server. The other output options can also be enabled if desired. For example, you may want to create an archive file at the same time that you are encoding a live stream so that you can make it available as an on-demand file after the live event has finished.
If you do plan to output archive files, be sure to use system tags when specifying your archive file name. This will allow a unique name to be generated for the archive file each time the project is run, so that you do not overwrite files should the task repeat. Some common system tags used for archive files (for a full list, please see the Stream Software Manual):
%T_% Time
%D_% Date
When you are specifying the Archive file name use UNC paths (e.g. \\host\directory\file).
Save the Project
Once you have finished setting up the project, save it to a directory that can be accessed by the Live Manager Server and by all of the Stream Encoder resources.
More Information about Stream Software
For more information about the Stream Software and Stream Projects, please refer to the "Stream Software User’s Guide" or the "Stream Live User’s Guide".
Using Remote Desktop
You can use Windows Remote Desktop to give you direct access to the Stream software on the host system.
Launch the Console application and connect to a Live Manager Server. Go to the Resources tab. All of your Stream Encoder resources will be listed. Right click on the resource you want to control, and select “Advanced > Launch Remote Desktop”. This will launch the Windows Remote Desktop, attempt to connect to the Host system for the selected resource, and if successful, allow you to log on.
Using Live Manager
Connect to the Live Manager Server
Launch the Live Manager Console software from the shortcut installed on your desktop. The Console will search the network for systems running the SelenioFlex Live Manager service and list them.
By default, the “Auto Connect to:” option will be enabled, and after a short time-out, the Console will automatically connect to the same server you connected to during your last session. If you quickly uncheck this option you will be able to choose any of the Found Servers in the list and then click the Connect button to connect to the selected server.
If you do not see your Server, you can also search for it using a specific Host or IP Address. If you set up a username/password authentication for the server, you will have to supply valid credentials before the Console will connect to the Server.
If the Advanced Security options are being used, each user will be assigned a role. When you log in your role will be shown on the Console. There are 4 roles, with the Administrator role being unrestricted, the Configuration and Operator roles having some restrictions, and the Viewer role having the most restrictions.
Once you are connected you will see a tabbed interface that gives you access to all of the management features of the Live Manager Server. If the tabs you need are not displayed in your Live Manager Console, right click on the tab bar, unlock the tab bar and add the tabs.
After you have connected to a server, if you want to connect to a different Live Manager Server you can use the Console’s main menu to select File > Connect to Live Manager menu item and pick another server.
Check the Agent Systems
Once your Console has successfully connected to a Server, click the Agents tab. This will show you a list of all the Encoders that are running Live Manager Agents and have been found by the Server.
These can be licensed or unlicensed Encoders. As long as they have the Live Manager Agent installed and running and the Encoder software/firmware installed they will be detected. Note that on the Agent’s window you can right click on the column heading to choose which columns you would like to display, and to export all of the data currently showing to a Comma Separated (CSV) file which can then be imported into a database or spreadsheet program for report generation. This is true throughout the entire Console application. That is, all tables in the Console application have the same Export right click option.
Both SFX-Live systems and non-SelenioFlex Live systems can use the following functions: Refresh: This simply refreshes the table, retrieving any new information since the last time the data in the table was displayed.
Reboot Host: You can also use this button to reboot the system using the selected Agent. This may be useful if you have a Stream system with updated software or license key.
Grab Log Files: For troubleshooting purposes, there is a Grab Log Files button. This will collect all of the log files from the selected Agent system, and copy them all to a specified location. These log files can be used by Imagine Communications Support to help analyze problems.
Delete: Once the Live Manager Server has detected an Agent, it will continue to list that system even if it is no longer available (for example, if it has been shut down). The Agent status will show as “Missing”. If you know that a particular system has been permanently removed, then you may want to delete that system from the list. The Delete button in the bottom right hand corner has been provided for that purpose. If you later need to see the information for the deleted system, you can enable the “Show Deleted” checkbox.
The following functions can only be used by non-SelenioFlex Live Stream systems:
Config Service: Used to configure the DRC Stream Service that runs on the Stream Encoders. Normally the configuration will be done when the software is installed. Should you need to modify it after installation you can use the Config Service, Start Service and Stop Service buttons found on the right hand side of this Agents window.
Remote Desktop: You can select a system, right click on it, and choose Launch Remote Desktop. This will launch Microsoft Windows Remote Desktop, attempt to connect to the Host system for the selected system, and if successful allow you to log on.
Software Upgrade: This function can be used to upgrade the Agent systems.
Note that for resources which include a Flux capture card you will have to accept the “certificate” when you install the Flux driver. In order to do that you must initially install it locally (that is, you cannot use the Agent’s remote software upgrade feature). To make it unnecessary to do a local install in future, check the “Always trust software from Imagine Communications Corporation” box before clicking the Install button.
Choose the type of software package you want to run. If you choose Live Manager Agent or Stream then the currently installed software will be uninstalled, then the new software will be installed with a reboot as necessary. If you want to uninstall/install other software (for example, Flux drivers, or SxS components) then you can use the Other Uninstall and Other Install options. Fill in a Username and Password with permission to install/uninstall software on the systems. If you have a resource which includes one of the early Flux boards, revision 1 or 2, then you will need to power cycle the system after an update that includes a board firmware update. If that is the case the update must be done locally on each system, as a reboot will not be sufficient to
reprogram the board. If you have a Flux board revision 3 or later then this will not be necessary.
Agent System Monitor (non-SelenioFlex Live systems)
Each non-SelenioFlex Live encoder that has an Agent installed and running will also have a local Agent Monitor installed. This monitor shows you some information about the resources installed on that local system. The Agent Monitor runs automatically when you log in to the system, and you will see a Live Manager icon in your system tray. If you double click on the Agent Monitor icon it will open the monitoring window.
For SFX-Live systems connecting to the system using the Web Browser will provide you will information about the encoding system.
Resources
The Resources tab is used to monitor and control individual resources, where each channel is an individual resource. Resources are automatically found by the Live Manager Server on systems that have a Live Manager Agent installed and running.
Click on the Resources tab. You will see a list of all of the resources (channels) that have been found by your Server. Look in the Status column.