Chapter 3. Recovering a Red Hat Ansible Automation Platform deployment

If you lose information on your system or issues with an upgrade, you can use the backup resources of your deployment instances. Use these procedures to recover your automation controller and automation hub deployment files.

3.1. Recovering the Automation controller deployment

Use this procedure to restore a previous controller deployment from an AutomationControllerBackup. The deployment name you provide will be the name of the new AutomationController custom resource that will be created.

Note

The name specified for the new AutomationController custom resource must not match an existing deployment or the recovery process will fail. If the name specified does match an existing deployment, see Troubleshooting for steps to resolve the issue.

Prerequisites

  • You must be authenticated with an Openshift cluster.
  • The automation controller has been deployed to the cluster.
  • An AutomationControllerBackup is available on a PVC in your cluster.

Procedure

  1. Log in to Red Hat OpenShift Container Platform.
  2. Navigate to Operators → Installed Operators.
  3. Select the Ansible Automation Platform Operator installed on your project namespace.
  4. Select the Automation Controller Restore tab.
  5. Click Create AutomationControllerRestore.
  6. Enter a Name for the recovery deployment.

  7. Enter a New Deployment name for the restored deployment.

    Note

    This should be different from the original deployment name.

  8. Select the Backup source to restore from. Backup CR is recommended.
  9. Enter the Backup Name of the AutomationControllerBackup object.

  10. Click Create.

    A new deployment is created and your backup is restored to it. This can take approximately 5 to 15 minutes depending on the size of your database.

3.2. Recovering the Automation hub deployment

Use this procedure to restore a previous hub deployment into the namespace. The deployment name you provide will be the name of the new AutomationHub custom resource that will be created.

Note

The name specified for the new AutomationHub custom resource must not match an existing deployment or the recovery process will fail.

Prerequisites

  • You must be authenticated with an Openshift cluster.
  • The automation hub has been deployed to the cluster.
  • An AutomationHubBackup is available on a PVC in your cluster.

Procedure

  1. Log in to Red Hat OpenShift Container Platform.
  2. Navigate to Operators → Installed Operators.
  3. Select the Ansible Automation Platform Operator installed on your project namespace.
  4. Select the Automation Hub Restore tab.
  5. Click Create AutomationHubRestore.
  6. Enter a Name for the recovery deployment.
  7. Select the Backup source to restore from. Backup CR is recommended.
  8. Enter the Backup Name of the AutomationHubBackup object.

  9. Click Create.

    A new deployment is created and your backup is restored to it.