use configuration

use configuration [primary | secondary | file_name]


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

Syntax Description


Specifies the configuration file named primary.cfg.


Specifies the configuration file named secondary.cfg.


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



Usage Guidelines

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


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


This command was first available in ExtremeXOS 10.1.

Platform Availability

This command is available on all platforms.