Managing the Configuration File

The configuration is the customized set of parameters that you have selected to run on the switch. The following table describes some of the key areas of configuration file management in ExtremeXOS.

expand icon

Configuration File Management

Task Behavior
Configuration file database

ExtremeXOS supports saving a configuration file into any named file and supports more than two saved configurations.

For example, you can download a configuration file from a network TFTP server and save that file as primary, secondary, or with a user-defined name. You also select where to save the configuration: primary or secondary partition, or another space.

The file names "primary" and "secondary" exist for backward compatibility with ExtremeWare.

Downloading configuration files

ExtremeXOS uses the tftp and tftp get commands to download configuration files from the network TFTP server to the switch.

For more information about downloading configuration files, see Using TFTP to Download the Configuration.

Uploading configuration files

ExtremeXOS uses the tftp and tftp put commands to upload configuration files from the switch to the network TFTP server.

For more information about uploading configuration files, see Using TFTP to Upload the Configuration.

Managing configuration files, including listing, copying, deleting, and renaming
The following commands allow you to manage configuration files:
  • ls: Lists all of the configuration files in the system.
  • cp: Makes a copy of an existing configuration file in the system.
  • rm: Removes/deletes an existing configuration file from the system.
  • mv: Renames an existing configuration file.
Configuration file types
  • XML-formatted configuration file
  • ASCII-formatted configuration file
XML-formatted configuration file ExtremeXOS configuration files are saved in Extensible Markup Language (XML) format. Use the show configuration command to view on the CLI your currently running switch configuration.
ASCII-formatted configuration file

You can upload your current configuration in ASCII format to a network TFTP server. The uploaded ASCII file retains the CLI format.

To view your configuration in ASCII format, save the configuration with the .xsf file extension (known as the XOS CLI script file). This saves the XML-based configuration in an ASCII format readable by a text editor.

ExtremeXOS uses the upload configuration command to upload the ASCII-formatted configuration file from the switch to the network TFTP server.

ExtremeXOS uses the tftp and tftp get commands to download configuration files from the network TFTP server to the switch.

For more information about ASCII-formatted configuration files, see Uploading ASCII-Formatted Configuration Files.

XML configuration mode Indicated by (xml) at the front of the switch prompt. Do not use; instead, run disable xml-mode to disable this mode.
Displaying configuration files You can also see a complete list of configuration files by entering the ls command followed by the [Tab] key.

For more information about saving, uploading, and downloading configuration files, see Save the Configuration.