use configuration

Description

Configures the switch to use a previously saved configuration on the next reboot.

Syntax Description

Default

N/A.

Usage Guidelines

Note

When the switch boots up after executing this command, examine the log to determine if a subsequent save and reboot of the switch or slot is necessary for the configuration to be correctly applied.

In rare cases, this command requires a second reboot for all configuration settings to take effect. This is because certain configuration settings are required for hardware initialization and are stored in the switch's non-volatile storage, as well as the configuration file. These settings include: configure forwarding internal-tables and configure ports partition Therefore, when the configuration file selected by this command has different values for the above settings, a message is logged explaining that a save and reboot are required.

XML-based configuration files have a .cfg file extension. When you enter the name of the file in the CLI, the system automatically adds the .cfg file extension.

Do not use this command with ASCII-formatted configuration files. Those configuration files have an .xsf file extension. For more information about using and saving ASCII-formatted configuration files see the upload configuration [hostname |ipaddress] filename {vr vr-name } and the load script filename {arg1} {arg2} ... {arg9} commands.

There is no special significance to the primary and secondary configurations. They are just conveniences to specify the files primary.cfg and secondary.cfg.

When you configure the switch to use a previously saved configuration, the switch displays the following message:

You can create a new configuration file by saving your current switch configurations and using that file on the next reboot. For example, to create a new configuration named test1 based on your current CLI session and switch configurations, use the following command:

Tracking and Displaying Switch Configuration Files

To keep track of your configuration file names, use the ls command to display the files saved on your switch. Files with the .cfg extension are configuration files. In addition, you can see a list of available configuration files when you use the use configuration command.

The following is sample output from this command (“test” and “XOS1” are the names of the user-created and defined configurations):

exsh.1 # use configuration
primary         Primary configuration file
secondary       Secondary configuration file
<file-name>     Configuration file name
"test" "XOS1"

You can also use the ls command to display a list of the current configuration and policy files in the system.

Displaying the Active Configuration

To view the currently active, running configuration, use the show switch command.

Local Filename Character Restrictions

This section provides information about the characters supported by the switch for local filenames.

When naming a local file, remember the requirements listed above.

History

This command was first available in ExtremeXOS 10.1.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, and X695 series switches.