Cisco 12000 Series Gigabit Switch Routers Description The Cisco 12000 series Gigabit Switch Routers (GSR) is a new product class of routers that perform Internet routing and switching at gigabit speeds. The Cisco 12012 and Cisco 12008 meet the exponential growth in demand for Internet bandwidth and bring scalability and high-performance services to IP-based networks.
Supported MIBs Document Conventions Command descriptions use these conventions: • • Boldface indicates commands and keywords that are entered literally as shown. • • • Square brackets ([ ]) indicate optional elements. Italics indicate arguments for which you supply values; in contexts that do not allow italics, arguments are enclosed in angle brackets ( >). Braces ({ }) group required choices, and vertical bars ( | ) separate alternative elements.
Loading Cisco IOS Images Configuration Tasks The following configuration tasks are listed for the Cisco 12000 series because they are in addition to or different from configuration information listed in the Cisco IOS documentation set. All tasks are optional.
Configuration Tasks To load a Cisco IOS image on a line card, first use the copy tftp command to download the Cisco IOS image to a slot on one of the PCMCIA Flash cards. After you have downloaded the Cisco IOS image on the Flash card, perform the following tasks beginning in global configuration mode: Task Command Step 1 Specify the type of line card, location of the Cisco IOS image, and the slot of the line card to download the image.
Storing Line Card Crash Information To perform field diagnostic testing on a line card, perform the following tasks in privileged EXEC mode: Task Step 1 Command Specify the line card that you want to perform diagnostic testing on.
Configuration Tasks To enable and configure the crash information options for a line card, perform the following task in global configuration mode: Task Command Specify the line card that you want crash information for when a line card resets. Optionally, specify the type and amount of memory to be stored.
Setting the LED Message on the Line Cards Task Command Display stack usage of processes and interrupt routines, including the reason for the last system reboot. This command is only useful to your technical support representative. show stacks Display the status of TCP connections. show tcp Display a concise description of TCP connection endpoints. show tcp brief [all] Display general information about the router when reporting a problem.
Configuration Tasks Table 1 Software Component Software Components in Cisco 12000 Series GSRs Description Version Information MBus Agent Code MBus agent code is bundled with the Cisco IOS image on the GRP card. When the router is powered on, the MBus agent powers on the GRP card. show diag1 GRP Cisco IOS Image Cisco IOS image that runs on the GRP card. This is the main image for the Cisco 12000 series GSR. It contains images for all the line card types and various microcode bundles.
Understanding Software Components Table 1 Software Components in Cisco 12000 Series GSRs (Continued) Software Component Description Version Information Line Card Field Diagnostic Image Image that runs on the line card when field diagnostics are run with the diag command. None GRP ROM Monitor The ROM monitor is responsible for booting the system from the local Flash devices. It is loaded into the Flash ROM on the GRP when the board is manufactured.
Configuration Example Internet backbone Workstation POS11/0 GSR – A E0 622-Mbps POS POS7/0 155-Mbps POS Backbone Cisco 12012 Gigabit Switch Routers Aggregation/distribution Cisco 7500 series routers S6767 POS4/0 – POS4/3 Note Distributed Cisco Express Forwarding (CEF) is automatically enabled. Enable other CEF features to meet your network configuration requirements.
Understanding Software Components ! Enable CLNS routing on the router clns routing clock timezone PST -8 clock summer-time PDT recurring clock calendar-valid ! interface Loopback0 ip address 1.1.1.31 255.255.255.255 bandwidth 10000000 ! Configure the Ethernet interface used for TFTP from the workstation interface Ethernet0 ip address 16.4.237.10 255.255.0.0 ip broadcast-address 16.4.255.
Configuration Example router igrp 199 network 16.0.0.0 ! router bgp 10 no synchronization redistribute connected redistribute static neighbor 1.1.1.3 remote-as 10 neighbor 1.1.1.3 update-source Loopback0 neighbor 1.1.1.13 remote-as 10 neighbor 1.1.1.13 update-source Loopback0 neighbor 1.1.1.20 remote-as 10 neighbor 1.1.1.20 update-source Loopback0 no auto-summary ! ip classless ip default-network 33.0.0.0 ip route 33.0.0.0 255.0.0.0 33.34.0.0 ip route 223.255.0.0 255.255.0.0 Ethernet0 ip route 223.255.253.
Understanding Software Components Command Reference This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 11.2 command references. Note The pos internal-clock interface configuration command has been replaced by the clock source interface configuration command. The pos transmitter-delay interface configuration command has been replaced by the transmitter-delay interface configuration command.
Command Reference attach To access the Cisco IOS software image on a line card to monitor and maintain information on the line card, use the attach privileged EXEC command. To exit from the Cisco IOS software image on the line card and return to the Cisco IOS image on the GRP card, use the exit command. attach slot-number Syntax Description slot-number Slot number of the line card you want to connect to. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
attach Example The following example connects to the Cisco IOS image running on the line card in slot 9, gets a list of valid show commands, and returns the Cisco IOS image running on the GRP: Router# attach 9 Entering Console for 4 Port Packet Over SONET OC-3c/STM-1 in Slot: 9 Type exit to end this session Press RETURN to get started! LC-Slot9# show ? cef Cisco Express Forwarding clock Display the system clock context Show context information about recent crash(s) history Display the session command histo
Command Reference atm sonet To set the mode of operation and thus control type of the ATM cell used for cell-rate decoupling on the SONET PLIM, use the atm sonet interface configuration command. To restore the default Synchronous Transport Signal level 12, concatenated (STS-12c) operation, use the no form of this command.
clear card-message clear card-message To remove the user-specified message that is displayed on the LED on the front panel of one or more line cards and revert to the normal status message for the line card, use the clear card-message privileged EXEC command. clear card-message {all | slot slot-number} Syntax Description all Clears the user-specified LED message on all line cards. slot slot-number Clears the user-specified LED message on a specific line card.
Command Reference clear logging To clear messages from the logging buffer, use the clear logging privileged EXEC command. clear logging {all | slot slot-number} [counts | messages] Syntax Description all Clears the logging buffer for all slots. slot slot-number Clears the logging buffer for a specific slot. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. counts (Optional) Clears the message counters only from the logging buffer. The messages are kept.
clear logging Example In the following example, the counters and messages are cleared from the logging buffer on all line cards. The show logging command shows the information before and after the log is cleared.
Command Reference diag To perform field diagnostics on a line card, on the Gigabit Route Processor (GRP), on the Switch Fabric Cards (SFC), and on the Clock Scheduler Card (CSC) in the Cisco 12000 series Gigabit Switch Routers, use the diag privileged EXEC command. To disable field diagnostics on a line card, use the no form of this command. diag slot-number [halt | previous | post | verbose [wait] | wait] no diag slot-number Syntax Description slot-number Slot number of the line card you want to test.
diag Perofrm diagnostics on the CSC only if a redendant CSC is in the router. Diagnostics will stop and ask you for confirmation before altering the router’s configuration. For example, running diagnostics on a SFC or CSC will cause the fabric to go from full bandwidth to one quarter bandwidth. Bandwidth is not affected by GRP or line card diagnostics.
Command Reference Field Diag eeprom values: run 159 fial mode 0 (PASS) slot 3 last test failed was 0, error code 0 sending SHUTDOWN FDIAG_QUIT to fdiag in slot 3 Board will reload ... Router# The following example shows the output when field diagnostics are performed on the line card in slot 3 in verbose mode. Router# diag 3 verbose Running Diags will halt ALL activity on the requested slot.
exception linecard exception linecard To enable storing of crash information for a line card and optionally specify the type and amount of information stored, use the exception linecard global configuration command. To disable the storing of crash information for the line card, use the no form of this command.
Command Reference Usage Guidelines This command was added in Cisco IOS Release 11.2 GS to support the Cisco 12000 series Gigabit Switch Routers. Use the exception linecard global configuration command only when directed by a technical support representative and only enable options that the technical support representative requests you to enable. Technical support representatives need to be able to look at the crash information from the line card to troubleshoot serious problems on the line card.
execute-on execute-on To execute commands remotely on a line card, use the execute-on slot privileged EXEC command. execute-on {slot slot-number | all} command Syntax Description slot-number Executes the command on the line card in the specified slot. Slot numbers range from 0 to 11 on the Cisco 12012 and 0 to 7 on the Cisco 12008. all Executes the command on all line cards. command Cisco IOS command to execute on the line card.
Command Reference Example The following example shows how to execute the show controllers command on the line card in slot 4: Router# execute-on slot 4 show controllers ========= Line Card (Slot 4) ======= Interface POS0 Hardware is BFLC POS lcpos_instance struct 6033A6E0 RX POS ASIC addr space 12000000 TX POS ASIC addr space 12000100 SUNI framer addr space 12000400 SUNI rsop intr status 00 CRC16 enabled, HDLC enc, int clock no loop Interface POS1 Hardware is BFLC POS lcpos_instance struct 6033CEC0 RX POS
logging linecard logging linecard To log messages to an internal buffer on a line card, use the logging linecard global configuration command. To cancel the use of the internal buffer on the line cards, use the no form of this command. logging linecard [size | message-level] no logging linecard Syntax Description size (Optional) Size of the buffer used for each line card. The range is 4096 to 65536 bytes. The default is 8 KB.
Command Reference Table 2 Message Levels (Continued) Level Name Level errors 3 warnings 4 notifications 5 informational 6 debugging 7 To display the messages that are logged in the buffer, use the EXEC command show logging slot. The first message displayed is the oldest message in the buffer. Do not make the buffer size too large because the router could run out of memory for other tasks.
microcode (Cisco IOS image) microcode (Cisco IOS image) To load a Cisco IOS software image on a line card from Flash memory or the GRP card on a Cisco 12000 series Gigabit Switch Router, use the microcode global configuration command. To load the microcode bundled with the GRP system image, use the no form of this command.
Command Reference To load a Cisco IOS image on a line card, first use the copy tftp command to download the Cisco IOS image to a slot on one of the PCMCIA Flash memory cards. After you have downloaded the Cisco IOS image on the Flash memory card, use the microcode command to download the image to the line card followed by the microcode reload command to start the image. To verify that the correct image is running on the line card, use the execute-on slot slot show version command.
microcode reload microcode reload To reload the Cisco IOS image on a line card on Cisco 12000 series routers after all microcode configuration commands have been entered, use the microcode reload global configuration command. microcode reload [slot-number] Syntax Description slot-number (Optional) Slot number of the line card that you want to reload the Cisco IOS software image on. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
Command Reference pos flag To set the SONET overhead bytes in the frame header to meet a specific standards requirement or to ensure interoperability with another vendor’s equipment, use the pos flag interface configuration command. To remove the setting of the SONET overhead bytes, use the no form of this command. pos flag {c2 | j0 | s1s0} value no pos flag {c2 | j0 | s1s0} value Syntax Description c2 value Path signal identifier used to identify the payload content type.
pos framing pos framing To specify the framing used on the POS interface, use the pos framing interface configuration command. To return to the default SONET STS-3c framing mode, use the no form of this command. pos framing {sdh | sonet} no pos framing Syntax Description sdh Selects SDH STM-1 framing. This framing mode is typically used in Europe. sonet Selects SONET STS-3c framing. This is the default.
Command Reference pos scramble-atm To enable SONET payload scrambling on a POS interface, use the pos scramble-atm interface command. To disable scrambling, use the no form of this command. pos scramble-atm no pos scramble-atm Syntax Description This command has no keywords or arguments. Default Disabled. Command Mode Interface configuration Usage Guidelines This command was added in Cisco IOS Release 11.2 GS to support the Cisco 12000 series Gigabit Switch Routers.
set card-message set card-message To specify the message that is displayed on the LED on the front panel of one or more line cards, use the set card-message privileged EXEC command. To remove the message, use the clear card-message global command. set card-message {all | slot slot-number} [expire seconds] [blink seconds] message Syntax Description all Specifies that the LED message is set on all line cards. slot slot-number Specifies that the LED message is set on a specific line card.
Command Reference show context To display information stored in NVRAM when the router crashes, use the show context EXEC command. show context summary show context {all | slot slot-number [crash-index] [all] [debug]} Syntax Description summary Displays a summary of all the crashes recorded. all Displays all crashes for all the slots. When optionally used with the slot keyword, displays crash information for the specified slot.
show context Sample Display The following is sample output from the show context command following a system failure: Router> show context System was restarted by error - a Software forced crash, PC 0x60189354 GS Software (RSP-PV-M), Experimental Version 11.
Command Reference show controllers (GRP image) To display information that is specific to the hardware, use the show controllers privileged EXEC command. show controllers [atm number | clock | csar [register] | csc-fpga | dp83800 | fab-clk | fia [register] | pos [number] [details] | queues [slot-number] | sca | xbar] Syntax Description 50 atm number (Optional) Displays the ATM controllers. Number is slot-number/ port-number (for example, 4/0).
show controllers (GRP image) xbar (Optional) Displays the crossbar register information. The XBAR is an ASIC that switches the data as it passes through the switch fabric. Command Mode Privileged EXEC Usage Guidelines This command was added in Cisco IOS Release 11.2 GS to support the Cisco 12000 series Gigabit Switch Routers. Note This information is of use only to technical support representatives in analyzing system failures in the field.
Command Reference show controllers (line card image) To display information that is specific to the hardware on a line card, use the attach privileged EXEC command to connect to the line card and then use the show controllers privileged EXEC command or the execute-on privileged EXEC command.
show controllers (line card image) l3 Displays Layer 3 ASIC information. pos {framers | queues | registers | rxsram port-number queue-start-address [queue-length] | txsram port-number queue-start-address [queue-length]} Displays the POS framer registers, queue information, ASIC registers, receive queue SRAM, or transmit queue SRAM information. When you display the transmit or receive queue information, you must specify a port (valid range is 0 to 3) and the queue SRAM logical starting address.
Command Reference BATMAN Asic Register Values: hi_addr_reg 0x8000, lo_addr_reg 0x000C, boot_msk_addr 0x0780, rmcell_msk_addr 0x0724, rmcnt__msk_addr 0x07C2, txbuf_msk_addr 0x070C, ... CM622 SAR Boot Configuration: txind_q_addr 0x14000 txcmd_q_addr 0x20000 ...
show controllers (line card image) Framer 1, addr=0x12000600: master reset C0 master config 1F master control 00 clock rcv cntrl D0 RACP control 84 RACP gfc control 0F TACP control status 04 RACP intr enable 04 RSOP cntrl intr enable 00 RSOP intr status 00 TPOP path sig lbl (c2) 13 SPTB control 04 SPTB status 00 Framer 2, addr=0x12000800: master reset C0 master config 1F master control 00 clock rcv cntrl D0 RACP control 84 RACP gfc control 0F TACP control status 04 RACP intr enable 04 RSOP cntrl intr enabl
Command Reference show diag To display hardware information including DRAM and SRAM on the line cards, use the show diag privileged EXEC command. show diag [slot-number] [details] [summary] Syntax Description slot-number (Optional) Slot number of the interface. details (Optional) Displays more details than the normal show diag output. summary (Optional) Displays a summary (one line per slot) of the chassis.
show diag The following is sample output from the show diag summary command: Router# SLOT 0 SLOT 2 SLOT 4 SLOT 7 SLOT 9 SLOT 11 SLOT 16 SLOT 17 SLOT 18 SLOT 19 SLOT 20 SLOT 24 SLOT 26 SLOT 28 SLOT 29 Router# show diag summary (RP/LC 0 ): Route Processor (RP/LC 2 ): 4 Port Packet Over SONET (RP/LC 4 ): 4 Port Packet Over SONET (RP/LC 7 ): 4 Port Packet Over SONET (RP/LC 9 ): 4 Port Packet Over SONET (RP/LC 11): 4 Port Packet Over SONET (CSC 0 ): Clock Scheduler Card (CSC 1 ): Clock Scheduler Card (SFC 0 ):
Command Reference show environment To display temperature, voltage, and blower information on the Cisco 12000 series Gigabit Switch Router, use the show environment privileged EXEC command. show environment [alarms | all | fans | hardware | last | leds | power-supply | table | temperatures | voltages] Syntax Description alarms (Optional) Displays the alarm contact information. all (Optional) Displays a detailed listing of the power supplies, temperature readings, voltage readings, and blower speeds.
show environment measurement is out of line within these time segments, an automatic warning message appears on the console. As noted, you can query the environmental status with the show environment command at any time to determine whether a measurement is at the warning or critical tolerance. If a shutdown occurs because of detection of fatal environmental margins, the last measured value from each sensor is stored in internal nonvolatile memory.
Command Reference Table 3 describes the fields shown in the output and lists the equipment that is supported by each environmental parameter. If an “NA” is listed in the field and the equipment is supported, it means that the reading could not be obtained. Try the command again. Table 3 Show Environment Field Descriptions Field Description Slot # Slot number of the equipment.
show environment Slot # 24 26 5V (mv) 0 5544 MBUS 5V 48V (mv) (Volt) 5096 3 5144 47 AMP_48 (Amp) 0 3 Slot # 16 Fan Information Voltage 16V Speed slow: Main Fans Ok Power Supply fans Ok Alarm Indicators No alarms Slot # 16 18 19 24 26 Card Specific Leds Mbus OK SFCs Failed Mbus OK Mbus OK Input Failed Input Ok The following is sample output from the show environment table command for a Cisco 12012.
Command Reference Bottom Blower: Warning Below 1000 1000 1000 Fan 0 Fan 1 Fan 2 Critical Below 750 750 750 The following is sample output from the show environment leds command for a Cisco 12012. The show environment leds command lists the status of the MBus LEDs on the clock and scheduler cards and switch fabric cards. Router# 16 leds 18 leds 19 leds 20 leds 62 Release 11.
show gsr show gsr To display hardware information on the Cisco 12000 series Gigabit Switch Routers (GSR), use the show gsr EXEC command. show gsr [chassis-info [details]] Syntax Description chassis-info (Optional) Displays backplane NVRAM information. details (Optional) In addition to the information displayed, this option includes hexadecimal output of the backplane NVRAM information. Command Mode EXEC Usage Guidelines This command was added in Cisco IOS Release 11.
Command Reference show logging To display the state of logging (syslog), use the show logging privileged EXEC command. show logging [history | slot slot-number | summary] Syntax Description history (Optional) Displays information in the syslog history table only. slot slot-number (Optional) Displays information in the syslog history table for a specific line card. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
show logging Table 4 Show Logging Field Descriptions Field Description Syslog logging When enabled, system logging messages are sent to a UNIX host that acts as a syslog server; that is, it captures and saves the messages. Console logging If enabled, states the level; otherwise, this field displays disabled. Monitor logging Minimum level of severity required for a log message to be sent to a monitor terminal (not the console).
Command Reference The following is sample output from the show logging summary command for the Cisco 12012. A number in the column indicates that the syslog contains that many messages for the line card. For example, line card in slot 9 has 1 error message, 4 warning messages, and 47 notification messages.
debug gsr mbus Debug Commands This section documents the following new debug commands. All other debug commands used with this feature are documented in the Cisco IOS Release 11.2 Debug Command Reference. • • • debug gsr mbus debug ipc errors debug mbus system debug gsr mbus To enable the display of MBus messages if a line card fails to come up properly, use the debug gsr mbus EXEC command. Use the no form of the command to disable debugging output.
Debug Commands Table 7 68 Debug GSR MBus Message Descriptions Message Description Removed slot 4 for config Enabling line card 242 on fabric Disabling slot 4 on the switching fabric. Added slot 4 for config Enabling line card 252 on fabric Enabling slot 4 on the switching fabric. Launching fab down loader in slot 4 with Switch Cards 1F and primary_clk CSC_1 Launching switching fabric downloader with switch cards 0x1F (all switch fabric cards) with CSC_1 as primary clock.
debug ipc errors debug ipc errors To enable warnings and errors from the Interprocess Communications (IPC) on the line card or Gigabit Route Processor (GRP), use the debug ipc errors EXEC command. Use the no form of the command to disable debugging output. [no] debug ipc errors Usage Guidelines This command first appeared in Cisco IOS Release 11.2 GS.
Debug Commands Table 8 Debug IPC Errors Message Descriptions Message Description IPC: Couldn’t get cached message block There was no message in the IPC message cache. IPC: Open port error, port not there Cannot find the IPC port while trying to initialize it. IPC: Open port error, no more room on port The maximum number of IPC ports have been opened. IPC: Failed opening master port While trying to locate an IPC port from the master IPC port, the software could not open the master port.
debug ipc errors Table 8 Debug IPC Errors Message Descriptions (Continued) Message Description Malloc failed for RTTY server port Memory problems while allocating server port information in RTTY client. Failed to open RTTY server port RTTY client cannot open IPC port to RTTY server. Cannot allocate TTY RTTY client cannot allocate TTY to communicate with RTTY server. Failed to duplicate server name RTTY client cannot copy server port name during initialization.
Debug Commands debug mbus system To enable the display of low-level mbus messages, use the debug mbus system EXEC command. Use the no form of the command to disable debugging output. [no] debug mbus system Usage Guidelines This command first appeared in Cisco IOS Release 11.2 GS. The debug mbus system command is useful for low-level debug of the MBus system. Enable the debug mbus system command if you are getting a lot of MBus errors.