Table Of Contents
Cisco IP/TV Release 5.2 Addendum
New Features and Enhancements in IP/TV Release 5.2
Failover Support for Live Capture and Recording
Creating a New Scheduled Live-Capture Program with Failover Support
Adding Failover Support to an Existing Scheduled Program
Setting Up Failover Support for an IP/TV Recording
Switching Between IP/TV Broadcast Servers
Configuring .ini File Variables for Failover Support
Higher Resolution for SlideCast Using MPEG-4
Web-Based Program Guide Customization
Multibyte Character Set Support
Additional Documentation Changes
Recording and Streaming of MP2T Streams
Playing Back MP4 Files Locally in the QuickTime Player
Integrating IP/TV with an ACNS Network
Creating an ACNS Network Website with Content Routing Support
Playing Nonhinted On-Demand Programs over an ACNS Network
ACNS Software CLI Commands for IP/TV Program Manager
Starting and Stopping IP/TV Program Manager
Managing the Database in IP/TV Program Manager
Obtaining Technical Assistance
Cisco Technical Support Website
Definitions of Service Request Severity
Obtaining Additional Publications and Information
Cisco IP/TV Release 5.2 Addendum
Note
The most current Cisco documentation for released products is available at Cisco.com at http://www.cisco.com. The online documents may contain updates and modifications made after the hardcopy documents were printed.
Documentation Survey
Is Cisco documentation helpful? Click here to give us your feedback.
Contents
•
New Features and Enhancements in IP/TV Release 5.2
•
Additional Documentation Changes
•
Obtaining Technical Assistance
•
Obtaining Additional Publications and Information
Introduction
The Cisco IP/TV Release 5.2 Addendum document supplements the information available in Cisco IP/TV Release 5.1 documentation. The Cisco IP/TV Release 5.2 Addendum document describes the new features introduced in Cisco IP/TV Release 5.2. It also explains enhancements and modifications to Cisco IP/TV Release 5.1 as well as the documentation changes that occurred after the Cisco IP/TV Release 5.1 documentation was released.
Note
Read the Cisco IP/TV Release 5.2 Addendum document in conjunction with the Cisco IP/TV Release 5.1 and Release 5.2 documentation.
If you are not familiar with the Cisco IP/TV product and the documentation conventions, we recommend that you refer to the Cisco IP/TV Release 5.1 documentation before reading this document.
Cisco IP/TV Release 5.1 documentation is located at:
http://www.cisco.com/univercd/cc/td/doc/product/webscale/iptv/iptv51/index.htm
Cisco IP/TV Release 5.2 documentation is located at:
http://www.cisco.com/univercd/cc/td/doc/product/webscale/iptv/iptv52/index.htm
Cisco ACNS Release 5.2 documentation is located at:
http://www.cisco.com/univercd/cc/td/doc/product/webscale/uce/acns52/index.htm
The "Product Overview" section of this document briefly describes Cisco IP/TV software and its various components.
The "New Features and Enhancements in IP/TV Release 5.2" section explains the new features and enhancements in Cisco IP/TV Release 5.2. This section also covers the procedures for implementing the new features.
The "Additional Documentation Changes" section explains the corrections and modifications applicable to the Cisco IP/TV Release 5.1 documentation.
Product Overview
Cisco IP/TV is a network-based application that delivers live or prerecorded, on-demand or scheduled programs to an unlimited number of users over any IP-based local- or wide-area network. Synchronized presentations and screen captures are also supported, in addition to a wide range of video management functions.
Cisco IP/TV Release 5.2 interoperates with a Cisco Application and Content Networking System (ACNS) network running Cisco ACNS software, Release 5.2. Interoperability with an ACNS network provides a single integrated content delivery platform for the streaming operations of IP/TV.
Cisco IP/TV consists of three components: IP/TV Viewer, IP/TV Program Manager (known as Content Manager in versions earlier than Release 5.1), and IP/TV Broadcast Server.
IP/TV Viewer is the client component and is available as software only, whereas IP/TV Program Manager is an application that runs on Cisco Content Engine hardware. Refer to the Cisco IP/TV Viewer
User Guide for more information on Cisco IP/TV Viewer software. For more information on IP/TV Program Manager, refer to the Cisco ACNS Software Program Manager for IP/TV User Guide.IP/TV Broadcast Server components are available either as a software-only application or as a hardware appliance. As a software-only option, these components must run on third-party PC systems that meet the minimum requirements of the specific IP/TV component. As a hardware appliance, IP/TV Broadcast Server comes as part of the Cisco IP/TV 3400 Series Server hardware. Each IP/TV 3400 Series Broadcast Server has IP/TV Server software preinstalled on it.
For more information on IP/TV Broadcast Server, refer to the Cisco IP/TV Broadcast Server User Guide. Refer to the Cisco IP/TV 3400 Series Servers User Guide for more information on server hardware configuration and setup.
New Features and Enhancements in IP/TV Release 5.2
Cisco IP/TV software Release 5.2 introduces the following features and enhancements:
•
Failover Support for Live Capture and Recording
•
Higher Resolution for SlideCast Using MPEG-4
•
Web-Based Program Guide Customization
•
Multibyte Character Set Support
Failover Support for Live Capture and Recording
Cisco IP/TV software Release 5.2 introduces a failover mechanism to ensure seamless streaming and recording of live streams. In Cisco IP/TV, failover support is implemented on a per program basis. You can set up an IP/TV Broadcast Server to act as the backup for a primary IP/TV Broadcast Server streaming or recording a particular program. When the primary IP/TV Broadcast Server fails, the backup IP/TV Broadcast Server takes charge of the streaming and continues the program. This process is transparent to an end user viewing the program on IP/TV Viewer. However, viewers using the Apple QuickTime Player may want to close and restart the player if the program fails to continue properly after the primary IP/TV Broadcast Server fails. Viewers using the Apple QuickTime plug-in can continue the program by refreshing the browser window.
Note
To ensure that failover works correctly, you must upgrade all three IP/TV components to Cisco IP/TV software, Release 5.2. Seamless failover does not work with Cisco IP/TV versions earlier than Release 5.2.
The primary and secondary IP/TV Broadcast Servers regularly exchange data packets, known as heartbeats, with each other to inform one another about the status of the live program and of the backup IP/TV Broadcast Server. The interval between such messages is configured using the HeartBeatTxInterval variable in iptvserv.ini file. If the backup IP/TV Broadcast Server does not receive any heartbeat messages during the specified timeout period called HeartBeatTimeout, it takes over as the streaming server, because the lack of heartbeats indicates that the primary IP/TV Broadcast Server is down or not functioning.
For more information about setting up the iptvserv.ini variables for failover support, see the "Configuring .ini File Variables for Failover Support" section.
The capture cards on the backup IP/TV Broadcast Server should support the same type of encoding as that on the primary IP/TV Broadcast Server. When you configure failover support for a program, make sure that you choose the same type of capture card, one that supports same type of encoding, on both servers.
You can choose a backup server while creating a new scheduled program, or add one later from the Edit Scheduled Program window. For more information on setting up a backup server for scheduled programs, see the "Creating a New Scheduled Live-Capture Program with Failover Support" section.
Cisco IP/TV Release 5.2 supports failover for MOV and native MPEG and MP4 recordings. When you create a recording for a program that has failover support enabled, the New Recording window of IP/TV Program Manager allows you to choose a backup IP/TV Broadcast Server for the recording failover. Both primary and backup IP/TV Broadcast Servers record the stream and create two separate files with the same attributes. Even if one server fails, the other continues with the recording and creates the file. For more information about setting up failover support for recording, see the "Setting Up Failover Support for an IP/TV Recording" section.
Creating a New Scheduled Live-Capture Program with Failover Support
To create a new scheduled live-capture program with failover support, you must configure failover servers for its different media streams as explained in Step 19. (See Table 2).
To create a new scheduled live-capture program with failover support, follow these steps:
Step 1
In the IP/TV Program Manager main window, click the Scheduled Programs link. The Scheduled Programs window appears.
Step 2
In the Scheduled Programs window, click the New Program link in the banner bar. The New Scheduled Program Channel Selection Window appears. (See Figure 1.) If IP/TV is set up as part of an ACNS network the New Scheduled Program window displays the ACNS Network Information section also. (See Figure 2.)
Figure 1 New Scheduled Program Window—Standalone IP/TV
Step 3
Choose a channel or choose None from the Select the Channel drop-down list. See the "Assigning
Programs to Channels" section in Chapter 6 of the Cisco ACNS Software Program Manager for IP/TV
User Guide for more information about channels.Step 4
Choose either of the following program types.
•
Basic Live Capture Program: Click this radio button if the program you want to create is a live-capture program.
•
Advanced Program (Show All Options): Click this radio button if you want to view all possible program options, or if the program is to be inserted into an ACNS network.
Note
Failover is not supported for basic media file programs, that is, file-based scheduled programs, so do not click the Basic Media File Program radio button.
Figure 2 New Scheduled Program Window—IP/TV Integrated into an ACNS Network
Step 5
If you want to distribute the program over an ACNS network, follow Step 6 through Step 10. If you do not want to distribute the program over an ACNS network, go directly to Step 11.
Step 6
From the ACNS Network Information section of the New Scheduled Program window (see Figure 2), click the Select Website button to choose the ACNS network website.
Note
The ACNS Network Information section is displayed only if IP/TV Program Manager is configured as a part of an ACNS network.
The IP/TV Browse Websites window appears, listing all the websites for which this IP/TV Program Manager is the origin server.
Step 7
Choose the website that has the channel to which you want to add the program.
Step 8
Click the Select Channel button.
The IP/TV Browse Channels window appears. It lists all the live channels associated with the ACNS network website that you chose in Step 6.
Step 9
Choose the channel to which you want to add the program.
Step 10
Click Create Program to create a new scheduled program.
The New Scheduled Program window appears. (See Figure 3.) Depending on the program type you chose in Step 4, some of the options shown may not appear. When IP/TV is integrated into an ACNS network, the New Scheduled Program window displays the name of the ACNS network channel with which the scheduled program is associated.
Figure 3 New Scheduled Program Window
Step 11
Enter the program name. Use a fairly short name, such as Third-Quarter Sales Projections or New Employee Orientation. This is a mandatory field.
Note
IP/TV Program Manager permits a name up to 60 characters long. However, when the name of the program is displayed in IP/TV Viewer or in other IP/TV Program Manager windows, the name may be truncated to fit within the display area. For this reason, it is good practice to use short program names.
Step 12
In the Program Information section of the New Scheduled Program window, enter a description of the program in the Description field. This field allows you to enter a longer description of the program than the Program Name field permits. The maximum number of characters permitted in the Description field is 512.
Step 13
If there is a website that provides additional information about the program, you can enter the URL in the URL Link field.
If you enter a URL, a user watching this program on IP/TV Viewer can click the URL and go to the website.
Step 14
If the program contains copyrighted material, you can enter a copyright statement in the Copyright field.
Step 15
If the program is not assigned to an IP/TV channel, you can set a password for the program by entering the password in both the Password and the Confirm Password fields. Only users who know the password are able to view the program. If the program is assigned to an IP/TV channel, it inherits the password from the channel.
Note
Passwords are applicable only in standalone IP/TV environments. The ACNS network does not support password-protected programs. If ACNS network information has been entered in the ACNS Network Information section of the New Scheduled Program Window, IP/TV Program Manager does not display the password fields in the New Scheduled Program window.
The password protects the audio, video, and SlideCast streams in the program. If the program includes a web presentation stream, the web presentation stream is not protected.
Note
Password-protected programs cannot be viewed by users of the Apple QuickTime player. Such programs can only be viewed using IP/TV Viewer.
Step 16
If you want to enable Question Manager for this program, check the Question Manager check box. See the "Using Question Manager" section in Chapter 6 of the ACNS Software Program Manager for IP/TV User Guide for more information about the Question Manager function.
Step 17
If you do not want the program to be announced or to appear in program listings, but you do want to save the program information, check the Hide the Program from Viewer/SAP Announcements check box.
Step 18
In the Schedule section of the window, enter the program schedule. (See Figure 4.)
Figure 4 Schedule Section of the New Scheduled Program Window
Table 1 briefly describes the schedule options.
Step 19
In the Multimedia Source Information section of the New Scheduled Program window, enter information about the program. Figure 5 shows an example of the options for a basic live-capture program.
If the program is assigned to a channel, nearly all of these options are determined by the channel defaults. In this case, the only options that appear are the check boxes for video, audio, SlideCast, and web presentation.
The options that appear in the window also differ depending on whether you chose Basic Live Capture Program or Advanced Program in the New Scheduled Program window.
Figure 5 Multimedia Source Information—Live-Capture Program
Table 2 describes the options in the Multimedia Source Information section for a basic live-capture program.
Table 2 Multimedia Source Information Options
Field DescriptionPreferred Video Format
Defines the preferred video format. This field defaults to the format specified in the Preferences window. Choices include H.261, Indeo, MPEG-1, MPEG-2 full D1, MPEG-2 half D1, ISO MPEG-4, Microsoft MPEG-4, and other Video for Windows codecs.
Compression Quality
Sets the H.261 compression quality level. Applies only to live-capture video compressed with the H.261 codec. The default value is 8.
Preferred Audio Format
Sets the format to be used for live-capture audio. This field defaults to the format specified in the Preferences window.
Video Frame Size For `MPEG4 - ISO' Format (Width x Height)
Sets the ISO MPEG-4 frame format to either predefined or customized dimensions in pixels (width x height). Unlike other codecs, the resolution cannot be changed in the IP/TV Server configuration. By default, the Preferred Audio Format option is set to AAC, 32000 Hz stereo.
Refer to the Cisco IP/TV Broadcast Server User Guide for ISO MPEG-4 minimum requirements.
Play Video
Defines whether the video portion of the file or live-capture stream is included in the program. The Enable QoS?1 check box allows you to choose to enable Quality of Service (QoS), if supported on your network.
Play Audio
Defines whether the audio portion of the file or live-capture stream is included in the program. The Enable QoS?1 check box allows you to choose to enable QoS, if supported on your network.
Play SlideCast
Defines whether the program includes a SlideCast portion in addition to video or audio. The Enable QoS?1 check box allows you to choose to enable QoS, if supported on your network.
For basic live-capture programs two choices of SlideCast playback format are available: H.261 and MPEG-4.
You have two encoding resolutions available for SlideCast using MPEG-4. Choose either 640x480 or 352x288 (CIF) resolution from the drop-down list next to the MPEG-4 radio button.
Note
A scheduled program cannot contain both SlideCast and web presentation portions.
See Chapter 8, "Managing Online Presentations," of the Cisco ACNS Software Program Manager for IP/TV User Guide for information on the SlideCast feature.
Play Web Presentation
Defines whether the program is a web presentation in addition to video or audio.
For information on the Web Presenter feature, see Chapter 8, "Managing Online Presentations," of the Cisco ACNS Software Program Manager for IP/TV User Guide.
Note
The Play Web Presentation and related options are not available for programs that are inserted into an ACNS network.
Multicast content to client (required for ScreenCaster)2
Pushes the HTML pages and embedded graphics files of the web presentation to the client browser. If this option is checked, the pages are multicast to all viewers. If the option is unchecked, the browser of each viewer individually requests the HTML pages, and the server unicasts the pages to each requester, which adds the cumulative bandwidth required to deliver the HTML pages to the bandwidth required for the program itself.
Serve Over MPEG2 Transport
Enables MPEG-2 transport (MP2T) streaming capability. The Preferred Video Format option must be set to MPEG-2 full D1 or MPEG-2 half D1. The Preferred Audio Format option must be set to MPEG. The MPEG-2 transport option allows a program with a valid MPEG-2 transport file to be streamed as a single composite stream, instead of separate audio and video streams. MP2T is the standard format used in the cable industry.
AudioPID
Specifies the audio packet ID (PID) of the program. The range is 16 through 8190.
VideoPID
Specifies the video packet ID (VID) of the program. The range is 16 through 8190.
Share SlideCast with3
Specifies whether the program you are defining includes the SlideCast stream from the program you choose in the list.
Share Presentation with3
Specifies whether the program you are defining includes the web presentation stream from the program you choose in the list.
Audio/Video Bandwidth
Sets the audio/video bandwidth in kilobits per second (kbps). The default is 1150.
Note
If the preferred video format of the program is ISO MPEG-4, you cannot change the bandwidth setting of the program directly. To change the bandwidth, you must change the video frame rate or the source video size.
Maximum Video Frame Rate
Sets the maximum number of frames per second for the video portion of the program. Applies only to MPEG live-capture streams and MPEG files. The default is 30.
Start Page URL (Optional)
Specifies the HTML page that the user goes to at the start of the presentation. It can be either a URL Internet address or the full path name of an HTML file on the local hard drive of the server, for example, http://www.cisco.com or C:\BoardMtg\slide001.htm.
Audio/Video Server
Specifies the name or IP address of the IP/TV Server assigned to play the audio or video portions of the program. Either click the Select a server from this list radio button and choose a server from the drop-down list, or click the Enter a new server name radio button and enter the name of a new server in the accompanying field.
Select Capture Card
Assigns the capture card port for live capture. The drop-down list shows the available capture card ports depending on the codec selected. For MPEG-1 and MPEG-2, 3 ports (1, 2, and 3) are available, whereas for other codecs, there are 6 available ports: 1, 2, 3-Port 1, 3-Port 2, 3-Port 3, and 3-Port 4.
Select a Backup Server from this List
(Optional; mandatory if you want failover support for a live-capture program) Assigns a backup audio-video server for a live-capture program. Choose a server from the list. Make sure that the backup server has the same capture card settings as those of the primary IP/TV Server.
Select Capture Card (for Backup Server)
Assigns the capture card port for live-capture failover. The drop-down list shows the available capture card ports depending on the codec selected. For MPEG-1 and MPEG-2, 3 ports (1, 2, and 3) are available, whereas for other codecs, there are six available ports: 1, 2, 3-Port 1, 3-Port 2, 3-Port 3, and 3-Port 4.
SlideCast/Web Presentation Server
Specifies the name or IP address of the IP/TV Server assigned to play the SlideCast or web presentation. Either click the Select a server from this list radio button and choose a server from the drop-down list, or click the Enter a new server name radio button and enter the name of a new server in the accompanying field.
Note
For an audio-only SlideCast program, the SlideCast server can be the same as the audio-video server.
Select a backup server from this list
(Optional; mandatory if you want failover support for the live-capture program) Assigns a backup server for a SlideCast or web presentation stream of the live program. Choose a server from the drop-down list.
Note
For a program containing audio, video, and SlideCast streams, you cannot assign the primary or backup audio video server as the backup server for SlideCast.
1 The Enable QoS Option is not available for programs assigned to ACNS network channels.
2 This option must be chosen if the HTML pages are to be served by a server that is not configured as a web server or is not accessible to the browser of the user. This option must also be chosen for Web Presenter programs that multicast content captured with ScreenCaster, either live or from a previously recorded .mp4 file.
3 The start and end time of the program you are defining must be within the range of the program that contains the SlideCast or web presentation stream.
Step 20
Enable QoS (Quality of Service) for improving transmission quality, if supported on your network.
Note
The Enable QoS option is not available for programs that are inserted into an ACNS network.
The Enable QoS? check box to the right of the Play Video, Play Audio, and Play SlideCast check boxes lets you enable QoS using RSVP (Resource Reservation Protocol). QoS provides superior transmission quality in networks with RSVP-enabled routers running under Windows 2000.
Step 21
In the ACNS Network Delivery Mode section (see Figure 6), choose the mode of content delivery over the ACNS network. (See Table 3.)
Figure 6 ACNS Network Delivery Mode
Note
The ACNS Network Delivery Mode section is available only for programs that are assigned to an ACNS network channel. This section is not displayed if ACNS network channel information has not been entered for the program.
Step 22
In the Multimedia Address Information section of the New Scheduled Program window, enter information about the program.
The options that appear in the window differ depending on whether you chose Basic Live Capture Program or Advanced Program in the New Scheduled Program window. Most of these options also depend on whether the corresponding global option to allow them to be selected is enabled or not (in the Preferences window).
Note
If the program is to be delivered over an ACNS network using live multicast mode, you must use the same multicast IP address for audio, video, and SlideCast streams.
See Chapter 3, "Setting Up IP/TV Program Manager," in the Cisco ACNS Software Program Manager for IP/TV User Guide for more information on source-specific multicast (SSM) and multicast address.
Figure 7 shows an example of the Multimedia Address Information options for a basic live-capture program.
Figure 7 Multimedia Address Information—Live-Capture Program
Table 4 describes the options in the Multimedia Address Information section for a basic live-capture program.
Figure 8 shows an example of the Multimedia Address Information options for an advanced program.
Figure 8 Multimedia Address Information—Advanced Program
Table 5 describes the Multimedia Address Information options for an advanced program that are not explained in Table 4.
Table 5 Multimedia Address Information—Advanced Program
Field DescriptionSelect Global Scoped Addresses1
Determines whether globally scoped addresses will be used for the program. This option is not available unless the option to allow administratively scoped addresses is enabled globally (in the Preferences window).
Select Addresses Manually1
Allows the user to specify multimedia address information for the program. This option is not available unless the option to allow modifications of IP addresses, UDP ports, and multicast range is enabled globally (in the Preferences window).
Multicast TTL Range1
Sets the multicast range for the program.
Defines the video IP address for the program.
Video UDP Port1
Defines the video UDP port for the program. See Table 6 for UDP port ranges.
Defines the audio IP address for the program.
Audio UDP Port1
Defines the audio UDP port for the program. See Table 6 for UDP port ranges.
Defines the IP address for the SlideCast or web presentation portion of the program.
SlideCast/Presentation UDP Port1
Defines the UDP port for the SlideCast or web presentation portion of the program. See Table 6 for UDP port ranges.
Use SSM1
Enables SSM for the program when multimedia addresses are configured using the Use these Addresses option.
1 This option is available only if the Allow modification of IP addresses, UDP ports and Multicast Range check box is checked in the Preferences window.
2 If the program is to be delivered over an ANCS network using live multicast mode, you must use the same multicast IP addresses for audio, video, and SlideCast streams.
Table 6 lists the UDP port ranges used by IP/TV Program Manager for various types of data streams. If you decide to specify port numbers explicitly rather than letting IP/TV Program Manager assign them, you should choose even-numbered ports within these ranges.
Table 6 UDP Port Ranges
Type of Stream Port Number RangeAudio
16,384 through 32,766
Web presentation
32,768 through 49,150
Video or SlideCast
49,152 through 65,534
Step 23
In the Contact section of the New Program window, indicate whom users can contact if they have questions about the program.
Step 24
Click Create Program to send the form to IP/TV Program Manager.
If IP/TV Program Manager finds errors or omissions in the form, the Data Entry Errors window prompts you to return to the New Program window to modify the information.
When you have finished correcting the errors, click Create Program again to submit the corrections to IP/TV Program Manager.
If the form is properly completed, you return automatically to the Scheduled Programs window.
Step 25
If you want to undo the changes you made, click Reset to restore the original settings.
Adding Failover Support to an Existing Scheduled Program
In Cisco IP/TV Release 5.2, you can add a failover server for an existing scheduled program by using the Edit Scheduled Program window or the Duplicate Scheduled Program window of IP/TV Program Manager.
To add a failover server from the Edit Scheduled Program window, follow these steps:
Step 1
In the Scheduled Programs window, click the Edit link for the program. Or, in the Review Scheduled Program window, click Edit at the bottom of the window.
Step 2
Go to the Multimedia Source Information section of the Edit Scheduled Program window.
Step 3
Scroll down to the Audio/Video Server section.
Step 4
Choose a backup server from the Select a Backup Server from the List drop-down list.
Step 5
If your program contains a SlideCast or web presentation, go to the SlideCast/Web Presentation Server section of the window.
Step 6
Choose a backup server from the Select a Backup Server from the List drop-down list.
Step 7
Click Revise Program at the bottom of the window to save the changes.
To add a failover server from the Duplicate Scheduled Program window, follow these steps:
Step 1
In the Scheduled Programs window, click the Duplicate link for the program. Alternatively, click Duplicate Program at the bottom of the Review Scheduled Program window.
Step 2
Scroll down to the Audio/Video Server section.
Step 3
Choose a backup server from the Select a Backup Server from the List drop-down list.
Step 4
If your program contains a SlideCast or web presentation, go to the SlideCast/Web Presentation Server section of the window.
Step 5
Choose a backup server from the Select a Backup Server from the List drop-down list.
Step 6
Click Duplicate Program at the bottom of the window to save the changes.
Setting Up Failover Support for an IP/TV Recording
Cisco IP/TV Release 5.2 allows you to configure failover support for recordings of live-capture programs that have streaming failover support enabled.
To create a recording with failover support, follow these steps:
Step 1
From the Recordings window of IP/TV Program Manager, click New Recording.
Step 2
In the New Recordings window, enter the necessary information as described in Step 1 to Step 11 of the "Setting Up the Recording" section on page 6-37 of the Cisco ACNS Software Program Manager for IP/TV User Guide, Release 5.1.
Step 3
Choose a backup IP/TV Broadcast Server from the Select a second server (for redundant recording) drop-down list. (See Figure 9.)
Note
The Select a second server (for redundant recording) drop-down list is available only when you create a recording for a live-capture program that has failover enabled for streaming.
Figure 9 Recording Instructions Section of the New Recording Window
Step 4
Complete Step 12 to Step 14 of the "Setting Up the Recording" section on page 6-37 of the Cisco ACNS Software Program Manager for IP/TV User Guide, Release 5.1.
Both primary and secondary IP/TV Broadcast Severs record the media streams and create identical files. If you encounter a problem on one of the servers, you can use the file on the other IP/TV Broadcast Server.
Switching Between IP/TV Broadcast Servers
Cisco IP/TV Release 5.2 allows you to switch back and forth between the primary and backup IP/TV Broadcast Servers in the IP/TV Broadcast Server GUI and choose the streaming server even after a program has been launched.(See Figure 10.) If a problem occurs during the streaming of a program, you can switch to the other server without waiting for failover to occur.
Figure 10 Switching Active Server Popup Menu Item of IP/TV Broadcast Server Program Listings Window
To switch between IP/TV Broadcast Servers, right-click the program name in the IP/TV Broadcast Server Program Listings window and choose Switch Active Server from the popup menu. Depending on the status of the program on that server, you can start or stop streaming the program from that IP/TV Broadcast Server. When you stop streaming the program from one IP/TV Broadcast Server, the other IP/TV Broadcast Server starts streaming the program and vice versa.
The backup IP/TV Broadcast Server takes over the streaming when you disable a program from the primary IP/TV Broadcast Server using any of the following:
•
The Enable/Disable Program option from the popup menu that appears when you right-click the program name
•
The Disable All or Disable Selected option from the View menu
•
The Stop button in the Program Details window
If you want to stop a program from streaming, you must disable it from both the primary and the backup IP/TV Broadcast Server. Alternatively, you can pause the program from the streaming server using the Pause button in the Program Details window.
Configuring .ini File Variables for Failover Support
For IP/TV Broadcast Server failover to work properly, you must configure a few variables in the iptvserv.ini file. Table 7 explains the iptvserv.ini variables for failover support.
If you are modifying the default values for any of the parameters given in Table 7, keep in mind the following guidelines:
•
The HeartbeatTimeout value should always be much bigger than the HeartBeatTxInterval value.
•
The MonitorInterval value must be less than the HeartBeatTimeout value.
Higher Resolution for SlideCast Using MPEG-4
Cisco IP/TV Release 5.2 supports 640 x 480 resolution for SlideCast using ISO MPEG-4 encoding. Cisco IP/TV Release 5.2 supports two resolutions: 640 x 480 and CIF (Common Intermediate Format 352 x 288) for ISO MPEG-4 encoding, whereas it supports only CIF resolution for H.261 encoding.
For ISO MPEG-4 SlideCast, 640 x 480 is the default resolution for slide captures, whereas CIF is the default for H.261 slide captures.
Web-Based Program Guide Customization
Cisco IP/TV Release 5.2 allows you to customize the web-based program guide to suit your needs.
Properties of the web-based program guide are configured in the iptvguide.properties file, which is located in the /local/local1/PMWebGuide folder of your IP/TV Program Manager device. The images and HTML files associated with the web-based program guide are located in the /local/local1/PMWebGuide/iptvguide folder of IP/TV Program Manager.
You can modify the iptvguide.properties file and the contents of the iptvguide folder to customize the web-based program guide.
Table 8 lists the variables and settings that can be modified in the iptvguide.properties file.
Table 8 Customizable Variables and Settings in the Iptvguide.Properties File
Parameter Description Syntax and Default ValueTable properties
Sets table properties for the web-based program guide.
Table border background color
Sets the background color for the table border.
default.view.border.bgcolor=#009999
Table cell background color
Sets the background color for table cells.
default.view.table.cell.bgcolor=#CEE6E6;
#F0F0F0Table section background color
Sets the background color for a table section.
default.view.section.bgcolor=#66CCCC
Table header background color
Sets the background color for the table header.
default.view.table.header.bgcolor=#FFFFF0
Table border text font color
Sets the font color for table border.
default.view.border.text.color= #FFFFFF
Table border text font face
Sets the font type for the table border.
default.view.border.text.face=Arial,Helvetica,
GenevaTable border text font size
Sets the font size for the table border.
default.view.border.text.size=3
Table section main text font color
Sets the text font color for the main section of the table.
default.view.section.main.text.color=#FFFF99
Table section main text font face
Sets the text font type for the main section of the table.
default.view.section.main.text.face=Times New
RomanTable section main text font size
Sets the font size for the main section of the table.
default.view.section.main.text.size=5
Table section minor text font color
Sets the font color for the minor text in the table.
default.view.section.minor.text.color=#FFFFFF
Table section minor text font face
Sets the font type for the minor text in the table.
default.view.section.minor.text.face=Times New
RomanTable section minor text font size
Sets the font size for the minor text in the table.
default.view.section.minor.text.size=3
Table header text font color
Sets the font color for the table header.
default.view.table.header.text.color=#000000
Table header text font face
Sets the font type for the table header.
default.view.table.header.text.face=Times
New RomanTable header text font size
Sets the font size for the table header.
default.view.table.header.text.size=3
Table cell text font color
Sets the font color for the table cell.
default.view.table.cell.text.color=#000000
Table cell text font face
Sets the font type for the table cell.
default.view.table.cell.text.face=Times
New RomanTable cell text font size
Sets the font size for the table cell.
default.view.table.cell.text.size=2
Poll rate
Sets the frequency (in minutes) with which the web-based program guide contacts IP/TV Program Manager for program information.
server.pollRate=5
Local information and language
Sets the language, country, and the variant.
server.locale=en, US1
Program Manager list
Configures the IP/TV Program Managers from which the web-based program guide receives program listings.
default.contentManager.list=
localhost:80where localhost is the default IP/TV Program Manager and 80 is the port number. You can add multiple IP/TV Program Managers separated by a semicolon.
Home page
Sets the web page of your choice as the home page of the web-based program guide.
default.view.home.url=/iptvguide/res/
en/homeview.htmlUser profile settings
Sets user profile options.
User profile enforcement
Enforces entry of the user's username and e-mail address when the default.view.home.profile variable is set to True.
default.view.home.profile=false
User profile validity period
Sets the maximum number of months for which the user profile is valid since the last update.
default.view.home.profile.maxAge=12
On-demand category
Controls the display of the on-demand programs category hierarchy in the web-based program guide.
default.onDemandPrograms.
showHierarchy=true
1 For more information about language and country codes, refer to http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt and http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html. Variant codes are vendor- and browser-specific.
To customize the web-based program guide, follow these steps:
Step 1
Establish an FTP connection to the IP/TV Program Manager device.
Step 2
Go to the /local/local1/PMWebGuide folder.
Note
The default FTP directory for IP/TV Program Manager is /local/local1.
Step 3
Copy the iptvguide.properties file using the following command:
iptvprogrammanager# copy disk ftp {hostname | ip-address} remotefiledir remotefilename iptvguide.propertieswhere hostname or ip-address is the host name or IP address of the destination, remotefiledir is the folder on the destination device to which the local file is copied, and remotefilename is the filename that you want to give to the file once it has been copied to the destination server.
Step 4
Open the iptvguide.properties file using a text editor.
Step 5
Edit the necessary parameters (see Table 8) to customize the web-based program guide.
Step 6
Save the changes you made in the iptvguide.properties file.
Step 7
Upload the updated file to the original location on IP/TV Program Manager using the following command:
iptvprogrammanager# copy ftp disk {hostname | ip-address} remotefiledir remotefilename iptvguide.propertieswhere hostname or ip-address is the host name or IP address of the source device, remotefiledir is the folder on the source device from which the file was copied, and remotefilename is the name of the file that you just copied.
This command replace the iptvguide.properties file on the IP/TV Program Manager device with the modified copy of the file.
Step 8
Restart IP/TV Program Manager using the following commands:
iptvprogrammanager# iptv program-manager stopiptvprogrammanager# iptv program-manager startThe changes you made take effect after you restart IP/TV Program Manager.
To modify or add any images or HTML files associated with the web-based program guide, follow these steps:
Step 1
Establish an FTP connection to the IP/TV Program Manager device.
Step 2
Go to the /local/local1/PMWebGuide/iptvguide folder.
Step 3
To modify an existing file, follow these steps:
a.
Download the file that you want to modify.
b.
Modify the file.
c.
Upload the modified file to the original location.
Note
Delete the original file from the /local/local1/PMWebGuide/iptvguide folder before placing the updated file there.
Step 4
To add a new file, follow these steps:
a.
Upload the new file to the /local/local1/PMWebGuide/iptvguide folder.
b.
Go to the iptvguide.properties file and modify the necessary parameters that should use the new file.
c.
Upload the iptvguide.properties file to the /local/local1/PMWebGuide folder.
Step 5
Restart IP/TV Program Manager using the following commands:
iptvprogrammanager# iptv program-manager stopiptvprogrammanager# iptv program-manager startThe changes you made take effect after you restart IP/TV Program Manager.
Multibyte Character Set Support
IP/TV Program Manager in Cisco IP/TV Release 5.2 supports multibyte character set (MBCS) characters in many text fields. MBCS characters are used to input non-ASCII alphabets, for example, for languages such as Japanese. However, Cisco IP/TV Release 5.2 does not support Japanese characters that are not part of the Japanese Industrial Standards (JIS) multibyte character set.
Only international versions of Microsoft Internet Explorer or Netscape Navigator allow you to enter MBCS characters. Web browsers support the JIS multibyte character set.
IP/TV Program Manager accepts MBCS characters in all text fields except the following:
•
Server names
•
Filenames
•
Path names
•
FTP user IDs
•
FTP passwords
•
Program passwords
•
Channel passwords
Note
If you enter program names using MBCS characters, the programs are not sorted correctly in program listings in IP/TV Program Manager windows, although the MBCS characters are displayed correctly. In IP/TV Server windows, program names using MBCS characters are displayed as a series of question marks, but programs will play normally. IP/TV Viewer displays program information correctly.
Japanese Windows
IP/TV Program Manager in Cisco IP/TV Release 5.2 supports IP/TV Viewer running Japanese Windows.
To support this configuration, remove the pound sign (#) from the following line in the CMSystem.properties file:
#File.encoding = SJIS
Note
Use FTP to obtain a copy of the CMSystem.properties file from the //local/local1/PMConf directory of IP/TV Program Manager. Before you copy the updated file to the //local/local1/PMConf directory of IP/TV Program Manager, delete the CMSystem.properties file. The default FTP directory for IP/TV Program Manager is //local/local1.
Note
For the changes to take effect, stop and start IP/TV Program Manager. For the ACNS software CLI commands for stopping and starting IP/TV Program Manager, see the "Starting and Stopping IP/TV Program Manager" section.
Additional Documentation Changes
This section contains updates to Cisco IP/TV documentation, Release 5.1. This section covers the following topics:
•
Recording and Streaming of MP2T Streams
•
Playing Back MP4 Files Locally in the QuickTime Player
•
Integrating IP/TV with an ACNS Network
•
Playing Nonhinted On-Demand Programs over an ACNS Network
•
ACNS Software CLI Commands for IP/TV Program Manager
Recording and Streaming of MP2T Streams
Cisco IP/TV Release 5.1.3 and later releases support MOV recording of MPEG-2 Transport (MP2T) streams. Cisco IP/TV Release 5.1.3 and later releases also support the streaming of MP2T stream-based MOV files from IP/TV Broadcast Server as well as the Cisco Streaming Engine.
Playing Back MP4 Files Locally in the QuickTime Player
Cisco IP/TV Release 5.1.3 and later releases support local playback of IP/TV-recorded MP4 files using the QuickTime Player. However, the support is limited to MP4 files containing AAC audio; QuickTime does not support playback of MP4 files with MP3 audio.
Integrating IP/TV with an ACNS Network
Cisco IP/TV Release 5.1 and later releases interoperate with Cisco ACNS network running Cisco ACNS software, Release 5.1 or later releases. Appendix B of the Cisco ACNS Software Program Manager for IP/TV User Guide, Release 5.1 explains the steps for integrating IP/TV with an ACNS network. The following section explains additional steps not covered in IP/TV Release 5.1 documentation.
Creating an ACNS Network Website with Content Routing Support
To use the content routing feature of the Cisco ACNS network, you must have the fully qualified domain name (FQDN) of the Content Router configured in the CR FQDN field of the New Channel Creation window in the ACNS Content Distribution Manager GUI. You can configure the Content Router while creating a new website or configure it later, by editing the settings for an existing website.
To create an ACNS network website with content routing for IP/TV programs, follow these steps:
Step 1
From the Content Distribution Manager GUI, choose Channels > Web Sites.
The Web Sites window appears.
Step 2
Click the Create New Web Site icon in the taskbar.
The Creating New Web Site window appears.
Step 3
Enter a unique name for the website in the Name field.
Step 4
Choose a content provider from the drop-down list.
Note
The content provider must be predefined in the Creating New Content Provider window. For more information on content providers, refer to the Cisco ACNS Software Deployment and Configuration Guide, Release 5.1.
Step 5
Enter the IP address or host name of your IP/TV Program Manager in the Origin Server field.
Note
Make sure that the entry in the Origin Server field matches the entry in the PM FQDN field in your IP/TV Program Manager Preferences window.
Step 6
Enter the host name or IP address of the Content Router in the Request Routed FQDN field.
Step 7
Click Submit to create a new ACNS network website.
For more information on creating and editing ACNS network websites, refer to the Cisco ACNS Software Deployment and Configuration Guide, Release 5.1.
To add a Content Router to an existing website, follow these steps:
Step 1
From the Content Distribution Manager GUI, choose Channels > Channels.
The Channels window appears.
Step 2
Click the Edit icon next to the name of the channel that is associated with the website you want to modify. The Modifying Channel window appears.
Step 3
Click the Edit Website icon in the Modifying Channel window. The Modifying Website window appears.
Step 4
Enter the host name or IP address of the Content Router in the Request Routed FQDN field.
Step 5
Click Submit to save the changes.
Playing Nonhinted On-Demand Programs over an ACNS Network
The Cisco Streaming Engine supports only hinted files (MOV and hinted MP4 files) for streaming. If you are creating a file-based IP/TV program for streaming over an ACNS network, make sure that you use only hinted files such as those with .mov or .mp4 extensions.
Note
Hinted files contain hint tracks, which store packetization information that tells the streaming server how to package the media data. The streaming server uses the packetization information in the hint tracks to stream the media data to the network.
However, you can pre-position on-demand programs based on nonhinted files such as .mpg files on Content Engines in an ACNS network. Pre-positioned on-demand programs based on nonhinted files are not listed in the IP/TV Viewer program listings or in the web-based program guide.
To watch IP/TV on-demand programs based on nonhinted files when IP/TV is integrated with an ACNS network, use the TV-out feature of the ACNS software. For more information on enabling the TV-out feature and creating playlists, refer to Chapter 7 of the Cisco ACNS Software Configuration Guide for Centrally Managed Deployments, Release 5.2.
ACNS Software CLI Commands for IP/TV Program Manager
This section lists and explains ACNS software command-line interface (CLI) commands applicable for IP/TV Program Manager. However, this section excludes the general ACNS commands for configuring and registering a Content Engine on an ACNS network. For a more detailed account of ACNS software CLI commands and different command modes, refer to the Cisco ACNS Software Command Reference, Release 5.2.
To view all IP/TV Program Manager commands, enter the following command at the IP/TV Program Manager command prompt:
Note
To access the Program Manager command prompt, open a Telnet session to the IP/TV Program Manager host and enter your username and password to validate the session.
iptvprogrammanager# iptv program-manager ?database IP/TV Program Manager database commandsstart Start Program Manager functionsstop Stop Program Manager functionsStarting and Stopping IP/TV Program Manager
You can start or stop IP/TV Program Manager by executing the following ACNS CLI commands on IP/TV Program Manager.
To start IP/TV Program Manager, enter the following command at the IP/TV Program Manager prompt:
iptvprogrammanager# iptv program-manager startTo stop IP/TV Program Manager use the following command:
iptvprogrammanager# iptv program-manager stopManaging the Database in IP/TV Program Manager
IP/TV Program Manager allows you to manage its database using CLI commands. To view all the IP/TV Program Manager database management commands, use the following command:
iptvprogrammanager# iptv program-manager database ?backup Back up Program Manager database to a fileclear Clear Program Manager databasedump Dump the Program Manager database to a filerestore Restore Program Manager database from a file•
To back up your IP/TV Program Manager database, enter the following command:
iptvprogrammanager# iptv program-manager database backup•
To clear your IP/TV Program Manager database, enter the following command:
iptvprogrammanager# iptv program-manager database clear•
To transfer the data from the IP/TV Program Manager database to another file, enter the following command:
iptvprogrammanager# iptv program-manager database dumpTo access the IP/TV Program Manager journaling database, enter the following command:
iptvprogrammanager# iptv program-manager database dump journal•
To restore the IP/TV Program Manager database from the backup file, enter the following command:
iptvprogrammanager# iptv program-manager restoreObtaining Documentation
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation at this URL:
http://www.cisco.com/univercd/home/home.htm
You can access the Cisco website at this URL:
You can access international Cisco websites at this URL:
http://www.cisco.com/public/countries_languages.shtml
Ordering Documentation
You can find instructions for ordering documentation at this URL:
http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm
You can order Cisco documentation in these ways:
•
Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool:
http://www.cisco.com/en/US/partner/ordering/index.shtml
•
Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).
Documentation Feedback
You can send comments about technical documentation to bug-doc@cisco.com.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883We appreciate your comments.
Obtaining Technical Assistance
For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, Cisco Technical Support provides 24-hour-a-day, award-winning technical assistance. The Cisco Technical Support Website on Cisco.com features extensive online support resources. In addition, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not hold a valid Cisco service contract, contact your reseller.
Cisco Technical Support Website
The Cisco Technical Support Website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, 365 days a year at this URL:
http://www.cisco.com/techsupport
Access to all tools on the Cisco Technical Support Website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:
http://tools.cisco.com/RPF/register/register.do
Submitting a Service Request
Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool automatically provides recommended solutions. If your issue is not resolved using the recommended resources, your service request will be assigned to a Cisco TAC engineer. The TAC Service Request Tool is located at this URL:
http://www.cisco.com/techsupport/servicerequest
For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco TAC engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.
To open a service request by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553 2447For a complete list of Cisco TAC contacts, go to this URL:
http://www.cisco.com/techsupport/contacts
Definitions of Service Request Severity
To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.
Severity 1 (S1)—Your network is "down," or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.
Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.
Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.
Obtaining Additional Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
•
Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:
http://www.cisco.com/go/marketplace/
•
The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as ordering and customer support services. Access the Cisco Product Catalog at this URL:
http://cisco.com/univercd/cc/td/doc/pcat/
•
Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:
•
Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL:
•
iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL:
http://www.cisco.com/go/iqmagazine
•
Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:
•
World-class networking training is available from Cisco. You can view current offerings at this URL:
http://www.cisco.com/en/US/learning/index.html
CCSP, the Cisco Square Bridge logo, Cisco Unity, Follow Me Browsing, FormShare, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, Registrar, ScriptShare, SlideCast, SMARTnet, StrataView Plus, SwitchProbe, TeleRouter, The Fastest Way to Increase Your Internet Quotient, TransPath, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0406R)
Copyright © 2004 Cisco Systems, Inc. All rights reserved.











