Cisco TV CDS 2.0 RTSP Software Configuration Guide

Book Contents

Find Matches in This Book

Available Languages

Download Options

Book Title

Cisco TV CDS 2.0 RTSP Software Configuration Guide

Chapter Title

SNMP MIB and Trap Information

PDF - Complete Book (6.32 MB) PDF - This Chapter (146.0 KB)
View with Adobe Reader on a variety of devices

Results

SNMP MIB and Trap Information

This appendix describes the Simple Network Management Protocol (SNMP) traps sent by the CDS. The topics covered in this appendix include:

•Overview

•SNMP Management Objects and Traps

•RFC Compliance

Overview

You can manage the servers by way of SNMP from a Network Management System (NMS). To implement SNMP management, the servers must be configured with a management IP address, SNMP community strings, and contact information. For more information about configuring the server for SNMP communication, see the "Configuring the SNMP Agent" section on page 4-49.

Note We recommend configuring a VLAN for management traffic.

SNMP management features on the servers include:

•SNMP version 1 or version 2c

•Standard MIBs

SNMP Agent

The server's SNMP agent uses certain variables that are included in a Cisco proprietary Management Information Base (MIB) file. By default, the SNMP agent is not started automatically. To start the SNMP agent, login to the server as root and enter the following command:

# nice -n 19 /usr/local/bin/snmpd

To have the SNMP agent start automatically after a reboot, use the Linux vi editor to add the following to the /etc/rc.local file:

nice -n 19 /usr/local/sbin/snmpd

To verify the SNMP agent has started, enter the ps -ef | grep snmpd command.

SNMP Management Objects and Traps

The CDS SNMP agent and Management Information Base (MIB) files are compliant with the Internet Engineering Task Force (IETF) standards for SNMP v1 and SNMP v2c. For a list of SNMP-associated Request For Comment (RFC) specifications, see the "RFC Compliance" section.

The MIB files are located in the /usr/local/share/snmp/mibs/ directory.

The CDS MIBs describe the following groups of trapped events:

•Device

•Configuration

•Health

•Statistics

Note Some MIBs (for example, Device) do not have any associated traps.

Table B-1 describes the management objects defined in the Device MIB.

Table B-1 Device MIB
Management Object	Description
arDeviceRole	The server type: •Streamer •Vault •SSV (ISV) •Controller (CDSM)
arDevicePartNo	The part number of the device.
arDeviceServerId	The server ID of this server.
arDeviceGroupId	All servers that are part of the same CDS (managed by one CDSM) have the same group ID. This group ID should be unique across an enterprise.

Table B-2 describes the management objects defined in the Configuration MIB for an ISA environment.

Table B-2 Configuration MIB¹
Management Object	Description
arConfigISANamingServiceIp	The IP address of the CORBA Naming Service used by the OpenStream system.
arConfigISANamingServicePort	The port of the Naming Service used by the OpenStream system.
arConfigISANotifyServiceIp	The IP address of the CORBA Notification Service used by the OpenStream system.
arConfigISANotifyServicePort	The port of the Notification Service used by the OpenStream system.
arConfigISANotifyEventChannelFactory	The name used to locate the Notify Service through corbaloc protocol (DefaultEventChannelFactory in OpenStream).
arConfigISAContentServiceMasterIp	The IP address for the master Content Service.
arConfigISAContentServiceMasterPort	The port number for the master Content Service.
arConfigISAStreamServiceMasterIp	The IP address for the master Streamer Service.
arConfigISAStreamServiceMasterPort	The port number for the master Streamer Service.
arConfigISAWebServicePort	The port number for the ISA web services.
arConfigISAConfigFile	The filename of the ISA configuration file.
arConfigISAEventChannelsId	A simple name that identifies the root directory of the Event Channel where all event channels need to register.
arConfigISAEventChannelsKind	The directory extension of the Event Channel ID.
arConfigISAContentChannelsId	A simple name that identifies the Content Event Channel where all events concerning content objects are published.
arConfigISAContentChannelsKind	The Event Channel Content ID extension.
arConfigISAStreamChannelsId	A simple name that identifies the Stream Event Channel where all events concerning stream objects are published.
arConfigISAStreamChannelsKind	The Event Channel Stream ID extension.
arConfigISAFactoriesId	A simple name that identifies the root directory of the Factories where all factories need to register.
arConfigISAFactoriesKind	The Factories ID extension.
arConfigISAEventChannelFactory	A simple name that identifies the Event Channel Factory, which is used to create event channels, and resolves the Notification Service name.
arConfigISALoadQueryInterval	The time interval, in seconds, in which ISA gets the current load heuristics of all servers in the Vault/Streamer arrays in order to make a provisioning decision.
arConfigISAContentStoreFactoryId	The name of the CDS Content Store Factory that is registered with the OpenStream system. The Content Store Factory allows the creation of Content Store objects, and the Content Store objects act as factories for content objects.
arConfigISAContentStoreKind	The Content Store Factory ID extension.
arConfigISAContentStoreNumThreads	The number of threads allocated to the ISA Content Store service.
arConfigISAFTPServerPort	The port used when the Vault receives a request from the OpenStream system to act as an FTP server and receives an FTP put command from the content provider acting as an FTP client.
arConifgISAFTPClientPort	The port used when the Vault receives a request from the OpenStream system to act as an FTP client and sends an FTP get command to the content provider acting as an FTP server.
arConfigISAFTPClientNumAttempts	The number of times the FTP client attempts to connect to the FTP server before considering the transaction failed.
arConfigISAFTPPollTimeout	The polling timeout for FTP.
arConfigISAStreamSourceIPConfig	The Stream Source IP address. The possible values are: •Control IP •Default Stream Source IP •Stream Interface IP •None
arConfigISAStreamServiceId	The name of the Stream Service.
arConfigISAStreamServiceKind	The Service ID extension.
arConfigISAStreamNumThreads	The number of threads created by the Stream Service.
arConfigISATME	Whether Trick-Mode Event (TME) enhancements are enabled.
arConfigISAStreamingSourcePort	The streaming source port number.
arConfigISALSCPServerPort	The port on the Streamer that is listening for LSCP commands from the set-top box.
arConfigISAStreamingMode	The stream mode. Mode 1 is used by the Scientific Atlanta QAMs. Mode 2 is used by the Scientific Atlanta GQAM, the Harmonic NSG, and the Motorola SEM.
arConfigISAStreamHeadendId	The headend ID for the Stream Service.
arConfigISAPlayNumThreads	The Lightweight Stream Control (LSC) number of threads.
arConfgISALSCPResponsePadding	The response padding used in LSCP transactions.
arConfigISAResourceManagerName	The name of the CDS Resource Service Manager that monitors orphan sessions.
arConfigISASessionsPollTime	The time interval between polling for orphan sessions.
arConfigISAStreamTimeout	The maximum time allowed before a stream object is played. If the stream object is not played within the timeout period, it is destroyed.
arConfigISAPreEncryptionEnabled	Indicates whether support for Motorola pre-encryption is enabled or disabled.
arConfigISAContentStoreName	The Content Store name.
arConfigISAMSAEnabled	Indicates whether Managed Services Architecture (MSA) is enabled or disabled. MSA routes successful events to the ISA event channels and error events to either the Event Posting Agent (EPA) or Event Log Agent (ELA).
arConfigISAFTPServerOutPort	The port number used by ISA 1.5 FTP out feature.
arConfigISAMSALSCPClientProto	The way LSCP clients communicate with the Streamers. The options are: •TVGuide—For Scientific Atlanta clients-TV Guide •RTI—For Tandberg clients •VODLink—For SeaChange clients •CV—For SeaChange clients with Cablevision •Cisco (RTSP) •TTV (RTSP)

¹All management objects in the Configuration MIB are for an ISA environment. If an ISA-specific management object is requested in an RTSP environment, an invalid response is generated (either blank or a standard error message that the element was not found).

Table B-3 describes the readable (with SNMP, GET or GETNEXT) defined in the Health MIB and Table B-4 describes the health traps in the Health MIB.

Table B-3 Health MIB
Management Object	Description
arDiskHealthMonitorIndex	The unique value that identifies the disk being monitored.
arDiskHealthDiskName	The name assigned to the disk device. This object is the driver assigned name for the disk specified.
arDiskHealthState	The state of the disk health are: •0 means okay. The disk is healthy and ready. •1 means not okay. The disk is not ready. It may be abandoned, removed, or in a transient state.
arDiskHealthTotalErrors	The total number of errors reported by the disk to the disk driver.
arDiskHealthErrorsReported	The number of errors reported to CServer. These are the errors that cannot be resolved by the disk driver in a timely manner.
arDiskHealthTotalResets	The total number of resets (soft and hard) for this disk. A soft reset affects a single device only and is the first recourse in resolving an unresponsive device.
arDiskHealthHardResets	The number of hard resets for the disk. A hard reset may affect all devices connected to the same bus or controller.
arDiskHealthTotalRequests	The total number of read and write requests submitted to this disk.
arDiskHealthRequestsRetried	The number of times requests were retried by the driver.
arDiskHealthBytesRead	The number of bytes read from this disk.
arDiskHealthBytesWritten	The number of bytes written to this disk.

Table B-4 Health MIB Traps
Trap	Description
arDiskHealthUp	Signifies that the previously inactive disk is now active and ready, that is, the disk has returned to the ok (0) state.
arDiskHealthDown	Signifies that the active disk is now inactive, that is, it has left the ok (0) state.
arMSAEvent	Signifies that an MSA event (error) has occurred.
arMSAEventmSessionId	The session ID sent to the MSA.
arMSAEventmServerId	The server ID of the Streamer associated with the session ID.
arMSAEventmGroupId	The array ID the Streamer is a member of.
arMSAEventmServiceGroup	The service group ID associated with the session ID.
arMSAEventmQAMIp	The QAM IP address associated with the session ID.
arMSAEventmEventTime	The timestamp associated with this session ID.
arMSAEventmErrorCode	The error code associated with this session ID .
arMSAEventmErrorCodeInt	The error code integer associated with the session ID. For a description of the error code, see the "Stream Failures" section on page 5-18.

Table B-5 describes the management objects defined in the Statistics MIB.

Table B-5 Statistics MIB
Management Object	Description
arCacheStatsFillReceiveStreamCount	The number of streams received through cache-fill.
arCacheStatsFillStreamActualBWinKbits	The bandwidth used (in kilobits per second [kbps]) for cache-fill streams.
arCacheStatsFillStreamCommittedBWinKbits	The bandwidth reserved (in kbps) for cache-fill streams.
arCacheStatsDiskReadStreamCount	The number of streams that retrieved content from local disk storage.
arCacheStatsDiskReadBWinKbits	The bandwidth used (in kbps) in retrieving streams from local disk storage.
arStreamStatsActiveStreamCount	The number of active streams.
arStreamStatsActiveStreamBWinKbits	The bandwidth used (in kbps) for active streams.
arStreamStatsUniqueStreamCount	The number of unique streams.
arStreamStatsUniqueStreamBWinKbits	The bandwidth used (in kbps) for unique streams.

RFC Compliance

Table B-6 is a list of SNMP RFC standards.

Table B-6 SNMP RFC Standards
RFC Standard	Title
RFC 1155 (STD0016)	Structure and Identification of Management Information for TCP/IP-based Internets
RFC 1157 (STD0015)	Simple Network Management Protocol (SNMP)
RFC 1212 (STD0016)	Concise MIB Definitions
RFC 1213 (STD0017)	Management Information Base for Network Management of TCP/IP-based internets:MIB-II
RFC 2790 (Draft Standard)	Host Resources MIB
RFC 1901(Historic)	Introduction to Community-based SNMPv2
RFC 1902 (Draft Standard)	Structure of Management Information for Version 2 of the Simple Network Management Protocol (SNMPv2)
RFC 1903 (Draft Standard)	Textual Conventions for Version 2 of the Simple Network Management Protocol (SNMPv2)
RFC 1904 (Draft Standard)	Conformance Statements for Version 2 of the Simple Network Management Protocol (SNMPv2)
RFC 1905 (Draft Standard)	Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2)
RFC 1906 (Draft Standard)	Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2)
RFC 1910 (Historic)	User-based Security Model for SNMPv2
RFC 2011(Proposed Standard - Updates RFC 1213)	SNMPv2 Management Information Base for the Internet Protocol using SMIv2
RFC 2012 (Proposed Standard)	SNMPv2 Management Information Base for the Transmission Control Protocol using SMIv2
RFC 2013 (Proposed Standard)	SNMPv2 Management Information Base for the User Datagram Protocol using SMIv2
RFC 2096 (Proposed Standard)	IP Forwarding Table MIB
RFC 2863 (Draft Standard)	The Interfaces Group MIB
RFC 3410 (Informational)	Introduction and Applicability Statements for Internet-Standard Management Framework
RFC 3411 (STD0062)	An Architecture for Describing Simple Network Management Protocol (SNMP) Management Frameworks
RFC 3412 (STD0062)	Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)
RFC 3413 (STD0062)	Simple Network Management Protocol (SNMP) Applications
RFC 3414 (STD0062)	User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)
RFC 3415 (STD0062)	View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)
RFC 3416 (STD0062)	Version 2 of the Protocol Operations for the Simple Network Management Protocol (SNMP)
RFC 3417 (STD0062)	Transport Mappings for the Simple Network Management Protocol (SNMP)
RFC 3418 (STD0062)	Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)
RFC 2570 (Informational)	Introduction to Version 3 of the Internet-standard Network Management Framework
RFC 2571 (Draft Standard)	An Architecture for Describing SNMP Management Frameworks
RFC 2572 (Draft Standard)	Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)
RFC 2573 (Draft Standard)	SNMP Applications
RFC 2574 (Draft Standard)	User-based Security Model (USM) for Version 3 of the Simple Network Management Protocol (SNMPv3)
RFC 2575 (Draft Standard)	View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)
RFC 2576 (Proposed Standard)	Coexistence between Version 1, Version 2, and Version 3 of the Internet-standard Network Management Framework
RFC 2578 (STD0058)	Structure of Management Information Version 2 (SMIv2)
RFC 2579 (STD0058)	Textual Conventions for SMIv2
RFC 2580 (STD0058)	Conformance Statements for SMIv2