|
|
The LightStream 1010 Asynchronous Transfer Mode (ATM) switch command line interface (CLI) provides access to several different command modes. Each of the six different command modes provide a different group of related commands. Users familiar with the Cisco Internetwork Operating System (Cisco IOS) user interface will find the commands very similar. This chapter describes how to access and list the commands available in each command mode and explains the primary uses for each command mode.
For security purposes, the user interface provides two levels of access to commands: user and privileged. The unprivileged user mode is called user EXEC mode. The privileged mode is called 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 level, you can access global configuration mode and three specific configuration modes: terminal, memory, and network configuration. In addition, if your switch does not find a valid system image, or if its configuration file is corrupted at startup, the system might enter read-only memory (ROM) monitor mode. Entering a question mark (?) at the system prompt allows you to obtain a list of commands available for each command mode.
Almost every switch configuration command also has a no form. In general, use the no form to disable a feature or function. Use the command without the keyword no to reenable a disabled feature or to enable a feature that is disabled by default. For example, terminal history is enabled by default. Specify the command no history to disable terminal history and specify terminal history to reenable it. The LightStream 1010 ATM Switch Command Reference publication provides the complete syntax for every switch configuration command and describes what the no form of a command does.
The user interface also provides context-sensitive help on command syntax. This chapter describes how to use the help system. It also describes the command editing and command history features that enable you to recall previous command entries and easily edit command entries.
For a complete description of the commands mentioned in this chapter, refer to the LightStream 1010 ATM Switch Command Reference publication.
You can perform the tasks in the following sections to become familiar with the LightStream 1010 ATM switch user interface:
This section describes how to access each of the LightStream 1010 ATM switch command modes:
Table 5-1 lists the command modes, how to access each mode, the prompt you will see while you are in that mode, the main uses for each configuration mode, and the method to exit that mode. The prompts listed assume the default switch name "Switch." Table 5-1 might not include all the possible ways to access or exit each command mode.
Table 5-1 Summary of Command Modes
After you log in to the switch, 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 connect to remote switches, change terminal settings on a temporary basis, perform basic tests, and list system information.
The user-level prompt consists of the switch's host name followed by the angle bracket (>):
The default host name is Switch unless it has been changed during initial configuration using the setup command. (Refer to the LightStream 1010 ATM Switch Software Configuration Guide for information on the setup facility.) You can also change the switch name using the hostname global configuration command described in the "System Management Commands" chapter in the LightStream 1010 ATM Switch Software Configuration Guide publication.
To list the commands available in user EXEC mode, enter a question mark (?) as shown in the following example:
The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
If your switch does not find a valid system image, or if you interrupt the boot sequence, the system might enter ROM monitor mode. From ROM monitor mode, you can boot the switch 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, use the copy running-config startup-config command before issuing the reload command.
To access and list the ROM monitor configuration commands, complete the following tasks:
| Task | Command |
|---|---|
reload1 |
|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
The ROM monitor prompt is the angle bracket (>):
To initialize the switch, enter the b command. To boot the system image file, use the b command (described in the chapter "Loading System Images, Software Images, and Configuration Files").
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 commands, see the LightStream 1010 ATM Switch Software Configuration Guide and LightStream 1010 ATM Switch Command Reference publications.
To access and list the privileged EXEC commands, complete the following tasks:
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. If an enable password has not been set, enabled mode can be accessed only from the console. 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 Lightstream 1010 ATM Switch Command Reference publication.
The privileged EXEC mode prompt consists of the switch's host name followed by the pound sign (#). (If the switch was named with the hostname command, that name would appear as the prompt instead of "Switch.")
The following example shows how to access privileged EXEC mode and list privileged EXEC commands:
The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
From the privileged level, you can access global configuration mode. For instructions, see the "Global Configuration Mode" section, which follows this section.
To return from privileged EXEC mode to user EXEC mode, perform the following task:
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:
You can then specify either the terminal, nonvolatile RAM (NVRAM), or a file stored on a network server as the source of configuration commands. (See the "System Image, Software Image, and Configuration File Load Commands" chapter in the LightStream 1010 ATM Switch Software Configuration Guide publication.) The default is to enter commands from the terminal console. Pressing the Return key begins this configuration method.
To access and list the global configuration commands, complete the following tasks:
| Task | Command |
|---|---|
At the terminal, from the privileged EXEC mode, enter global configuration mode |
|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
The following example shows how to access global configuration mode and list global configuration commands:
The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
To exit global configuration command mode and return to privileged EXEC mode, use one of the following commands:
From global configuration mode, you can access 16 configuration modes containing interface, subinterface, and line 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 an ATM, Ethernet, or asynchronous port. Interface configuration commands always follow an interface global configuration command that defines the interface type.
To access and list the interface configuration commands, complete the following tasks:
| Task | Command |
|---|---|
From global configuration mode, enter interface configuration mode |
|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
In the following example, ATM interface 1/0/0 is about to be configured. The new prompt
Switch(config-if)# indicates interface configuration mode. In this example, the user asks for help by requesting a list of commands.
The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
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, use the end command or press Ctrl-Z.
You can configure multiple logical interfaces (called subinterfaces) on a single ATM interface or ATM Switch Processor (ASP) Ethernet interface.
Subinterfaces appear to be distinct physical interfaces to the various protocols. For example, ATM networks provide multiple point-to-point links called permanent virtual circuits (PVCs). PVCs can be grouped under separate subinterfaces that in turn are configured on a single physical interface.
To access and list the subinterface configuration commands, complete the following tasks:
| Task | Command |
|---|---|
From interface configuration mode, configure a logical interface |
interface atm card/sub_card/port [.sub-inter #]1 |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
In the following example, an interface is configured for ATM 0/0/0. The subinterface is number 99 to indicate that it is subinterface 99 of port 0 on the port adapter module (PAM) 0 in carrier module (CAM in slot 0). The new prompt Switch(config-subif)# indicates subinterface configuration mode. The subinterface can be configured to support one or more ATM PVCs. To list the commands available in subinterface configuration mode, enter a question mark (?).
Note The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
In the following example an interface is configured for Ethernet 2/0/0. The subinterface is number 100 of ASP CPU interface 2/0/0. The new prompt Switch(config-subif)# indicates subinterface configuration mode. The subinterface can be configured to support one or more Ethernet PVCs.
To list the commands available in subinterface configuration mode, enter a question mark (?).
To exit subinterface configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, press Ctrl-Z.
Line configuration commands modify the operation of a terminal line. Line configuration commands always follow a line command, which defines a line number. These commands are generally used to connect to remote switches, change terminal parameter settings either on a line-by-line basis or for a range of line, and set up the auxiliary port modem configuration. For detailed line configuration instructions, see the chapter "Configuring Terminal Lines and Modem Support."
To access and list the auxiliary port, console port, and virtual terminal line configuration commands, complete the following tasks:
| Task | Command |
|---|---|
From global configuration mode, configure an auxiliary, console, or virtual terminal line |
|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
The following example shows how to enter line configuration mode for the console line and list the line configuration commands. The new prompt Switch(config-line)# indicates line configuration mode.
Note The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
To exit line configuration mode and return to global configuration mode, use the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The LightStream 1010 ATM switch supports a static mapping scheme that identifies the ATM address of remote hosts or switches.
Map-list configuration commands configure a map list. They always follow a map-list global configuration command. To access and list the map list configuration commands, complete the following tasks:
| Task | Command |
|---|---|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
The following example shows how to enter map-list configuration mode and list the map list configuration commands. In this example, the static map-list configuration commands are listed. The new prompt Switch(config-map-list)# indicates map-list configuration mode.
Note The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
To exit map-list configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The ATM interface allows you to specify quality of service (QOS) parameters that control how much traffic the source switch will be sending over a switched virtual circuit (SVC).
To define QOS parameters that are associated with a static map for an SVC, use the map-class global configuration command.
| Task | Command |
|---|---|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
In the following example, the static map-class configuration commands are listed. The prompt Switch(config-map-class)# indicates map-class configuration mode.
Note The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
To exit map-class configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The LightStream 1010 ATM switch supports the Private Network-Network Interface (PNNI) routing protocol. The atm router pnni command entered from privileged EXEC command mode allows you to change to PNNI router configuration mode.
To access and list the atm router pnni configuration commands, complete the following tasks:
| Task | Command |
|---|---|
From global configuration mode, use the atm router pnni command. |
|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
The following example shows how to enter ATM router PNNI configuration mode and list the ATM router PNNI configuration commands. The new prompt Switch(config-atm-router)# indicates ATM router PNNI configuration mode.
Note The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
To exit ATM router configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The LightStream 1010 ATM switch supports the PNNI routing protocol. The ATM router PNNI node command entered from ATM router PNNI command mode allows you to change to node configuration mode.
To access and list the ATM router PNNI node configuration commands, complete the following tasks:
| Task | Command |
|---|---|
From ATM router PNNI configuration mode, use the node command. |
|
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference publication. |
The following example shows how to enter ATM router PNNI node configuration mode for PNNI node index number one and list the ATM router PNNI node configuration commands. The new prompt Switch(config-pnni-node)# indicates ATM router PNNI node configuration mode.
Note The list of commands might vary slightly from this example, depending on the software feature set and configuration of your switch.
To exit ATM router node configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The previous sections described the first level of help available with the user interface. Entering a question mark (?) at the system prompt displays a list of commands available for each command mode. You can also get a list of any command's associated keywords and arguments with the context-sensitive help feature.
To get help specific to a command mode, a command, a keyword, or arguments, perform one of the following tasks:
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference. |
When using context-sensitive help, the space (or lack of a space) before the question mark (?) is significant. To obtain a list of commands that begin with a particular character sequence, type in those characters followed immediately by the question mark (?). Do not include a space. This form of help is called word help, because it completes a word for you.
To list keywords or arguments, enter a question mark (?) in place of a keyword or argument. Include a space before the ?. This form of help is called command syntax help, because it reminds you which keywords or arguments are applicable based on the command, keywords, and arguments you already have entered.
You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation. For example, you can abbreviate the show command to sh.
Enter the help command (which is available in any command mode) for a brief description of the help system:
As described in the help command output, you can enter a partial command name and a question mark (?) to obtain a list of commands beginning with a particular character set. See the section "Completing a Partial Command Name" in the chapter "Understanding the User Interface" of the LightStream 1010 ATM Switch Software Configuration Guide publication for more detail.
The following example illustrates how the context-sensitive help feature enables you to create an access list from configuration mode. First enter the letters co at the system prompt followed by a question mark (?). Do not leave a space between the last letter and the question mark (?). The system provides the commands that begin with co.
Enter the configure command followed by a space and a question mark (?) to list the command's keywords and a brief explanation:
Enter the terminal keyword to enter configuration mode from the terminal:
Enter the access-list command followed by a space and a question mark (?) to list the command's keywords:
Enter the access list number 99 and then enter another question mark (?) to see the arguments that apply to the keyword and brief explanations:
Enter the deny argument followed by a question mark (?) to list additional options:
Enter the IP address followed by a question mark (?) to list additional options:
The <cr> symbol appears in the list, indicating that one of your options is to press Return to execute the command. The other option is to add a wildcard mask. Enter the wildcard mask followed by a question mark (?) to list further options.
The <cr> symbol by itself indicates there are no more keywords or arguments. Press Return to execute the command. The system adds an entry to access list 99 that denies access to all hosts on subnet 131.108.134.0.
For a complete description of the user interface and configuration modes, see the following sections of the LightStream 1010 ATM Switch Software Configuration Guide publication:
After using the setup command or other configuration commands, exit the switch and quit the session.
To end a session, perform the following steps:
Refer to the LightStream 1010 ATM Switch Software Configuration Guide for more information on exiting sessions and closing connections.
Posted: Thu Jan 23 21:01:27 PST 2003
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.