You can manage configuration files to ensure that the ATN equipment starts normally.
6.1 Management of Configuration Files Introduction
The configuration file is the add-in configuration item when restarting the ATN equipment this time or next time.
6.1.1 Configuration Files
This part describes basic concepts of configuration files.
The configuration file is the add-in configuration item when restarting the ATN equipment this time or next time.
The configuration file is a text file in the following formats:
l It is saved in the command format.
l To save space, default parameters are not saved. For the default values of the configuration parameters, see following sections.
l Commands are organized on the basis of the command view. All commands of the identical command view are grouped into a section. Every two command sections are separated by one or several blank lines or comment lines (beginning with "#").
l The sequence of command sections is global configuration, logic interface configuration, physical interface configuration, routing protocol configuration and so on.
NOTE
l The system can run the command with the maximum length of 512 characters, including the command in an incomplete form.
l If the configuration is in the incomplete form, the command is saved in complete form. Therefore, the command length in the configuration file may exceed 512 characters. When the system restarts, these commands cannot be restored.
6.1.2 Configuration Files and Current Configurations
The part describes basic concepts of configuration files and current configurations.
l Initial configurations: On powering on, the ATN equipment retrieves the configuration files from a default save path to initiate itself. If configuration files do not exist in the default save path, the ATN equipment uses the default parameters.
l Current configurations: indicates the effective configurations of the currently running ATN equipment.
l Users can modify the current configurations of the ATN equipment through the command line interface. Use the save command to save the current configuration to the configuration file of the default storage devices, and the current configuration becomes the initial configuration of the ATN equipment when the ATN equipment is powered on next time.
6.2 Managing Configuration Files
You can manage configuration files to ensure that the ATN equipment starts normally.
6.2.1 Establishing the Configuration Task
Before managing configuration files, familiarize yourself with the applicable environment, complete the pre-configuration tasks, and obtain the required data. This can help you complete the configuration task quickly and accurately.
Applicable Environment
In one of the following situations, you need to manage configuration files:
l To start the ATN equipment normally, you need to select the correct ATN 910 system software and configuration file for the ATN equipment to load.
l After modifying current configurations, you need to save the modified contents.
l You need to view the configuration of the ATN equipment.
Pre-configuration Tasks
Before managing configuration files, complete the following task:
l Installing the ATN equipment and starting it properly
Data Preparation
To manage configuration files, you need the following data.
No. Data
1 ATN 910 System software and its file name 2 Configuration file and its name
3 The number of the start line from which the comparison of the configuration files begins
6.2.2 Configuring System Software for a ATN equipment to Load for the Next Startup
To upgrade the system software of a ATN equipment, you can specify the ATN 910 system software to be loaded for the next startup.
Context
Do as follows on the ATN equipment:
Procedure
Step 1 Run:
startup system-software system-file [ slave-board ]
The ATN 910 system software for the ATN equipment to load next time when it starts is configured.
The filename extension of the system software must be .cc and must be stored in the root directory of a storage device.
You can specify the system-file and use the system software for the next startup that is saved on the device.
slave-board is valid only on the ATN equipment with dual main control boards.
----End
6.2.3 Configuring the Configuration File for ATN to Load for the Next Startup
Before restarting a ATN equipment, you can specify the configuration files that are loaded for the next startup.
Context
Do as follows on the ATN equipment:
Procedure
Step 1 Run:
startup saved-configuration configuration-file
Configuration file is saved for the ATN equipment to load next time on startup.
The filename extension of the configuration file must be .cfg or .zip, and must be stored in the root directory of a storage device.
The effective configuration when a ATN equipment is working is called current configuration.
----End
6.2.4 Saving Configuration Files
You can save configuration files periodically or immediately.
Context
The system can save the configuration files periodically or in real time to prevent data loss when the ATN equipment is powered off or accidentally restarted.
Run one of the following commands to save configuration files.
Procedure
l Run:
1. system-view
The system view is displayed.
2. set save-configuration [ interval interval | cpu-limit cpu-usage | delay delay-interval ] *
The configuration file is saved at intervals.
After the parameter interval interval is specified, the device saves the configuration file at specified intervals regardless of whether the configuration file is changed.
– If the set save-configuration command is not run, the system does not automatically save configurations.
– If the set save-configuration command without specified interval is run, the system automatically saves configurations at 30-minute intervals.
When you configure the automatic saving function, to prevent that function from affecting system performance, you can set the upper limit of the CPU usage for the system during automatic saving. When automatic saving is triggered by the expiry of the timer, the CPU usage is checked. If the CPU usage is higher than the set upper limit, automatic saving will be canceled.
After delay delay-interval is specified, if the configuration is changed, the device automatically saves the configuration after the specified delay.
After automatic saving of configurations is configured, the system automatically saves the changed configurations to the configuration file for the next startup and
configuration files are changed accordingly with the saved configurations.
Before configuring the automatic configure file saving on the server, you need to run the set save-configuration backup-to-server server server-ip [ transport-type { ftp | sftp } ] user user-name password password [ path folder ] or set save-configuration backup-to-server server server-ip transport-type tftp [ path folder ] command to configure the server, including the IP address, username, password of the server, destination path, and mode of transporting the configuration file to the server.
NOTE
If configuration files transmitted in TFTP mode are saved, the tftp client-source command can be run to configure the address of a loopback interface of the ATN equipment as a source address of a client to ensure security.
WARNING
When the automatic saving function is enabled and the LPU is not properly installed, corresponding configurations may be lost.
l Run:
save [ all ] [ configuration-file ]
The current configurations are saved.
The filename extension of the configuration file must be .cfg or .zip. The system startup configuration file must be saved in the root directory of a storage device.
The user can modify the current configuration through the command line interface. To set the current configuration as initial configuration when the ATN equipment starts next time, you can use the save command to save the current configuration in the cfcard memory.
You can use the save all command to save all the current configurations, including the configurations of the boards that are not inserted, to the default directory.
NOTE
When saving the configuration file for the first time, if you do not specify the optional parameter configuration-file, the ATN equipment asks you whether to save the file as "vrpcfg.zip" or not.
----End
6.2.5 Clearing a Configuration File
You can clear the configuration file that has been loaded to a device, or clear the inactive configurations of the boards that are not installed in slots.
Context
The configuration file stored in cfcard memory needs to be cleared in the following cases:
l The system software does not match the configuration file after the ATN equipment has been upgraded.
l The configuration file is destroyed or an incorrect configuration file has been loaded.
Procedure
l Clear the currently loaded configuration file.
Run the reset saved-configuration command to clear the currently loaded configuration file.
– If the configuration file of the ATN equipment used for the current startup is the same as that used for the next startup, running the reset saved-configuration command will clear both the configuration files. The ATN equipment will uses the default
configuration file for the next startup.
– If the configuration file of the ATN equipment used for the current startup is different from that used at the next startup, running the reset saved-configuration command will clear the configuration file used for the current startup.
– If the configuration file of the ATN equipment used for the current startup is empty, the system will prompt you that the configuration file does not exist after you run the reset saved-configuration command.
If you do not run the startup saved-configuration configuration-file command to specify a new correct configuration file, or do not run the save command to save the configuration file after the configuration file is cleared, the ATN equipment will use the default configuration file at the next startup.
----End
6.2.6 Comparing Configuration Files
You can compare the current configuration with the initial configuration.
Context
Do as follows on the ATN equipment:
Procedure
Step 1 Run:
compare configuration [ configuration-file ] [ current-line-number save-line-number ]
The current configuration is compared with the configuration file for next startup.
If no parameter is set, the comparison begins with the first lines of configuration files. current-line-number and save-current-line-number are used to continue the comparison by ignoring the differences between the configuration files.
When comparing differences between the configuration files, the system displays the contents of the current configuration file and saved configuration file from the first different line. By default, 150 characters are displayed for each configuration file. If the number of characters from the first different line to the end is less than 150, the contents after the first different line are all displayed.
In comparing the current configurations with the configuration file for next startup, if the configuration file for next startup is unavailable or its contents are null, the system prompts that reading files fails.
----End
6.2.7 Checking the Configuration
After managing configuration files has been configured, you can view the current configuration files, configuration files to be loaded at the next startup, files for the device startup, and files saved in the storage device.
Prerequisites
The configuration of managing configuration files are complete.
Procedure
l Run the display current-configuration [ configuration [ configuration-type
[ configuration-instance ] ] | controller | interface [ interface-type [ interface-number ] ] ] [ feature feature-name [ filter filter-expression ] | filter filter-expression ] or display current-configuration [ all | inactive ] command to view the current configuration files.
l Run the display saved-configuration [ last | time | configuration ] command to view configuration files to be loaded at the next startup.
l Run the display startup command to view files for the device startup.
l Run the dir [ /all ] [ filename ] command to view files saved in the storage device.
l Run the display changed-configuration time command to view the time of the last configuration change.
----End
7 FTP and TFTP
About This Chapter
FTP and TFTP are commonly-used file transfer protocols.