cc/td/doc/product/lan/cat5000/rel_4_4
hometocprevnextglossaryfeedbacksearchhelp
PDF

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.3-1-1.bin]?
Enter destination file name [cat4000-sup.3-1-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.3-1-1.bin configuration file from the Flash device and then verify deletion by entering the show flash command:

Console> (enable) delete bootflash:cat5000-sup3.3-1-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
.3-1-1.bin
  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 cat5000-sup3
.4-1-1.bin
 
1428272 bytes available (6173904 bytes used)
Console> (enable)
Related Commands

dirswitch
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:


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:


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-1-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-1-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.3-1-1.bin
  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 cat5000-sup3.4-1-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

enableATM

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

enableswitch

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


hometocprevnextglossaryfeedbacksearchhelp

Copyright 1989-1999©Cisco Systems Inc.