The backup process saves XCO data, including the database, certificates, and multi-access network configuration. The process does not back up northbound certificates.
XCO supports backup and restore across the same IP modes. A warning message appears during restore operation.
The following table describes the support matrix for backup and restore operation across the IP modes:
Backup | Restore | Support |
---|---|---|
Dual | IPv6 | No |
Dual | IPv4 | No |
IPv4 | IPv6 | No |
IPv4 | Dual | Yes |
IPv6 | IPv6 | No |
IPv6 | IPv4 | No |
IPv4 | IPv4 | Yes |
IPv6 | IPv6 | Yes |
Dual | Dual | Yes |
A backup generated on one XCO system can be restored on another system.
For more information, see Back up and Restore the XCO System.
$ efa system backup-list +----+-----------------------------------+---------+----------------+ | ID | File | Version | Generated By | +----+-----------------------------------+---------+----------------+ | 1 | EFA-2020.08.20-20.26.46.tar | 2.3.0-1 | User | +----+-----------------------------------+---------+----------------+ | 2 | EFA-2020.08.20-20.27.29.tar | 2.3.0-GA| System | +----+-----------------------------------+---------+----------------+ --- Time Elapsed: 183.69386ms ---
XCO periodically backs up the system (12 AM by default, but configurable). During the backup process, all the services are locked and APIs return the message "Service is Locked with reason backup". Therefore, you cannot see the location under dropdown for Device Discovery.
The periodic backup process creates a backup tar file that is saved to the same location as the manual backup files. When new backup and supportsave files are created, according to the age of the backup files and maximum number of backup files to save, the system deletes the saved system-generated backup files, supportsave files, and manual backup files.
0:*:*:*
, meaning
every day at midnight.You can use the efa system settings show command to view the current backup settings.
Tip
You can use the efa system cleanup REST API to delete a specified backup or supportsave file. This feature lets you delete files before they are automatically deleted.You can use the efa system settings reset command to reset the backup system settings to default values.
The upgrade process of XCO also backs up the XCO system to recover data if the upgrade fails. For more information, see "Recover from an Upgrade Failure" in the ExtremeCloud Orchestrator Deployment Guide, 3.2.0 .
The REST APIs for backup, restore, and supportsave are part of the Monitoring Service and can be accessed via port 8078. The logs for the REST APIs are saved to the <log_dir>/monitor/ location.