use configuration
Description
Configures the switch to use a previously saved configuration on the next reboot.
Syntax Description
primary |
Specifies the configuration file named primary.cfg. |
secondary |
Specifies the configuration file named secondary.cfg. |
file_name |
Specifies an existing user-defined configuration file name (displays a list of available user-defined configuration files). |
Default
N/A.
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 test1Tracking 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.
-
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 all platforms.