User guide

Working With Configuration Files Configuration Files Overview
OmniSwitch AOS Release 7 Switch Management Guide March 2015 page 6-7
Cancelling a Timed Session
You may cancel a pending timed session by using the configuration cancel command. To confirm that
your timer session has been cancelled, use the show configuration status command. The following will
display.
-> configuration cancel
-> show configuration status
File configuration: none scheduled
For more details about the CLI commands used to apply configuration files or to use timer sessions, refer
to “Configuration File Manager Commands” in the OmniSwitch AOS Release 7 CLI Reference Guide.
Configuration File Error Reporting
If you apply a configuration file to the switch that contains significant errors, the application may not
work. In this case, the switch will indicate the number of errors detected and print the errors into a text file
that will appear in the /flash directory. The following display will result where the cfg_txt file contains
three errors.
-> configuration apply cfg_file
Errors: 3
Log file name: cfg_txt.1.err
In this case, the error message indicates that the application attempt was unsuccessful. It also indicates that
the switch wrote log messages into a file named cfg_txt.1.err, which now appears in your /flash direc-
tory. To view the contents of a generated error file, use the view command. For example, view
cfg_txt.1.err.
Setting the Error File Limit
The number of files ending with the .err extension present in the switch’s /flash directory is set with the
configuration error-file-limit command. You can set the switch to allow a maximum number of error
files in the /flash directory. Once the error file limit has been reached, the next error file generated will
cause the error file with the oldest time stamp to be deleted. The following command sets the error file
limit to 5 files:
-> configuration error-file limit 5
If you need to save files with the .err extension, you can either rename them so they no longer end with
the .err extension or you may move them to another directory.
Syntax Checking
The configuration syntax check command is used to detect potential syntax errors contained in a
configuration file before it is applied to the switch. It is recommended that you check all configuration
files for syntax errors before applying them to your switch.
To run a syntax check on a configuration file, use the configuration syntax-check command.
For example:
-> configuration syntax asc.1.snap
Errors: 3
Log file name: check asc.1.snap.1.err