Skip to content

Commit e9e1936

Browse files
RichardHochRichardHoch
committed
VSB cleanup for OADP 1.1
1 parent 5effd3a commit e9e1936

File tree

5 files changed

+149
-0
lines changed

5 files changed

+149
-0
lines changed

‎backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,29 @@ include::modules/oadp-backing-up-pvs-csi.adoc[leveloffset=+1]
2626
include::modules/oadp-backing-up-applications-restic.adoc[leveloffset=+1]
2727
include::modules/oadp-using-data-mover-for-csi-snapshots.adoc[leveloffset=+1]
2828

29+
[id="oadp-cleaning-up-after-data-mover-1-1-backup"]
30+
== Cleaning up after a backup using Data Mover with OADP 1.1.
31+
32+
For OADP 1.1., you must perform a data cleanup after you perform a backup using any version of Data Mover.
33+
34+
The cleanup consists of deleting the following resources:
35+
36+
* Snapshots in a bucket
37+
* Cluster resources
38+
* Volume snapshot backups (VSBs) after a backup procedure that is either run by a schedule or is run repetitively
39+
40+
include::modules/oadp-cleaning-up-after-data-mover-snapshots.adoc[leveloffset=+2]
41+
42+
[id="deleting-cluster-resources"]
43+
== Deleting cluster resources
44+
45+
Data Mover might leave cluster resources whether or not it successfully backs up your container storage interface (CSI) volume snapshots to a remote object store.
46+
47+
include::modules/oadp-deleting-cluster-resources-following-success.adoc[leveloffset=+2]
48+
include::modules/oadp-deleting-cluster-resources-following-failure.adoc[leveloffset=+2]
49+
50+
include::modules/oadp-vsb-cleanup-after-scheduler.adoc[leveloffset=+2]
51+
2952
[role="_additional-resources"]
3053
.Additional resources
3154
* xref:../../../operators/admin/olm-adding-operators-to-cluster.adoc#olm-installing-operators-from-operatorhub_olm-adding-operators-to-a-cluster[Installing Operators on clusters for administrators]

‎modules/oadp-cleaning-up-after-data-mover-snapshots.adoc

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc
4+
5+
:_content-type: PROCEDURE
6+
[id="oadp-cleaning-up-after-data-mover-snapshots_{context}"]
7+
= Deleting snapshots in a bucket
8+
9+
Data Mover might leave one or more snapshots in a bucket after a backup. You can either delete all the snapshots or delete individual snapshots.
10+
11+
.Procedure
12+
13+
* To delete all snapshots in your bucket, delete the `/<protected-ns>` folder that is specified in the Data Protection Application (DPA) `.spec.backupLocation.objectStorage.bucket` resource.
14+
* To delete an individual snapshot:
15+
. Browse to the `/<protected-ns>` folder that is specified in the DPA `.spec.backupLocation.objectStorage.bucket` resource.
16+
. Delete the appropriate folders that are prefixed with `/<volumeSnapshotContent name>-pvc` where `<VolumeSnapshotContent_name>` is the `VolumeSnapshotContent` created by Data Mover per PVC.

‎modules/oadp-deleting-cluster-resources-following-failure.adoc

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc
4+
5+
:_content-type: PROCEDURE
6+
[id="oadp-deleting-cluster-resources-following-failure_{context}"]
7+
= Deleting cluster resources following a partially successful or a failed backup and restore that used Data Mover
8+
9+
If your backup and restore operation that uses Data Mover either fails or only partially succeeds, you must clean up any `VolumeSnapshotBackup` (VSB) or `VolumeSnapshotrestore` custom resource definitions (CRDs) that exist in the application namespace, and clean up any extra resources created by these controllers.
10+
11+
.Procedure
12+
13+
. Clean up cluster resources that remain after a backup operation where you used Data Mover by entering the following commands:
14+
15+
.. Delete VSB CRDs on the application namespace, the namespace with the application PVCs to backup and restore:
16+
+
17+
[source,terminal]
18+
----
19+
$ oc delete vsb -n <app_namespace> --all
20+
----
21+
22+
.. Delete `VolumeSnapshot` CRs:
23+
+
24+
[source,terminal]
25+
----
26+
$ oc delete volumesnapshot -A --all
27+
----
28+
29+
.. Delete `VolumeSnapshotContent` CRs:
30+
+
31+
[source,terminal]
32+
----
33+
$ oc delete volumesnapshotcontent --all
34+
----
35+
36+
.. Delete any PVCs on the protected namespace, the namespace the Operator is installed on.
37+
+
38+
[source,terminal]
39+
----
40+
$ oc delete pvc -n <protected_namespace> --all
41+
----
42+
43+
.. Delete any `ReplicationSource` resources on the namespace.
44+
+
45+
[source,terminal]
46+
----
47+
$ oc delete replicationsource -n <protected_namespace> --all
48+
----
49+
50+
. Clean up cluster resources that remain after a restore operation using Data Mover by entering the following commands:
51+
52+
.. Delete VSR CRDs:
53+
+
54+
[source,terminal]
55+
----
56+
$ oc delete vsr -n <app-ns> --all
57+
----
58+
59+
.. Delete `VolumeSnapshot` CRs:
60+
+
61+
[source,terminal]
62+
----
63+
$ oc delete volumesnapshot -A --all
64+
----
65+
66+
.. Delete `VolumeSnapshotContent` CRs:
67+
+
68+
[source,terminal]
69+
----
70+
$ oc delete volumesnapshotcontent --all
71+
----
72+
73+
.. Delete any `ReplicationDestination` resources on the namespace.
74+
+
75+
[source,terminal]
76+
----
77+
$ oc delete replicationdestination -n <protected_namespace> --all
78+
----

‎modules/oadp-deleting-cluster-resources-following-success.adoc

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc
4+
5+
:_content-type: PROCEDURE
6+
[id="oadp-deleting-cluster-resources-following-success_{context}"]
7+
= Deleting cluster resources following a successful backup and restore that used Data Mover
8+
9+
You can delete any `VolumeSnapshotBackup` or `VolumeSnapshotRestore` CRs that remain in your application namespace after a successful backup and restore where you used Data Mover.
10+
11+
.Procedure
12+
13+
. Delete cluster resources that remain on the application namespace, the namespace with the application PVCs to backup and restore, after a backup where you use Data Mover:
14+
+
15+
[source,terminal]
16+
----
17+
$ oc delete vsb -n <app_namespace> --all
18+
----
19+
20+
. Delete cluster resources that remain after a restore where you use Data Mover:
21+
+
22+
[source,terminal]
23+
----
24+
$ oc delete vsr -n <app_namespace> --all
25+
----
26+
27+
. If needed, delete any `VolumeSnapshotContent` resources that remain after a backup and restore where you use Data Mover:
28+
+
29+
[source,terminal]
30+
----
31+
$ oc delete volumesnapshotcontent --all
32+
----

‎modules/oadp-vsb-cleanup-after-scheduler.adoc

Whitespace-only changes.

0 commit comments

Comments
 (0)