Table Of Contents
Boot Configuration Mode Commands
(config-boot) gateway address
(config-boot) ip address
(config-boot) no
(config-boot) passive
passive gateway address
passive ip address
passive primary boot-file
passive primary boot-type
passive primary config-path
passive secondary boot-file
passive secondary boot-type
passive secondary config-path
passive subnet mask
passive sync
(config-boot) primary
primary boot-file
primary boot-type
primary config-path
(config-boot) reboot
(config-boot) remove
(config-boot) remove-gui
(config-boot) secondary
secondary boot-file
secondary boot-type
secondary config-path
(config-boot) shutdown
(config-boot) subnet mask
(config-boot) unpack
(config-boot) unpack-gui
Boot Configuration Mode Commands
Boot configuration mode contains all commands necessary to manage booting the CSS and to maintain the software revision. To access this mode, use the boot command from global configuration mode.
(config) boot
The prompt changes to (config-boot). For information about commands available in this mode, see the following commands.
(config-boot) gateway address
To configure a management port default gateway to load a boot file on a CSS across different subnets, use the gateway address command. To change the IP address, reenter this command. Use the no form of this command to disable the default gateway address by setting the IP address to 0.0.0.0.
gateway address ip_or_host
no gateway address
Syntax Description
ip_or_host
|
IP address for the management port gateway. Enter the IP address in dotted-decimal notation (for example, 192.168.11.1) or mnemonic host-name format (for example, myhost.mydomain.com).
|
Usage Guidelines
If you have a second SCM installed in a CSS 11800, use the passive gateway address command to configure the Management Port gateway address on the passive SCM boot-config.
The gateway address command has an effect only in an Offline DM boot operation and not in the running-config.
A gateway address of 0.0.0.0 for the Ethernet management port does not appear in the show boot-config command output for the CSS boot configuration.
Related Commands
show boot-config
(config-boot) passive
(config-boot) ip address
To configure the system boot IP address, use the ip address command. To change the boot IP address, reenter this command.
ip address ip_or_host
Syntax Description
ip_or_host
|
IP address used upon boot. Enter the IP address in dotted-decimal notation (for example, 192.168.11.1) or mnemonic host-name format (for example, myhost.mydomain.com).
Do not enter an all zero IP address.
|
Related Commands
(config-boot) subnet mask
(config-boot) no
To negate a command or set it to its default, use the no command. Not all commands have a no form. For information on general no commands you can use in this mode, see the general no command.
Syntax Description
no gateway address
|
Disables the default gateway address by setting the IP address to 0.0.0.0
|
no passive primary boot-file
|
Removes the primary boot file from the passive SCM
|
no passive primary boot-type
|
Removes the primary boot type from the passive SCM
|
no passive secondary boot-file
|
Removes the secondary boot file from the passive SCM
|
no passive secondary boot-type
|
Removes the secondary boot type from the passive SCM
|
no primary boot-file
|
Removes the primary boot file
|
no primary boot-type
|
Removes the primary boot type
|
no primary config-path
|
Removes the primary network configuration path
|
no secondary boot-file
|
Removes the secondary boot file
|
no secondary boot-type
|
Removes the secondary boot type
|
no secondary config-path
|
Removes the secondary network configuration path
|
(config-boot) passive
To configure the boot configuration record for the current passive SCM, use the passive command. The boot configuration record consists of the IP address, subnet mask, boot method, and boot file.
The options for this boot mode command are:
•
passive gateway address - Configures a management port default gateway to load a boot file on a CSS across different subnets for the passive SCM.
•
passive ip address - Configures the system boot IP address for the passive SCM.
•
passive primary boot-file - Specifies the primary boot file for the passive SCM.
•
passive primary boot-type - Specifies the primary boot method, local disk, FTP, or network-mounted file system via FTP, for the passive SCM.
•
passive primary config-path - Specifies the primary alternate path to a network CSS configuration for the passive SCM.
•
passive secondary boot-file - Specifies the secondary boot file for the passive SCM.
•
passive secondary boot-type - Specifies the secondary boot method, local disk, FTP, or network-mounted file system via FTP, for the passive SCM.
•
passive secondary config-path - Specifies the secondary alternate path to a network CSS configuration for the passive SCM.
•
passive subnet mask - Configures the system boot subnet mask for the passive SCM.
•
passive sync - Copies the boot configuration record from the active SCM to the passive SCM. For the CSS 11506, the passive sync command also copies the start configuration and the clock time from the active SCM to the passive SCM.
Usage Guidelines
The passive command also allows you to configure the individual components of the boot configuration record on the passive SCM. For example, you can configure a boot record on the passive SCM that has a software version that differs from the active SCM. This allows you to run a new software version on the active SCM with the security of having an older software version on the passive SCM.
You can also configure a different IP address on the passive SCM to track an active-to-passive state transition between the SCMs. You can accomplish this through a management station where you can receive SNMP host traps.
Note
The passive command and its options only affect the current passive SCM. When you configure the passive SCM, the set values are loaded into its nonvolatile RAM. If the passive SCM transitions to the active state, it continues to retain these values but is no longer affected by these commands; boot commands are not saved in the running-config.
For more information on the passive command options and associated variables, see the following commands.
passive gateway address
To configure a management port default gateway to load a boot file on a CSS across different subnets for the passive SCM, use the passive gateway address command. To change the IP address, reenter this command.
passive gateway address ip_or_host
Syntax Description
ip_or_host
|
IP address for the management port gateway. Enter the IP address in dotted-decimal notation (for example, 192.168.11.1) or mnemonic host-name format (for example, myhost.mydomain.com).
Do not enter an all zero IP address.
|
Related Commands
(config-boot) gateway address
passive ip address
To configure the system boot IP address for the passive SCM, use the passive ip address command. To change the boot IP address, reenter this command.
passive ip address ip_or_host
Syntax Description
ip_or_host
|
IP address for the passive SCM used upon boot. Enter the IP address in dotted-decimal notation (for example, 192.168.11.1) or mnemonic host-name format (for example, myhost.mydomain.com).
Do not enter an all zero IP address.
|
Command Modes
Boot
passive primary boot-file
To specify the primary boot image for the passive SCM, use the passive primary boot-file command. Use the no form of this command to remove the primary boot file from the passive SCM.
passive primary boot-file filename
no passive primary boot-file
Syntax Description
filename
|
Filename of the primary boot image for the passive SCM. Enter an unquoted text string with no spaces and a maximum length of 64 characters. To see a list of boot filenames, enter:
passive primary boot-file ?
|
Command Modes
Boot
passive primary boot-type
To specify the primary boot method for the passive SCM, use the passive primary boot-type command. The method is from either the CSS software on the CSS disk or a network-mounted file system, or to install the CSS software from an FTP server onto the CSS disk and then boot the CSS from the drive. Use the no form of this command to remove the primary boot type from the passive SCM.
passive primary boot-type [boot-via-disk|boot-via-ftp ftp_record|
boot-via-network ftp_record]
no passive primary boot-type
Syntax Description
boot-via-disk
|
Boots the CSS from its disk.
|
boot-via-ftp
|
Installs the CSS software on the CSS disk and boots the CSS. The CSS accesses an .ADI or GZIP file containing the CSS software from an FTP server, copies it to its disk, and unpacks it. Then the CSS boots from the disk.
|
ftp_record
|
Name of the FTP record file that contains the IP address, username, and password for the FTP server. Enter an unquoted text string with no spaces.
|
boot-via-network
|
Boots the system from a network-mounted file system via FTP. Instead of the CSS disk, the network file system contains the CSS software. The CSS boots from this file system and loads the configuration into memory.
|
Command Modes
Boot
Usage Guidelines
Be aware of the following network boot restrictions:
•
A network boot is not supported on UNIX workstations.
•
The War-FTP daemon is not supported for network-booting the system software.
A network boot requires that the CSS contains an operational disk.
passive primary config-path
To specify the alternate path to a network configuration for the network boot method for the passive SCM, use the passive primary config-path command. An alternate configuration path allows multiple CSSs to use the same boot image while keeping their configuration information in separate directories. Use the no form of this command to remove the primary network configuration path.
passive primary config-path path
no passive primary config-path
Syntax Description
path
|
Path to use for network configuration. Enter an unquoted text string with no spaces and a maximum length of 64 characters.
|
Command Modes
Boot
Usage Guidelines
When using an alternate configuration path, make sure that the path leads to a directory containing the script, log and info subdirectories, and the startup-config file. These subdirectories must contain the files in the corresponding subdirectories in the unZipped boot image. Create these subdirectories. Then copy the files from the boot image.
Note
The CSS must be able to access the configuration path through an FTP server as defined through the FTP record for the network boot method.
passive secondary boot-file
To specify the secondary boot image for the passive SCM, use the passive secondary boot-file command. Use the no form of this command to remove the secondary boot file from the passive SCM.
passive secondary boot-file filename
no passive secondary boot-file
Syntax Description
filename
|
Filename of the primary boot image. Enter an unquoted text string with no spaces and a maximum length of 64 characters. To see a list of boot filenames, enter:
passive primary boot-file ?
|
Command Modes
Boot
passive secondary boot-type
To specify the secondary boot method for the passive SCM, use the passive secondary boot-type command. The method is from either the CSS software on the CSS disk or a network-mounted file system, or to install the CSS software from an FTP server onto the CSS disk and then boot the CSS from the drive. Use the no form of this command to remove the secondary boot type from the passive SCM.
passive secondary boot-type [boot-via-disk|boot-via-ftp
ftp_record|boot-via-network ftp_record]
no passive secondary boot-type
Syntax Description
boot-via-disk
|
Boots the CSS from its disk.
|
boot-via-ftp
|
Installs the CSS software on the CSS disk and boots the CSS. The CSS accesses an .ADI or GZIP file containing the CSS software from an FTP server, copies it to its disk, and unpacks it. Then the CSS boots from the disk.
|
ftp_record
|
Name of the FTP record file that contains the IP address, username, and password for the FTP server. Enter an unquoted text string with no spaces.
|
boot-via-network
|
Boots the system from a network-mounted file system via FTP. Instead of the CSS disk, the network file system contains the CSS software. The CSS boots from this file system and loads the configuration into memory.
|
Command Modes
Boot
Usage Guidelines
Be aware of the following network boot restrictions:
•
A network boot is not supported on UNIX workstations.
•
The War-FTP daemon is not supported for network-booting the system software.
A network boot requires that the CSS contains an operational disk.
passive secondary config-path
To specify the secondary alternate path to a network configuration for the network boot method for the passive SCM, use the passive secondary config-path command. Use the no form of this command to remove the secondary network configuration path.
passive secondary config-path path
no passive secondary config-path
Syntax Description
path
|
Path to use for network configuration. Enter an unquoted text string with no spaces and a maximum length of 64 characters.
|
Command Modes
Boot
Usage Guidelines
An alternate configuration path allows multiple CSSs to use the same boot image while keeping their configuration information in separate directories.
Note
The CSS must be able to access the configuration path through an FTP server as defined through the FTP record for the network boot method.
When using an alternate configuration path, make sure that the path leads to a directory containing the script, log and info subdirectories, and the startup-config file. These subdirectories must contain the files in the corresponding subdirectories in the unZipped boot image. Create these subdirectories. Then copy the files from the boot image.
passive subnet mask
To configure the system boot subnet mask for the passive SCM, use the passive subnet mask command.
passive subnet mask mask
Syntax Description
mask
|
Subnet mask used at boot. Enter the mask in dotted-decimal notation (for example, 255.255.255.0).
|
Command Modes
Boot
passive sync
To copy the primary and secondary boot configuration record from the nonvolatile RAM (NVRAM) of the active Switch Control Module (SCM) to its passive SCM backup, use the passive sync command. For the CSS 11506, the passive sync command also copies the boot configuration, boot image, startup configuration, or the clock time from the active SCM to the passive SCM.
passive sync {boot-config|image|startup-config|time}
Syntax Description
boot-config
|
Copies the boot configuration record from the active SCM to the passive SCM (CSS 11506 only).
|
image
|
Copies the boot image and local startup configuration file from the active SCM to the passive SCM (CSS 11506 only).
|
startup-config
|
Copies the startup configuration file and archive directory from the active SCM to the passive SCM (CSS 11506 only).
|
time
|
Synchronizes the clock time of the passive SCM with the active SCM (CSS 11506 only).
|
Command Modes
Boot
Related Commands
show chassis
(config-boot) primary
To specify the primary boot configuration, use the primary command. The options for this boot mode command are:
•
primary boot-file - Specifies the primary boot file
•
primary boot-type - Specifies the primary boot method, local disk, via FTP, or a network-mounted file system via FTP
•
primary config-path - Specifies the alternate path to a network CSS configuration
For more information on these options and associated variables, see the following commands.
Related Commands
(config) ftp-record
(config-boot) secondary
primary boot-file
To specify the primary boot image, use the primary boot-file command. Use the no form of this command to remove the primary boot file.
primary boot-file filename
no primary boot-file
Syntax Description
filename
|
Filename of the primary boot image. Enter an unquoted text string with no spaces and a maximum length of 64 characters. To see a list of boot filenames, enter:
|
Command Modes
Boot
primary boot-type
To specify the primary boot method, use the primary boot-type command. The method is from either the CSS software on the CSS disk or a network-mounted file system, or to install the CSS software from an FTP server onto the CSS disk and then boot the CSS from the drive. Use the no form of this command to remove the primary boot type.
primary boot-type [boot-via-disk|boot-via-ftp ftp_record|
boot-via-network ftp_record]
no primary boot-type
Syntax Description
boot-via-disk
|
Boots the CSS from its disk.
|
boot-via-ftp
|
Installs the CSS software on the CSS disk and boots the CSS. The CSS accesses an .ADI or GZIP file containing the CSS software from an FTP server, copies it to its disk, and unpacks it. Then the CSS boots from the disk.
|
ftp_record
|
Name of the FTP record file that contains the IP address, username, and password for the FTP server. Enter an unquoted text string with no spaces.
|
boot-via-network
|
Boots the system from a network-mounted file system via FTP. Instead of the CSS disk, the network file system contains the CSS software. The CSS boots from this file system and loads the configuration into memory.
|
Command Modes
Boot
Usage Guidelines
Be aware of the following network boot restrictions:
•
A network boot is not supported on UNIX workstations.
•
The War-FTP daemon is not supported for network-booting the system software.
A network boot requires that the CSS contains an operational disk.
primary config-path
To specify the alternate path to a network configuration for the network boot method, use the primary config-path command. Use the no form of this command to remove the primary network configuration path.
primary config-path path
no primary config-path
Syntax Description
path
|
Path to use for network configuration. Enter an unquoted text string with no spaces and a maximum length of 64 characters.
|
Command Modes
Boot
Usage Guidelines
An alternate configuration path allows multiple CSSs to use the same boot image while keeping their configuration information in separate directories.
Note
The CSS must be able to access the configuration path through an FTP server as defined through the FTP record for the network boot method.
When using an alternate configuration path, make sure that the path leads to a directory containing the script, log and info subdirectories, and the startup-config file. These subdirectories must contain the files in the corresponding subdirectories in the unZipped boot image. Create these subdirectories. Then copy the files from the boot image.
(config-boot) reboot
To reboot the CSS, use the reboot command.
reboot
Usage Guidelines
Before you enter the reboot command, save an existing running-config file prior to rebooting the CSS by using the copy running-config startup-config command from SuperUser mode. If you are not in expert mode, the CSS displays the prompts to save profile and configuration changes before it reboots.
The CSS displays a prompt to verify that you want to reboot it:
Are you sure you want to reboot the system, [y/n]
Enter y to reboot the CSS.
The CSS has a reboot alias that allows you to reboot it from any mode except User mode. When you issue the reboot alias, the CSS changes the current mode to Boot mode and then executes the reboot command.
You must enter the entire reboot alias name to execute it. The CSS does not automatically complete the reboot alias when you enter only part of its name. For example, if you enter reb in global configuration mode, the CSS displays an invalid command message.
(config-boot) remove
To remove an ArrowPoint Distribution Image (ADI) file from the CSS or a version of CSS software that is currently not running on the CSS, use the remove command.
remove {disk_slot} software
Syntax Description
disk_slot
|
(Optional) Slot location of the disk in a CSS. The valid entries are:
• 0 for the disk in slot 0
• 1 for the disk in slot 1
|
software
|
Filename of the ADI or the version of software installed on the CSS. Enter an unquoted text string with a maximum length of 32 characters. To see a list of CSS software versions and ADI files on the CSS, enter:
|
Related Commands
(config-boot) unpack
(config-boot) remove-gui
To remove CiscoView Device Manager (CVDM) from the CSS, use the remove-gui command.
remove-gui
Related Commands
(config-boot) unpack-gui
(config-boot) secondary
To specify the secondary boot configuration, use the secondary command. The secondary boot configuration is used when the primary configuration fails. The options for this boot mode command are:
•
secondary boot-file - Specifies the secondary boot file
•
secondary boot-type - Specifies the boot method, local disk or FTP
•
secondary config-path - Specifies the path to a network configuration via FTP
For more information on these options and associated variables, see the following commands.
Related Commands
(config) ftp-record
(config-boot) primary
secondary boot-file
To specify the secondary boot image, use the secondary boot-file command. Use the no form of this command to remove the secondary boot file.
secondary boot-file filename
no secondary boot-file
Syntax Description
filename
|
Filename of the primary boot image. Enter an unquoted text string with no spaces and a maximum length of 64 characters. To see a list of boot filenames, enter:
|
Command Modes
Boot
secondary boot-type
To specify the secondary boot method, use the secondary boot-type command. The method is either from the CSS software on the CSS disk or a network-mounted file system, or to install the CSS software from an FTP server onto the CSS disk and then boot the CSS from the drive. Use the no form of this command to remove the secondary boot type.
secondary boot-type [boot-via-disk|boot-via-ftp ftp_record
|boot-via-network ftp_record]
no secondary boot-type
Syntax Description
boot-via-disk
|
Boots the CSS from its disk.
|
boot-via-ftp
|
Installs the CSS software on the CSS disk and boots the CSS. The CSS accesses an .ADI or GZIP file containing the CSS software from an FTP server, copies it to its disk, and unpacks it. Then the CSS boots from the disk.
|
ftp_record
|
Name of the FTP record file that contains the IP address, username, and password for the FTP server. Enter an unquoted text string with no spaces.
|
boot-via-network
|
Boots the CSS from a network-mounted file system on via FTP. Instead of the CSS disk, the network file system contains the CSS software. The CSS boots from this file system and loads the configuration into memory.
|
Command Modes
Boot
Usage Guidelines
Be aware of the following network boot restrictions:
•
A network boot is not supported on UNIX workstations.
•
The War-FTP daemon is not supported for network-booting the system software.
A network boot requires that the CSS contains an operational disk.
secondary config-path
To specify the alternate path to a network configuration for the network boot method, use the secondary config-path command. Use the no form of this command to remove the secondary network configuration path.
secondary config-path path
no secondary config-path
Syntax Description
path
|
Path to use for network configuration. Enter an unquoted text string with no spaces and a maximum length of 64 characters.
|
Command Modes
Boot
Usage Guidelines
An alternate configuration path allows multiple CSSs to use the same boot image while keeping their configuration information in separate directories.
Note
The CSS must be able to access the configuration path through an FTP server as defined through the FTP record for the network boot method.
When using an alternate configuration path, make sure that the path leads to a directory containing the script, log and info subdirectories, and the startup-config file. Create these subdirectories. These subdirectories must contain the files in the corresponding subdirectories in the unZipped boot image. Copy the files from the boot image.
(config-boot) shutdown
To shut down the CSS, use the shutdown command.
shutdown
Usage Guidelines
The CSS displays a prompt to verify that you want to shut it down:
Are you sure you want to shutdown the system, [y/n]:
Enter y to shut down the CSS.
The CSS has a shutdown alias that allows you to shut it down from any mode except User mode. When you issue the shutdown alias, the CSS changes the current mode to Boot mode and then executes the shutdown command.
You must enter the entire shutdown alias name to execute it. The CSS does not automatically complete the shutdown alias when you enter only part of its name. For example, if you enter shutd in global configuration mode, the CSS displays an invalid command message.
(config-boot) subnet mask
To configure the system boot subnet mask, use the subnet mask command.
subnet mask mask
Syntax Description
mask
|
Subnet mask used at boot. Enter the mask in dotted-decimal notation (for example, 255.255.255.0).
|
Related Commands
(config-boot) ip address
(config-boot) unpack
To unpack the ArrowPoint Distribution Image (ADI), use the unpack command.
unpack install_filename
Syntax Description
install_filename
|
Filename of the ADI
|
Related Commands
(config-boot) remove
(config-boot) unpack-gui
To unpack the CiscoView Device Manager (CVDM) on the CSS, use the unpack-gui command.
unpack-gui cvdm_filename
Syntax Description
cvdm_filename
|
CVDM zip filename
|
Related Commands
(config-boot) remove-gui