Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Back Up and Restore Paragon Automation

This topic describes the back up and restore functionality available in Paragon Automation.

Back Up Paragon Automation

You can back up your current Paragon Automation network configuration using Paragon Shell CLI. When you run the back up command, all the application configuration information stored in PostgreSQL and ArangoDB configuration database systems are backed up. The back up procedure can be performed while the microservices and applications are running and does not affect the operation of the network.

To back up your Paragon Automation configuration state.

  1. Log in as root user to any of the Paragon Automation nodes.
  2. Execute the following command to back up the configuration.
    root@Primary1> request paragon backup start

The back up takes a few minutes to complete and a back up file with a filename in the yyyymmdd-hhmmss format is created. The back up file is stored in the local persistent /export/paragon-shell/backup folder on the node. You'll have to exit out of Paragon Shell to the Linux root shell navigate to the backup folder.

Caveat of the backup process

  • Metrics data such as that stored in InfluxDB is not backed up.

Restore Paragon Automation

You can restore your Paragon Automation network configuration from a backup configuration file. To restore from a backup configuration file, all microservices and applications must be stopped and the cluster is not functional until the databases are restored. Once the databases are flushed and restored to the backed-up configuration, the applications must be restarted and configuration restored from the databases must be reparsed.

To restore your Paragon Automation configuration from a specific backup configuration file.

  1. Log in as root user to the node where the backup file is located.
  2. Execute the following command to uninstall all the running applications.
    root@Primary1> request paragon destroy cluster input “-v -t apps”

    This command takes sometime to complete, and you must wait until all the applications are shut down before proceeding to the next step. To check the status of applications, perform the following steps.

    1. Type exit to exit Paragon Shell to the Linux root shell.

    2. Check each application namespace for running deployments using the kubectl get deployments -n namespace command, where namespace is the name of the application namespace. Use this command for each namespace and the output of every command should be empty, which indicates that no deployments are running. Table 1 lists all the namespaces that you must check.

      Table 1: Namespace List

      airflow

      epic

      foghorn

      gnmi-term

      mems

      netbox

      northstar

      oc-term

      paa

      papi

      streams

      trust

      healthbot

      The command output should display only the following deployments:

      vm-operator-victoria-metrics-operator, vmauth-victoria-metrics-auth, vminsert-victoria-metrics-cluster

      When all applications are shut down, you are ready to proceed with the restore process.

    3. Type cli to log in again to Paragon Shell.
  3. Restore the applications configuration from the backup file.
    root@Primary1> request paragon restore start backup-id backup-id
  4. Reinstall all the applications.
    root@Primary1> request paragon deploy cluster input “-v -t apps”
  5. Reparse and synchronize the restored configuration.
    root@Primary1> request paragon restore sync

You must perform the restore operation only on the node where the required backup file is located.

Caveats of the restore process

  • When you perform the restore operation, the network configuration is returned to the configuration present in the backup file. From the time the backup was taken, if the network configuration has changed due to new devices being onboarded or new service orders being executed, the network configuration in Paragon Automation might be different from the actual network state. To ensure that the network configuration in Paragon Automation and the actual network state have minimal mismatch post a restore operation, we recommend that you take regular periodic backups or specific backups after every network intent change.

  • You cannot restore data from a version different from the installed version of Paragon Automation.

View Backup Files

To view a list of all backup files across all nodes, use the following command:

root@Primary1> show paragon backup

The node connects to all the other nodes in the Paragon Automation cluster using SSH and displays a list of all backup filenames along with the IP address of the node on which the file is located.

To view a list of backup files along with a list of failed back up attempts, use the following command:

root@Primary1> show paragon backup include-failure true

Delete Backup Files

To delete a backup file, use the following command.

root@Primary1> request paragon backup delete backup-id backup-id

You can delete a backup file located only on the node that you execute the command.

See Also