Backup and Restore

Standalone Fabric Server Backup and Restore

You can take a backup of the configurations, Fabric applications data, and firewall information of a Standalone Fabric Server and restore them using the fabric-app- backup-restore command.

Take a Backup of Standalone Fabric Server

1. Execute the fabric-app-backup-restore command in the Fabric Server.

2. Select the Backup option.

Click OK to start the backup process.

A confirmation message appears in the Fabric Server when the backup completes.

• The Fabric Server stores the backup in the /home/cmdr-admin location of the cmdr-admin user.

• The Fabric Server saves only one backup file on a specific date. If you take two backups on the same date, the second backup file overrides the first file.

• The backup process does not store Director license information. You must re-upload the license from Director Console after restoring the backup.

Restore the Backup

• To restore the backup, Fabric Server must be in the same version as the Fabric Server from which the backup was taken.

• After the restore process, Fabric Server is reverted to the state when the backup was taken. All changes made to the Fabric Server after the backup are lost.

Follow the steps below to restore a backup:

1. Execute the fabric-app-backup-restore command in the Fabric Server.

2. Select the Restore option.

3. Enter the full path of the backup file that you want to restore.

   Click OK to start the restore process.

   A confirmation message appears in the Fabric Server when the restore process completes.

• You must execute the get-fabrichosts command in the API Server after restoring the backup.

• You must re-upload the license from Director Console after restoring the backup since the backup process does not store Director license information.

• You must sync the LPSM data to Fabric Proxy after restoring the backup.

Fabric Authenticator Backup and Restore in Cluster Setup

You can take a backup of the Master Fabric Server’s Fabric Authenticator configurations in a cluster set up and restore them using the fabric-auth-backup-restore command.

There are two main reasons you might want to perform a backup and restore of the Fabric Authenticator:

• If you want to set up a new cluster setup with server configurations from the existing cluster setup.

• If you want to recover the lost configurations of the fabric authenticator in an existing cluster setup.

Take a Backup of the Fabric Authenticator

1. Access the Master Fabric Server through SSH connection.

2. Execute the fabric-auth-backup-restore command in the Master Fabric Server.

3. Select Backup.

4. Click OK to start the backup process.

A confirmation message appears in the Fabric Server when the backup completes.

1. Click OK.

• The Fabric Server stores the backup in the /home/cmdr-admin location of the cmdr-admin user.

• The Fabric Server saves only one backup file. If you take two backups, the second backup file overrides the first file.

• As a failsafe measure, make sure to copy the backup file to other remote locations too.

Restore the Fabric Authenticator Backup

• To restore the backup in new Master Fabric Server, the Fabric Server must have same physical IP, tunnel IP and hostname as the Fabric Server from which the backup was taken.

• To restore the backup, Fabric Server must be in the same version as the Fabric Server from which the backup was taken.

• If you are setting up new Master Fabric Server, execute fabric-app-installer command in the Master Fabric Server.

• After the restore process, Fabric Authenticator configurations is reverted to the state when the backup was taken. All changes made to the Fabric Authenticator configurations after the backup are lost.

There are two ways to restore a backup:

1. Restore Fabric Authenticator Database from File

2. Restore Fabric Authenticator Database from Slave Server

Restore Fabric Authenticator Database from File

The backup file is located in the /home directory of cmdr-admin user in existing Master Fabric Server. If you are setting up a new Master Fabric Server, copy the backup file from the existing Master Fabric Server where the backup file is located. Following example shows how to copy the backup file from existing Master Fabric Server to the new Master Fabric Server using SCP:

scp -i <path_to_rsa_file> <user>@<SOURCE_IP>:<path_to_backup_file> <user>@<DESTINATION_IP>:<path_to_backup_file>

In the above command,

• SOURCE_IP : IP address of existing Master Fabric Server or remote server where the backup file is located.

• DESTINATION_IP: IP address of Master Fabric Server where you want to copy the backup file.

To restore a backup from a file:

1. Access the Master Fabric Server through SSH connection.

2. Execute the fabric-auth-backup-restore command in the Master Fabric Server.

3. Select Restore.

4. Select File.

5. Enter the full path of the backup file that you want to restore.

6. Click OK to start the restore process.

   In the Fabric Server, a timer starts counting down the time until the restore process completes. When the restore process is completed, the system reboots automatically.

Restore Fabric Authenticator Database from Slave Server

To restore the backup from the slave server:

1. Access the Master Fabric Server through SSH connection.

2. Execute the fabric-auth-backup-restore command on the Master Fabric Server.

3. Select Restore.

4. Select the Network.

5. Select the slave server from where you want to restore the configurations.

6. Click OK to start the restore process.

   In the Fabric Server, a timer starts counting down the time until the restore process completes. When the restore process is completed, the system reboots automatically.

After restoring the Fabric Authenticator configurations,

• Perform Sync To Fabric Proxy in LPSM. For more details, go to Sync to Fabric Proxy.

• In case of setting up new Master Fabric Server, execute recover-fabric-app command to recover the Fabric Storage.