cc/td/doc/product/software/ssr91
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Modifying the Startup Configuration

Modifying the Startup Configuration

You can modify the startup configuration through the command interpreter called the EXEC. This chapter provides the following information about using the command interpreter:

This chapter also provides command information about modifying the configuration through two EXEC commands as follows:

Finally, this chapter provides information about how you can review the modifications you have made to the configuration.

Using the EXEC Command Interpreter

The EXEC interprets the commands you enter and carries out the corresponding operations.

You can enter commands when you see the system prompt, which is the system's host name ending with an angle bracket (>). Although the default system host name is PT>, this may have been changed during the initial configuration, or with the hostname configuration command.

The following sections describe how to use the EXEC.

EXEC Command Syntax

The EXEC accepts commands entered in uppercase letters, lowercase letters, or both. You can also abbreviate commands and other keywords to the number of characters that cause the command to be a unique abbreviation. For example, you can abbreviate the show command to sh.

If you make a typing mistake, you can erase characters one at a time with the Delete or the Backspace key. Press either key to erase the last character entered. To erase the entire line, enter Ctrl-U. (This notation means "Hold down the Ctrl key and press the U key.") The protocol translator acts on most commands after you press the Return key.

You can list available EXEC commands by entering a question mark (?). You can also enter a question mark to obtain more information about commands. For example, enter terminal? to obtain a list of terminal commands or show? to obtain a list of show commands.

Certain EXEC commands produce multiple screens of output. At the end of each screen, the EXEC pauses and displays:

-More-

Enter a space to continue the output; enter anything else to return to the system command prompt.

EXEC Command Levels

The EXEC has two levels of access: user and privileged. The commands available at the user level are a subset of the commands available at the privileged level. Because many of the privileged commands set operating parameters, the privileged level should be password-protected to prevent its unauthorized use. The system prompt for the privileged level ends with a pound sign (#) instead of an angle bracket (>).

The EXEC enable command allows access to the privileged level, prompting for a password if one has been set with the enable-password configuration command. For more information, see Chapter 4 of the Protocol Translator Configuration and Reference publication.

Enter the ? (question mark) command at the user level to see a list of the user-level EXEC commands similar to the following:

PT> ?
connect <host>  			Connect to host - same as typing just a host name
disconnect <cn> 		Break the connection specified by name or number
exit, quit      Exit from the EXEC
lat <service>   Connect to service using DEC LAT protocol
lock            Lock the terminal
name-connection Give a connection a logical name
pad <host>      Connect to host using X.29/X.3 protocols
resume          Make the named connection be current
rlogin <host>   Connect to host using rlogin protocol
show <cmd>      Information commands, type "show ?" for list
slip <addr>     Enter SLIP mode
systat          Show terminal lines and users
telnet <host>   Connect to host using telnet protocol
tn3270 <host>   Connect to host using telnet protocol (3270)
terminal        Change terminal's parameters, type "terminal ?"
where           Show open connections
x3              Set X.3 parameters on PAD
xremote         Enter XRemote mode
<cr>            To resume connection

Enter enable and the password to access the privileged command level then enter the ? (question mark) command to see a list of privileged-level EXEC commands similar to this example:

PT# ?

clear          Reinitialization functions, type "clear ?" for list
configure       Configure from terminal or over network
connect <host>  Connect to host - same as typing just a host name
copy            copy flashmem->tftp or tftp->flashmem
debug           Enable debugging functions, type "debug ?" for list
disable         Turn off privileged commands
disconnect <cn> Break the connection specified by name or number
enable          Turn on privileged commands
exit, quit      Exit from the EXEC
lat <service>   Connect to service using DEC LAT protocol
lock            Lock the terminal
name-connection Give a connection a logical name
pad <host>      Connect to host using X.29/X.3 protocols
ping            Send echo messages
reload          Halt and reload system
resume          Make the named connection be current
rlogin <host>   Connect to host using rlogin protocol
send <line>|*   Send message to a terminal line or lines
setup           Initialize system configuration
show <cmd>      Information commands, type "show ?" for list
slip <addr>     Enter SLIP mode
systat          Show terminal lines and users
telnet <host>   Connect to host using telnet protocol
tn3270 <host>   Connect to host using telnet protocol (3270)
terminal        Change terminal's parameters, type "terminal ?"
test            Run hardware tests, type "test ?"
trace <address> Trace route to <address>
undebug         Disable debugging functions,type "undebug ?"for list
where           Show open connections
write           Write configuration memory, type "write ?" for list
x3              Set X.3 parameters on PAD
xremote         Enter XRemote mode
<cr>            To resume connection

To return to the user-level prompt, enter disable at the EXEC prompt.

Using the Setup Command

The setup command facility can be used after first-time startup to make basic changes at any time. The changes you make will affect only the changed elements current memory value stored in nonvolatile memory.

When you enter the setup command facility after first-time startup, you must run through the entire dialog until you come to the element you wish to change. Note that when you use the setup command after first-time startup, the default values indicated within the brackets in the System Configuration Dialog are the values last set using the setup command facility or left as defaults. If you do not want to make the change while still in the System Configuration Dialog, type Ctrl-C to return to the privileged EXEC prompt.

Refer to Chapter 2, "Preparing for First-Time Startup," for complete
descriptions of the values you can assign each item within the dialog.

Using the Configure Command

This section provides a brief overview of using the configure command for advanced configuration changes. For detailed information about advanced configuration, refer to the Protocol Translator Configuration and Reference publication.

Use the privileged EXEC command configure to begin advanced configuration of the protocol translator. Begin by entering the privileged level of the EXEC. This is done by entering the enable command at the EXEC prompt:

PT> enable

The EXEC then prompts you for a privileged-level password:

Password:

Enter the password. For security purposes, the password will not be displayed. (Also note that the password is case sensitive.) When you enter the correct password, the system displays the privileged-mode system prompt:

PT#

To begin configuration mode, enter the configure command at the privileged-mode prompt:

PT# configure

When you enter this command, the EXEC prompts you for the source of the configuration subcommands.

Configuring from terminal, memory, or network [terminal]?

The default is to enter commands from the terminal console. Pressing the Return key begins this configuration method. Each configuration technique (terminal, memory, and network) is described in more detail in Chapter 5, "Miscellaneous System Tasks."

The EXEC provides you with a simple editor for entering the configuration commands, and explains the editing functions. The prompt is as follows:

Enter configuration commands, one per line.
Edit with DELETE, CTRL/W, and CTRL/U; end with CTRL/Z

Table 1-1 lists the edit key functions and their meanings.


Configuration Edit Keys
Key Meaning
Delete or Backspace Erases one character.
Ctrl-W Erases a word.
Ctrl-U Erases a line.
Ctrl-R Redisplays a line.
Return Executes single-line commands.
Ctrl-Z Ends configuration mode and returns to the EXEC.

Configuration Subcommands

The configuration subcommands are categorized by these functions:

The descriptions of the commands include the command type and give examples of their use.

As with EXEC commands, you can enter configuration subcommands in uppercase letters, lowercase letters, or both. You can also shorten all commands and other keywords to unique abbreviations. You can add comments by preceding the line with an exclamation point (!). Comments are ignored and do not affect command processing.

If you make a typing mistake, use the Delete or Backspace key to erase a character, Ctrl-W to erase a word, and Ctrl-U to erase a line. To redisplay a line, use Ctrl-R. See Table 4-1 for a list of valid edit keys.

The protocol translator executes single-line commands when you press the Return key. The protocol translator does not display confirmation messages as it executes the commands. If the protocol translator encounters a problem, it displays an error message on the console terminal. When you enter Ctrl-Z, the protocol translator exits the configuration mode.

In most cases, you can negate a configuration subcommand or restore a default by entering no before the subcommand keyword. You can usually omit the arguments of the subcommand when you negate it with no. The command descriptions note any exceptions to these rules.

The following examples illustrate how to enter the configuration subcommands.

The EXEC accepts commands in uppercase and lowercase letters. Exclamation points are not parsed and serve as comment lines and delimiters between configuration commands.

Global Configuration Commands

Global configuration commands enable functions that affect the entire system rather than a particular line or interface, and can appear any place within the configuration file. An example of this is the global configuration command to define the host name, or the name of the protocol translator:

hostname translator-1

Interface Subcommands

Interface subcommands modify the operation of an interface such as an Ethernet, FDDI, or serial port. Interface subcommands always follow an interface command that defines the interface type.

The following example illustrates how to enable LAT and DEC MOP on interface Ethernet 0:

interface ethernet 0
mop enabled
lat enabled

The EXEC accepts commands in uppercase and lowercase letters. Exclamation points (!) are not parsed and serve as comment lines and delimiters between configuration commands. If you forget to enter the interface command, the system displays the message "must specify a network interface."

Line Subcommands

Line subcommands modify the operation of a serial terminal line. Line subcommands always follow a line command which defines the line number. If you forget to enter the line command, the system displays the message "must specify a line or range of lines."

The following example illustrates how to set the password on line 5:

line 5
password secretword

Enter Ctrl-Z to end your configuration sessions, and the disable command to leave privileged level mode.

Reviewing the Modifications to the Configuration

You can review the changes you have made to the configuration. To display information stored in nonvolatile memory use the EXEC command show configuration. After making changes, review them by displaying the configuration running in memory with the write terminal command. If the changes meet your needs and you want to save them, use the write memory command to copy the current running configuration to nonvolatile memory.


Note The write commands create their output by examining the state of the system currently running. The output produced by write commands is generated by the software, and will not necessarily match the text the user entered to create the current configuration. For example, comments are omitted from the configuration.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.