cc/td/doc/product/lan/cat5000/rel_4_3
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Workgroup MIB Reference

Workgroup MIB Reference

This appendix describes how to access the Cisco Management Information Base (MIB), a set of private extensions to the Internet standard MIB  II.

This appendix consists of the following sections:

Understanding Internet MIB Hierarchy

The MIB structure is logically represented as a tree hierarchy. (See Figure A-1.) The root of the tree is unnamed and splits into three main branches: International Telecommunication Union Telecommunication Standardization Sector (ITU-T), International Organization for Standardization (ISO), and joint ISO/ITU-T.

Every branch in the tree has a short text string and integer to identify it. The text strings are object names. The integers are object identifiers (OIDs) that allow computer software to create compact, encoded representations of the names. For example, the Cisco MIB variable authAddr is an object name. Its object identifier is 1.3.6.1.4.1.9.2.1.5.

The Internet standard MIB is represented by the OID 1.3.6.1.2.1. It also can be expressed as iso.org.dod.internet.mgmt.mib. (See Figure A-1.)

The Internet standard MIB II is documented in RFC 1213, Management Information Base for Network Management of TCP/IP-based Internets: MIB-II.


Figure A-1: Internet MIB Hierarchy


Identifying the Cisco Workgroup MIB

The Cisco Workgroup MIB is a set of private extensions to the Internet standard MIB  II. You can read or set the Cisco Workgroup MIB variables to gather and change information on Cisco network devices and interfaces. The supported MIBs in the Cisco private MIB hierarchy are:


Note The Cisco MIB is provided with all Cisco software releases and with CiscoWorks router management software.

The private Cisco MIB is represented by the OID 1.3.6.1.4.1.9 or iso.org.dod.internet.private.enterprise.cisco. The Cisco MIB is split into two main areas: Workgroup Products and Cisco Management.


Note Local variables do not change; they are supported by the Cisco Workgroup MIB in each subsequent system software release. As indicated by the name, temporary variables might have a limited time span or change with each system software release.

In Figure A-2, the stack MIB group is identified by 1. One of its subgroups, called tftp grp, is identified by  5. Therefore, the variable in the subgroup tftp grp has an OID of 1.3.6.1.4.1.9.5.1.5.1. The appended 0 indicates that 1.3.6.1.4.1.9.5.1.5.1.0 is the one and only instance of this variable.


Figure A-2: Cisco Workgroup Stack MIB Hierarchy


Downloading the Cisco Workgroup MIB File

The Catalyst 5000 series switch supports all standard traps defined in the standard MIBs listed in the in the "Supported MIBs" section of "Product Overview." Cisco-proprietary traps used by the Catalyst 5000 series switch are documented in the CISCO-STACK-MIB.my file.

You can download a copy of the CISCO-STACK-MIB.my file in two ways:

Using FTP to Download the MIB File

To download the CISCO-STACK-MIB.my MIB file using FTP, perform these steps:

Step 1 From a UNIX server, enter this command at the system prompt:

The system displays a login prompt.

Step 2 Log in with the username anonymous, as follows:

The system displays a password prompt.

Step 3 Enter your full e-mail address in the following format:

For example (the e-mail address you type at the password prompt will not appear onscreen):

The system displays an ftp> prompt.

Step 4 Change directories to pub/mibs, as follows:

Step 5 Change to the directory containing the CISCO-STACK-MIB.my file. For SNMP version  1, enter this command:

For SNMP version  2, enter the following command:

Step 6 Use the get command to download the CISCO-STACK-MIB.my file, as follows:

Step 7 Exit FTP by entering quit at the ftp> prompt, as follows:

Using CCO to Download the MIB File

You can use CCO to download the CISCO-STACK-MIB.my MIB file from your web browser. You can access CCO through either a character-based terminal program (such as ZTerm), a text-based web browser (such as Lynx), or a multimedia web browser (such as Netscape Navigator).

The character-based interface, called CCO Classic, allows you to access CCO even if you do not have direct Internet access. CCO Classic supports Xmodem, Ymodem, Zmodem, Kermit, FTP, Internet e-mail, and fax download options; you can access CCO Classic using the Telnet protocol. The multimedia browser interface provides richly formatted documents with photographs, figures, graphics, and video. Both methods provide hyperlinks to related information.

Table A-1 shows the modem settings that you should use to access CCO.


Table A-1: Modem Settings for Accessing CCO
Modem Setting Value

Terminal emulation

VT100

Data bits

8

Parity

None

Stop bits

1

Baud rate

Up to 28.8  kbps

To access CCO from North America, dial 408  526-8070; from Europe, dial 33  1  6446  40  82.

Accessing CCO Using a Multimedia Web Browser

To access CCO using a multimedia WWW browser, complete these steps:

Step 1 Go to one of the following WWW locations to reach the Catalyst 5000 MIB Support List page:

Step 2 Read the instructions at the top of the Catalyst 5000 MIB Support List page, and select the appropriate CISCO-STACK-MIB.my hypertext link. The browser displays the CISCO-STACK-MIB.my file.

Step 3 Save the CISCO-STACK-MIB.my file as text using the Save as... command from your browser's File pulldown menu. You can also send the file to yourself using the Mail  Document... command from the browser's File menu.

Accessing CCO Using a Character-Based Interface

To access CCO using a character-based interface, complete these steps:

Step 1 From a system capable of running the Telnet protocol, enter this command:

The system displays a login prompt.

Step 2 Log in as cco, as follows:

The system displays messages similar to the following and prompts you to specify a terminal type:

Step 3 Press Return to select VT100 terminal emulation.

The system displays messages similar to the following:

Step 4 Select Enter CCO as a Guest User (public information), and press Return.

The system displays the Welcome to Cisco Connection Online screen.

Step 5 Select Software Image Library, and press Return.

The system displays the Software Image Library (p1 of 4) screen.

Step 6 Select v1 (for SNMP version 1) or v2 (for SNMP version 2), and press Return.

The system displays the first page of the CISCO-STACK-MIB.my file.

Step 7 Press P.

The system displays the Printing Options (CCOLynx Version 2.5) screen.

Step 8 Select the Mail the file option, and press Return.

The system prompts you for a valid Internet mail address.

Step 9 Enter your e-mail address at the prompt, using this format:

The CCO Classic interface sends the CISCO-STACK-MIB.my file to the specified e-mail address.

Accessing the MIB Files Through SNMP

You can access the Cisco MIB variables through the Simple Network Management Protocol (SNMP), which is an application-layer protocol that facilitates the exchange of management information between network devices. The SNMP system consists of three parts: SNMP manager, SNMP agent, and MIB.

Instead of defining a large set of commands, SNMP places all operations in a get-request, get-next-request, and set-request format. For example, an SNMP manager can get a value from an SNMP agent or store a value into that SNMP agent. The SNMP manager can be part of a network management system (NMS), and the SNMP agent can reside on a networking device such as a router. You can compile the Cisco MIB with your network management software. If SNMP is configured on a Catalyst 5000 series switch, the SNMP agent can respond to MIB-related queries sent by the NMS.

One example is CiscoWorks network management software, which uses Cisco MIB variables to set device variables and to poll devices on the internetwork for specific information. The results of a poll can be displayed as a graph and analyzed to troubleshoot internetwork problems, increase network performance, verify the configuration of devices, monitor traffic loads, and more.

As shown in Figure A-3, the SNMP agent gathers data from the MIB, which is the repository for information about device parameters and network data. The agent can send traps, or notification of certain events, to the manager. The Cisco trap file, mib.traps, which documents the format of the Cisco traps, is available on the Cisco host cco.cisco.com.


Figure A-3: SNMP Network


The SNMP manager uses information in the MIB to perform the operations described in Table A-2.


Table A-2: SNMP Manager Operations
Operation Description

get-request

Retrieve a value from a specific variable.

get-next-request

Retrieve a value from a variable within a table1.

get-response

Reply to a get-request, get-next-request, and set-request sent by an NMS.

set-request

Store a value in a specific variable.

trap

Show an unsolicited message sent by an SNMP agent to an SNMP manager indicating that some event has occurred.

1With this operation, an SNMP manager does not need to know the exact variable name. A sequential search is performed to find the needed variable from within a table.


hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1998 © Cisco Systems Inc.