|
|
This chapter describes the command-line interface (CLI) you use to configure the Catalyst 5000 family Route Switch Module (RSM) and Route Switch Feature Card (RSFC).
This chapter consists of these sections:
The RSM and RSFC are full-function routers running Cisco IOS software. The Cisco IOS user interface allows you to access several different command modes. Each command mode provides a group of related commands. This section describes how to access and list the commands available in each command mode.
Cisco IOS software has two levels of access to commands: user and privileged. The unprivileged user mode is the user EXEC mode. The privileged mode is the privileged EXEC mode and requires a password. The commands available in user EXEC mode are a subset of the commands available in privileged EXEC mode.
From the privileged EXEC level, you can access global configuration mode and six specific configuration modes: interface, subinterface, line, router, ipx-router, and route-map configuration. Enter a question mark (?) at the system prompt to display a list of commands for each command mode.
Almost every system configuration command has a no form. Enter the no form to disable a feature or function. Enter the command without the keyword no to reenable a disabled feature or enable a feature that is disabled by default. For example, IP routing is enabled by default. Specify the command no ip routing to disable IP routing and specify ip routing to reenable it.
To access an RSM or RSFC installed in a Catalyst 5000 family switch, enter the session mod_num command from the Catalyst 5000 family switch command line, where mod_num is the RSM or RSFC module number.
The switch responds with the Enter Password prompt if a password is configured. Enter the password for the RSM or RSFC if necessary. The RSM or RSFC responds with the Router> prompt. At this point, you are in user EXEC command mode, and you have direct access only to the RSM or RSFC with which you have established a session.
The following example shows how to open a session on an RSM installed in slot 5:
Console> (enable) session 5 Trying Router-5... Connected to Router-5. Escape character is '^]'. Router>
The following example shows how to open a session on an RSFC installed on the supervisor engine in slot 1:
Console> (enable) session 15 Trying Router-15... Connected to Router-15. Escape character is '^]'. Router>
When you use the RSM with the Catalyst VIP2, the combination is a module that occupies two contiguous slots in the Catalyst 5000 family switch. The Catalyst VIP2 data and control interface is provided through two ribbon cables. Power to the Catalyst VIP2 is provided through the Catalyst VIP2 backplane connector.
For more information, refer to the Route Switch Module Catalyst VIP2-15 and VIP2-40 Installation and Configuration Note.
This section describes the command modes and functions that allow you to access and operate the RSM and RSFC CLI.
Table 2-1 lists the command modes, how to access each mode, the prompt you will see while you are in that mode, and the method to exit a mode. The prompts listed assume the default host name, Router.
| Command Mode | Access Method | Prompt | Exit Method |
|---|---|---|---|
User EXEC | Log in to RSM or RSFC. | | Use the logout command. |
Privileged EXEC | From user EXEC mode, use the enable EXEC command. | | To exit back to user EXEC mode, use the disable command. To exit into global configuration mode, use the configure privileged EXEC command. |
Global configuration | From privileged EXEC mode, use the configure privileged EXEC command. | | To exit to privileged EXEC mode, use the exit or end command or press Control-Z. To exit to interface configuration mode, enter an interface configuration command. |
Interface configuration | From global configuration mode, enter by specifying an interface with an interface command. | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, press Control-Z. To exit to subinterface configuration mode, specify a subinterface with the interface command. |
Subinterface configuration | From global configuration mode, specify a subinterface with an interface command. | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, press Control-Z. |
Line configuration | From global configuration mode, enter by specifying a line with a line command. | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, press Control-Z. |
Router configuration | From global configuration mode, enter by issuing a command that begins with router (such as router igrp). | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, press Control-Z. |
IPX-router configuration | From global configuration mode, enter by issuing the ipx routing command, and then a command that begins with ipx router (such as ipx router eigrp). | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, press Control-Z. |
Route-map configuration | From global configuration mode, enter by specifying the route-map command. | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, press Control-Z. |
ROM monitor | From privileged EXEC mode, use the reload EXEC command. Press Break during the first 60 seconds while the system is booting. | | To exit to user EXEC mode, press c to continue. |
After you log in to the RSM or RSFC, you are automatically in user EXEC command mode. The EXEC commands available at the user level are a subset of those available at the privileged level. In general, the user EXEC commands allow you to establish connections, change terminal settings on a temporary basis, perform basic tests, and list system information.
To list the user EXEC commands, perform this task:
| Task | Command |
|---|---|
List the user EXEC commands. | ? |
The user-level prompt consists of the RSM or RSFC host name followed by an angle bracket (>):
Router>
You can change the host name using the hostname global configuration command described in the IOS Command Reference publications.
Because many of the privileged commands set operating parameters, privileged access should be password-protected to prevent unauthorized use. The privileged command set includes those commands contained in user EXEC mode, as well as the configure command through which you can access the remaining command modes. Privileged EXEC mode also includes high-level testing commands, such as debug. For details on the debug command, see the Debug Command Reference publication.
To access and list the privileged EXEC commands, perform this task:
| Task | Command |
|---|---|
Step 1 Enter the privileged EXEC mode. | enable [password] |
Step 2 List privileged EXEC commands. | ? |
If the system administrator has set a password, you are prompted to enter it before being allowed access to privileged EXEC mode. The password is not displayed on the screen and is case sensitive. The system administrator uses the enable password global configuration command to set the password that restricts access to privileged mode. This command is described in the IOS Command Reference publications.
The privileged-level prompt consists of the RSM or RSFC host name followed by the pound sign (#):
Router#
From the privileged level, you can access global configuration mode. For instructions, see the "Accessing Global Configuration Mode" section.
To return from privileged EXEC mode to user EXEC mode, perform this task:
| Task | Command |
|---|---|
Move from privileged EXEC mode to user EXEC mode. | disable |
Global configuration commands apply to features that affect the system as a whole. Use the configure privileged EXEC command to enter global configuration mode. When you enter this command, the EXEC prompts you for the source of the configuration commands:
Configuring from terminal, memory, or network [terminal]?
You can then specify either the terminal, NVRAM, or a file stored on a network server as the source of configuration commands. The default is to enter commands from the terminal console. To begin this configuration method, press the Return key.
To access and list the global configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 At the terminal, from the privileged EXEC mode, enter global configuration mode. | configure {terminal | memory | network}1 |
Step 2 List the global configuration commands. | ? |
| 1This command is documented in the IOS Command Reference publications. |
To exit global configuration mode and return to privileged EXEC mode, use one of the following commands:
| Task | Command |
|---|---|
Exit global configuration mode. | exit |
From global configuration mode, you can access seven configuration sublevels: interface, subinterface, line, router, ipx-router, route-map, and ROM monitor configuration commands. These command modes are described in the following sections.
Many features are enabled on a per-interface basis. Interface configuration commands modify the operation of an interface such as a VLAN interface. Interface configuration commands always follow an interface command, which defines the interface type.
To access and list the interface configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, enter interface configuration mode. | interface interface-type interface-number1 |
Step 2 List the interface configuration commands. | ? |
| 1This command is documented in the IOS Command Reference publications. |
To exit interface configuration mode and return to global configuration mode, enter the exit command. To exit Configuration mode and return to privileged EXEC mode, press Control-Z.
Router configuration commands configure a routing protocol and always follow a router command. To access and list the router configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, enter router configuration mode. | router [keyword]1 |
Step 2 List the router configuration commands. | ? |
| 1This command is documented in the IOS Command Reference publications. |
To list the available router configuration keywords, enter the router command followed by a space and a question mark (?) at the global configuration prompt:
Router(config)#router ?
bgp Border Gateway Protocol (BGP)
egp Exterior Gateway Protocol (EGP)
eigrp Enhanced Interior Gateway Routing Protocol (EIGRP)
igrp Interior Gateway Routing Protocol (IGRP)
isis ISO IS-IS
iso-igrp IGRP for OSI networks
mobile Mobile routes
odr On Demand stub Routes
ospf Open Shortest Path First (OSPF)
rip Routing Information Protocol (RIP)
static Static routes
In the following example, the router is configured to support the Routing Information Protocol (RIP). The new prompt is router(config-router)#. Enter a question mark (?) to list router configuration commands.
Router(config)#router rip
Router(config-router)#?
Router configuration commands:
auto-summary Enable automatic network number summarization
default Set a command to its defaults
default-metric Set metric of redistributed routes
distance Define an administrative distance
distribute-list Filter networks in routing updates
exit Exit from routing protocol configuration mode
help Description of the interactive help system
maximum-paths Forward packets over multiple paths
neighbor Specify a neighbor router
network Enable routing on an IP network
no Negate a command or set its defaults
offset-list Add or subtract offset from IGRP or RIP metrics
output-delay Interpacket delay for RIP updates
passive-interface Suppress routing updates on an interface
redistribute Redistribute information from another routing
protocol
timers Adjust routing timers
validate-update-source Perform sanity checks against source address of
routing updates
version Set routing protocol version
Router(config-router)#
The list of commands might vary slightly from this example, depending upon how your router has been configured.
To exit router configuration mode and return to global configuration mode, enter the exit command. To exit Configuration mode and return to privileged EXEC mode, press Control-Z.
Internet Packet Exchange (IPX) is a Novell network-layer protocol. To access and list the IPX routing configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, enter IPX-router configuration mode. | ipx router [keyword]1 |
Step 2 List the IPX-Router configuration commands. | ? |
| 1This command is documented in the IOS Command Reference publications. |
In the following example, IPX RIP routing is configured. The new prompt is Router(config-ipx-router):
Router(config)#ipx router rip
Router(config-ipx-router)#?
To exit IPX-router configuration mode and return to global configuration mode, enter the exit command. To exit Configuration mode and return to privileged EXEC mode, press Control-Z.
Use the Route-Map Configuration mode to configure routing table and source and destination information. To access and list the route-map configuration commands, perform this task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, enter Route-Map Configuration mode. | route-map map-tag [[permit | deny] | [sequence-number]]1 |
Step 2 List the route-map configuration commands. | ? |
| 1This command is documented in the IOS Command Reference publications. |
In the following example, a route map named arizona1 is configured. The new prompt isRouter(config-route-map). Enter a question mark (?) to list route-map configuration commands.
Router(config)#route-map arizona1 Router(config-route-map)#? Route Map configuration commands: exit Exit from route-map configuration mode help Description of the interactive help system match Match values from routing table no Negate or set default values of a command set Set values in destination routing protocol
To exit Route-Map Configuration mode and return to global configuration Mode, enter the exit command. To exit Configuration mode and return to privileged EXEC mode, press Control-Z.
If the RSM or RSFC does not find a valid system image, or if its configuration file is corrupted at startup, the system might enter ROM-monitor mode. From ROM-monitor mode, you can boot the router or perform diagnostic tests.
You can also enter ROM-monitor mode by entering the reload EXEC command and then pressing the Break key during the first 60 seconds of startup. To save changes to the configuration file before reloading, use the copy running-config startup-config command before entering the reload command.
To access and list the ROM monitor configuration commands, complete the following tasks:
| Task | Command |
|---|---|
Step 1 Enter ROM-monitor mode from privileged EXEC mode. | reload1 |
Step 2 List the ROM monitor commands. | ? |
| 1This command is documented in the IOS Command Reference publications. |
The ROM monitor prompt is an angle bracket (>). The following example shows how to list the ROM monitor commands:
> ?
$ state Toggle cache state (? for help)
B [filename] [TFTP Server IP address | TFTP Server Name]
Load and execute system image from ROM or from TFTP server
C [address] Continue execution [optional address]
D /S M L V Deposit value V of size S into location L with modifier M
E /S M L Examine location L with size S with modifier M
G [address] Begin execution
H Help for commands
I Initialize
K Stack trace
L [filename] [TFTP Server IP address | TFTP Server Name]
Load system image from ROM or from TFTP server, but do not
begin execution
O Show configuration register option settings
P Set the break point
S Single step next instruction
T function Test device (? for help)
Deposit and Examine sizes may be B (byte), L (long) or S (short).
Modifiers may be R (register) or S (byte swap).
Register names are: D0-D7, A0-A6, SS, US, SR, and PC
To return to user EXEC mode, enter c to continue. To boot the system image file, use the b command (described in the IOS Command Reference publications).
Posted: Tue Feb 29 10:32:28 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.