Summary of Contents for VBrick Systems Portal Server ETV v4.2.1
Page 1
VBrick EtherneTV Portal Server EtherneTV v4.2.1 Portal Server Admin Guide May 9, 2008 4410-0118-0008...
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.2.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 EtherneTV Backup Amino Set Top Box ACNS Configuration Rebranding the User Inte rface NXG-to-VOD- W Content Migration Purchased Content Ingestion Manual System Backup 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.
Font Conventions is used to describe dialog boxes and menu choices, for example: Arial bold Start > All Programs > VBrick Courier fixed-width font is used for code elements (C++, HTML) as well as filenames, directories, etc. Black Courier fixed-width font is used to indicate user input in keyboard commands, scripts, etc.
PC Type Requirements Macintosh PCs • Mac OS 10.3 or higher for PowerPC. • Mac OC 10.4 or higher for Intel-based PC. • Firefox for Macintosh 2.0 or higher. • QuickTime Player 6.0 or higher. • Internet Explorer on a Macintosh is not supported. Linux PCs •...
• 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 •...
servers assessable to LAN users only (within a secured corporate network and behind a firewall) are called LAN-zone servers. 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 time (again, if they are configured with this privilege). Table 3. Supported Operating Systems and Browsers – Windows Operating System Windows 2000 Windows XP Windows Vista † or higher Locked-Down Windows PCs As described above, the Portal Server automatically downloads components to client PCs depending on the Global Assignment setting.
Operating System Linux Fedora Core 4 † Use version shown or higher. Port Requirements The drawing below, and the table that follows, show the required port configuration for various Portal Server devices. All ports in the drawing are TCP except as noted. Table 6.
Page 27
Table 7. Portal Server License Files License File Description Warm Backup Server If you purchased ETV Backup, two Portal Servers will be present—one of which must be configured as a warm backup. Use this option (and the popup shown below) to enable or disable the backup server.
Admin Console Options Login to the ETV Portal Server Admin pages with a valid user name and password to display the following window. This window provides access to all admin configuration options. Table 8. Admin Options Option Description Getting Started The ETV Portal Server splash page shown above.
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 ............19 Custom Fields .
Page 33
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 Set Expired VOD Content Treatment Assign Content Expiration Warning Recipient Assign Mail Server Assign Presentations Select Macintosh Player for MPEG4 Content ETV Portal Server Admin Guide Description Specifies whether expired content will be kept or automatically deleted at the expiration date. Enter one e-mail address for the person who is responsible for renewing copyrighted or otherwise protected content.
Item External Player Mode Client Multiple Monitor Setup 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,"...
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 41
IP or Domain This is the primary IP address or Host Name of the VOD server for LAN users (see also Name or IP address entered into the ETV Portal Server must be accessible by the ETV Portal Server. (If the network supports Windows 98 users, you must use the IP address.) Server Description This allows the administrator to define a descriptor such as location.
Page 43
Figure 5. Add VOD-WM Server Domain or When the ETV Portal Server and the VOD-WM server reside in the same Machine Name domain, this is the name of that domain. When workgroups are being used, this is the machine name of the VOD-WM server. Note: the machine name is not the IP address of the server.
Page 45
Note • The publishing point name within a server must be unique. You cannot add a publishing point that already exists in MCS database. • The publishing point FTP directory within a server must be unique. • If free space information is available at the time a publishing point is added, it must be greater than the entered Low Space Threshold.
Page 47
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 49
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.
Note In some cases you may be able to control a source device using the front panel or the handheld remote that came with the unit, but this is not always possible. For example, if the remote gets lost or the source DVD and/or VCRs are rack-mounted in an inaccessible metal enclosure, you must use the Portal Server interface or a VBIR.
Page 53
Name Enter a unique, descriptive name that will be displayed on the virtual remote. For example in Figure 7, "Sony DVD" is the configured name shown on the controller. No embedded spaces or special characters are allowed. Device Select a device from the dropdown list. The list shows serial port direct-connect devices and VBIR (SpitFire) commanded devices that are tested and supported by VBrick.
the online help for the encoder. You can also control devices using VBrick's VBIR remote controller. To use the VBIR remote controller, you connect the VBIR SpitFire device to COM1 or COM2 on the VBrick encoder. The VBIR subsequently communicates with the DVD or VCR via infrared commands (see Figure 9) at the configured baud rate.
Page 57
Global Settings To add an STB configuration: 1. Go to Global Settings > Set Top Boxes 2. Select and click Add STBs Submit ETV Portal Server Admin Guide...
Page 59
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 61
To add a Script Device configuration: 1. Go to Global Settings > Script Devices 2. Select Add Script Devices 3. In Script Device Configuration the newly configured script device to the list of devices shown in the previous window. To modify a Script Device, first delete the device and then repeat these steps. Device Name Any user-defined name.
Page 63
2. Select and click Add Scripts 3. In Script Configuration 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.
To locate a parameter name by viewing the source code: 1. Find the Parameter Name 2. Then locate the parameter name by viewing the source code of the page. To find the parameter value: 1. Locate the parameter name as described above. 2.
Stream Type URL Syntax http://172.22.2.147/vbs1http.asx http://172.22.2.147/vbrickvideo1 Where the program name. Note that the WM IPR does not support RTSP streams. Other ASX Files http://172.1.1.1/file.asx http://myHost/file.asx http://www.myCompany.com/files/file.asx MP3 and WMA Files http://172.1.1.1/file.mp3 http://myHost/file.mp3 http://172.1.1.1/file.wma http://myHost/file.wma WMV Files http://www.myCompany.com/files/file.wmv mms://www.myCompany.com/files/file.wmv Add VOD Content Administrators can manually enter URLs to VOD content that is not automatically displayed by the Portal Server.
The URL must point to a web server or a local drive. The Portal Server server can act as the web server for this content, if the content is placed in the directory on the ETV Portal Server (or in any subdirectory you create, e.g..
Page 71
Note Advanced Settings configuration parameters. It is unlikely you will ever need to change these settings. In all cases you can safely ignore the ETV Portal Server. Template name Alphanumeric characters or spaces. No special characters. Schedule Type Live Broadcast •...
Alert Templates available to ETV Portal Server users from the Portal Server application. See the ETV Portal Server User Guide for more information. Program Names Program Names are used with live presentations. A displayed on the Live Broadcasts Live Channel privileges. Program names are also used to set permissions for live presentations and all defined Program Names are displayed in the window.
Folders Select a folder location for the playlist. The default folder is the private MyMedia Title Use any alphanumeric characters except ' ^ : * ? | [ ] ( ) < > % # Owner The owner is the logged-in user who created the playlist. Access Logging Access logging tracks Portal Server usage.
Global Settings Using EthernetTV Reporter If you purchased a separate license, you can use VBrick's powerful "EtherneTV Reporter" log analysis tool to examine the access logs. EtherneTV Reporter is a dedicated log file analysis tool. It reads individual log files generated by the Portal Server and generates a graphical statistical report based on the contents of the log data.
Page 81
provided by a Channel Guide Server. Note that the unless you have a Channel Guide Server license installed on the Portal Server (see Installing Portal Server License Files on page 14 for more information). All currently defined stations are shown in the Stations List The Portal Server discovers all available live streams on the network.
Name Required. Name assigned to the station that will display on the popup when you mouseover the icon on the Live Broadcasts page. Channel Required. Unique number that will display on the popup when you mouseover the icon on the Live Broadcasts page Description Optional.
Link Type • Web page URL – Enter a valid URL or copy and paste one from your web browser. • Uploaded File – Browse to select an upload file. This can be a PowerPoint, an image, or any file you want to make available to end users.
Note The message "Program Unavailable" in the Channel Guide means there is no programming data associated with the stream. It does not mean the stream itself is unavailable. You can still click on the stream to launch it in the preview window. Edit Custom Programs To edit a Custom Program: 1.
Valid Licenses This dropdown displays a list of all currently valid licenses for content purchased from VBrick. Select the license you wish to update. Update all content Use this field to update the expiration dates of purchased content. First expiration for the install the license you receive from VBrick (see Installing Portal Server selected license License Files on page 14).
are shown on the navigation bar. Access control determines what Resource Groups functionality is available to each user. For example some users may have unlimited access, while others can only view certain live channels and may not have permission to record live channels or add videos to the VOD server.
Attribute for Usernames† Attribute for Groups† User Base DN 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.
Using Single Sign-On To use single-sign-on (and avoid username/password prompts), you must do one of the following: • Access the Portal Server by the alphabetical name (for example • Access the Portal Server by the IP address in which case you must also add the Portal Server to the Local Intranet Zone pushed company-wide by an administrator using security policies.
Resolving Other Security Alerts If you are receiving any other Security Alerts you will need to identify the problem as either "out of date" or The name on the security certificate is invalid. name, follow the steps below to determine the valid name. If the certificate has an "out of date"...
Logout This command logs you out of the application and lets you log back in as a different user. This may be necessary to gain access to certain functionality. For example, some users may not be allowed to create thumbnails and you may want to login as a user who has the permissions to do this.
Configuring 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. 1. ETV Portal Server – The ETV Portal Server needs to be properly setup and configured on the network.
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 ..........95 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. You can use this feature in addition to the Portal Server authorization features.
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 Configuring Users on Privileges page 93. 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.
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. Note that the ETV Portal Server uses the least restrictive settings when providing access to the system.
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.
5. Select Server Certificate 6. Select Process the pending request and install the certificate 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.
NVR Performance Considerations The NVR 40 lets you record any combination of up to 40 MPEG-1, MPEG-2, MPEG-4, and WM streams at a time. There are however performance considerations when recording multiple, simultaneous, high-rate MPEG-2 or WM streams. At MPEG-2 rates up to 5.5Mbps or WM rates up to 1.2Mbps 40 simultaneous recordings are supported.
Allow Content Recording Schedule Privileges Configuring a Standalone NVR To configure a standard NVR in a Standalone NVR Installation: 1. Login to the Standalone NVR Admin Console using the host name or IP address of the Standalone NVR machine. For example: 2.
VBPresenter Note VBPresenter v2.x works with VBrick's WM or MPEG-4 appliances and uses the Windows Media Player interface. VBPresenter v3.x supports VBrick WM video only. It delivers an advanced interactive viewer interface using Microsoft's Silverlight technology. VBPresenter v3.x requires VBDNA v4.2 or above for direct streaming from a WM appliance to viewers.
this combination of FTP user name and password must place the user into the FTP root directory of the Portal Server. (This is not the same as the directory is a virtual directory in IIS. This directory is the root folder for live Presentations presentations only.) There is an made in the Admin console are stored in the Portal Server and do not actually configure IIS.
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 autoingest video files by placing an .xml file in the on 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. As explained below there are three ways (see Table 14) to use this feature depending on where the source files are located.
Page 137
</AutoIngestCmd> Table 15. AutoIngestXML Tags Description Command Required. Must be set to MCSTitle Required. Cannot be blank. Must begin with "/" and contains fully qualified path to destination VOD folder/title on the Portal Server. The autoingest user name must have publishing rights for VOD target folder.
EtherneTV Backup This chapter explains how to use ETV Backup to create a warm back Portal Server. If you did not purchase ETV Backup, you can backup key Portal Servers files and directories manually. See Manual System Backup on page 163 for details. Topics in this chapter Overview .
Configuring ETV Backup To configure EtherneTV Backup, you must perform all of the following steps in the exact sequence shown. 1. Enable the Warm Backup Server If you purchased ETV Backup, two Portal Servers will be present at your site—one of which must be configured as a warm backup.
3. Be sure a user with administrative privileges on the server machine is shown in the box. Press Set Password 4. Press and minimize the application—do not exit. 5. Reset Database Backup Versioning This step is important. Do not omit this step. To reset database backup versioning: 1.
Turning a Warm Backup Server into a Live Server A Portal Server can experience a hardware failure for a variety of reasons. If the hardware fails, you will be unable to communicate with the server via a web browser, the Remote Desktop utility, or any other means.
Figure 16. Amino MCS Home Page 11. Click on Watch live broadcasts (Figure 17). You can use this page to select any available MPEG-2 stream. Figure 17. 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.
Page 151
Table 18. Video Output with a Widescreen (16:9) TV: TV Display Format Widescreen TV ETV Portal Server Admin Guide Video Output 16:9 video plays normally and 4:3 video has black bars left and right (pillar box). This relies on the TV responding to aspect ratio switching signals on VBI line 23 (PAL only).
3. Check Enable manifest generation specify an interval (default = 10 minutes) that defines how often the file will be regenerated. 4. Click when done. Submit 5. Click to create an "on demand" manifest file. The Portal Server will create Generate Now (and periodically overwrite) a manifest file called Files\VBrick\MCS\Cisco...
Amino set top box, and the WM IP Receiver. On the Portal Server you can also change the default title ( VBrick Systems change this title, open the Portal Server Admin Console and go to ; then enter a new title or leave the title blank by entering at least one space.
Page 159
Modify #header tag – add: background-image: url(yourLogo.jpg); .headerLogo – change to: display:none; Header Client Branding (Left hand text in header) Files to Change css/MCSv4.css Classes .header_ClientBranding Modify Any attributes for font and color. Page Margins and Borders Files to Change css/PC_HighRes.css, css/PC_LowRes.css Classes #workspace...
Increasing the Ingestion Rate You can make the migration process substantially faster by increasing the rate at which files are ingested on the VOD-W server. To increase the ingestion rate: 1. On the VOD-W server, go to Advanced 2. Set the Transfer Rate 3.
Assets Filter Optional. Enter an alphabetic substring to search for matching files and click File Names Select the video files to be migrated from the complete list of files in the asset list. Use appropriate. Note that highlighted) files and not checked files. Schedule Start On Start date.
d. Set permissions to allow for anonymous FTP and close IIS. 3. Copy the Excel spreadsheet from the flash drive to your 4. Install the license file (for example utility. Remove Programs Go to Start > Control Panel > Add or Remove Programs > VBrick Media Control Server Suite b.
4. After mass ingestion is complete, review the total results displayed on the Mass Ingestion utility. (The total results cannot be saved.) On the Portal Server, open Microsoft Office Excel Viewer 2003, view the Excel spreadsheet from the MCS failures on columns A, C and E. The columns should be populated with True and if False is shown, a failure has occurred.
Manual System Backup This chapter explains how to manually backup key system files and directories on the Portal Server. If you purchased EtherneTV Backup, this process is automatic. See EtherneTV Backup on page 127 for details. 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.
Numerics 1. Generate a Certificate Request 105 1. Setup and Configure the EtherneTV System 2. Choose an Authentication Method 91 2. Submit a Certificate Request 106 3. Install the Certificate 106 4. Configure ETV Resources for SSL 107 4. Create Resource Groups on the Portal Server 5.
Page 178
Overview 1 Port Requirements 13 Portal Server Components 6 Portal Server Installation 10 Program Names 61 Recorders 46 Removing a Live Presentation 118 Resolving Other Security Alerts 85 Resource Groups 86 Resources and Resource Groups 90 Schedule Privileges 99 Script Devices 48 Scripts 50 Securing the Portal Server User Pages 107 Server Requirements 2...
Need help?
Do you have a question about the Portal Server ETV v4.2.1 and is the answer not in the manual?
Questions and answers