Import and export of configuration EcoRouter Documentation / Import and export of configuration
- Connectong to server
- Copy path
- Configuration archive
- Interface selecting
- Export of configuration
- Import of configuration
In administration mode use the copy command to export and import configuration files.
In general the command's logic is following:
copy <FROM> <TO> <WHAT> <VIA_INTERFACE>
Each parameter's syntax described below.
Connectong to server
EcoRouter supports export / import configuration files to / from FTP or TFTP server.
To connect ro FTP server user name, password and FTP server IP address must be specified.
To connect to TFTP server only its IP address must be specified.
Copy path
After specifying an IP address the path to directory where archive file will be stored and archive's name can be specified (configuration files' names by default described in the paragraph "Configuration archive").
For example when copying to TFTP server with IP address 192.168.10.10 the path can be specified by one of the following ways:
Path option | File location | File name |
|---|---|---|
| tftp://192.168.10.10/ | Server's root directory | By default |
| tftp://192.168.10.10/folder/ | Certain directory | By default |
| tftp://192.168.10.10/name | Server's root directory | Specified file name, extension by default |
| tftp://192.168.10.10/folder/name | Certain directory | Specified file name, extension by default |
| tftp://192.168.10.10/folder/name.res | Certain directory | Specified file name, specified extension |
This example demostrates flexibility of path specifying when copying configuration archive.
Configuration archive
When exporting a configuration an archive with a following name type is created: startup_backup_hostname_YYYYMMDDhhmmsss.tar.gz, i.e. startup_backup_EcoRouterOS_20160623175405.tar.gz.
This archive contains two files:
- crc – file containig archive's startup_backup.tar checksum,
- startup_backup.tar – archive containig configuration files.
The startup_backup.tar archive contains the following elements:
- configuration.json – module's configuration file,
- EcoRouterOS.conf – configuration file containing EcoRouter's settings,
- vrN – folders containing virtual routers' configuration files,
- aaa.db.bak – AAA database file.
Interface selecting
By default export and import are carried out via management port (marked as MNG/E0).
If necessary export and import can be confugured via default virtual router or any other virtual router. For this purpose the following parameter of the copy command is used:
vr <default|NAME>
Export of configuration
In case of export configuration is copied from startup-config to FTP or TFTP server. Last saved configuration version is copied using the write command. All changes of configuration made after its saving will not be included into exported file.
The command's syntax is following:
copy startup-config ftp|tftp <ADDRESS>/<PATH>/< |NAME.RES> vr <default|NAME>
See more export commands examples in the table below:
| Command | Description |
|---|---|
| FTP | |
copy startup-config ftp ftp://user:password@192.168.10.10/ | Export to the specified FTP server, default parameters |
copy startup-config ftp ftp://user:password@192.168.10.10/my_name_of_archive | Export to the specified FTP server, archive's name specified |
copy startup-config ftp ftp://user:password@192.168.10.10/my_name_of_archive.res | Export to the specified FTP server, archive's name and extension specified |
copy startup-config ftp ftp://user:password@192.168.10.10/ vr default | Export to the specified FTP server via defailt virtual router |
copy startup-config ftp ftp://user:password@192.168.10.10/ vr VR1 | Export to the specified FTP server via specified virtual router |
| TFTP | |
copy startup-config tftp tftp://192.168.10.10/ | Export to the specified TFTP server, default parameters |
copy startup-config tftp tftp://192.168.10.10/my_name_of_archive | Export to the specified TFTP server, archive's name specified |
copy startup-config tftp tftp://192.168.10.10/my_name_of_archive.res | Export to the specified TFTP server, archive's name and extension specified |
copy startup-config tftp tftp://192.168.10.10/ vr default | Export to the specified TFTP server via defailt virtual router |
copy startup-config tftp tftp://192.168.10.10/ vr VR1 | Export to the specified TFTP server via specified virtual router |
Import of configuration
In case of import configuration is copied from FTP or TFTP server to EcoRouter and extracted an downloaded archive into startup-config. With this the last saved configuration archiv is created. If the downloaded file is damaged or can not be installed as configuration file for any reason the system automatically restores the last saved configuration and reports an error.
EcoRouter must be restarted after configuration import for the changes take effect.
The import command's syntax is following:
copy ftp|tftp startup-config <ADDRESS>/<PATH>/<NAME> vr <default|NAME>
When importing the archive file name must be specified.
The import command's parameters are in the table below:
| Command | Description |
|---|---|
| FTP | |
copy ftp startup-config ftp://user:password@192.168.10.10/ startup_backup_EcoRouterOS_20160623175405.tar.gz | Import from the specified FTP server, default parameters |
copy ftp startup-config ftp://user:password@192.168.10.10/ my_name_backup vr default | Import from the specified FTP server via defailt virtual router |
copy ftp startup-config ftp://user:password@192.168.10.10/ my_name_backup vr VR1 | Import from the specified FTP server via specified virtual router |
copy ftp startup-config ftp://user:password@192.168.10.10/ my_name_backup mgmt | Import from the specified FTP server via management interface |
| TFTP | |
copy tftp startup-config tftp://192.168.10.10/my_name_backup | Import from the specified TFTP server, default parameters |
copy tftp startup-config tftp://192.168.10.10/my_name_backup vr default | Import from the specified TFTP server via defailt virtual router |
copy tftp startup-config tftp://192.168.10.10/ startup_backup_EcoRouterOS_20160623175405.tar.gz vr VR1 | Import from the specified TFTP server via specified virtual router |
copy tftp startup-config tftp://192.168.10.10/my_name_backup mgmt | Import from the specified TFTP server via management interface |