Cisco TV CDS 2.4 RTSP Software Configuration Guide for the Cisco ISM (Integrated Service Module) Line Card
System Maintenance
Downloads: This chapterpdf (PDF - 206.0KB) The complete bookPDF (PDF - 4.7MB) | Feedback

Table of Contents

System Maintenance

User Access

Setting Up Users

Editing User Settings

Deleting a User

Viewing User Settings

Changing User Default Settings

Server Maintenance

Restarting a Server

Shutting Down a Server

Offloading a Server

Server Offload—Disable

Setting System Thresholds

Restarting the Services

Software Maintenance

Viewing the Software Version and Server Information

Uploading an EPG File

Identifying Server IDs and Group IDs for VVI with Split-Domain Management

Generating Server IDs and Group IDs from the VVIM

Manuals

System Maintenance

This chapter explains how to perform common administrative tasks including, updating system software, restarting services, and shutting down the Vault and Streamer servers. This chapter covers the following topics:


NoteIf Virtual Video Infrastructure (VVI) with split-domain management is enabled, the CDSM pages associated with the Vaults and Caching Nodes display only on the VVI Manager (VVIM), and the CDSM pages associated with the Streamers display only on the Stream Manager. For more information, see the If Virtual Video Infrastructure (VVI) with split-domain management is enabled, the CDSM pages associated with the Vaults and Caching Nodes display only on the VVI Manager (VVIM), and the CDSM pages associated with the Streamers display only on the Stream Manager. For more information, see the “Virtual Video Infrastructure” section.



NoteYou must have read/write privileges to perform the functions described in this chapter. You must have read/write privileges to perform the functions described in this chapter.



Caution Many of the functions discussed in this chapter involve rebooting a CDS server. Rebooting a Vault server does not interrupt stream services, but causes current ingests to fail. If your CDS does not have stream failover, rebooting a Streamer without offloading it interrupts all stream services. If possible, you should perform functions that require a system restart during times when the least number of users are actively connected to your system.

User Access

The CDS consists of one of the following network configurations:

  • One or more Vault servers, one or more Streamer servers, and one CDSM
  • One or more ISV servers and one CDSM

All the components of your CDS are configured, monitored, and managed centrally through the CDSM. The CDSM is a browser-based interface that runs on its own server. However, there are some ISV systems that include the CDSM functions.

The CDS provides three levels of user access:

  • Read only access provides viewing access to the configuration settings and monitoring capabilities.
  • Read/write access provides the ability to change the configuration settings and monitor all aspects of the system. In addition, a user with read/write access can perform software upgrades, restart servers, and restart services in a CDS.
  • Master access has all the privileges of the read/write level and can add, delete, and change the level of access of the other users.
  • Engineering access is primarily used for initializing the CDS at the time of installation and for CDS diagnostics. After your CDS has been configured, you should not require a user with engineering access level for day-to-day operations.

There is one built-in user, “admin,” that has master user capabilities. This is the only user that exists on a new system.

Setting Up Users

The CDS provides one built-in user, “admin,” that has master level access and cannot be deleted. The master user can add additional users with different levels of access.

To add a user, do the following:


Step 1 Choose Maintain > Users > Add User . The Add User page is displayed.

Step 2 Fill in the fields as described in Table 7-1 .

 

Table 7-1 Add User Fields

Field
Description

New User

User login ID. A user name may have up to 25 characters. Any 7-bit characters from the American National Standards Institute (ANSI) character set are allowed.

Password

Password associated with the user login name. The password must be at least 5 characters. The maximum is 20.

Access

Choose the appropriate access level from the drop-down list. See the beginning of this section, the “User Access” section for descriptions of the access levels.

Step 3 Click Add User to add this user.

To clear the fields and start over, click Reset .


 

Editing User Settings

To change a user password and access level, do the following:


Step 1 Choose Maintain > Users > Edit User . The Edit User page is displayed.

Step 2 From the Action drop-down list, choose Change Password or Change Access .

Step 3 From the User Name drop-down list, choose a user name.

Step 4 Fill in the new password or choose the access as appropriate. See Table 7-2 for descriptions of these fields.

 

Table 7-2 Edit User Fields

Field
Description

New Password

Password associated with the user login name. The range is 5 to 20 characters.

Access

Choose the appropriate access level from the drop-down list. See the beginning of this section, the “User Access” section, for descriptions of the access levels.

Step 5 Click Submit to save the changes.

To clear the fields and start over, click Reset .


 

Deleting a User

To delete a user from the list of users, do the following:


Step 1 Choose Maintain > Users > Edit User . The Edit User page is displayed (Figure 7-1).

Step 2 From the Action drop-down list, choose Delete User .

Step 3 From the User Name drop-down list, choose a user.

Step 4 Click Submit to delete the user.

To clear the fields and start over, click Reset .


 

Viewing User Settings

To view all user settings you must log in with master access level. Choose Maintain > Users > View Users . The View Users page is displayed.

Changing User Default Settings

The User Default Settings page allows you to specify your settings for the Media Scheduler page so that each time you log in to the CDSM your settings are recalled. If you have master level access, you can specify the settings for all users. For more information about the Media Scheduler, see the “Configuring the Media Scheduler” section.

To change the default settings for a user, do the following:


Step 1 Choose Maintain > Users > User Default Settings . The User Default Settings page is displayed.

Step 2 From the Select User drop-down list, choose a user. The User Default Settings page refreshes and displays the user settings (Figure 7-1).

Figure 7-1 User Default Settings Page

 

Step 3 In the Media Scheduler Preferences section of the page, make your selections as appropriate. See Table 7-3 for descriptions of the fields.

 

Table 7-3 Media Scheduler Preferences

Field
Description

Action on Recurring Schedules

Choose either Preserve Exiting Schedules or Overwrite Existing Schedules . This option is only for user-generated schedules and is not for uploaded electronic program guide (EPG) data.

Preserving Existing Schedules keeps any content that is currently scheduled for the day and channel you selected and fills in only the empty timeslots. Overwrite Existing Schedules overwrites any content that is currently scheduled for the day and channel you selected.

Package Name Generation

When you schedule an event that originated from an uploaded EPG file, the Media Scheduler creates a package name combining the channel name, title brief, and the word “package.” If the package name already exists and you want a new package name auto-generated, choose Enable and the start time is added to the package name. If the package name already exists and you want to create the package name using the Metadata Editor, choose Disable .

Step 4 In the Input Channels Displayed on Media Scheduler section of the page, check the check boxes for the channels you want to schedule, or check the Select All check box to choose all channels.

Step 5 If you have master level access and you want to apply the user default settings of this page to all users, check the Apply To All Users check box.

Step 6 Click Save to save the changes.

To clear the fields and start over, click Reset .


 

Server Maintenance

The Server Maintenance pages provides the ability to offload and shutdown a server for maintenance, and to restart a server without shutting it down. The Server Maintenance pages include the following:

Restarting a Server


Caution Restarting a Vault or Streamer server while there are still active ingests and streams causes the current ingests and streams to fail.

Restarting a server briefly shuts down the unit, then restarts it using the installed version software image. This action does not power off the unit.

To restart a server, do the following:


Step 1 Choose Maintain > Servers > Server Restart . The Server Restart page is displayed.

Step 2 From the Server IP drop-down list, choose the IP address or nickname of the server and click Display . The server type and ID, as well as the array ID, are displayed.

Step 3 From the Restart drop-down list, choose Yes and click Submit .


 

Shutting Down a Server


Caution Shutting down a Vault or Streamer server while there are still active ingests and streams causes the current ingests and streams to fail.

Shutting down by simply powering off the unit using the chassis power button is not recommended, as this may result in corruption of the configuration information, including system status when the shutdown occurred.

Shutting down and restarting using the CDSM is the recommended procedure. the Server Shutdown shuts down and powers off the selected unit.

To shut down and power off a server, do the following:


Step 1 Choose Maintain > Servers > Server Shutdown . The Server Shutdown page is displayed.

Step 2 From the Server IP drop-down list, choose the IP address or nickname of the server and click Display . The server type and ID, as well as the array ID, are displayed.

Step 3 From the Shutdown drop-down list, choose Yes and click Submit .


 

Offloading a Server

The Server Offload page lets you enable or disable the server offload. When Server Offload is enabled on a server, the server is configured to reject new provisioning; that is, do not allow new ingests on a Vault and do not allow new streams on a Streamer.

To enable Server Offload, do the following:


Step 1 Choose Maintain > Servers > Server Offload . The Server Offload page is displayed.

Step 2 From the Server IP drop-down list, choose the IP address or nickname of the server and click Display . The server type and ID, as well as the array ID, are displayed.

Step 3 Choose Enable and click Submit .


 

After enabling Server Offload, current traffic activity can be monitored, and when the server offload is complete, the software can be updated. To view activity on a Vault server, see the “Monitoring Content Objects” section. To view activity on a Streamer, see the “Monitoring Stream Objects” section. If the server is an ISV, verify that activity is completed for both content objects and stream objects before updating the software.


NoteThe Server Offload setting is persistent through a system reboot. The Server Offload setting is persistent through a system reboot.


Server Offload—Disable

After the software upgrade or maintenance is complete, you need to disable the server offload so that the server can again participate in the system.

To disable Server Offload, do the following:


Step 1 Choose Maintain > Servers > Server Offload .

Step 2 From the Server IP drop-down list, choose the IP address or nickname of the server and click Display . The server type and ID, as well as the array ID, are displayed.

Step 3 Choose Disable and click Submit .


 

Setting System Thresholds

The System Thresholds page allows you to set thresholds for loss and usage of the CDS resources, as well as enable or disable monitoring of the CDS services. The Performance Parameters section of the page has threshold values; the System Services section of the page enables or disables monitoring of the specific services. To view the system services monitored, see the “Services Monitor” section. Table 7-4 lists each threshold in the Performance Parameters section, and where each threshold is monitored.

 

Table 7-4 Performance Thresholds

Threshold
Monitoring Page

Port Loss

The Network indicator box on the “System Health” section.

Disk Loss

The Disk indicator box on the “System Health” section.

Disk Capacity Notify

The “Disk Monitor” section.

Disk Capacity Warning

The “Disk Monitor” section.

Linux File System Usage

The “Disk Monitor” section.

To set the system thresholds and enable or disable the system services, do the following


Step 1 Choose Maintain > Servers > System Thresholds. The System Thresholds page is displayed (Figure 7-2).

Figure 7-2 System Thresholds Page

 

Step 2 Enter the threshold settings and enable or disable the services as appropriate.

Step 3 Click Submit to save the settings.

To clear the fields and start over, click Reset .

To restore the default settings, click Restore . The default values are shown in a separate column on the page.


 

Restarting the Services

Each server runs services that allow the server to function with other components in the CDS. Services are not automatically restarted each time there is a configuration change. If you need to restart a service, the Services Restart page provides this option. This action does not power cycle the unit. Table 7-5 describes the different services.

 

Table 7-5 Restart Services Options

Service
Description

Reload Bandwidth Manager

Optional feature. Any time there are changes to the Bandwidth Manager configuration, it is necessary to reload the bandwidth manager.

RTSP

Any time there are changes to the RTSP Setup page, it is necessary to restart the RTSP nABLE service.

SNMP

Any time there are changes to the SNMP configuration, it is necessary to restart the SNMP service.

To restart a service, do the following:


Step 1 Choose Maintain > Services . The Services Restart page is displayed.

Step 2 From the Server IP drop-down list, choose the IP address or nickname of the server and click Display . The server type and ID, as well as the array ID, are displayed.

Step 3 Select the check box next to each service you want to restart and click Submit .

To clear the fields and start over, click Reset .


 

Software Maintenance

The Software Maintenance pages provides the ability to view the CDS software, upload an electronic program guide (EPG) file, generate server IDs and group IDs for Video Virtualization Infrastructure (VVI), and upload a topology file. This section covers the following topics:

Viewing the Software Version and Server Information

To view the TV CDS software version and server information, choose Maintain > Software > Software Version . The Software Version page is displayed. From the Server IP drop-down list, choose the IP address or nickname of the server and click Display . The following information is displayed:

  • Server type (Vault, Streamer SSV (ISV))
  • Software version
  • Server ID
  • Array ID
  • Product ID (PID)—CDE model (for example, the Cisco ISM (Integrated Service Module) Line Card)
  • Version ID (VID)—Hardware version (for example, V01)
  • Serial number—Serial number of the CDE
  • Additional string—Model variation (for example, 4A-C)

Uploading an EPG File

The EPG File Upload page can be used to upload an electronic program guide (EPG) file into the CDS for use with the Media Scheduler. The EPG file is an XML file.


NoteBefore you can upload an EPG file, you need to enter the channel information. See the Before you can upload an EPG file, you need to enter the channel information. See the “Configuring Input Channels” section for more information.


To upload an EPG file, do the following:


Step 1 Choose Maintain > Software > EPG Upload . The EPG File Upload page is displayed.

Step 2 Enter the full path and filename in the EPG File Location field, or click Browse to locate the file using the Browse window.

Step 3 After the full path and filename of the EPG File is entered, click Upload .

To clear the fields and start over, click Reset .


 

Identifying Server IDs and Group IDs for VVI with Split-Domain Management

The VVIM manages all the identifiers, and the Stream Managers get a range of group IDs and server IDs from the VVIM and uses them for the Streamers it manages.

Table 7-6 lists the CDSM GUI ID names and maps them to the CServer names in the setupfile and .arroyorc files.

 

Table 7-6 ID Names in the CDSM GUI and CServer Files

CDSM GUI ID Name
CServer Files ID Name

Array ID on the Array Name page

groupid

Group ID on the Server-Level pages

groupid

Stream Group ID on the Server Setup page

arrayid

Cache Group ID on the Server Setup page

arrayid

Vault Group ID on the Server Setup page

arrayid

Stream Group ID on the Configuration Generator page

arrayid

Generating Server IDs and Group IDs from the VVIM

The Configuration Generator page is used to generate group IDs and server IDs for the Stream Managers. When the Stream Manager contacts the VVIM during the initial configuration using the cdsconfig script, the VVIM generates the IDs, sends them to the Stream Manager, and populates the table on the Configuration Generator page. This is done by an HTTP GET request over port 80.

If the Stream Manager is unable to contact the VVIM during the initial configuration, the cdsconfig script prompts the Stream Manager administrator to contact the VVIM administrator for the server ID. The VVIM administrator would then go to the Configuration Generator page to generate the IDs for the Stream Manager.

For HTTP streamers, if the Stream Manager is unable to reach the VVIM, either because port 80 is not open for communication or because of some other connectivity reason, the Stream Manager administrator can contact the VVIM administrator for the needed information. This information consists of the following:

  • Stream Group IDs
  • Cache Group information

Using the Configuration Generator page, the VVIM administrator can look up the group ID and server ID ranges, and if necessary generate them. The VVIM administrator can provide the beginning group ID for the Stream Groups, which the Stream Manager administrator enters on the Stream Groups Setup page, if prompted to do so.

The Cache Group information is contained in an XML file, called CacheGroupsConfig.xml. The VVIM administrator can click the Download link to view the CacheGroupsConfig.xml file, and right-click the Download link to save the XML file locally. This XML file can be sent to the Stream Manager administrator and the Stream Manager can upload it through the Cache Group Locator page.

To generate new IDs or view the existing IDs, do the following:


Step 1 Choose Maintain > Software > Configuration Generator. The Configuration Generator page is displayed (Figure 7-3).

Figure 7-3 Configuration Generator Page

 

Step 2 In the Stream Domain Name field, enter the name of the Stream Manager that you are generating IDs for.

Step 3 In the Stream Manager IP field, enter the IP address of the Stream Manager that you are generating IDs for.

Step 4 Click Generate New IDs .


 

Configuration Generator Table

The table on the Configuration Generator page lists the Stream Domain Name, Stream Manager IP address, and the ID ranges assigned for each Stream Manager.

Stream Group ID Range and Server ID Range

Sometimes the group IDs and Server IDs show as “not generated” in the table.To generate the IDs, click the Not Generated text in the Stream Group ID Range column. A dialog box is displayed asking if you want to generate the IDs now. Click OK .

Stream Manager IP Address

The IP address of the Stream Manager is not included in the table on the Configuration Generator page until the Stream Manager is configured using the CDSM Setup page. It is possible that the Stream Manager IP address failed to be captured, in which case the entry is displayed as “Not Captured.” Click the Not Captured link to enter the IP address manually. A text box is displayed with an Update icon (plus sign) and a Cancel icon (X).

Setup ID Range

Setup IDs are only used in RTSP environments that have split-domain management and are using CCP Streamers. The VVIM only generates two setup IDs for each Stream Domain. A setup ID is used to identify the Setup server in a Stream Group. The Setup and Control servers are configured for each Stream Group on the Control/Setup IP page. See the “Configuring the Control and Setup IPs” section for more information. If the Stream Manager uses the two allotted setup IDs, it contacts the VVIM for a new set of setup IDs. If the connection between the Stream Manager and VVIM fails, the Stream Manager administrator contacts the VVIM administrator for the IDs. The new setup IDs can be generated by clicking the Generate new Setup ID range icon in the Setup ID Range column.


NoteCCP Streamers are not supported in a VVI split-domain management for RTSP environments. CCP Streamers are not supported in a VVI split-domain management for RTSP environments.


Manuals

To view the manual, choose Maintain > Manuals . The Manual page is displayed. Click the link to the manual. The manual is displayed by means of the Acrobat Reader plug-in for your browser.


Tip To download the manual to your computer, right-click the link of the manual and save the manual to a location on your hard drive for later viewing.