Catalyst 6500 Series Command Reference, 8.7
download to enable
Download this chapter
download to enabledownload to enable
Download the complete book
Catalyst 6500 Series Switch Command Reference (Book-length PDF)Catalyst 6500 Series Switch Command Reference (Book-length PDF) (PDF - 9 MB)
give_us_feedback

Table Of Contents

download

enable


download

To copy a software image from a specified host to the Flash memory of a designated module, use the download command.

download host file [mod] [rcp]

download serial

download vmps

download boot flash_device:filename mod_num

download epld file [mod [force]]

Syntax Description

host

Name or IP address of host.

file

Name of file to be downloaded.

mod

(Optional) Number of the module to receive the downloaded image.

rcp

(Optional) Specifies rcp as the file transfer method.

serial

Specifies download through a serial port.

vmps

Downloads VMPS.

boot

Downloads an image to the boot ROM of a module.

flash_device:filename

Name of the software image to be downloaded.

mod_num

Number of the module to receive the downloaded image.

epld

Updates the module's Erasable Programmable Logic Device (EPLD) image file.

file

Name of the EPLD image file.

force

(Optional) Updates the existing EPLD image file on the module with the new EPLD image regardless of the version of the existing image.


Defaults

If a module number is not specified, the image is downloaded to all modules for which the image is valid.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Catalyst 6500 series switches download new code to the processors using Kermit serial download through the EIA/TIA-232 console port.

The download command downloads code to the module Flash memory. Catalyst 6500 series switch software rejects an image if it is not a valid image for the module.

The download serial command uses Kermit through the serial EIA/TIA-232 console port. The download serial command is not allowed from a Telnet session.

Before you can execute the download vmps command successfully, you must use the set vmps downloadserver command to configure the IP address of the TFTP server and the name of the VMPS configuration file on that server. If the IP address of the TFTP server is not configured, the download vmps command reports an error. If the configuration filename is not configured, the download vmps command uses the default filename vmps-config-database.1.

The VMPS backup file is overwritten each time a new VMPS configuration is downloaded from the TFTP server by means of a VMPS server reboot or because the download vmps command or set vmps state {disable | enable} command was entered. If there are not enough resources to build the new configuration database, the VMPS is made inactive.

If you specify the module number, the download goes to the specified module, but the download will fail if the module is a different type from the one that is indicated by the download header. If you do not specify the module number, the download goes to all modules of that type.

Caution After starting the serial download using Kermit, do not attempt to abort the serial download by pressing Ctrl-C. Pressing Ctrl-C interrupts the download process and could affect the functionality of the switch. If the functionality of the switch is affected as a result of pressing Ctrl-C, reboot the switch.

If you enter the download epld file command without specifying a module, the new EPLD image is downloaded to all compatible modules where the new EPLD image version is greater than the existing version on the module. If the download epld file mod command is used with the force keyword, the existing EPLD image on a module is upgraded with the new EPLD image regardless of the version level of the existing image.

Caution If you remove the module while the EPLD image is updating, the module might not come back online.

Examples

This example shows how to download the c6000_spv11.bin file from the mercury host to the supervisor engine (by default): 

Console> (enable) download mercury c6000_spv11.bin

Download image c6000_spv11.bin from mercury to module 1FLASH (y/n) [n]? y

\

Finished network single module download. (2418396 bytes)

FLASH on Catalyst:


Type            Address             Location

Intel 28F008    20000000            NMP (P3) 4MB SIM


Erasing flash sector...done.

Programming flash sector...done.

Erasing flash sector...done.

Programming flash sector...done.

The system needs to be reset to run the new image.

Console> (enable)

This example shows how to download the acpflash_1111.bbi file from the mercury host to module 3: 

Console> (enable) download mercury acpflash_1111.bbi 3

This command will reset Module 3.

Download image acpflash_1111.bbi from mercury to Module 3 FLASH (y/n) [n]? y

/

Done.  Finished network download.  (1964012 bytes)

Console> (enable)

This sample session shows how to connect to a remote terminal from a Sun workstation and how to use the download serial command to copy a software image to the supervisor engine: 

[At local Sun workstation]

host% kermit

C-Kermit 5A(172) ALPHA, 30 Jun 95, SUNOS 4.0 (BSD)

Type ? or 'help' for help

C-Kermit> set line /dev/ttyb

C-Kermit> c     

Connecting to /dev/ttyb, speed 9600.

The escape character is ^ (ASCII 28).

Type the escape character followed by C to get back,

or followed by ? to see other options.

Console> enable

Enter Password: 

Console> (enable) set system baud 19200

^\C

[Back at local Sun workstation]

C-Kermit> set speed 19200

/dev/ttyb, 19200 bps

C-Kermit> c

Connecting to /dev/ttyb, speed 19200.

The escape character is ^ (ASCII 28).

Type the escape character followed by C to get back,

or followed by ? to see other options.

Console> (enable) download serial

Download Supervisor image via console port (y/n) [n]? y


Concentrator Boot ROM (Ver 1.00)

Waiting for DOWNLOAD!!

Return to your local Machine by typing its escape sequence

Issue Kermit send command from there[ Send `Filename`]

^\C

[Back at Local System]

C-Kermit> send c6000_xx.bin

                          SF

c6000_xx.bin => C6000_XX.BIN, Size: 1233266

X to cancel file,  CR to resend current packet

Z to cancel group, A for status report

E to send Error packet, Ctrl-C to quit immediately: ..........................

...............................................................................


...... [OK]

ZB

C-Kermit> quit

host%

This example shows how to download a ROM image to module 9: 

Console> (enable) download boot bootflash:boot542.ubin 9

Warning!! This command replaces the existing boot code on Module 9.

Please verify with TAC that the file specified is appropriate for WS-X6408-GBIC.

Use this command with caution.

Do you want to continue (y/n) [n]? y

Download boot image start...

Download boot code completed.

Console> (enable)

This example shows how to upgrade the EPLD image in force mode on the module in slot 5: 

Console> (enable) download epld aq_cr128_art.bin 5 force

CCCCCC

Device found requiring upgrade in slot 5.

########################################################

#                   W A R N I N G                      #

#                                                      #

# Any disruptions to the module during programming may #

# leave the module or system in an inconsistent state. #

# Please ensure that the system or module does not get #

# switched off or reset during the programming process.#

# Programming may take a minute or two, depending on   #

# the number of devices updated.  Please wait for the  #

# module to come back online before continuing.        #

#                                                      #

#                   W A R N I N G                      #

########################################################

This command may reset module 5.

Updating fabric modules may significantly affect system performance while the update is 

occurring.

Do you wish to update the devices in slot 5 (y/n) [n]? y


Updating programmable devices in slot 5.  This may take a minute...

  JAM Message -> Device #1 Silicon ID is ALTERA98(00)

  JAM Message -> programming 7K device(s)...

  JAM Message -> verifying 7K device(s)...

  JAM Message -> DONE

Programming successful, updating EPLD revisions.

2002 Aug 09 06:32:22 %SYS-4-NVLOG:EpldUpdate:Module 5 EPLD A updated from rev 1 to rev 1

Waiting for module to come online.

..........2002 Aug 09 06:32:33 %SYS-5-MOD_OK:Module 5 is online

.

################################################################################

                E P L D   P R O G R A M M I N G   C O M P L E T E

    Found 1 devices requiring upgrades, 1 attempted, 1 updated, 0 failed

################################################################################

Console> (enable) 2002 Aug 09 06:32:34 %SYS-4-NVLOG:EpldUpdate:Module 5 EPLD A s

prom updated to rev 1

Console> (enable)

Related Commands

reset—switch
set system supervisor-update
show flash
show rcp
show system supervisor-update
show version
show vmps

enable

To activate privileged mode, use the enable command. In privileged mode, additional commands are available, and certain commands display additional information.

enable

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Normal.

Usage Guidelines

The (enable) in the prompt indicates that the system is in privileged mode and that commands can be entered.

Examples

This example shows how to enter privileged mode: 

Console> enable

Enter password:

Console> (enable)

Related Commands

disable