FeedbackTable Of Contents
Access Using the Nodal Community String
End-to-End Connection Related Tables
Traps Defined in the Service MIB
End-to-End Connection Provisioning Interface
Using the MIB
This appendix describes the organization and contents of the Cisco WAN Manager (CWM) Service Agent Management Information Base (MIB). See these sections:
The Service Agent MIB is structured into the following separate MIBs:
•
The Network MIB contains the database and network configuration information. This MIB also contains trap definitions for the Cisco BPX 8600, Cisco MGX 8220, Cisco MGX 8230, Cisco MGX 8250, Cisco MGX 8850 PXM1-based, and Cisco IGX 8400 (both router and feeder nodes).
•
–
–
–
–
–
–
To fully understand the information in these MIBs, you need a working knowledge of SNMP MIB conventions and standards.
MIB Organization
The CWM Service Agent Network and Service MIBs are organized sets of objects, each of which contains information regarding the following platforms:
•
•
•
•
•
•
•
•
•
•
The SNMP community string is treated differently on these MIBs. The string is used for authentication in the Service MIB and is used as part of the instance in the Network MIB. The community string for identifying a node is the Domain Node (for example, Network1.node3) in the Network MIB Node and Trunk Tables, and is not used for the RTM MIB.
Each object is assigned a unique identifier within the MIB. Objects are accessed by the SNMP Manager GET and GETNext commands that specify the unique identifier of the object. The Service Agent obtains the value of the specified object and transmits it to the SNMP Manager.
In the Network MIB, all objects are read-only. In the Service MIB, most tables are read-write.
When a single piece of information contained in a single object is required, a simple GET of that object by the SNMP Manager retrieves the information. To obtain more complex information about the network, it requires the retrieval of several objects and the interpretation of their values. This is the case when the SNMP Manager needs to construct and display the network topology.
Network MIB Overview
The Network MIB provides several interfaces, including the fault management related mechanisms and read-only configuration information for network resources. The configuration views presented by the Network MIB are primarily on a per-node basis. In this proxying role, the Service Agent provides a single point of contact to multiple instances of the same MIBs, each representing the configuration of resources for a specific node.
Note
Fault Management Tables
The Network MIB supports fault management and must be utilized in collecting SNMP traps from the network. This section describes the fault management tables that are contained in the Network MIB.
Trap Configuration Table
The Trap Configuration table (trapConfigTable) is used for registering to receive SNMP traps from the Service Agent.
Trap Upload Table
The Trap Upload table (trapUploadTable) is used to retrieve missing traps through the Robust Trap Mechanism (RTM).
Note
Configuration Tables
The Network MIB contains read-only configuration information pertaining to the network, nodes, trunks, circuit lines, Frame Relay ports, and connections in the network. This section describes the configuration tables that are contained in the Network MIB.
Trunk Table
The Trunk table (svTrunkTable) contains trunk-related configuration information for the specified node. Some examples of trunk information include specified slots for certain cards, trunk line load, local and remote line numbers, and the remote node ID (CWM node ID). This read-only table is indexed by slot and physical port number.
Circuit Line Table
The Circuit Line table (lineTable) contains read-only configuration information about the specified circuit lines and is indexed by circuit line number and port number.
Node Table
The Node table (svNodeTable) contains the list of nodes in the network(s) managed and monitored by the CWM associated with this Service Agent. Feeder elements, such as the IGX feeding into a BPX 8600 routing node, are not represented in this table.
Network Table
The Network table (svNetworkTable) contains the list of all networks managed and monitored by the associated CWM. The table is indexed by network name and contains the CWM ID assigned to the network as well as the network ID.
Note
Node-Related Objects
The Network MIB defines a set of objects belonging to the svNodeGroup group. These objects specify certain characteristics of the node, such as the node's alarm state, platform type (that is,
BPX 8600, MGX 8850, MGX 8250, MGX 8230, MGX 8220, or IGX 8400), and ForeSight increase rate. These objects are briefly described in the following subsection on nodal community string access, and can be found in the Network MIB specification.Access Using the Nodal Community String
The configuration tables described previously, with the exception of the Node Table and Network Table, provide information on a per-node basis, and require nodal community strings to access the proper instance of the table. The community strings, in essence, index these tables.
Other objects defined in the Network MIB also require nodal community string access, such as the svNodeGrpAlarmState object, which specifies the node alarm status (clear, minor, major, or unreachable). The general format of the community strings for these tables and objects is shown in Table A-1.
For example, access to the Trunk Table for a node called "node34" in a network called "network1", requires the community string "network1.node34" to be used in an SNMP request.
Service MIB Overview
The Service MIB provides extensive provisioning services for end-to-end connection. The following end-to-end connections between any interface cards supporting Frame Relay (FR), ATM, and Circuit Emulation (CE) combinations are supported:
•
•
•
•
•
•
•
•
•
The Service MIB also contains port provisioning services. Through the SNMP tables, ports can be configured on Cisco MGX 8850 PXM1-based, Cisco MGX 8250, Cisco MGX 8230, and Cisco MGX 8220 shelves and on Cisco IGX 8400 platforms. Configurable port parameters include: port speed, signaling protocol, DE threshold, etc. The following subsections describe the types of services available through Service MIB tables and objects.
Note
End-to-End Connection Related Tables
The Service MIB includes several tables to facilitate the provisioning of end-to-end connections via SNMP. End-to-end connections are specified by two endpoints, local and remote.
From an SNMP perspective connections are composed of MIB objects representing the endpoints and a connection object that links or describes the relationship between the local and remote endpoints. The Connection Tables provide the capability to establish connections, modify parameters associated with the connections, and perform diagnostics on the connections. The following tables provide this information.
Connection Table
This table gives information all about end-to-end connections in the network managed by the associated Cisco CWM workstation and provides capabilities for creating, modifying, testing, and deleting connections. This table is indexed by a connection index, which is a unique positive value generated by the Service Agent during connection creation. The value of 0 is specified during the creation of new connections.
Frame Relay Endpoint Table
This table gives connection characteristic information about all Frame Relay endpoints of every Virtual Connection (VC) in the network. This information includes: QIR, CIR, MIR, PIR, VC queue size, and percent utilization. This table is indexed by node name, shelf name, slot number, physical line number, physical port number, and DLCI.
For a description of the Frame Relay Endpoint Table objects, see the Frame Relay Endpoint Table, page C-90 section in Appendix C, "Service MIBs".
Frame Relay Endpoint Attribute Object IDentifier Structure
The Object IDentifier (OID) used for specifying attributes in the Frame Relay endpoint table consists of the ASN.1 identifier associated with the object, followed by the indices into the SNMP table. This allows creation of endpoints to be controlled via a single MIB object, frEndPointRowStatus. Specification of this object includes the name of the endpoint being created, and results in a specified action upon that object. The indices in CWM are physical in nature, and include the node name, shelf name, slot number, physical line number, port number, and DLCI. For currently available IGX 8400 cards, the endpoints typically specify a 0 value line number.
Specification of the node and shelf names in the OID is accomplished by using a simple encoding/translation from strings to integers. The ASN.1 representation for strings is comprised of the string length followed by the ASCII integer representation for each individual character. Thus the "AXIS245" string would be encoded as: 7.65.88.73.83.50.52.53, where 7 represents the number of characters in the string, 65 represents the character "A", and so on.
Thus, specification of the frEndPointRowStatus object for a Frame Relay endpoint with DLCI 200, located on slot 6, line 2, and port 1 of an MGX 8220 shelf called "AXIS245" connected to a BPX 8600 called "nmsbpx03" appears as follows (shown on multiple lines):
Frame Relay Endpoint MIB Objects
The user can create an endpoint by specifying a single MIB object, if the default endpoint parameters are acceptable. For details about this table, see the Frame Relay Endpoint Table, page C-90 section in Appendix C, "Service MIBs".
ATM Endpoint Table
This table gives connection characteristic information about all ATM endpoints in the network, including the middle segments associated with a Frame Relay Network Interworking connection. In a tiered-network architecture, end-to-end connections are comprised of up to three segments: the local feeder element to the local routing node, local routing node to remote routing node, and remote routing node to remote feeder element. Frame Relay connections spanning an ATM core network result in the creation of ATM endpoints in this table. This table also includes the ATM endpoints associated with Frame Relay/ATM Service Interworking connections between FRSM and ASI cards. This table is indexed by node name, shelf name, slot number, physical port number, VPI, and VCI.
For a description of the ATM Endpoint Table object, see the ATM Endpoint Table, page C-47 section in Appendix C, "Service MIBs".
ATM Endpoint Attribute OID Structure
The OID used for specifying attributes in the ATM endpoint table consists of the ASN.1 identifier associated with the object, followed by the indices into the SNMP table. This allows creation of endpoints to be controlled via a single MIB object, atmEndPointRowStatus. Specification of this object includes the name of the endpoint being created, and results in a specified action upon that object. The indices in CWM include the node name, shelf name, slot number, physical port number, and VPI/VCI.
Specification of the node and shelf names in the OID is accomplished by using a simple encoding/translation from strings to integers. The ASN.1 representation for strings is comprised of the string length followed by the ASCII integer representation for each individual character. Thus the "AXIS245" string would be encoded as: 7.65.88.73.83.50.52.53, where 7 represents the number of characters in the string, 65 represents the character "A", and so on.
Thus, specification of the atmEndPointRowStatus object for an ATM endpoint with VPI 200 and
VCI 20, located on slot 6, port 1 of an MGX 8220 shelf called "AXIS245" connected to a BPX 8600 called "nmsbpx03" appears as follows (shown on multiple lines):
ATM Endpoint MIB Objects
Creation of an endpoint can be accomplished via the specification of a single MIB object, if the default endpoint parameters are acceptable. For details about this table, see the ATM Endpoint Table, page C-47 section in Appendix C, "Service MIBs".
Traps Defined in the Service MIB
The Service MIB defines trap types associated with the operational state of end-to-end connections. These end-to-end traps are generated by CWM when a service fault affecting the network is received. Each trap provides information about the local and remote endpoints affected, the connection status, the connection A-bit status, and the connection type. The trap types defined are
•
•
•
•
•
•
End-to-End Connection Provisioning Interface
Creating a connection via the Service Agent interface is achievable via a single SNMP SET request. The connection paradigm supported in CWM requires interaction with two types of tables:
•
•
The following basic steps used when creating connections via the Service MIB are briefly outlined:
Step 1
This process involves creation of the ports and specification of characteristics including signaling, port speed, and timer values. For Frame Relay/ATM Service Interworking connections between FRSM and ASI endpoints, the ATM port cannot be provisioned through the CWM Release 9.2 Service Agent interface. ATM and Frame Relay ports are supported in CWM Release 9.2.
Step 2
The endpoint definitions include several parameters associated with bandwidth, queueing, and traffic metrics. For Frame Relay/ATM Service Interworking, the remote endpoint of the connection must be defined in the endpoint table reserved for ATM endpoints.
Step 3
The simple model for connection provisioning allows for connection creation using a single SNMP SET request on multiple MIB objects. When the ports terminating the connections already exist, the following minimum set of MIB objects in Table A-2 are required to create a connection:
Connection Table
This table maintains characteristic information about all Frame Relay and ATM endpoints of every VC in the network. The entries in this table describe the association between a local and a remote endpoint. These two endpoints define the end-to-end connection, regardless of the network topology. In a tiered network, where feeder elements (for example, MGX 8220 shelves) are connected to a routing mesh network, an end-to-end connection comprises at most, three segments.
Figure A-1 shows the constituent segments of user connections in different scenarios involving routing nodes and feeder nodes. The boundary between segments is marked with white circles. The "a_local-to-a_remote" connection comprises three segments, while the "b_local-to-b_remote" connection is comprises two segments, and the "c_local-to-c_remote" connection comprises one segment. In a flat network with no feeder elements, each end-to-end connection consists of a single segment.
Figure A-1 Connection Management Example
The parameters and attributes associated with an entry in the Connection Table typically relate to routing, and are independent of the types of endpoints. Each connection in the table is indexed by an integer determined by the Service Agent when the connection is created. A connection operational status object indicates the connection's state. Other connection objects include a hop-by-hop route description, a ForeSight enable/disable object, and string descriptions of the endpoints.
The remote and local endpoints defining the connection are referenced in the Connection Table by the OID of the first attribute of the endpoint in their respective endpoint tables. When provisioning a connection, the local and remote endpoints can be Frame Relay or ATM endpoint. The "incomplete" operational status for an entry in the Connection Table indicates that segments exist, but others are unknown or nonexistent.
Connection Provisioning
For an example of how to provision a connection using SNMP, consider the creation of a Frame Relay end-to-end connection from an IGX node to an MGX 8220 shelf. The local endpoint is located on a node named "nmsigx10" which has a channelized FRM card in slot 6, and a provisioned 128kbps port on DS-0 timeslot 1. The desired DLCI for this endpoint is 150.
For the remote endpoint, consider a Frame Relay endpoint located on an MGX 8220 shelf named "AXIS245" feeding into a BPX 8600 node named "nmsbpx03." The endpoint is located on an FRSM card in slot 6 of the MGX 8220 shelf, on a preprovisioned 128kbps port on physical line 1, DS-0 timeslot 2. The desired DLCI for this endpoint is 200.
Each endpoint is customized with specific parameters defined for the traffic travelling in each direction. The provisioned connection has a high class of service (a high priority for rerouting—on a scale of 0-15, this connection will be assigned a value of 1). In the local-to-remote direction, traffic is provisioned with an MIR of 2400bps, CIR of 3600bps, PIR of 9200bps, and QIR of 4000bps. In the remote-to-local direction, the asymmetric traffic will be provisioned with an MIR of 2300bps, CIR of 3200bps, PIR of 5600bps, and QIR of 3200bps.
The MIB objects described in Table A-3 must be set in the SNMP request.
Port Provisioning Interface
The port provisioning interface is described in this section. For a description of the Frame Relay Port Table objects, see the Frame Relay Port Table, page C-215 section in Appendix C, "Service MIBs".
Port Attribute OID Structure
The OID used for specifying attributes in the Frame Relay Port Table (svFrPortTable) consists of the ASN.1 identifier associated with the object, followed by the indices into the table. This allows creation of ports to be controlled via a single MIB object: svFrPortRowStatus. Specification of this object includes the name of the port being created, and results in a specified action upon that object. The indices in CWM are physical in nature, and include the node name, shelf name, slot number, physical line number, and port number. For currently available IGX 8400 cards, the endpoints typically specify a 0 value line number and a null value for the shelf name.
Specification of the node and shelf names in the OID is accomplished by using a simple encoding/translation from strings to integers. The ASN.1 representation for strings is comprised of the string length followed by the ASCII integer representation for each individual character. Thus the "AXIS245" string would be encoded as: 7.65.88.73.83.50.52.53, where 7 represents the number of characters in the string, 65 represents the character "A", and so on.
Thus, specification of the svFrPortRowStatus object for a Frame Relay FRSM port, located in slot 6, line 2, and DS-0 timeslot 4 of an MGX 8220 shelf called "AXIS245" connected to a BPX 8600 called "nmsbpx03" appears as follows (shown on multiple lines):
Similarly, for an FRM port located in slot 4 and DS-0 timeslot 16 of an IGX node called "nmsigx10", the specification of the svFrPortRowStatus object would appear as follows (shown on multiple lines):
1.3.6.1.4.1.351.1.101.2.4.1.5.
8.110.109.115.105.112.120.49.48.
0.
4.0.16
// ASN.1 ID of svFrPortRowStatus
// ASN.1 representation of "nmsigx10"
// ASN.1 representation of no shelf
// slot.line.port
Port MIB Objects
Creation of a port can be accomplished via the specification of a single MIB object, if the default port parameters are acceptable. For a description of the Frame Relay port objects, see the Frame Relay Port Table, page C-215 section in Appendix C, "Service MIBs".
