use configuration

use configuration file-name

Description

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

Syntax Description

file-name

Specifies an existing user-defined configuration file name (displays a list of available user-defined configuration files).

Default

N/A.

Usage Guidelines

Note

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:

The selected configuration file is now “<file-name>.cfg”. By default, this file will be used for saving the configuration which will take effect after the next switch reboot.

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:

save configuration test1

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 specifying a local filename, the switch permits only the following characters:
  • Alphabetical letters, upper case and lower case (A-Z, a-z)

  • Numerals (0-9)

  • Period ( . )

  • Dash ( - )

  • Underscore ( _ )

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

Example

The following command specifies that the next reboot should use the saved configuration file named XOS1.cfg:

use configuration XOS1

The following command specifies that the next reboot should use the configuration saved in the primary partition:

use configuration primary

History

This command was first available in ExtremeXOS 10.1.

Platform Availability

This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.