Support

Table Of Contents

copy

debug mpoa client

default-name

delete

dev

dir—ROM monitor

dir—switch

disable—ATM

disable—switch

disconnect

display-databases

copy

Use the copy command to upload or download a Flash image or a switch configuration to or from a Flash device or a TFTP server.

copy file-id {tftp | flash | file-id | config}
copy tftp {flash | file-id | config}
copy flash {tftp | file-id | config}
copy config {flash | file-id | tftp}

Syntax Description

file-id	Format used to specify the file on the Flash device, where the format is [[m/]device:][filename]. m/ = Option that gives access to different modules, such as the standby supervisor engine, an FDDI module, and an ATM module. device: = Device where the Flash resides. filename = Name of the configuration file.
tftp	Keyword that allows you to copy to or from a TFTP server.
flash	Keyword to support multiple module download.
config	Keyword that allows you to copy the configuration to Flash memory, another Flash device, or a file on a TFTP server.

Default

If a source or destination device is not given, the one specified by the cd command is used. If a destination filename is omitted, the source filename is used.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

For Catalyst 5000, 2926G, and 2926 series switches, this command applies only to the Supervisor Engine III. If you attempt to run this command on a Supervisor Engine I or II, you will receive an error message.

For Catalyst 4000 and 2948G series switches, this command applies to the supervisor engine module. The Flash device for the Catalyst 4000 and 2948G series switches is bootflash; slot0 and slot1 are not supported by the Catalyst 4000 and 2948G series switches.

If copying to an FDDI or ATM module, you must specify the file-id as m/bootflash: without the filename.

If the source or destination device is not specified, the command uses the ones specified by the cd command. If the destination filename is omitted, the software uses the source filename.

A colon (:) is required after the specified device.

When the flash keyword is used, based on the file type derived, a prompt is given for all modules of the same type. A different prompt is given depending on the command argument and reply.

ATM module software release 4.3(0) does not support the copy tftp command. Use the write network or the config network command to save or retrieve the configuration to a TFTP server.

Examples

This example shows how to use the copy command to upload the switch configuration to a file named cat.cfg on the slot0 Flash device:

Console> (enable) copy config slot0:cat.cfg

Upload configuration to slot0:cat.cfg 

649324 bytes available on device slot0, proceed (y/n) [n]? y

.........

.........

.........

........

.........

.

/

Configuration has been copied successfully. (10200 bytes)

Console> (enable)

This example shows how to use the copy command to upload the switch configuration to a file named lab2.cfg on the TFTP server:

Console> (enable) copy config tftp:lab2.cfg

IP address or name of remote host [172.20.22.7]? y

Upload configuration to tftp:lab2.cfg (y/n) [n]? y

.........

.........

.........

.

/

Configuration has been copied successfully. (10299 bytes).

Console> (enable)

This example shows how to use the copy command to upload the switch configuration to the cat.cfg file on the slot1 Flash device:

Console> (enable) copy config flash

Flash device [bootflash]? slot1:

Name of file to copy to [test_image]? cat.cfg

Upload configuration to slot1:cat.cfg 

749124 bytes available on device slot1, proceed (y/n) [n]? y

.........

.........

.........

........

.

/

Configuration has been copied successfully. (200345 bytes).

Console> (enable)

These examples show how to use the copy commands to download a configuration:

Console> (enable) copy slot0:cat.cfg config

Configure using slot0:cat.cfg (y/n) [n]? y

/

Finished download. (10900 bytes)

>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set prompt Console>

>> set length 24 default

Screen length set to 24.

>> set logout 20

..........

Console> (enable)

Console> (enable) copy tftp config

IP address or name of remote host? 172.20.22.7

Name of configuration file? cat.cfg

Configure using cat.cfg from 172.20.22.7 (y/n) [n]? y

/

Finished network download. (10900 bytes)

>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set prompt Console>

>> set length 24 default

Screen length set to 24.

>> set logout 20

...........

Console> (enable)

Console> (enable) copy tftp bootflash

Address or name of remote host [172.20.22.7]?

Enter source file name [cat4000-sup.4-5-1.bin]?

Enter destination file name [cat4000-sup.4-5-1.bin]?

6942528 bytes available in flash, proceed (y/n) [n]?y

Console> (enable)

Console> (enable) copy flash config

Flash device [bootflash]? 

Name of configuration file? test.cfg

Configure using bootflash:test.cfg (y/n) [n]? y

/

Finished download. (10900 bytes)

>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

Password changed.

>> set prompt Console>

>> set length 24 default

Screen length set to 24.

>> set logout 20

.....

Console> (enable)

Related Commands

write network
configure network

debug mpoa client

Use the debug mpoa client command to display MPC debug information.

debug mpoa client {all | data | egress | general | ingress | keep-alives | platform-specific} [name mpc-name]
no debug mpoa client [name mpc-name]

Syntax Description

all	(Optional) Keyword to show debugging information for all MPC activity.
data	(Optional) Keyword to show debugging information for data plane activity only. This option applies only to routers.
egress	(Optional) Keyword to show debugging information for egress functionality only.
general	(Optional) Keyword to show general debugging information only.
ingress	(Optional) Keyword to show debugging information for ingress functionality only.
keep-alives	(Optional) Keyword to show debugging information for keepalive activity only.
platform-specific	(Optional) Keyword to show debugging information for specific platforms only. This option applies only to the Catalyst 5000, 2926G, and 2926 series ATM module.
name mpc-name	(Optional) Keyword to specify the name of the MPC with the specified name.

Default

The default is debugging is turned on for all MPCs.

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Usage Guideline

This command is not supported by the Catalyst 4000 and 2948G series switches.

Example

This example shows how to turn on debugging for the MPC ip_mpc:

ATM#debug mpoa client all name ip_mpc

ATM#

Related Command

show mpoa client cache

default-name

Use the default-name command to provide an ELAN name in the configuration server's database for those client MAC addresses and client ATM addresses that do not have explicit ELAN name bindings. Use the no form of this command to remove the default name.

default-name elan-name
no default name

Syntax Description

elan-name

Default ELAN name for any LANE client MAC address or LANE client ATM address not explicitly bound to any ELAN name. The maximum length of elan-name is 32 characters.

Default

By default, no name is configured.

Command Type

Cisco IOS ATM command.

Command Mode

Database configuration.

Usage Guidelines

This command is not supported by the Catalyst 4000 and 2948G series switches.

This command affects only the bindings in the configuration server's database. It has no effect on the LANE components themselves.

The named ELAN must already exist in the configuration server's database before this command is used. If the default name-to-ELAN name binding already exists, the new binding replaces it.

Related Commands

client-atm-address name
lane database
name

delete

Use the delete command to delete a configuration file.

delete [[m/]device:]filename

Syntax Description

m/	(Optional) Module number of the supervisor engine containing the Flash device.
device:	(Optional) Device where the Flash resides.
filename	Name of the configuration file.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

A colon (:) is required after the specified device.

This command applies only to the Supervisor Engine III and the Catalyst 4000 and 2948G series switch supervisor engine modules. If you attempt to run this command on a Supervisor Engine I or II, you will receive an error message.

Use the undelete command to recover a deleted file.

A file cannot be undeleted if a valid one with the same name exists. Instead, the existing one must be deleted first and then undelete the target file. A file can be deleted or undeleted up to 15 times. To permanently delete all 'deleted' files on a device, use the squeeze command.

Example

This example shows how to delete the cat5000-sup3.4-5-1.bin configuration file from the Flash device and then verify deletion by entering the show flash command:

Console> (enable) delete bootflash:cat5000-sup3.4-5-1.bin

Console> (enable)

Console> (enable) show flash

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name

  1 .D ffffffff 5415406e  3300b8   25  3080247 Oct 12 1998 13:22:46 cat5000-sup3

.4-5-1.bin

  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 cat5000-sup3

.4-5-1.bin

1428272 bytes available (6173904 bytes used)

Console> (enable)

Related Commands

dir—switch
undelete
show flash
squeeze

dev

Use the dev command to list the device IDs available on a switch.

dev

Syntax Description

This command has no arguments or keywords.

Default

This command has no defaults.

Command Type

ROM monitor command.

Command Mode

Normal.

Usage Guideline

This command is not supported by the Catalyst 4000 and 2948G series switches.

Example

This example shows how to use the dev command:

rommon 10 > dev

Devices in device table:

        id  name

    flash:  flash                      

    slot0:  PCMCIA slot 0              

    slot1:  PCMCIA slot 1              

    eprom:  eprom                      

dir—ROM monitor

Use the dir command to list the files of the named device.

dir device

Syntax Description

device

ID of the device.

Default

This command has no defaults.

Command Type

ROM monitor command.

Command Mode

Normal.

Example

This example shows how to use the dir command:

rommon 11 > dir flash:

         File size           Checksum   File name

        65 bytes (0x41)       0xb49d    clev/oddfile65

   2229799 bytes (0x220627)   0x469e    clev/sierra-k.Z

dir—switch

Use the dir command to display a list of files on a Flash memory device.

dir [[m/]device:][filename] [all | deleted | long]

Syntax Description

m/	(Optional) Module number of the supervisor engine containing the Flash device.
device:	(Optional) Device where the Flash resides.
filename	(Optional) Name of the configuration file.
all	(Optional) Keyword to display all files, deleted or not.
deleted	(Optional) Keyword to display only deleted files.
long	(Optional) Keyword to display files that have not been deleted, in long format.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal and privileged.

Usage Guidelines

A colon (:) is required after the specified device.

This command applies only to the Supervisor Engine III and the Catalyst 4000 and 2948G series switch supervisor engine modules. If you attempt to run this command on a Supervisor Engine I or II, you will receive an error message.

When you omit all keywords (all, deleted, or long), the system displays file information in short format. Short format output is explained in :

Table 2-1

Column Heading	Description
#	File index number
length	File length
date/time	Date and time the file was created
name	Filename

Short Format

When you use one of the keywords (all, deleted, or long), the system displays file information in long format. The long format is shown in :

Table 2-2 Long Format

Column Heading	Description
#	File index number
ED	Letter to indicate whether the file contains an error (E) or is deleted (D)
type	File type (1 = configuration file, 2 = image file); when the file type is unknown, the system displays a zero or FFFFFFFF in this field
crc	File cyclic redundancy check
seek	Offset into the file system of the next file
nlen	Filename length
length	File length
date/time	Date and time the file was created
name	Filename

Examples

This example shows how to display the file information in short format:

Console> (enable) dir

-#- -length- -----date/time------ name

  2  3093399 Oct 18 1998 12:33:14 cat5000-sup3.4-5-1.bin

1428272 bytes available (6173904 bytes used)

Console> (enable)

This example shows how to display the file information in long format:

Console> (enable) dir long

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name

  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 
cat5000-sup3.4-5-1.bin

1428272 bytes available (6173904 bytes used)

Console> (enable)

This example shows the file with index number 1 deleted:

Console> (enable) dir all

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name

  1 .D ffffffff 5415406e  3300b8   25  3080247 Jun 12 1998 13:22:46 
cat5000-sup3.4-5-1.bin

  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 
cat5000-sup3.4-5-1.bin

1428272 bytes available (6173904 bytes used)

Console> (enable)

Related Command

show flash

disable—ATM

Use the disable command to exit privileged EXEC mode and return to user EXEC mode. After executing this command, the angle-bracket (>) prompt appears.

disable [level]

Syntax Description

level

(Optional) Option to reduce the privilege level.

Default

This command has no default setting.

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Usage Guidelines

This command is not supported by the Catalyst 4000 and 2948G series switches.

Use this command with the level option to reduce the privilege level. If you do not specify a level, it defaults to the user EXEC mode, which is level 1.

Example

This example shows how to cause the system to exit privileged EXEC mode and return to user EXEC mode, as indicated by the angle bracket (>) prompt:

ATM#disable

ATM>

Related Command

enable—ATM

disable—switch

Use the disable command to return to normal mode from privileged mode.

disable

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to return to normal mode:

Console> (enable) disable

Console> 

Related Command

enable—switch

disconnect

Use the disconnect command to close an active console port or Telnet session.

disconnect {ip_addr | console}

Syntax Description

ip_addr	IP address or IP alias.
console	Keyword to denote an active console port.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If multiple sessions from the same IP address exist, the disconnect command checks if the current process is also from the same IP address. If it is not, all Telnet sessions from the specified IP address are disconnected. If it is, all sessions, other than the current session, are disconnected. The system prompts whether to disconnect the current Telnet session. You can answer n and remain connected or answer y and be disconnected.

ip_addr is an IP alias or and IP address in dot notation, for example, 101.102.103.104.

Examples

This example shows how to close a Telnet session to host 198.134.214.4:

Console> (enable) disconnect 198.134.214.4

Telnet session from 198.134.214.4 disconnected. (1)

Console> (enable)

This example shows how to close the current console session:

Console> (enable) disconnect console

Console session disconnected.

Console> (enable)

Related Command

telnet

display-databases

Use the display-databases command to display all the LECS database tables.

display-databases

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Cisco IOS ATM command.

Command Mode

Database configuration.

Usage Guideline

This command is not supported by the Catalyst 4000 and 2948G series switches.

Example

This example shows how to display all the LECS database tables:

ATM(lane-config-database)#display-databases

  eng_dbase

  display-databases   <----- config table in context