efa system backup

Backs up the EFA 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.
--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 ---