Skip to content

Commit

Permalink
Merge pull request #7145 from stolostron/jcberger-13226-oadp-install-…
Browse files Browse the repository at this point in the history
…2.11

changes for 2.11
  • Loading branch information
jc-berger authored Oct 22, 2024
2 parents 36d97dd + 7cb8c22 commit 1d7916e
Showing 1 changed file with 29 additions and 16 deletions.
45 changes: 29 additions & 16 deletions business_continuity/backup_restore/backup_install.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -25,24 +25,37 @@ To create a storage location secret, complete the following steps:
[#enabling-the-backup-operator]
=== Enabling the backup operator

To enable backup operator for your active and passive hub clusters, complete the following steps:
Enable the backup operator to use the disaster recovery solutions for {acm}.

. From your {ocp} cluster, install the {acm} operator version {product-version}.x. The `MultiClusterHub` resource is automatically created when you install {acm-short}, and displays the following status: `Running`.
. Manually install the cluster backup and restore operator.
. Enable the cluster backup and restore operator (`cluster-backup`).
. Edit the `MultiClusterHub` resource by setting the `cluster-backup` parameter to `true`. If this hub cluster does not have the AWS Security Token Service (STS) option enabled, the OADP operator is also installed in the same namespace with the backup component. For hub clusters where the STS option is enabled, you must manually install the OADP operator.
[#enabling-backup-operator-prerequisite]
==== Prerequisite

* From your {ocp} cluster, install the {acm-short} operator version {product-version}. The `MultiClusterHub` resource is automatically created when you install {acm-short}, and displays the following status: `Running`.
[#enabling-backup-operator-clusters]
==== Enabling backup operators for your hub clusters
To enable the backup operator for your active and passive hub clusters, complete the following steps:

. Enable the cluster backup and restore operator, `cluster-backup`, by completing the following steps:
.. Update the `MultiClusterHub` resource by setting the `cluster-backup` parameter to `true`. If this hub cluster does not have the AWS Security Token Service (STS) option enabled, the OADP operator is also installed in the same namespace with the backup component.
.. For hub clusters where the STS option is enabled, you must manually install the OADP operator.
. Ensure that the restore hub cluster uses the same {acm-short} version that the backup hub cluster uses. You cannot restore a backup on a hub cluster with a version earlier than the one used by the backup hub cluster.
. *Optional:* If you want to run the restore operation on a hub cluster that has a version newer than the hub cluster where the backup was created, complete the following:
.. On the restore hub cluster, install the operator at the same version as the hub cluster where the backup was created.
.. Restore the date on the restore hub cluster.
.. On the restore hub cluster, use the upgrade operation to upgrade to the version you want to use.
.. Manually configure the hub cluster.
.. Install all operators on the active hub cluster and in the same namespace as the active hub cluster.
.. Verify that other operators, such as {aap-short}, {ocp-short} GitOps, or certificate manager, are installed.
.. Verify that the new hub cluster is configured the same way as the initial hub cluster.
.. Use the same namespace name as the initial hub cluster when you install the backup and restore operator and any operators that are configured on the earlier hub cluster.
. Create the `DataProtectionApplication resource` on the passive hub cluster.
. Connect the passive hub cluster to the same storage location where the initial hub cluster backed up the data.
. Manually configure the restore hub cluster by completing the following steps:
.. Install all operators that are installed on the active hub cluster and in the same namespace as the active hub cluster.
.. Verify that the new hub cluster is configured the same way as the backup hub cluster.
.. Use the same namespace name as the backup hub cluster when you install the backup and restore operator and any operators that are configured on the backup hub cluster.
. Create the `DataProtectionApplication` resource on the passive hub cluster by completing the following steps:
.. Create the `DataProtectionApplication` resource on both the active and passive hub cluster.
.. For the restore hub cluster, when you create the `DataProtectionApplication` resource, use the same storage location as the backup hub.

[#running-restore-operation]
==== Running a restore operation on a hub cluster with a newer version

If you want to run the restore operation on a hub cluster that uses a newer {acm-short} version than the hub cluster where the backup was created, you can still run a restore operation by completing the following steps:

. On the restore hub cluster, install the operator at the same version as the hub cluster where the backup was created.
. Restore the backup data on the restore hub cluster.
. On the restore hub cluster, use the upgrade operation to upgrade to the version you want to use.

[#installing-the-oadp-operator]
=== Installing the OADP operator
Expand Down

0 comments on commit 1d7916e

Please sign in to comment.