Summary of Contents for VBrick Systems Portal Server ETV v4.1
Page 1
VBrick EtherneTV Portal Server ETV v4.1 Portal Server Admin Guide June 21, 2007 4410-0118-0006...
Page 2
VBrick products. This freely available source code is posted at http://www.vbrick.com/opensource. About VBrick Systems Founded in 1997, VBrick Systems, an ISO 9001 certified vendor, is a privately held company that has enjoyed rapid growth by helping our customers successfully introduce mission critical video applications across their enterprise networks.
Portal Server v4.1 Admin Guide This Portal Server Admin Guide is written for anyone who will be using or evaluating the VBrick EtherneTV Portal Server. This includes system administrators, software developers, network technicians, and others. The ETV Portal Server is a web-based portal for accessing and managing video assets including both live or stored audio and video files.
VBPresenter Auto Content Ingestion explains auto content ingestion. This is the process whereby Database Backup Amino Set Top Box ACNS Configuration Getting Help If you need help, or more information about any topic, use the online help system. The online help is cross-referenced and searchable and can usually find the information in a few seconds.
EtherneTV-STB Admin Guide EtherneTV-STB Quick Start Guide EtherneTV-NXG Server Quick Start Guide EtherneTV-VOD W Server Quick Start Guide EtherneTV-VOD WM Server Quick Start Guide VBPresenter User Guide Printer-Friendly Click on the following link to print a hard copy of the document. ETV Portal Server User Guide ETV Portal Server Admin Guide ETV Portal Server Release Notes...
Macintosh PCs • Mac OS X with Safari 1.0 (or higher) • Firefox for Mac 1.0.4 • QuickTime Player 6.0 or higher. • Internet Explorer is not supported. • Intel-based Macintoshes play all streams except WM. Copyright Protection The Portal Server uses copyright restrictions and content expiration to protect the rights of content owners and to enforce rules against unauthorized usage or distribution.
• Set-Top Box users can use familiar remote control to navigate through video listings. • Users can search through the list of Live or On-Demand videos by , or other custom fields defined by an ETV Portal Server administrator. Description •...
Content added by users in the LAN zone will be ingested to all VOD servers for which they have permissions using the page available only if they have permissions for at least one VOD server that is also in the Internet zone.
Introduction Figure 3. Live Portal Server User Interface VB-PC Remote Controller The VB-PC Remote is a handheld infrared device you can use to control (stop/start/pause, etc.) any stream running on the Portal Server. The VB-PC Remote is compatible with Internet Explorer 6.0 or higher;...
users will also be required to install an additional plugin when they use first time (again, if they are configured with this privilege). Table 2. Supported Operating Systems and Browsers – Windows Operating System Windows 2000 Windows XP † or higher Locked-Down Windows PCs As described above, the Portal Server automatically downloads components to client PCs depending on the Global Assignment setting.
Page 23
Table 5. Port Requirements† Zone Port(s) Protocol Description Internet > Internet > 9876/9878 DMZ > Internet LAN > DMZ LAN > DMZ 9875/ 9876/ 9878 LAN > DMZ DMZ > LAN DMZ > LAN DMZ > LAN 80/8080 ETV Portal Server Admin Guide Web request from client to MCS.
( ) that is superimposed on the header image Figure 4) of the user VBrick Systems interface. To change this title go to title or leave the title blank by entering at least one space. (Note that the title is always displayed in white text and may not be visible if you use a light-colored background image.)
Note As a standard best practice, VBrick recommends changing the default administrator User Name and Password. Go to Admin Console. Admin Console Options Login to the ETV Portal Server Admin pages with a valid user name and password to display the following window.
Option Description Live Presentations Provides the ability to view and remove current live presentations from the Live Broadcasts page. Users† Used in conjunction with Access Control to limit access to the ETV Portal Server system to different users. User Groups† Used in conjunction with Access Control to limit access to the ETV Portal Server system to different groups of users.
Global Settings Global Settings include configuration settings and parameters that apply to the entire system. Global Settings include all of the following. Topics in this chapter Global Assignments ............21 Custom Fields .
Page 33
(default 120 minutes) allowed for a continuous recording. Maximum record duration limited only by size of hard drive. Changes the text (i.e. VBrick Systems) that is displayed on the upper left hand corner of the Portal Server User Interface. To leave blank, enter at least one space. Note that the title text is white and cannot be changed.
Page 35
Item Assign Content Expiration Warning Recipient Assign Mail Server Assign Presentations Select Macintosh Player for MPEG4 Content Assign AutoIngest ETV Portal Server Admin Guide Description Enter the semicolon-separated e-mail address(es) of the person(s) responsible for renewing copyrighted or otherwise protected content. When you configure or change either the recipient or the mail server, the Portal Server will attempt to send a test message.
Item Set Cisco ACNS Manifest Options Custom Fields Custom fields are used to add additional fields to the Info pages associated with stored videos and live broadcast streams. All stored videos, and those live streams that have been "customized," have an Info .
2. Choose an Available Live Stream number, and click Channel the panel on the right. 3. Optionally, add a Description on the broadcast list page and on the 4. You can also add Keywords associated with a stream. They make it easier to search for specific content. Program Name Required.
Live Stream Click on any live stream shown in the list to populate this field. Max. Concurrent Set the maximum number of concurrent viewers for this stream to Viewers unlimited or any number greater than zero. Viewing Period of Set the length of the viewing period for a file recorded with this Stream Recordings stream in hours, days, weeks, months, or years.
Page 43
FTP Password The FTP password the Portal Server uses when publishing content to the server. The default for NXG servers is default for all others is on the server, it must be changed here as well. Use any combination of alphanumeric and special characters. Publishing Local Path Maps the Publishing Directory to the physical location on the VOD server.
Page 45
This function is useful for VBrick VBStar appliances to easily transfer content from their hard drives to the VOD server. (It can also be helpful for users who acquire content outside of the ETV Portal Server, for example from StreamPlayer Plus.) When a folder is created, you must check a box in Add/Modify Folders on Selected Servers server for autoingestion.
Page 47
3. In , select one or more existing VBricks for which a SAP has been received. Select VBrick If you select one VBrick, this populates the multiple VBricks, it does not populate the panel; if you need to configure the VBricks, you must add them one at a time.) 4.
Control Devices Control devices let you configure a video source device so that it can be controlled by end users from the Portal Server user interface. (An example of a video source device is a DVD or VCR directly connected to a VBrick encoder.) Once configured, a special icon on the page indicates you can control the stream using a "virtual"...
Name Enter a unique, descriptive name that will be displayed on the virtual remote. For example in Figure 6, "Sony DVD" is the configured name shown on the controller. No embedded spaces or special characters are allowed. Source Device Select a source DVD or VCR from the dropdown list. The list shows serial port direct-connect devices and VBIR (SpitFire) devices that are tested and supported by VBrick.
Figure 8. Connecting Control Devices Table 10. Device Connectors Device MPEG-1 Encoder MPEG-2/4/WM Encoders † Typical device connector. Configuring Control Devices You also need to configure the baud rate and passthrough state of the VBrick associated with a control device. In IWS, go to the Configuration: Passthrough page and set these values as follows: Table 11.
Page 55
2. Select and click Add STBs 3. In , select one or more existing STB for which a SAP has been received. This Select STB populates the STB Configuration populate the panel; if you need to configure the STBs, you must add them one at a time.) 4.
Page 57
2. Select Add Recorders 3. Complete the fields in newly configured recorder to the previous window. If necessary see Synchronizing the Portal Server and the NVR below. Recorder Server IP address or host name of recorder server. Defaults to localhost if recorder server is on the same machine as ETV Portal Server.
Page 59
Note You can also write a script (launched from the Portal Server) that uses TCP/IP to communicate with any compatible device on the network. Contact VBrick Support Services for more information. 2. Select Add Script Devices 3. In Script Device Configuration adds the newly configured script device to the list of devices shown in the previous window.
Page 61
2. Select and click Add Scripts 3. In Script Configuration MPEG2/MPEG4/WM, or Other) from the dropdown list—and wait a few seconds for ETV Portal Server to populate the panel with a list of devices. 4. In , highlight one or more devices and use the arrow buttons to populate Select Device the right panel.
find the value associated with that parameter using a standard MIB browser or text editor. These brief procedures simply outline the basic steps which are typically performed by a programmer or a system administrator. Contact VBrick Customer Service or see the VBrick SDK User Guide for more information.
Enter a valid URL or IP address. For example: rtsp://ipaddress/programname mms://ipaddress/videoname.wmv Type Choose MPEG-1, MPEG-2, MPEG-4, MPEG-4 NXG, Document, WM, or Other. If you are creating a URL for stored video that points www.yahoo.com Other. Title This is what will display to clients in the ETV Portal Server viewing pages Folder This is the folder on the VOD server in which the video will be...
Page 67
2. Select Add Template 3. Enter a Template Name names are allowed but not recommended.) Each Schedule Type you make but basically, you select the video source (which can be a live or stored broadcast), the downstream targets (VBricks or STBs) to which it will be broadcast, and configure any Advanced Settings the template you created is available to authorized Portal Server users as an Emergency...
Page 69
Schedule Start Enter values that describe the device state at schedule start. Options • Program Name – Program name selected above. • Template – MPEG only. Screen varies for MPEG-1, 2, or 4. • Destination – Destination 1, Destination 2, RTSP Server. •...
Access Logging Access logging tracks Portal Server usage. It creates logs that let you review who has watched what content, when, and for how long. Specifically, it logs access to live or VOD content, and to user-initiated recordings. There are two output logs; one is used for live/VOD content and the other is for recordings.
Viewing the Access Logs The log files are saved in standard editor like Notepad or you can use the Excel spreadsheet template provided by VBrick. The MCSS Access Log.xlt can also use this template to build Pivot Tables to analyze the log data in greater detail. Pivot Tables are a powerful tool used to analyze multi-dimensional data.
Diagnostics This window displays information about Scheduler events only. It displays system log messages by source and time and (generally) IP address. Use Status This window shows the status of videos being added or recorded. Use necessary. Use the tree controls on the left to expand (or contract) individual entries. Click the Cancel icon to the left of each to cancel a recording or ingestion in progress.
Access Control Under the Access Control section, administrators have the ability to enable Authentication and Authorization which requires users to login and be authenticated. By default Authentication and Authorization and all functions (recording, publishing, etc.). When Access Control is enabled, ,and Groups Resource Groups...
Username Prefix Master Username Master Password Ind. Group ObjectClass Ind. Group Identifier † ETV Portal Server required field. All others are optional. Note The Softerra LDAP Browser 2.6 provides an Explorer-like LDAP client you can use to browse the LDAP tree. It is available for Windows only and can be downloaded free of charge from Softerra at http://www.ldapbrowser.com Single Sign-On To use single sign-on, go to...
Using LDAP Servers with SSL Installing the Root Certificate If the LDAP server requires SSL (Secure Sockets Layer) for encryption and authentication, you will need to install the certificate locally on the ETV Portal Server as a Certificate Authority To install the root certificate locally on the ETV Portal Server as Trusted Root Certificate Authority: 1.
To determine the valid certificate name: 1. Click View Certificate 2. The tab shows who the Certificate is issued to; the address shown is the address General that will need to be used in the browser address bar, as well as in the configuration of the LDAP Server.
group Resources into Resource Groups. This allows the administrator to quickly and easily assign several resources at once to specific Users or User Groups. Configuring for Users and User Groups 1. Setup and Configure ETV Components The following products need to be setup and properly configured prior to configuring Access Control.
LDAP administrator to allow the authentication to occur. Using LDAP reduces the amount of administrative time necessary to add and modify users from the ETV Portal Server system. VBrick Systems encourages customers who have LDAP directories implemented to use them for authentication with the ETV Portal Server.
4. Create Resource Groups on the Portal Server In the Portal Server software, providing a user with Resources refers to providing them access to a particular functionality of the EtherneTV system. These include the ability to: • View Live Channels. •...
Once all selections have been made, you can press the screen (or any of the other buttons shown above) to submit the information to the database. User privileges include the following options: Add/Modify User Information ..........83 Add/Modify User's Group Assignments .
Note The live streams shown in the Portal Server may also be restricted by a bit mask on a VBrick encoder. The Portal Server will parse the bitmask and send the live stream only to ETV clients with a IP address that matches the masked IP of the source VBrick.
STB Access Administrators can allow a user the ability to access all STBs or only specific STBs when scheduling events. When scheduling an event, users will see only those STBs for which they have been granted access. Schedule Privileges Users may have full, partial, or no permission to schedule VBrick event. Users with full privileges can modify all configuration parameters in a schedule.
Note The remaining options for ) are the same as those described earlier for individual Users on page 81. Privileges The only difference is that the descriptions will apply to groups of users rather than to individual users. Resource Groups In the ETV Portal Server software, providing a user with Resources refers to providing them access to a particular functionality of the EtherneTV system.
Authentication by PIN When an end user accesses the ETV Portal Server via a STB, the Portal Server takes the following steps to authorize users. 1. It determines if there is Authentication/Authorization information associated with the Host Name of the STB. If so, based on the STB Host Name, the ETV Portal Server will present the STB with the information appropriate to its privileges.
Configuring for SSL Overview Secure Sockets Layer (SSL) provides endpoint authentication and communications privacy over the Internet using cryptography. Whenever there is a concern regarding confidentially and integrity of management data being sent between ETV Portal Server and external clients, the ETV Portal Server user login page and all admin pages should be configured with a digital X.509 certificate to enable SSL encryption.
7. Enter the path and file name of the file that contains the response from the CA, and then click Next. 8. Examine the certificate overview, click installed on the ETV Portal Server. 4. Configure ETV Resources for SSL After installing the certificate on the ETV Portal Server, the ETV Portal Server can now be configured for SSL.
Page 107
Configuring for SSL <directory path="/" recurse="True" /> </secureWebPages> <!-- end of security settings --> ETV Portal Server Admin Guide...
installation, a subset of the Portal Server application is installed on one machine and the NVR application is installed on the same machine. If you need to add recording capacity, you can add multiple Standard NVRs necessary. You use the subset of the Portal Server application to configure the NVR (see Configuring a Standalone NVR).
Note To use a standard NVR, the Portal Server and the NVR must be installed and running. To use a standalone NVR, only the NVR application must be running. Figure 11. Portal Server "Schedule Record" Page NVR Hardware The NVR is comprised of both hardware and software. Each platform (standard or standalone) comes fully loaded with NVR software.
Configuring for Live Presentations You must perform the following steps to configure the Portal Server for each live presentation. To configure the Portal Server for a live presentation: 1. Go to Global Settings > Program Names ). Then use this same name in the Presentation This is the title that will be displayed on the presentation.
Launching a Stored Presentation To launch a stored presentation: 1. Open the Portal Server user interface. 2. On the Video Library click once to launch it in a browser. 3. Mouse over the presentation name to display the window to enter Keyword easy to find in a search.
AutoIngest Content via XML This feature lets you FTP an XML file and a target video file to the the Portal Server. It also lets you associate metadata with the video such as maximum number of viewers for copyright protection, keywords for searching, etc. The Portal Server monitors this folder for XML command files and auto-ingests any files at five-minute intervals.
Page 125
an error message if you try to add such files. VBrick provides a utility to remove the closed captions track from an MPEG-4 file if necessary. It is installed with ETV Portal Server in c:\program files\vbrick\utils To remove the closed captions track from MPEG-4 files: 1.
Database Backup Introduction The EtherneTV Portal Server uses MySQL to manage the database of users and groups, and also the video information related to content on the VOD Servers. Note that this procedure backs up information in the MySQL database only. It does not back up any video content you may have stored on attached VOD servers.
11. Click on Watch live broadcasts (Figure 14). You can use this page to select any available MPEG-2 stream. Figure 14. Live Broadcasts Page Changing the IP Address Once the Amino is initially configured as explained above, you can change the IP address as necessary using the wireless keyboard.
When a Portal Server is configured to integrate with an ACNS network, content playback is redirected to stream from ACNS nodes only if RTSP is used for video transmission. To use RTSP, verify that the Portal Server option to always use TCP is unchecked (this is the default).
Page 137
Numerics 1. Generate a Certificate Request 93 1. Setup and Configure the EtherneTV System 2. Choose an Authentication Method 79 2. Submit a Certificate Request 94 3. Install the Certificate 94 4. Configure ETV Resources for SSL 95 4. Create Resource Groups on the Portal Server 5.
Page 138
Macintosh and Linux PCs 11 Managing Rich Media Presentations 105 Modify VOD Content 65 MySQL 4 Overview 1 Port Requirements 12 Portal Server Components 6 Portal Server Installation 10 Program Names 60 Recorders 46 Removing a Live Presentation 108 Resolving Other Security Alerts 74 Resource Groups 75 Resources and Resource Groups 78 Schedule Privileges 87...