diff --git a/README.md b/README.md index 7f1269ed..d9954ff1 100644 --- a/README.md +++ b/README.md @@ -1237,7 +1237,14 @@ Apply the awx-operator.yml for that release to upgrade the operator, and in turn #### Backup -The first part of any upgrade should be a backup. Note, there are secrets in the pod which work in conjunction with the database. Having just a database backup without the required secrets will not be sufficient for recovering from an issue when upgrading to a new version. See the [backup role documentation](https://github.com/ansible/awx-operator/tree/devel/roles/backup) for information on how to backup your database and secrets. In the event you need to recover the backup see the [restore role documentation](https://github.com/ansible/awx-operator/tree/devel/roles/restore). +The first part of any upgrade should be a backup. Note, there are secrets in the pod which work in conjunction with the database. Having just a database backup without the required secrets will not be sufficient for recovering from an issue when upgrading to a new version. See the [backup role documentation](https://github.com/ansible/awx-operator/tree/devel/roles/backup) for information on how to backup your database and secrets. + +In the event you need to recover the backup see the [restore role documentation](https://github.com/ansible/awx-operator/tree/devel/roles/restore). *Before Restoring from a backup*, be sure to: +* delete the old existing AWX CR +* delete the persistent volume claim (PVC) for the database from the old deployment, which has a name like `postgres-13--postgres-13-0` + +**Note**: Do not delete the namespace/project, as that will delete the backup and the backup's PVC as well. + #### PostgreSQL Upgrade Considerations diff --git a/roles/restore/README.md b/roles/restore/README.md index c4cfe8e4..ace30c9c 100644 --- a/roles/restore/README.md +++ b/roles/restore/README.md @@ -17,6 +17,12 @@ This role assumes you are authenticated with an Openshift or Kubernetes cluster: - AWX is deployed to via the operator - An AWX backup is available on a PVC in your cluster (see the backup [README.md](../backup/README.md)) +*Before Restoring from a backup*, be sure to: + - delete the old existing AWX CR + - delete the persistent volume claim (PVC) for the database from the old deployment, which has a name like `postgres-13--postgres-13-0` + +**Note**: Do not delete the namespace/project, as that will delete the backup and the backup's PVC as well. + Usage ----------------