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.

•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 passivegateway address command. To change the IP address, reenter this command.

Command Modes

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 passiveprimary 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.

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 passiveprimary 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 passivesecondary 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 passivesecondary 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.

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 passivesecondary 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

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 passivesync 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).

Related Commands

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:

primary boot-file ?

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.

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

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:

secondary boot-file ?

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.

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.