configure

Use this command to execute a previously downloaded configuration file stored on the device.

Syntax

configure filename [append] [chassis-id chassis-id]

Parameters

filename Specifies the path and file name of the configuration file to execute.
append (Optional) Executes the configuration as an appendage to the current configuration. This is equivalent to typing the contents of the config file directly into the CLI and can be used, for example, to make incremental adjustments to the current configuration.
chassis-id (Optional) Specifies the replacement chassis ID in the VSB system the configuration file is being applied to. The original chassis ID was set using set bonding chassis (S-, 7100-Series).

Defaults

If append is not specified, the current running configuration will be replaced with the contents of the configuration file, which will result in an automatic reset of the chassis.

If chassis-id is not specified on an S- and 7100-Series device for a VSB system, see the usage section below for a discussion of chassis ID precedence rules.

Mode

All command modes.

Usage

If C2 security mode is enabled, a non-append version of the configure command can not be accessed while in Read-Write or Read-Only user mode.

On an S- and 7100-Series device, the configure command is not allowed if an HA upgrade is pending.

A VSB configuration file contains chassis specific information such as the chassis serial-number. When configuring a replacement VSB chassis with an already existing VSB configuration file, you must specify the chassis ID of the replacement chassis so that chassis specific information on the specified chassis will be ignored and replaced in the configuration file with the correct chassis settings. Use the chassis-id option to specify a replacement VSB system chassis.

There are four rules of chassis ID precedence that determine the chassis ID selection when applying a configuration file to a VSB system (from high precedence to low precedence):

  1. If bonding is already enabled, and the chassis is active, the active chassis ID is used
  2. The chassis ID specified using the configure command chassis-id option is used
  3. The chassis ID specified in the configuration file that contains a serial-number matching the device serial number is used
  4. The lowest chassis ID specified in the configuration file is used

Examples

This example shows how to execute the “myconfig” file on the USB device connected to the USB port associated with the module in slot 1:

System(rw)->configure slot1/usb2/myconfig

This S- and 7100-Series example shows how to execute the “myconfig” file on the USB device connected to the USB port associated with a replacement chassis 2 in a VSB system:

System(rw)->configure slot1/usb1/myconfig chassis-id 2