Version 8.0 Part No. 300861-C Rev.
Copyright © 1999 Nortel Networks All rights reserved. Printed in the USA. December 1999. The information in this document is subject to change without notice. The statements, configurations, technical data, and recommendations in this document are believed to be accurate and reliable, but are presented without express or implied warranty. Users must take full responsibility for their applications of any products specified in this document.
these terms and conditions, return the product, unused and in the original shipping container, within 30 days of purchase to obtain a credit for the full purchase price. 1. License Grant. Nortel Networks NA Inc.
SHALL THE LIABILITY OF NORTEL NETWORKS RELATING TO THE SOFTWARE OR THIS AGREEMENT EXCEED THE PRICE PAID TO NORTEL NETWORKS FOR THE SOFTWARE LICENSE. 5. Government Licensees. This provision applies to all Software and documentation acquired directly or indirectly by or on behalf of the United States Government. The Software and documentation are commercial products, licensed on the open market at market prices, and were developed entirely at private expense and without the use of any U.S. Government funds.
Contents Preface Before You Begin .............................................................................................................. ix Text Conventions ............................................................................................................... x Acronyms ..........................................................................................................................xii Hard-Copy Technical Manuals .....................................................................
Restrictions on Standard MIBs .......................................................................................3-3 RFC 1213 MIB-II Restrictions ..................................................................................3-3 RFC 1243 AppleTalk MIB Restrictions .....................................................................3-4 RFC 1643 Ethernet MIB Restrictions .......................................................................3-5 RFC 1724 RIP V2 MIB Restrictions ........................
Tables Table 1-1. Supported SNMP Commands .................................................................1-2 Table 2-1. Supported Standard SNMP Traps ...........................................................2-5 Table 3-1. Standard MIBs Supported by the RAC ....................................................3-2 Table 3-2. RFC 1213 MIB-II Objects .........................................................................3-4 Table 3-3. RFC 1243 AppleTalk ...........................................
Preface If you are responsible for developing custom applications for configuring or managing a Nortel Networks 5399 Access Switch or 8000 Access Switch (formerly known as Model 5399 and Model 8000 Remote Access Concentrator (RAC)) using SNMP, you need to read this guide. Note: The Access Switch product name appears only on the title page. Whenever the term Remote Access Concentrator (RAC) appears in this document, it refers to the Nortel Networks 5399 or 8000 Access Switch.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Text Conventions This guide uses the following text conventions: angle brackets (< >) Indicate that you choose the text to enter based on the description inside the brackets. Do not type the brackets when entering the command. Example: If the command syntax is: ping , you enter: ping 192.32.10.12 bold text Indicates command names and options and text that you need to enter. Example: Enter show ip {alerts | routes}.
Preface ellipsis points (. . . ) Indicate that you repeat the last element of the command as needed. Example: If the command syntax is: ethernet/2/1 [ ] . . . , you enter ethernet/2/1 and as many parameter-value pairs as needed. italic text Indicates file and directory names, new terms, book titles, and variables in command syntax descriptions. Where a variable is two or more words, the words are connected by an underscore.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Acronyms This guide uses the following acronyms: xii AUI attachment unit interface BootP Bootstrap Protocol BRI basic rate interface CSMA/CD carrier sense multiple access/collision detection DLCMI Data Link Control Management Interface HDLC High-level Data Link Control HTTP Hypertext Transfer Protocol IGMP Internet Group Management Protocol IP Internet Protocol ISDN Integrated Services Digital Network ISO International Or
Preface Hard-Copy Technical Manuals You can print selected technical manuals and release notes free, directly from the Internet. Go to support.baynetworks.com/library/tpubs/. Find the product for which you need documentation. Then locate the specific category and model or version for your hardware or software product. Using Adobe Acrobat Reader, you can open the manuals and release notes, search for the sections you need, and print them on most standard printers.
Chapter 1 Simple Network Management Protocol (SNMP) This chapter describes the Simple Network Management Protocol (SNMP) and the SNMP agent provided by the RAC. This chapter includes the following sections: • • SNMP Protocol Overview SNMP Commands SNMP Overview SNMP provides an alternative means of managing the RAC. SNMP operates over the UDP (Unreliable Datagram Protocol), which is part of the TCP/IP protocol suite. 300861-C Rev.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference SNMP Commands The SNMP agent software in the RAC supports the SNMP commands get, get-next, set, and trap as defined in RFC 1157. Table 1-1 describes these commands. Table 1-1. Supported SNMP Commands Action Description get Retrieves the value of a specific object from one of the supported MIBs. get-next Traverses the MIB tree to retrieve the next object’s management information. set Modifies the values of MIB objects.
Simple Network Management Protocol (SNMP) Using SNMP set to Send Commands to the RAC The private enterprise MIB objects allow you to change the configuration of the RAC. Note: For some objects, the configuration changes do not take effect until the RAC is rebooted. Using the SNMP set command, you can broadcast a message, reset a port or subsystem, and reboot the RAC.
Chapter 2 Configuring the RAC for SNMP Before an SNMP network management application can monitor or manage the RAC, the RAC must be configured for SNMP. This entails defining certain configuration data, including the SNMP agent, the SNMP community string, and related RAC parameters.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Details of these keywords, as well as the parameters you use with SNMP, are described in the following sections. A sample entry in the gateway section of the configuration file looks like this: % gateway annex 132.245.6.34 host 132.245.1.01 gateway 132.245.7 metric 1 hardwired net 132.245.9.0 gateway 132.245.2.
Configuring the RAC for SNMP Defining the Community String When an SNMP request is received by the agent in the RAC, the agent performs three tests to authenticate the request. The tests are as follows: • Each SNMP message contains a community string in its header. The receiving SNMP agent tries to match the message’s string with an existing community string list.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Defining Trap Hosts and Traps The RAC employs two methods for defining the host addresses it uses when generating SNMP trap messages. • The first method loads the trap hosts (if any) from the configuration file into the Trap Host Table. You can modify this table by adding or deleting trap hosts in the configuration file. • The second method defines up to ten static trap hosts using the anxTrapHostTable objects in the proprietary MIB.
Configuring the RAC for SNMP Table 2-1 describes the standard SNMP traps supported by the RAC. The proprietary traps and descriptions are provided in Chapter 5, “Error Handling. Table 2-1.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Defining the allow_snmp_sets Parameter The RAC’s default setting for the allow_snmp_sets parameter does not permit parameter value changes because the SNMP set command’s header transmits the community string in clear text, which may be a security risk. To modify parameters through SNMP, you must first set allow_snmp_sets to yes using the na utility, the admin command, or from the ROM monitor. You cannot set this parameter using SNMP.
Chapter 3 Private MIBs and Standard MIB Support This chapter describes the private enterprise MIBs for the RAC, and lists the exceptions and restrictions placed on standard MIBs by the RAC SNMP agent.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 3-1. Standard MIBs Supported by the RAC RFC Object Name Description 1213 MIB-II Updated by RFCs 2011, 2012, and 2013. For restrictions, refer to Table 3-2. 1243 Appletalk MIB Support will be reinstated in this release. For restrictions, refer to Table 3-3. 1406 DS1 MIB Describes the MIB that manages DS1 interfaces. For restrictions, refer to Table 3-6. 1643 Ethernet MIB Obsoletes RFC 1623.
Private MIBs and Standard MIB Support Understanding MIB Objects RFC 1155 (Structure and Identification of Management Information for TCP/IP-based Internets) describes the layout and encoding of exchanged data objects. The SMI uses the ISO standard ASN.1 (Abstract Syntax Notation One) to define a method for describing a hierarchical name space for managed information. Each object has: • A name (also referred to as an Object Identifier [OID]). • A syntax and an encoding.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 3-2.
Private MIBs and Standard MIB Support Table 3-3.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 3-4. RFC 1643 Ethernet MIB Objects Object Name Restrictions Read Object Limitations dot3StatsSQETestErrors Not supported Not applicable dot3StatsInternalMac ReceiveErrors Not supported Not applicable dot3StatsEtherChipSet Read only None dot3CollIndex Not supported Not applicable RFC 1724 RIP V2 MIB Restrictions The RAC supports rip2GlobalGroup, rip2IfStatTable, and rip2IfConfTable. It does not support rip2PeerTable.
Private MIBs and Standard MIB Support Table 3-6.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 3-7. Private MIB Filenames MIB Filename Description xylo.smi Describes the structure of the Remote Access Concentrator MIBs. xylo.trp Contains the trap definitions for all the private traps. xylo-anx.mib Contains MIB objects related to configuring the Model 8000 RAC and Model 5399 RAC (for example, RAC-wide configuration settings). xylo-callmgmt.mib Contains the private MIB active call and call history objects. xylo-modem.
Private MIBs and Standard MIB Support Table 3-8. 300861-C Rev. 00 Prefixes for MIB Object Names Related to the RAC Prefix Corresponding MIB File act xylo-callmgmt.mib active xylo-callmgmt.mib anx xylo-anx.mib anxt1 xylo-wan.mib call xylo-wan.mib callhist xylo-callmgmt.mib gp xylo-wan.mib gsy xylo-anx.mib igmp xylo-anx.mib nfas xylo-anx.mib ippool xylo-anx.mib ntp xylo-ntp.mib mdm xylo-modem.mib mdmCall xylo-callmgmt.mib radius xylo-anx.mib pooling xylo-anx.
Chapter 4 Call Management The RAC maintains call statistics for active calls and call history statistics for previous calls. This chapter describes active call statistics, call history statistics, active call MIBs, history MIBs, modem, and WAN statistics for the RAC.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference The actCallTable is indexed by the activeCallDeviceType and the activeCallDeviceNumber. The actCallTable is implemented as a sparse table. Therefore, data is only returned for active calls. Update older applications to use the actCallTable. Active Modem Calls A further level of granularity is provided for active modem calls. The actCallAsyTable in the xylo-callmgmt.mib file provides additional statistics specifically for active modem calls.
Call Management Call History Statistics The RAC maintains generic call history statistics for terminated calls (both completed calls and calls that failed to connect) and makes the information available to management applications through SNMP MIB objects. The statistics are used to generate call information for accounting purposes and capacity planning. The call history MIB object names and descriptions are listed in the callHistTable in the xylo-callmgmt.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference MP Call History Statistics A further level of granularity is provided for MP call history statistics. The callHistMpTable in the xylo-callmgmt.mib file provides additional call history statistics specifically for terminated MP calls. The callHistMpTable is implemented as a sparse table.
Call Management Modem Statistics The objects in the mdmStatTable provide cumulative modem statistics for each modem. See the MIB object descriptions in the xylo-modem.mib file for more details. WAN Statistics The wanStatTable, indexed by a WAN interface number, provides WAN statistics. This table is valid for WAN module platforms only. Refer to the xylo-wan.mib file for more information about this MIB object. 300861-C Rev.
Chapter 5 Error Handling This chapter describes error handling and error reporting. The RAC handles errors and error reporting through the use of a number of error counters, thresholds, and traps, and the Point-to-Point Protocol (PPP) syslog. Error Counters The RAC makes use of a number of error counter MIB objects for the DS1 WAN interfaces.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 5-1. 5-2 Current Error Counter MIBs MIB Object Name Description anxt1CurrentIndex The index value of the DS1 interface for the current interval. anxt1CurrentOofs The number of OOF (Out Of Frame) events for the current interval. (An event begins when any two out of four consecutive frame synchronizing bits are received from the network interface are incorrect.) An OOF state ends when reframe occurs.
Error Handling Table 5-2. 300861-C Rev. 00 Interval Error Counter MIBs MIB Object Name Description anxt1IntervalIndex The index value of the DS1 interface for the selected interval. anxt1IntervalNumber A number between 1 and 96, where 1 is the most recently completed 15 minute interval and 96 is the least recently completed 15 minute interval (this assumes that all 96 intervals are valid). anxt1IntervalOofs The number of OOF events for the selected interval.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 5-3. Total Error Counter MIBs MIB Object Name Description anxt1TotalIndex The index value of the DS1 interface for the selected interval. anxt1TotalOofs The number of OOF events for the selected interval. (An event begins when any two out of four consecutive frame synchronizing bits are received from the network interface are incorrect.) An OOF state ends when reframe occurs.
Error Handling Table 5-4 lists the threshold MIB objects, descriptions, and corresponding error counters. (Error counter MIBs are in parentheses.) Table 5-4. Threshold MIBs MIB Object Name Description wanBpvThreshold The threshold which, when met or exceeded, triggers the wanBpvThreshTrap to be sent. (anxt1CurrentBpvs) wanOofThreshold The threshold which, when met or exceeded, triggers the wanOofThreshTrap to be sent.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Trap Configuration The RAC generates SNMP traps, which are messages sent to users to inform them of events. This release includes trap groups that enable and disable certain traps and a filter to indicate which traps are sent to specific trap hosts. Refer to the xylo-trpobj.mib file for more information about these MIB objects. 5-6 300861-C Rev.
Error Handling Proprietary Traps The RAC generates various SNMP traps. Some alarm traps are generated when the error counters have reached the error threshold. Clear traps are generated after the associated trap has been sent. By default, all traps are disabled. Table 5-5 lists the proprietary traps and descriptions. Table 5-5. Proprietary Traps MIB Object Name Description callBeginTrap This trap is generated when an incoming call is detected or an outbound call is generated by the RAC.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference Table 5-5. Proprietary Traps (continued) MIB Object Name Description unexpectDisconnectTrap This trap is generated when a call is disconnected unexpectedly. A call is considered to disconnect unexpectedly when one of the following occurs: protocolError localHangup timeoutHDLC maxLogonTimeout Or, when a call is handled by a modem, the unexpected disconnect can be caused by poorSignalQ or failRetrain.
Error Handling Table 5-5. 300861-C Rev. 00 Proprietary Traps (continued) MIB Object Name Description wanEsClearTrap This trap is generated when a 15 minute interval is terminated without the number of errored seconds meeting or exceeding wanEsThreshold. wanEsfClearTrap This trap is generated when a 15 minute interval is terminated without the number of ESF errors meeting or exceeding wanEsfThreshold.
Chapter 6 Troubleshooting This chapter provides answers to the questions frequently asked when you are unable to use SNMP to communicate with the RAC. • Why am I unable to use SNMP to communicate with the RAC? In order to enable SNMP communication with a RAC, the RAC SNMP agent must be up and the specified community string must match one of the RAC community strings. Check the configuration file to make sure that your host is not disabled through the community string.
Nortel Networks 5399 and 8000 Access Switch SNMP MIB Reference • Why can’t I use an SNMP set to change parameters on the RAC? You may be prevented from changing parameter values based on the value of the allow_snmp_sets parameter. If allow_snmp_sets is set to disabled, you can use the telnet command to reach the RAC and run the superuser CLI admin command to set allow_snmp_sets to yes. The RAC default value does not allow changes to configuration parameters through SNMP.
Index A acronyms, xii actCallAsyTable, 4-2 actCallMpTable, 4-2 actCallTable, 4-1 contact string defining, 2-5 customer support, xiii D active call statistics, 4-1 active modem calls, 4-2 active MP calls, 4-2 activeCallDeviceNumbe, 4-2 activeCallDeviceType, 4-2 allow_snmp_sets parameter, 1-2, 2-6 B Before you begin, ix C disabled_modules parameter, 1-3, 2-5 G gateway entries for SNMP community, 2-3 for SNMP trap hosts, 2-4 uses for configuring SNMP agent, 2-1 M mdmCtlObject, 4-4 call history statis
MP call history statistics, 4-4 U P Unreliable Datagram Protocol, 1-1 Port Actions, 4-2 W portActionTable, 4-2 product support, xiii wanStatTable, 4-5 publications hard copy, xiii S SNMP commands, 1-2 get, 1-2 get-next, 1-2 set, 1-2 configuring the RAC for, 2-1 definition, 1-1 gateway entry for community string, 2-3 gateways file entry for trap hosts, 2-4 MIB object hierarchy, 3-2 overview, 1-1 SNMP agent configuration defining allow_snmp_sets parameter, 2-6 defining community string, 2-3 defining