Overview

CLI Command Reference Formats

Understanding Command Modes

Enabling Passwords

Entering Configuration Mode

Using Commands

Abbreviating Commands

Command Completion

Command History

Command-Line Error Messages

Getting Help

Saving Configuration Changes

Overview

This chapter defines the following aspects of the Cisco Enterprise Edition Software command-line interface (CLI) commands of the Cisco 1538 Micro Hub 10/100 (hereafter referred to as the Cisco 1538 hub):

CLI Command Reference Formats

Understanding Command Modes

The CLI commands for the Cisco 1538 hub are sorted into classes: Exec commands and configuration commands. Configuration commands are further categorized into three modes: global configuration, interface (and sub-interface) configuration, and line configuration. Figure 1-1 illustrates the class and mode hierarchy.

Figure 1-1: CLI Command Classes and Modes

Table 1-1 lists the command modes that are used in this guide, how to access each mode, the prompt you see in that mode, and how to exit that mode. The examples in the table use the hostname 1538.

.
Table 1-1: Comma nd Mo des Summary

Mode Access Method Prompt Exit Method About This Mode¹

User Exec

Begin a session with your hub.

1538>
Enter the exit command.

This mode contains the nonpassword-protected Exec mode commands. Use this mode to

Change terminal settings.

Perform basic tests.

Display system information.

Privileged Exec

Enter the enable command in user Exec mode.

1538#
To exit to user Exec mode, enter the disable command.

To enter global configuration mode, enter the configure command.

Use this mode to

Configure your hub operating parameters.

Verify information.

To prevent unauthorized changes to your hub configuration, protect access to this mode with a password.

Global configuration

Enter the configure command in privileged Exec mode.

1538(config)#
To exit to privileged Exec mode, enter the exit or end command, press Ctrl-C or Ctrl-Z.

To enter hub configuration mode, enter the hub command. To enter line configuration mode, enter the line command.

Use this mode to configure parameters that apply to your hub as a whole.

Hub configuration

Enter the hub command in global configuration mode.

1538(config-hub)#
To exit to global configuration mode, enter the exit command.

To exit to privileged Exec mode, enter the end command, or press Ctrl-C or Ctrl-Z.

Use this mode to specify the hub in a stack that you are configuring (range is 1 to 4).

Interface configuration

Enter the interface command (with an interface number) in the hub configuration mode.

1538(config-if)#
To exit to hub configuration mode, enter the exit command.

To exit to privileged Exec mode, enter the end command, or press Ctrl-C or Ctrl-Z.

Use this mode to configure Ethernet and Fast Ethernet parameters for the hub interfaces.

Line configuration

Specify a line with the line console command in global configuration mode.

1538(config-line)#
To exit to global configuration mode, enter the exit command.

To enter privileged Exec mode, enter the end command, or press Ctrl-C or Ctrl-Z.

Use this mode to configure parameters for the terminal line.

¹For any of the modes, you can see a comprehensive list of the available commands by entering a question mark (?) at the prompt.

Mode	Access Method	Prompt	Exit Method	About This Mode¹
User Exec	Begin a session with your hub.	1538>	Enter the exit command.	This mode contains the nonpassword-protected Exec mode commands. Use this mode to Change terminal settings. Perform basic tests. Display system information.
Privileged Exec	Enter the enable command in user Exec mode.	1538#	To exit to user Exec mode, enter the disable command. To enter global configuration mode, enter the configure command.	Use this mode to Configure your hub operating parameters. Verify information. To prevent unauthorized changes to your hub configuration, protect access to this mode with a password.
Global configuration	Enter the configure command in privileged Exec mode.	1538(config)#	To exit to privileged Exec mode, enter the exit or end command, press Ctrl-C or Ctrl-Z. To enter hub configuration mode, enter the hub command. To enter line configuration mode, enter the line command.	Use this mode to configure parameters that apply to your hub as a whole.
Hub configuration	Enter the hub command in global configuration mode.	1538(config-hub)#	To exit to global configuration mode, enter the exit command. To exit to privileged Exec mode, enter the end command, or press Ctrl-C or Ctrl-Z.	Use this mode to specify the hub in a stack that you are configuring (range is 1 to 4).
Interface configuration	Enter the interface command (with an interface number) in the hub configuration mode.	1538(config-if)#	To exit to hub configuration mode, enter the exit command. To exit to privileged Exec mode, enter the end command, or press Ctrl-C or Ctrl-Z.	Use this mode to configure Ethernet and Fast Ethernet parameters for the hub interfaces.
Line configuration	Specify a line with the line console command in global configuration mode.	1538(config-line)#	To exit to global configuration mode, enter the exit command. To enter privileged Exec mode, enter the end command, or press Ctrl-C or Ctrl-Z.	Use this mode to configure parameters for the terminal line.

The commands of each mode are accessible only to users with privileges assigned for the mode.

Enabling Passwords

Because many privileged-level Exec commands are used to set operating parameters, you should password-protect these commands to prevent unauthorized use.

Use two commands to do this:

The enable command to set the command access level
The enable password command to configure your privileged and user Exec passwords

For maximum security, the privileged and user Exec passwords should be different.

An enable password has from 4 to 8 alphanumeric characters. The passwords are case sensitive, and the first character cannot be a number. Spaces are valid password characters; for example, two words is a valid password as long the string is enclosed in quotation marks.

Entering Configuration Mode

To make any configuration changes to your hub, you must be working in configuration mode. This section describes how to enter configuration mode while using a terminal or PC that is connected to your hub console port.

To enter configuration mode:

1. After your hub boots ups, enter the enable command, and if you have configured your hub with an enable password, enter the password when you are prompted for it. (The enable password does not show on the screen.)

This example shows how to enter configuration mode on a Cisco 1538 hub:

> enable
Password: <enable_password>
#

Enable mode is indicated by the # symbol in the prompt. You can now make changes to your hub configuration.

2. Enter the config command to enter configuration mode, which is indicated by the (config)# in the prompt:

# config
(config)#

You can now make changes to your hub configuration.

Using Commands

This section provides some tips about entering Enterprise Edition Software CLI commands.

Abbreviating Commands

The CLI requires a minimum number of characters to uniquely identify a keyword in a command. For example, for the fictional commands catch and catalog, the minimum number of characters required to identify them are catc and cata, respectively. An error message appears if the keyword is ambiguous.

Command Completion

If you enter part of a keyword and press the Tab key, the CLI displays the remaining keyword characters to the point of a keyword ambiguity. For example, for the fictional commands catch and catalog, entering ca and pressing the Tab key displays the characters cat.

Command History

You can use the up arrow or Ctrl-P key to display your last ten commands, beginning with the most recent. Exec and configuration commands are listed in their own history files and display from their respective command modes. Use the down arrow or Ctrl-N key to display your last CLI entry.

Command-Line Error Messages

Table 1-2 shows the five types of CLI error messages you are most likely to see:

Table 1-2: Common CLI Error Messages

Error Message Meaning

1538 (config-hub)# interface % Incomplete command
Incomplete command error message:

You did not enter all of the keywords or values required by this command. This example requires a module and port specification.

Reenter the command followed by a question mark with a space between the command and the question mark. The possible keywords that you can enter with the command are displayed.

1538(config)# hub 5 ^ % Invalid input detected at `^' marker
Invalid input error message:

This example lists module and port values outside the valid range.

Reenter the command followed by a question mark with a space between the command and the question mark. The possible keywords that you can enter with the command are displayed.

1538(config)# gizbot? % Unrecognized command
This example uses a command that is not available within that mode.

Backspace over the previous text and enter a question mark with no space between the command and the question mark to see all the commands for that mode.

Refer to the "Command Descriptions" chapter of this book to find the correct mode for the command you want and enable that mode. Enter a question mark with a space between the command and the question mark to see all the commands for that mode.

1538(config)# co % Ambiguous command: "co"
Ambiguous command error message:

The example shows a command word fragment that could be either configure or copy.

Reenter the command followed by a question mark with no space between the command and the question mark. The possible keywords that you can enter with the command are displayed.

1538(config)# ip default-gateway 172.20.128.126 % Error: IP address not found
Configuration error error message:

If you enter a complete command with the correct syntax, errors might still occur due to mismatches between the configuration you want and the configuration choices you have. These messages are command-specific. Refer to the "Command Descriptions" chapter of this book to find the correct syntax for the command.

Error Message	Meaning
1538 (config-hub)# interface % Incomplete command	Incomplete command error message: You did not enter all of the keywords or values required by this command. This example requires a module and port specification. Reenter the command followed by a question mark with a space between the command and the question mark. The possible keywords that you can enter with the command are displayed.
1538(config)# hub 5 ^ % Invalid input detected at `^' marker	Invalid input error message: This example lists module and port values outside the valid range. Reenter the command followed by a question mark with a space between the command and the question mark. The possible keywords that you can enter with the command are displayed.
1538(config)# gizbot? % Unrecognized command	This example uses a command that is not available within that mode. Backspace over the previous text and enter a question mark with no space between the command and the question mark to see all the commands for that mode. Refer to the "Command Descriptions" chapter of this book to find the correct mode for the command you want and enable that mode. Enter a question mark with a space between the command and the question mark to see all the commands for that mode.
1538(config)# co % Ambiguous command: "co"	Ambiguous command error message: The example shows a command word fragment that could be either configure or copy. Reenter the command followed by a question mark with no space between the command and the question mark. The possible keywords that you can enter with the command are displayed.
1538(config)# ip default-gateway 172.20.128.126 % Error: IP address not found	Configuration error error message: If you enter a complete command with the correct syntax, errors might still occur due to mismatches between the configuration you want and the configuration choices you have. These messages are command-specific. Refer to the "Command Descriptions" chapter of this book to find the correct syntax for the command.

Getting Help

You can use the question mark (?) and arrow keys to help you enter commands. For a list of available commands within that command mode, enter a question mark:

1538(config-if)# ?
 
Interface configuration commands:
  description  Interface specific description
  end          Exit from interface configuration mode, to Privileged mode
  exit         Exit from interface configuration mode, to hub configuration
               mode
  help         Description of the interactive help system
  no           Negate a command or set its defaults
  port-speed   Port speed of the interface
  shutdown     Shutdown the selected interface

To check the correct spelling of a command, enter a few known characters followed by a question mark (with no space):

1538(config)# debug?
debug memory read
debug memory write

For a list of command keywords and parameters, enter the command followed by a space and a question mark:

1538(config)# copy ?

tftp:    Copy from a TFTP server
xmodem:  Copy from a XMODEM host

To redisplay a command you previously entered, press the up-arrow key. You can continue to press the up-arrow key to see up to ten previous commands.

Saving Configuration Changes

All configuration changes are saved to nonvolitile RAM (NVRAM) immediately after the command is entered successfully. You can save the configuration to a TFTP server by using the upgrade mode command. You can restore the saved configuration by using the copy tftp command.

Table of Contents

Overview