efa system backup

Backs up the XCO system, including the database and certificates.

Syntax

efa system backup [ --device-ip stringArray | --remote | --fabric-all | --fabric-name string ]

Parameters

--device-ip stringArray
Specifies a comma-separated range of device IPs for which the configuration backup will be taken. Example: 10.1.1.13,10.1.1.50,10.1.1.101.
--remote boolean
Specifies if backup should be stored remotely. Default is false (only on local). When set to true, backup is stored both locally and remotely. Use the efa system settings update command to configure the remote server.
--fabric-all
Indicates to back up all devices that are part of all fabrics running the configuration backup.
--fabric-name string
Indicates to back up all devices that are part of this fabric running the configuration backup.

Usage Guidelines

You can restore a backed-up database for various reasons, such as if the database becomes corrupted or you want to revert to a previous configuration. The backup process creates a backup tar file, which you specify for the restore process. The backup tar file is saved to one of the following locations:
  • Server: /var/log/efa/backup
  • TPVM: /apps/efa_logs/backup

Run this command as a sudo user for the base operating system.

Examples

This example performs system backup without device configuration backup.

efa system backup --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.735.tar
--- Time Elapsed: 5.741750131s ---

This example performs system backup by taking configuration backup of all devices that are part of the fabric specified.

efa system backup --fabric default --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.736.tar
--- Time Elapsed: 5.741750131s ---

This example performs system backup by taking configuration backup of all fabrics and its devices.

efa system backup –-fabric-all --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.734.tar
--- Time Elapsed: 5.741750131s ---

This example performs system backup by taking configuration backup of all devices that are specified.

efa system backup --device-ip 10.20.1.2,10.20.1.3,10.20.1.4 --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.737.tar
--- Time Elapsed: 5.741750131s ---

This example shows the error message: Fabric does not exist.

efa system backup --fabric default --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.733.tar
Backup is partially success: 
    Fabric does not exist 
--- Time Elapsed: 5.741750131s ---

This example shows the error message: Device not found.

efa system backup --device-ip 10.20.1.5,10.20.1.6 --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.738.tar
Backup is partially success: 
    Device 10.20.1.5 not found
--- Time Elapsed: 5.741750131s ---

This example shows the error message: Operation not allowed.

efa system backup --device-ip 10.20.1.2,10.20.1.3 --remote
Generating backup of EFA...
Backup Location: root@10.10.10.10:/tmp/efa/EFA-2021-04-07T03-04-48.739.tar
Backup is partially success: 
    Devices [10.20.1.2] failed to get config backup as its locked for configuration change by process [Firmware download]. 
--- Time Elapsed: 5.741750131s ---