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.
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
- Log in to Red Hat OpenShift Container Platform.
-
Navigate to
. - Select the Ansible Automation Platform Operator installed on your project namespace.
- Select the Automation Controller Restore tab.
- Click .
- Enter a Name for the recovery deployment.
Enter a New Deployment name for the restored deployment.
NoteThis should be different from the original deployment name.
- Select the Backup source to restore from. Backup CR is recommended.
- Enter the Backup Name of the AutomationControllerBackup object.
Click
.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.
Verification
- Log in to Red Hat Red Hat OpenShift Container Platform
-
Navigate to
. - Select the Ansible Automation Platform Operator installed on your project namespace.
- Select the AutomationControllerRestore tab.
- Select the restore resource you want to verify.
Scroll to Conditions and check that the Successful status is
True
.NoteIf Successful is
False
, the recovery has failed. Check the automation controller operator logs for the error to fix the issue.
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.
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
- Log in to Red Hat OpenShift Container Platform.
-
Navigate to
. - Select the Ansible Automation Platform Operator installed on your project namespace.
- Select the Automation Hub Restore tab.
- Click .
- Enter a Name for the recovery deployment.
- Select the Backup source to restore from. Backup CR is recommended.
- Enter the Backup Name of the AutomationHubBackup object.
Click
.A new deployment is created and your backup is restored to it.