Cisco ACNS Software Program Manager for IP/TV User Guide, Release 5.1
Chapter 3: Setting Up IP/TV Program Manager

Table Of Contents

Setting Up IP/TV Program Manager

Setting Up User Accounts for IP/TV Program Manager

Setting IP/TV Program Manager Defaults and Preferences

Multicast Addresses

Link-Level Scoped IP Multicast Addresses

Globally Scoped IP Multicast Addresses

Administratively Scoped IP Multicast Addresses

Limiting How Far Your Programs Reach

IP/TV Security

Password Protection

Access Restrictions

About Proximity Management

Defining Servers and Server Clusters

Defining a Server Cluster

Reviewing a Cluster

Deleting a Cluster

Editing a Cluster

Defining Servers

Multihomed Host Support

Reviewing a Server

Deleting a Server

Editing a Server

Searching for a Server

Managing Proximity Groups and Subnets

Defining a Proximity Group

Reviewing a Proximity Group

Deleting a Proximity Group

Editing a Proximity Group

Searching for a Proximity Group

Defining a Subnet

Reviewing a Subnet

Deleting a Subnet

Editing a Subnet

Searching for a Subnet

Managing Channels

Channels Window

Creating a New Channel

Reviewing a Channel

Deleting a Channel

Editing a Channel


Setting Up IP/TV Program Manager


This chapter describes how to set up IP/TV Program Manager. Topics include:

Setting Up User Accounts for IP/TV Program Manager

Setting IP/TV Program Manager Defaults and Preferences

Multicast Addresses

IP/TV Security

About Proximity Management

Defining Servers and Server Clusters

Managing Proximity Groups and Subnets

Managing Channels

Setting Up User Accounts for IP/TV Program Manager

IP/TV Program Manager allows you to create and modify user accounts using ACNS software commands. To access the ACNS software command prompt, open a Telnet session to the IP/TV Program Manager host and enter your username and password to validate the session.


Note The default username is admin, and the default password is default.


To create a new user account, enter the following global configuration command:

ContentEngine(config)# username yourusername password yourpassword

where yourusername and yourpassword are your username and password, respectively.


Note To enter global configuration mode, use the following command:
ContentEngine# configure


To set up a privilege level for the user, use the following command:

iptvcm(config)# username yourusername privilege {0|15}

where 15 denotes a superuser, and 0 is a normal user.

For more information on privilege levels, see the "Access Restrictions" section.

To change the password for a user, use the following command:

iptvcm(config)# username yourusername password ?

0 Specifies an UNENCRYPTED password will follow
1 Specifies a HIDDEN password will follow
WORD  The UNENCRYPTED (cleartext) user password

For more information on this command and related commands, refer to the Cisco ACNS Software Command Reference, Release 5.1.

Setting IP/TV Program Manager Defaults and Preferences

IP/TV Program Manager allows you to specify certain default parameter values, and to govern the level of information that is displayed in the IP/TV Program Manager window.

To set IP/TV Program Manager defaults and preferences, follow these steps:


Step 1 Click the Preferences link in the IP/TV Program Manager main window to go to the Preferences window.

Step 2 In the Multicast Addresses section at the top of the window you can choose address options. (See Figure 3-1.) Table 3-1 lists the available multicast address options, and briefly describes each one. Multicast addresses determine how far across the network your IP/TV sessions reach.

See the "Multicast Addresses" section later in this chapter for more information about globally scoped and administratively scoped addresses and multicast range or Time To Live (TTL) values.

See the "Limiting How Far Your Programs Reach" section later in this chapter for recommendations on using administratively scoped addresses to limit how far your IP/TV programs reach across the network.

Figure 3-1 Multicast Addresses Section of the Preferences Window

Table 3-1 Multicast Address Options 

Parameter
Description

Globally Scoped Addresses

Determines whether globally scoped addresses can be specified for a program, and sets the default multicast ranges as well as the TTL values of each possible range.

By default, this option is enabled, and the default multicast range is set to Site. The TTL values of the available ranges are set as follows:

Local              1
Site               15
Regional       63
Worldwide  127

Globally Scoped SSM Addresses

Determines whether globally scoped source-specific multicast (SSM) addresses can be specified for a program.

By default, this option is disabled. The SSM address range is 232.0.0.0 through 232.255.255.255 and the TTL value is 127. The address range and TTL cannot be configured by the user.

Administratively Scoped Addresses

Determines whether administratively scoped addresses can be specified for a program, sets the start and end of the range of administratively scoped addresses that IP/TV Program Manager will assign, and sets the multicast range.

By default, this option is disabled. The default address range is 239.255.0.0 through 239.255.255.255. The default multicast range is 15.

Admin Scoped SSM Addresses

Determines whether administratively scoped SSM addresses can be specified for a program, sets the start and end of the range of administratively scoped SSM addresses that IP/TV Program Manager will assign, and sets the multicast range.

By default, this option is disabled. The default address range is 239.232.0.0 through 239.232.255.255. The default SSM range is 63.

Default Multicast Addresses

Determines whether programs scheduled by IP/TV Program Manager default to globally scoped multicast addresses, globally scoped SSM addresses, administratively scoped multicast addresses, or administratively scoped SSM addresses. The default is globally scoped addresses.

Allow modification of IP addresses

Determines whether administrators can override the default IP addresses, UDP ports, and multicast ranges assigned to a program. The default is off (no modification is allowed).

RTCP Feedback Suppression

Controls RTCP feedback from IP/TV Viewer to IP/TV Server. There are three options:

Suppress multicast RTCP feedback—this option is chosen by default.

Suppress all kinds of RTCP feedback

Do not suppress any RTCP feedback


Step 3 In the SmallCast section of the Preferences window, set the SmallCast options. (See Figure 3-2.)

Figure 3-2 SmallCast and Multimedia Sources Section of the Preferences Window

Table 3-2 describes the SmallCast options.

Table 3-2 SmallCast Options 

Parameter
Description

Allow SmallCasting (Forwarding Programs to Unicast Addresses)

Determines whether IP/TV Program Manager administrators can specify that a program be forwarded to unicast addresses. The default is off (no SmallCasting is allowed).

Maximum SmallCast Level

Determines how many levels of SmallCast servers you can define to create a stream splitting hierarchy. This value can be set to 1 or 2. The default value is 1. If this value is set to 2, the forwarding servers can also unicast outbound streams.

Maximum Unicast Destinations

Defines how many unicast streams an IP/TV Server can send for a particular program. The range for this value is 1 through 20. The default is 7.


Step 4 In the Multimedia Sources section of the Preferences window, set video and audio options. (See Figure 3-2.)

Refer to Appendix A, "Live Capture and File Formats" of the Cisco IP/TV Broadcast Server User Guide for more information on the default video and audio formats and settings for various types of live-capture equipment.

Table 3-3 describes the multimedia sources options.

Table 3-3 Multimedia Sources Options 

Parameter
Description

Preferred Video Format

Sets the preferred format for live-capture video. The default is H.261.

Compression Quality

Sets the compression quality for the preferred video format. The default is 8. This option applies only to H.261 video.

Preferred Audio Format

Sets the preferred format for live-capture audio. The default is PCM (mu-law).

Alternate Audio Formats

Determines if alternative audio formats are allowed, and specifies the alternative formats allowed.

Audio/Video Bandwidth

Sets the bandwidth in kilobits per second (kbps). The default is 1150.

Maximum Video Frame Rate

Sets the maximum video frame rate (in frames per second). The default is 30.


Step 5 In the Scheduled Program Management section of the Preferences window, set program management options for scheduled programs. (See Figure 3-3.)

Figure 3-3 Scheduled Program Management Section of the Preferences Window

Table 3-4 describes the scheduled program management options.

Table 3-4 Scheduled Program Management Options 

Parameter
Description

Delete Local Programs

Determines how long locally created program information is saved by IP/TV Program Manager. The default is 24 hours after the last run finishes (minimum 0, maximum 720 hours).

Delete Announced Programs

Determines how long program announcements are saved by IP/TV Program Manager. By default, an announcement is deleted 24 hours after the last time it is received (minimum 0, maximum 720 hours).

Announce Local Programs

Determines whether this IP/TV Program Manager sends out announcements about its IP/TV programs to other IP/TV Program Managers on the network. The default is off. See the "Customer Sites Using Multiple IP/TV Program Managers" section for details.

Listen for Program Announcements

Determines whether this IP/TV Program Manager receives announcements from other IP/TV Program Managers.

Do Not Listen: If checked, IP/TV Program Manager does not listen for other announcements.

Listen to Neighbors: If checked, IP/TV Program Manager listens for announcements of programs that use the same administratively scoped addresses, or for programs that use global addresses if the server is defined on this IP/TV Program Manager.

Listen for Remote Announcements: If checked, IP/TV Program Manager listens for announcements of programs that use globally scoped addresses.

Listen for All Announcements: If checked, IP/TV Program Manager listens for all announcements.

Listen to these IP/TV Program Managers: Enter the DNS name or IP address of up to three other IP/TV Program Managers for whose announcements this IP/TV Program Manager will listen.


Step 6 In the Question Management section of the Preferences window, set the Question Manager preferences. (See Figure 3-4.)

Figure 3-4 Question, Recording, and File Transfer Management Sections

Table 3-5 describes the question management options.

Table 3-5 Question Management Options 

Parameter
Description

Max. Questions Per Program

Limits the number of questions that can be submitted to the moderator for any one program. The default is 100 (minimum 1, maximum 1000).

Question Manager Port

Sets the UDP port on the source server to which questions will be directed. The default is "Select any available port." The possible range is 1 to 65,535.

You should specify a well-known port only if the moderator of a program will be on the other side of a firewall from the IP/TV Program Manager on which the program is defined. If that is the case, obtain a port number from the firewall administrator, who must configure the firewall to allow traffic using that UDP port number to cross the firewall.


Step 7 In the Recording Management section of the Preferences window, specify recording preferences. (See Figure 3-4.) Table 3-6 describes the recording management options.

Table 3-6 Recording Management Options

Parameter
Description

Concurrent Per Server1

Determines the maximum number of concurrent recording sessions. The default is 4 (minimum 1, maximum 128).

Maximum Recording Time2

Determines the maximum length (in hours) of a given recording. The default is 4 (minimum 1, maximum 24).

1 If you have a multihomed IP/TV Server, you must be careful not to exceed the concurrent recording limits. IP/TV Program Manager can enforce the concurrent recording limits for a server with a single network interface but cannot enforce them in the case of a multihomed host.

2 Recording files can consume large amounts of disk space. You can conserve disk space by setting up procedures to delete or archive recordings that are no longer needed.


Step 8 In the File Transfer Management section of the Preferences window, set the parameters for FTP file transfers to and from IP/TV Servers. (See Figure 3-4.) Table 3-7 describes the file transfer management options.

Refer to Chapter 5, "File Transfers," of the Cisco IP/TV Broadcast Server User Guide for additional information on the file transfer function.

Table 3-7 File Transfer Management Options

Parameter
Description

Maximum Concurrent FTPs1

Maximum number of concurrent FTP connections for each file transfer job. The default value is 6 concurrent connections per job. If the job has multiple destinations specified, the connections are load balanced across those destination FTP servers that are responding.

Maximum Duration per FTP

Maximum length of time that a file transfer job is allowed to run. When this length of time has elapsed since the start of the file transfer job, the job is aborted and all open FTP connections are closed. The units are hours and the default value is 8.

Delete Completed FTP Jobs in

Determines how long the information about completed FTP jobs is saved in a Results window by IP/TV Program Manager. The default is 24 hours (minimum 0 hours, maximum 720 hours).

1 The maximum number of concurrent FTP connections per IP/TV Server limits the number of file transfers that can be ongoing at the same time, not the number of destination addresses you can specify when scheduling a file transfer. For example, if the limit is set to 6, and you schedule a server to transfer a file to 10 different destinations, the file transfers to the first 6 addresses in the list are performed concurrently. As these are completed, the file transfers to the remaining 4 addresses begin. At no time will more than 6 file transfers be in progress, but all the transfers that you schedule will be completed eventually.


Step 9 In the Server Management section of the Preferences window, set server management options. (See Figure 3-5.)

Figure 3-5 Server Management Section of the Preferences Window

Table 3-8 describes the server management options.

Table 3-8 Server Management Options 

Parameter
Description

Default RTSP Server Port

Sets the default RTSP server port. The RTSP port is the port number at which IP/TV Server receives on-demand information from IP/TV Program Manager, and must match the RTSP port configured at the server.

Default Capacity Per Server

Sets the capacity per server in kilobits per second (kbps). Server capacity is the maximum amount of multimedia data that the server can output onto the network.

Default Capacity Per Cluster

Sets the capacity per server cluster in kbps.

Note There is a predefined cluster called "default." Changing the Capacity per Cluster parameter in the Preferences window does not change the capacity for the default cluster. If you plan to use the default cluster, you must change the capacity for the default cluster to the value you want. See the "Editing a Cluster" section later in this chapter for the procedure for modifying the parameter values for a cluster.

Total Program Manager Capacity

Sets the total capacity in kbps for all server clusters managed by this IP/TV Program Manager.

Idle IP/TV Viewer Timeout

Sets the number of minutes that IP/TV Viewer can be paused or stopped before the connection with IP/TV Server is terminated. (The default is 30 minutes. Zero disables timeouts.)

Scheduled Reservation and OnDemand Non-preemption

Sets the number of minutes ahead of time that bandwidth is allocated for scheduled programs. An on-demand program is not assigned to the server during the allocated time if the assignment would cause the capacity of the server to be exceeded when the scheduled program starts. On-demand programs that are active longer than the specified number of minutes may be preempted when the scheduled program starts if the server capacity would be exceeded. Setting this option to zero disables preemption but may cause the server capacity to be exceeded.


Step 10 In the Viewer Management section of the Preferences window, set the plug-in management options. The Enforce Use of IP/TV Plug-in check box enables administrators to enforce the use of the IP/TV plug-in to watch a program. Programs with this option checked cannot be played using the QuickTime plug-in. If this check box is checked and you try to play an IP/TV program from the web-based program guide, IP/TV prompts you to download the IP/TV plug-in to play the program.

Step 11 In the Other Options section of the Preferences window, set the remaining IP/TV Program Manager preferences. (See Figure 3-6.)

Figure 3-6 Other Options and ACNS Network Information Sections of the Preferences Window

Table 3-9 describes the Other Options section.

Table 3-9 Other Options

Parameter
Description

Proximity Group Priorities

Sets the number of server clusters available to Proximity Groups. The default is 5. See the "About Proximity Management" section later in this chapter for information about proximity groups.

Save Journaling Records for

Sets the number of days that journaling records are kept. The default is 0, which disables journaling. See the "Journaling" section for information about journaling.


Step 12 In the ACNS Network Information section of the Preferences window, enter the ACNS network information to integrate IP/TV with the ACNS network. (See Figure 3-6.)

Table 3-10 ACNS Network Information Options

Parameter
Description

CDM Host Name/ IP Address

Host name or IP address of the Content Distribution Manager of the ACNS network for IP/TV integration.

CDM Username

Username for the IP/TV Program Manager user to access the Content Distribution Manager. The user should have admin roles assigned from the Content Distribution Manager.

CDM Password

Password for validating the user for accessing the Content Distribution Manager.

Confirm CDM Password

Confirmation password.

CDM Poll Rate

Interval (in seconds) at which IP/TV Program Manager downloads ACNS network information from the Content Distribution Manager. Valid values are between 10 and 600 seconds. The default is 60.

PM FQDN List

List of fully qualified domain names associated with a particular IP/TV Program Manager. This information helps IP/TV Program Manager identify the ACNS channel for which it is the origin server. Only those channels in which the origin server matches an entry in the IP/TV Program Manager FQDN list are stored in the database of IP/TV Program Manager. The entries in the IP/TV Program Manager FQDN list exactly match the entries in the Origin Server field of the CDM website. Separate multiple entries with a comma.


Step 13 When you have set all the preferences appropriate to your site, click Revise Preferences at the bottom of the window to submit the completed 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 Preferences window to modify the information.

When you have finished correcting the errors, click Revise Preferences again to submit the corrections to IP/TV Program Manager.

If the form is properly completed, you return automatically to the IP/TV Program Manager main window.


Multicast Addresses

When you set up a new channel or a new program that is not assigned to a channel, the new channel or program is assigned the default multicast address type specified in the Preferences window.

All Class D IP addresses (224.0.0.0 through 239.255.255.255) are IP multicast addresses. Within Class D, three types of multicast address are available:

Link-level scoped multicast addresses (224.0.0.0 through 224.0.0.255)

Globally scoped multicast addresses (224.0.1.0 through 238.255.255.255)

Administratively scoped multicast addresses (239.0.0.0 through 239.255.255.255)

Link-Level Scoped IP Multicast Addresses

Packets with link-level scoped multicast addresses are configured in all routers as unforwardable. A program defined with a link-level scoped IP multicast address is not forwarded by any router, regardless of the multicast range defined for the program. (See the next section, "Globally Scoped IP Multicast Addresses," for information about multicast ranges.) We recommend that you do not use addresses in the link-level scoped address range when you set up programs.

Globally Scoped IP Multicast Addresses

Globally scoped multicast addresses use a mechanism called "multicast ranges" to limit how far across the intranet or Internet your program reaches.

IP/TV Program Manager allows you to set the default multicast range, and to set the explicit values for each available range. The value for a range determines the TTL parameter for all channels or programs assigned that range.

The TTL parameter refers to the number of hops a packet can travel before the next router in the path declines to forward the packet. Table 3-11 lists the available multicast ranges and their default values.

Table 3-11 Multicast Range Default Values

Range
Number of Hops

Local (default)

1

Site

15

Regional

63

Worldwide

127



Note The TTL values, that is, the number of hops shown in Table 3-11, are the values used for MBone sessions, which typically are intended to be disseminated across the entire Internet. We strongly recommend that your organization establish administratively scoped addresses rather than rely on multicast ranges to determine how far your programs reach.


Administratively Scoped IP Multicast Addresses

The primary purposes of the administratively scoped IP multicast address range are:

To define a set of addresses that are locally administered. MBone traffic or other incoming multicast traffic should not use this range of addresses.

To give sites the ability to set a boundary for their multicast sessions. An IP multicast-compatible router can be configured to not forward a packet beyond the administrative boundary if the packet has an address in this range, and to block any external traffic sent to addresses in this range.

Administratively scoped addressing relies on the routers in the network to limit how far across the intranet or Internet your programs are forwarded.

IP/TV Program Manager is configured by default to use the range of administratively scoped addresses from 239.255.0.0 to 239.255.255.255, which is known as the IPV4 Local Scope. This scope has a fixed definition in RFC 2365 and is not to be subdivided. IP/TV Program Manager uses this range as the default range because the range should always exist whenever administrative scoping is used. However, we recommend that if you want to use administratively scoped addresses, you use instead some or all of the range 239.192.0.0 through 239.195.155.155 for the one or more zones you want to define. This is known as the IPV4 Organization Local Scope, and is intended for organizations to subdivide for their own purposes. Refer to RFC 2365 for detailed information about the use of IPV4 Local Scope and Organization Local Scope addresses.

Administrative scope zones may topologically overlap, but when they do, the address ranges must not intersect. (Topologically disjointed zones may reuse the same address range.) A separate IP/TV Program Manager must be used for each distinct address range, because each IP/TV Program Manager supports only one range.

To configure administratively scoped multicast addresses, follow these steps:


Step 1 In the Preferences window, check Allow Use of Admin. Scoped Addresses and uncheck Allow Use of Global Scoped Addresses.

Step 2 Set the start and end of the address range you want to use. IP/TV Program Manager always assigns the multicast address of a program within the range specified here.

Step 3 Configure each router that constitutes a boundary point for this range so that it refuses to forward packets with addresses in that range (refer to your router documentation for this procedure).


Administratively scoped IP multicast addresses are an important tool in limiting the impact of multimedia programs on your network.


Note If a program uses an administratively scoped address, the program announcement uses the highest address of the administratively scoped address range set in your preferences, which means that all other IP/TV Program Manager servers will receive the announcement only if they use the same address range.


Limiting How Far Your Programs Reach

If you do not want your programs to be seen outside your site, use the following strategy:

Uncheck the Allow modification of IP addresses, UDP ports, and Multicast range check box in the Multicast Addresses section of the Preferences window.

Use administratively scoped addresses rather than globally scoped addresses, and configure your boundary routers not to forward these addresses.

If using globally scoped addresses, set the default multicast range to a low number appropriate to your network topology.

IP/TV Security

IP/TV supports two levels of security:

Password protection on channels and scheduled and on-demand programs

Configurable restrictions on access to IP/TV Program Manager

Password Protection

IP/TV Program Manager allows you to set passwords in two ways:

A channel can be assigned a password. If a channel has a password, all scheduled programs on that channel use the same password.

An on-demand program or a scheduled program that is not on a channel can be assigned a password.

If a password is set (either for the channel or for the program), the user who wants to view a program must supply a matching password in order to view or subscribe to the program.

The password is always saved in encrypted form to preserve security.


Note Passwords can be assigned only to channels or programs created on the local IP/TV Program Manager. Channels or programs created by one IP/TV Program Manager cannot be password-protected by a different IP/TV Program Manager. Sessions originating on the MBone cannot be password-protected.



Note If you set up an IP/TV program that you want to be available to the MBone community on the Internet, do not assign a password to the program. Any IP/TV program that has a password assigned is not viewable by the MBone tools vic and vat.


Access Restrictions

You can restrict the user's privileges on IP/TV Program Manager while creating user accounts. There are two types of predefined ACNS system privilege profiles that are applicable for IP/TV Program Manager:

Normal user—The user has read access, and can see some of the Content Engine settings.

Superuser—The user has administrative privileges such as creating new users and modifying the Content Engine settings.

A privilege profile must be assigned to each new user account. IP/TV Program Manager comes with a predefined superuser account that can be used initially to access IP/TV Program Manager and add other users. For information on creating users on IP/TV Program Manager, see the "Setting Up User Accounts for IP/TV Program Manager" section.

About Proximity Management

Together, the Server Clusters window and the Proximity Groups window of IP/TV Program Manager allow you to define the proximity of IP/TV Viewers to IP/TV Servers. Proximity management allows you to restrict IP/TV Viewers to receiving on-demand video only from specified server clusters and also allows you to balance on-demand loads among servers.

Servers and server clusters are defined in the Server Clusters windows of IP/TV Program Manager. Each server is a member of a single cluster.

IP/TV Program Manager is shipped with a cluster called Default. If you do not want to use clusters, assign all your servers to the Default cluster.


Note If you plan to use the default cluster, you should review the cluster capacity parameter, and change it to a value appropriate for your site. See the "Editing a Cluster" section later in this chapter for information.


A collection of subnets is defined as a proximity group. Any number of subnets can be defined within a single proximity group.

The assignment of proximity groups to server clusters is defined by the administrator, based on priority. Priority might be determined by physical distance, bandwidth capacity, network topology, or any other factor.

When a client requests an on-demand program, OnDemand Manager verifies which proximity group the client belongs to, and obtains the list of server clusters that can be used to meet the client request. OnDemand Manager then routes the IP/TV Viewer request to the cluster with the highest priority for that proximity group, and to the least busy server in that cluster.

If that cluster is unavailable, OnDemand Manager then tries other clusters in order of their priority for that proximity group. OnDemand Manager assigns the least busy server in the cluster to meet the client request or, depending on how the system has been configured by the IP/TV administrator, may deny the request.


Note There is no load balancing across clusters, only within a given cluster.


Defining Servers and Server Clusters

IP/TV Program Manager requires that you define all the machines that act as IP/TV Servers, and all other file servers that will be used for the transfer of media files.


Note If you define a new server, and there are on-demand programs already defined on other servers that use the same media files, the newly defined server is automatically added to the list of servers enabled to play those programs. It is thus easy to add capacity where needed.


For scheduled program servers, you can define the servers in either of two ways:

Define all the servers at once as part of the configuration process. If all servers are defined, then when you want to define a new program and assign it to a specific server, you can simply select that server from a list, making the procedure for defining a new program easier for IP/TV administrators.

Define servers dynamically. If you define a new scheduled program or recording and assign it to a server that is not yet defined, IP/TV Program Manager defines the server with a minimal set of information. The user who is defining the new program or recording needs to know the domain name of the server. At a later time, you may need to edit the minimal definition to add or modify information about that server. For example, you may want to add information about file transfer or SmallCast functions.


Note You must define the servers that you will use the media files from before you define on-demand programs, because OnDemand Manager communicates with the server and finds all media files in the media root directory of the server.


Defining a Server Cluster

To define an IP/TV Server cluster, follow these steps:


Step 1 In the IP/TV Program Manager main window, click the Server Clusters link. The Server Clusters window appears. (See Figure 3-7.)

Figure 3-7 Server Clusters Window

Step 2 In the Server Clusters window, click the New Cluster link in the banner bar. The New Cluster window appears. (See Figure 3-8.)

Figure 3-8 New Cluster Window

Step 3 Enter the name of the new cluster.

Step 4 In the Cluster Information section of the window, enter an optional description of the cluster and the cluster capacity in kbps.

Step 5 Click Add Cluster at the bottom of the window to send the completed form to IP/TV Program Manager.


Reviewing a Cluster

To review a cluster definition, follow these steps:


Step 1 In the Server Clusters window, click the Review link for the cluster.

Step 2 Read the Review Cluster window to find the information that you want to see.

Step 3 Click Edit or Delete at the bottom of the window to edit cluster information or delete the cluster. Click Servers to display the servers assigned to this cluster.


Deleting a Cluster

To delete a cluster, follow these steps:


Step 1 In the Server Clusters window, click the Delete link for the cluster. Or, in the Review Cluster window, click Delete at the bottom of the window.

Step 2 The Delete Cluster window asks you to confirm that you want to delete the cluster.


Note If servers are assigned to this cluster, you cannot delete the cluster until you either delete the servers or edit them to change their cluster assignments.


Step 3 If you still want to delete the cluster, click Delete Cluster. You return automatically to the Server Clusters window.


Editing a Cluster

To edit a cluster definition, follow these steps:


Step 1 In the Server Clusters window, click the Edit link for the cluster. Or, on the Review Cluster window, click Edit at the bottom of the window. The Edit Cluster window appears.

Step 2 In the Edit Cluster window, make any necessary changes.

Step 3 Click Revise Cluster at the bottom of the window to send the changes 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 Edit Cluster window to modify the information.

When you have finished correcting the errors, click Revise Cluster again to submit the corrections to IP/TV Program Manager.

If the window is properly completed, you return automatically to the Server Clusters window.


Defining Servers

To define an IP/TV Server, follow these steps:


Step 1 In the IP/TV Program Manager main window, click the Server Clusters link. The Server Clusters window appears. (See Figure 3-7.)

Step 2 To see all servers currently defined in a given cluster, click the Servers link for that cluster.

Step 3 Click the New Server link in the banner bar. The New Server window appears. (See Figure 3-9.)

Figure 3-9 New Server Window

Step 4 Enter the name of the new server. We recommend that you define a server by its domain name, not its IP address.

Step 5 In the Server Information section of the window, enter a description of the server.

The description is optional. However, it is useful to record information such as the location of the server and its capabilities (for example, a server that is used solely for live capture and has appropriate hardware such as a satellite feed or live-capture camera, a server in a specified department that is used to multicast all IP/TV programs for that department, or a server that is a multihomed host).

We recommend that you use the Description field to make it easier for IP/TV Program Manager administrators to select the appropriate server for a given program.

Step 6 Choose the default cluster or another cluster name in the cluster list.

Step 7 Specify the server type. Click IP/TV Server if you are defining an IP/TV Server. Click Other Server if you are defining a file transfer server.


Note If IP/TV Server is a multihomed host, only one of its addresses can be used to serve on-demand programs. Any of the other addresses of the server that are defined as servers must be specified as Other Server.


Step 8 If you are defining an IP/TV Server, leave the RTSP port unchanged or enter a new port number. The default number in this field is the value set in the Preferences window.

Step 9 Enter the capacity of the new server. The capacity is the maximum amount of multimedia data (in kbps) that the server can output onto the network.

Step 10 If the server has Windows Media Services installed and you want the server to be able to serve programs using either IP/TV Server or Windows Media Services, check the Interoperate with Windows Media Services check box.


Note If you check the Interoperate with Windows Media Services check box, when you define an on-demand program, the Use WMT column includes an option button beside the name of the server.


Step 11 If you plan to use the file transfer function to transfer files to or from the server, in the File Transfer Information portion of the window, enter the user ID and password (in both fields) that this server requires for FTP access. (See Figure 3-10.)

Step 12 In the SmallCast Information section of the New Server window, enter the names or IP addresses of IP/TV Servers to which this server can be instructed to SmallCast programs. See Chapter 7, "SmallCasting Scheduled Programs," for general information about the SmallCast capability. Also, see the "Sample SmallCast Program" section for an example of a program that uses SmallCast.

Figure 3-10 File Transfer and SmallCast Section of the New Server Window

Step 13 Click Add Server at the bottom of the window to send the completed form to IP/TV Program Manager.

Step 14 Repeat this procedure for each server that you want to define.


Multihomed Host Support

A multihomed host is a computer that has multiple network interfaces. IP/TV supports multihomed servers for scheduled multicast programs. You must define each interface as if it were a separate server in IP/TV Program Manager. Then, when you create a program to be served by that machine, you must choose the correct server name.

Reviewing a Server

To review a server definition, follow these steps:


Step 1 In the Servers window, click the Review link for the server. The Review Server window appears.

Step 2 Scroll through the Review Server window to find the information that you want to see.

Step 3 Click Edit or Delete at the bottom of the window to edit server information or delete the server.


Deleting a Server

To delete a server, follow these steps:


Step 1 In the Servers window, click the Delete link for the server. Or, in the Review Server window, click Delete at the bottom of the window. The Delete Server window appears.

Step 2 If you still want to delete the server, click Delete Server. You return automatically to the Servers window.

The Delete Server window asks you to confirm that you want to delete the server.



Caution If you delete the server, all scheduled and on-demand programs assigned to the server become inoperable, and all scheduled file transfers are deleted.

Editing a Server

To edit a server definition, follow these steps:


Step 1 In the Servers window, click the Edit link for the server. Or, in the Review Server window, click Edit at the bottom of the window. The Edit Server window appears.

Step 2 In the Edit Server window, make any necessary changes.

Step 3 Click Revise Server at the bottom of the window to send the changes 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 Edit Server window to modify the information.

When you have finished correcting the errors, click Revise Server again to submit the corrections to IP/TV Program Manager.

If the form is properly completed, you return automatically to the Servers window.


Searching for a Server

The Search window allows you to find the cluster for a given server. (See Figure 3-11.)

Figure 3-11 Search Window

To find the cluster for a given server, follow these steps:


Step 1 In the Server Clusters window, click the Search link in the banner bar.

Step 2 In the Search window, choose a server from the list.

Step 3 Click the corresponding Go button.

A new Search window lists the results of your search.


Managing Proximity Groups and Subnets

A proximity group is a collection of subnets. Any number of subnets can be defined within a single proximity group.

As shipped, IP/TV Program Manager is configured with a default proximity group. The default proximity group contains a single subnet (0.0.0.0/0) named The World. The default proximity group obtains its IP/TV programs from the default server cluster. With this initial configuration, all users in your network can view any program defined on any server in the default cluster.

If you prefer not to use proximity groups, you need not change this default configuration.

However, if you define new clusters, proximity groups, and subnets, your new definitions take precedence over the default configuration. Any viewers not in a proximity group you define remain in the default proximity group, and can view only those programs on the default server cluster.

If you want to tighten security, after setting up your own clusters, proximity groups, and subnets, delete the default proximity group and the default cluster. In this way, you can prevent any user not in a defined proximity group from viewing any IP/TV programs.


Note Viewers in different proximity groups may have a different set of on-demand programs available to them, because their on-demand requests are fulfilled by different clusters. If a program is not available because it is not defined on a server in the cluster priority list of the proximity group, the program does not appear in the program listing of the viewer.


Defining a Proximity Group

To define a proximity group, follow these steps:


Step 1 In the IP/TV Program Manager main window, click the Proximity Groups link. The Proximity Groups window appears. (See Figure 3-12.)

If no proximity groups have been defined, the window displays only the default proximity group, which includes all clients that belong to an unspecified network.

Figure 3-12 Proximity Groups Window

Step 2 Click the Subnets link for a given proximity group to display a list of all subnets currently defined for that proximity group.

Step 3 To create a new proximity group, click the New Proximity Group link in the banner bar. The New Proximity Group window appears. (See Figure 3-13.)

Figure 3-13 New Proximity Group Window

Step 4 Enter the name of the proximity group.

Step 5 Enter a description of the proximity group.

Step 6 In the Cluster Priority List section of the New Proximity Group window, choose clusters in order of priority.

The cluster list determines the order in which OnDemand Manager tries each server cluster when a request for an on-demand program is received from IP/TV Viewer. The maximum number of clusters in the hierarchy is set on the Preferences window of IP/TV Program Manager. The default is five.

Step 7 Click Add Proximity Group at the bottom of the window to send the completed form to IP/TV Program Manager.


Reviewing a Proximity Group

To review a proximity group, follow these steps:


Step 1 In the Proximity Groups window, click the Review link for the proximity group. The Review Proximity Group window appears.

Step 2 Scroll through the Review Proximity Group window to find the information that you want to see.

Step 3 Click Edit or Delete at the bottom of the window to edit proximity group information or delete the proximity group, or click Back to return to the Proximity Groups window.


Deleting a Proximity Group

To delete a proximity group, follow these steps:


Step 1 In the Proximity Groups window, click the Delete link for the proximity group. Or, in the Review Proximity Group window, click Delete at the bottom of the window. The Delete Proximity Group window appears.

Step 2 The Delete Proximity Group window asks you to confirm that you want to delete the proximity group.

Step 3 If you still want to delete the proximity group, click Delete Proximity Group. You return automatically to the Proximity Groups window.


Editing a Proximity Group

To edit a proximity group, follow these steps:


Step 1 In the Proximity Groups window, click the Edit link for the proximity group. Or, in the Review Proximity Group window, click Edit at the bottom of the window. The Edit Proximity Group window appears.

Step 2 In the Edit Proximity Group window, make any necessary changes.

Step 3 Click Revise Proximity Group at the bottom of the window to send the changes 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 Edit Proximity Group window to modify the information.

When you have finished correcting the errors, click Revise Proximity Group again to submit the corrections to IP/TV Program Manager.

If the form is properly completed, you return automatically to the Proximity Groups window.


Searching for a Proximity Group

To search for the proximity group for a given host, follow these steps:


Step 1 In the Proximity Groups window, click the Search link in the banner bar. The Search window appears. (See Figure 3-11.)

Step 2 To find the proximity group for a host, enter the host name and click the corresponding Go button. A new Search window lists the results of your search.


Defining a Subnet

To define a new subnet, follow these steps:


Step 1 To create a new subnet, click the New Subnet link in the banner bar in the Proximity Groups window. The New Subnet window appears. (See Figure 3-14.)

Figure 3-14 New Subnet Window

Step 2 Enter the name of the new subnet.

Step 3 Enter an optional description of the new subnet.

Step 4 Choose a proximity group for the new subnet from the list.

Step 5 Enter the IP address of the new subnet, and an optional subnet mask.

Step 6 Click Add Subnet at the bottom of the window to send the completed 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 Subnet window to modify the information.

When you have finished correcting the errors, click Add Subnet again to submit the corrections to IP/TV Program Manager.

If the form is properly completed, you return automatically to the Subnets window.


Reviewing a Subnet

To review a subnet definition, follow these steps:


Step 1 In the Proximity Groups window, click the Subnets link for the Proximity Group with which the subnet is associated, and then click the Review link for the subnet. The Review Subnet window appears.

Step 2 Scroll through the Review Subnet window to find the information that you want to see.

Step 3 Click Delete or Edit at the bottom of the window to delete or edit the subnet, or click Back to return to the Subnets window.


Deleting a Subnet

To delete a subnet, follow these steps:


Step 1 In the Subnets window, click the Delete link for the subnet. Or, in the Review Subnets window, click Delete at the bottom of the window. The Delete Subnet window appears.

Step 2 The Delete Subnet window asks you to confirm that you want to delete the subnet.

Step 3 If you still want to delete the subnet, click Delete Subnet. You return automatically to the Subnets window.


Editing a Subnet

To edit a subnet, follow these steps:


Step 1 In the Subnets window, click the Edit link for the subnet. Or, in the Review Subnet window, click Edit at the bottom of the window. The Edit Subnet window appears.

Step 2 In the Edit Subnet window, make any necessary changes.

Step 3 Click Revise Subnet at the bottom of the window to send the changes 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 Edit Subnet window to modify the information.

When you have finished correcting the errors, click Revise Subnet again to submit the corrections to IP/TV Program Manager.

If the window is properly completed, you return automatically to the Subnets window.


Searching for a Subnet

To search for the proximity group for a subnet, follow these steps:


Step 1 In the Proximity Groups window, click the Search link in the banner bar. The Search window appears. (See Figure 3-11.)

Step 2 To find a proximity group for a subnet, enter the IP address and (optional) subnet mask, and click the corresponding Go button. The IP address and subnet mask must exactly match the information you entered when you defined the subnet in the New Subnets window.


Managing Channels

Channels are used only for scheduled programs and not for on-demand programs. The use of channels is optional. IP/TV Program Manager allows you to set up programs that are not assigned to any channel.

If you decide to use channels as a way to organize IP/TV programs, you can define IP/TV channels in any of several ways. For example, you might choose one of the following schemes:

Create a channel for each department that originates programs, for example, "Sales," "Tech Support," "Training," "Corporate," "Engineering," and "Manufacturing."

Create a channel for each type of program content, for example, "Education," "Product News," and "24-Hour News."

Channels Window

To display the Channels window (see Figure 3-15), click the Channels link in the banner bar in the Scheduled Programs window.

Figure 3-15 Channels Window

The Channels window lists all existing channels. For each channel, the display indicates the name and description of the channel.

The following links are available for each channel:

The Review link takes you to the Review Channel window (see the "Reviewing a Channel" section later in this chapter).

The Delete link takes you to the Delete Channel window (see the "Deleting a Channel" section later in this chapter).

The Edit link takes you to the Edit Channel window (see the "Editing a Channel" section later in this chapter).

Creating a New Channel

To create a new channel, follow these steps:


Step 1 In the Channels window, click the New Channel link in the banner bar. The New Channel window appears. (See Figure 3-16.)

Figure 3-16 New Channel Window

Step 2 Enter the channel name. Use a fairly short name, such as Sales Channel or News Channel.

Step 3 Enter a description of the channel. The Description field allows you to enter a longer description of the channel than the name field permits.

Step 4 If there is a website that provides additional information about the channel, you can enter the URL of that website.

Step 5 If you want the channel to have a password, enter the password in both password fields. The password applies to every program assigned to this channel.

Step 6 In the Multimedia Source Information section of the New Channel window (see Figure 3-17), enter the preferred video and audio formats to be used by programs assigned to this channel, or accept the defaults specified in your preferences.

Figure 3-17 Multimedia Source Information Section of the New Channel Window

Table 3-12 describes the channel multimedia source options.

Table 3-12 Channel Multimedia Source Options 

Parameter
Description

Preferred Video Format

Defines the default video format.

Preferred and alternate audio formats

Defines the default audio format, and any alternatives that can be used to override the default. You can choose to allow all alternatives, or only selected alternatives.

Play Video

Defines whether the video portion of programs assigned to this channel is shown.

Play Audio

Defines whether the audio portion of programs assigned to this channel is shown.

Play SlideCast

Defines whether programs assigned to this channel include a SlideCast portion in addition to video and audio portions. You can choose either Play SlideCast or Play Web Presentation, but not both.

Play Web Presentation

Defines whether programs assigned to this channel include a web presentation portion in addition to video and audio portions. You can choose either Play SlideCast or Play Web Presentation, but not both.


Step 7 In the Multimedia Address Information section of the New Channel window (see Figure 3-18), enter information about the addresses to be used for programs assigned to this channel, or accept the defaults specified in your preferences.

Figure 3-18 Multimedia Address Information Section of the New Channel Window

Table 3-13 describes the channel multimedia address options.

Table 3-13 Channel Multimedia Address Options 

Parameter
Description

Select Global Scoped Addresses

Assigns global scoped addresses for all programs assigned to this channel.

Multicast Range (TTL)1

Sets the multicast range for all programs assigned to this channel.

Use these Addresses1

Overrides the default addresses for this channel, and requires that you enter the IP addresses and UDP port numbers to be used for the video, audio, and SlideCast or web presentation portions of all programs assigned to this channel.

Video IP Address

Defines the video IP address for programs assigned to this channel.

Video UDP Port1

Defines the video UDP port for programs assigned to this channel. See Table 3-14 for UDP port ranges.

Audio IP Address

Defines the audio IP address for programs assigned to this channel.

Audio UDP Port1

Defines the audio UDP port for programs assigned to this channel. See Table 3-14 for UDP port ranges.

SlideCast/Presentation IP Address1

Defines the IP address for the SlideCast or web presentation portion of programs assigned to this channel.

SlideCast/Presentation UDP Port1

Defines the UDP port for the SlideCast or web presentation portion of programs assigned to this channel. See Table 3-14 for UDP port ranges.

Use SSM1

Enables source-specific multicast (SSM) for the program when multimedia addresses are configured using the Use these Addresses option.

1 If the ability to override the default is disabled in your preferences, this parameter does not appear.


Table 3-14 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 3-14 UDP Port Ranges

Type of Stream
Port Number Range

Audio

16,384 through 32,766

Web presentation

32,768 through 49,150

Video or SlideCast

49,152 through 65,534


Step 8 In the Contact Information section of the New Channel window, enter the name, telephone number, and e-mail address of the person that users can contact with questions about the channel. (See Figure 3-19.)

Figure 3-19 Contact Information Section of the New Channel Window

Step 9 Click Create Channel at the bottom of the New Channel window 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 Channel window to modify the information.

When you have finished correcting the errors, click Create Channel again to submit the corrections to IP/TV Program Manager.

If the form is properly completed, you return automatically to the Channels window.


Reviewing a Channel

To review a channel, follow these steps:


Step 1 In the Channels window, click the Review link for the channel that you want to review. The Review Channel window appears.

Step 2 Scroll through the Review Channel window to find the information that you want to see.

Step 3 After you have reviewed the information, click Back to return to the Channels window, or click Edit or Delete at the bottom of the window to modify or delete the channel.


Deleting a Channel

To delete a channel, follow these steps:


Step 1 In the Channels window, click the Delete link for the channel. Or, in the Review Channel window, click Delete Channel at the bottom of the window. The Delete Channel window appears.

Step 2 The Delete Channel window asks you to confirm that you want to delete the channel and all programs assigned to it.

Click Delete Channel to delete the channel.

Click Back to return to the Channels window without deleting the channel and its programs.


Editing a Channel

To edit a channel, follow these steps:


Step 1 In the Channels window, click the Edit link for the channel. Or, in the Review Channel window, click Edit Channel at the bottom of the window. The Edit Channel window appears.

Step 2 Scroll through the Edit Channel window to find the information that you want to change. The window allows you to change any field that was entered when the channel was created.

Step 3 Click Revise Channel at the bottom of the window to send the changes 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 Edit Channel window to modify the information.

When you have finished correcting the errors, click Revise Channel again to submit the corrections to IP/TV Program Manager.

If the window is properly completed, you return automatically to the Channels window.



Note Avoid changing the password, audio format, video format, IP addresses, or UDP port numbers assigned to a channel less than 10 minutes before any program on the channel is scheduled to begin or while a program is playing. Changes can prevent IP/TV Viewer from displaying the program properly.