diff --git a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-about-kopia.adoc b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-about-kopia.adoc index e4294e0f41..4a0da256db 100644 --- a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-about-kopia.adoc +++ b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-about-kopia.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] Kopia is a fast and secure open-source backup and restore tool that allows you to create encrypted snapshots of your data and save the snapshots to remote or cloud storage of your choice. Kopia supports network and local storage locations, and many cloud or remote storage locations, including: diff --git a/backup_and_restore/application_backup_and_restore/installing/about-oadp-data-mover.adoc b/backup_and_restore/application_backup_and_restore/installing/about-oadp-data-mover.adoc index d07cd4e524..e7bb560f36 100644 --- a/backup_and_restore/application_backup_and_restore/installing/about-oadp-data-mover.adoc +++ b/backup_and_restore/application_backup_and_restore/installing/about-oadp-data-mover.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] {oadp-first} includes a built-in Data Mover that you can use to move Container Storage Interface (CSI) volume snapshots to a remote object store. The built-in Data Mover allows you to restore stateful applications from the remote object store if a failure, accidental deletion, or corruption of the cluster occurs. It uses xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-about-kopia.adoc#oadp-about-kopia[Kopia] as the uploader mechanism to read the snapshot data and write to the unified repository. {oadp-short} supports CSI snapshots on the following: diff --git a/backup_and_restore/application_backup_and_restore/installing/configuring-backup-restore-pvc-datamover.adoc b/backup_and_restore/application_backup_and_restore/installing/configuring-backup-restore-pvc-datamover.adoc index 89ad1412a3..ed7ab9f13a 100644 --- a/backup_and_restore/application_backup_and_restore/installing/configuring-backup-restore-pvc-datamover.adoc +++ b/backup_and_restore/application_backup_and_restore/installing/configuring-backup-restore-pvc-datamover.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] A backup PVC is an intermediate persistent volume claim (PVC) to store data during the data movement backup operation. For some storage classes, such as, CephFS, creating a read-only volume from a snapshot results in faster Data Mover backups. You create a `readonly` backup PVC by using the `nodeAgent.backupPVC` section of the `DataProtectionApplication` (DPA) and setting the `readOnly` access mode to `true`. diff --git a/backup_and_restore/application_backup_and_restore/installing/oadp-backup-restore-csi-snapshots.adoc b/backup_and_restore/application_backup_and_restore/installing/oadp-backup-restore-csi-snapshots.adoc index b0b7be6e2e..d66b71c325 100644 --- a/backup_and_restore/application_backup_and_restore/installing/oadp-backup-restore-csi-snapshots.adoc +++ b/backup_and_restore/application_backup_and_restore/installing/oadp-backup-restore-csi-snapshots.adoc @@ -6,7 +6,8 @@ include::_attributes/common-attributes.adoc[] toc::[] -You can back up and restore persistent volumes by using the OADP 1.3 Data Mover. +[role="_abstract"] +You can back up and restore persistent volumes by using the {oadp-short} 1.3 Data Mover. include::modules/oadp-1-3-backing-csi-snapshots.adoc[leveloffset=+1] diff --git a/backup_and_restore/application_backup_and_restore/installing/overriding-kopia-algorithms.adoc b/backup_and_restore/application_backup_and_restore/installing/overriding-kopia-algorithms.adoc index e6bd656005..69058c10dd 100644 --- a/backup_and_restore/application_backup_and_restore/installing/overriding-kopia-algorithms.adoc +++ b/backup_and_restore/application_backup_and_restore/installing/overriding-kopia-algorithms.adoc @@ -7,6 +7,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] You can override the default values of Kopia hashing, encryption, and splitter algorithms by using specific environment variables in the Data Protection Application (DPA). // configuring the DPA with Kopia environment variables diff --git a/modules/oadp-1-3-backing-csi-snapshots.adoc b/modules/oadp-1-3-backing-csi-snapshots.adoc index f2cf009f0a..688f399f58 100644 --- a/modules/oadp-1-3-backing-csi-snapshots.adoc +++ b/modules/oadp-1-3-backing-csi-snapshots.adoc @@ -5,6 +5,7 @@ [id="oadp-1-3-backing-csi-snapshots_{context}"] = Backing up persistent volumes with CSI snapshots +[role="_abstract"] You can use the OADP Data Mover to back up Container Storage Interface (CSI) volume snapshots to a remote object store. .Prerequisites diff --git a/modules/oadp-1-3-restoring-csi-snapshots.adoc b/modules/oadp-1-3-restoring-csi-snapshots.adoc index 3e492ff22d..b35c3d5d7f 100644 --- a/modules/oadp-1-3-restoring-csi-snapshots.adoc +++ b/modules/oadp-1-3-restoring-csi-snapshots.adoc @@ -6,11 +6,12 @@ [id="oadp-1-3-restoring-csi-snapshots_{context}"] = Restoring CSI volume snapshots +[role="_abstract"] You can restore a volume snapshot by creating a `Restore` CR. [NOTE] ==== -You cannot restore Volsync backups from OADP 1.2 with the OAPD 1.3 built-in Data Mover. It is recommended to do a file system backup of all of your workloads with Restic prior to upgrading to OADP 1.3. +You cannot restore Volsync backups from OADP 1.2 with the OAPD 1.3 built-in Data Mover. It is recommended to do a file system backup of all of your workloads with Restic before upgrading to OADP 1.3. ==== .Prerequisites diff --git a/modules/oadp-configuring-backup-pvc-datamover-backup.adoc b/modules/oadp-configuring-backup-pvc-datamover-backup.adoc index b69bc0105c..a5b3fae9d5 100644 --- a/modules/oadp-configuring-backup-pvc-datamover-backup.adoc +++ b/modules/oadp-configuring-backup-pvc-datamover-backup.adoc @@ -6,6 +6,7 @@ [id="configuring-backup-pvc_{context}"] = Configuring a backup PVC for a Data Mover backup +[role="_abstract"] Use the `nodeAgent.backupPVC` section of the `DataProtectionApplication` (DPA) object to configure the backup persistent volume claim (PVC) for a storage class. .Prerequisites diff --git a/modules/oadp-configuring-restore-pvc-datamover-restore.adoc b/modules/oadp-configuring-restore-pvc-datamover-restore.adoc index 65aaa78bfc..0fd47803d8 100644 --- a/modules/oadp-configuring-restore-pvc-datamover-restore.adoc +++ b/modules/oadp-configuring-restore-pvc-datamover-restore.adoc @@ -6,6 +6,7 @@ [id="configuring-restore-pvc_{context}"] = Configuring a restorePVC for a Data Mover restore +[role="_abstract"] A `restorePVC` is an intermediate PVC that is used to write data during the Data Mover restore operation. You can configure the `restorePVC` in the `DataProtectionApplication` (DPA) object by using the `ignoreDelayBinding` field. Setting the `ignoreDelayBinding` field to `true` allows the restore operation to ignore the `WaitForFirstConsumer` binding mode. The data movement restore operation then creates the restore pod and provisions the associated volume to an arbitrary node. diff --git a/modules/oadp-deletion-policy-1-3.adoc b/modules/oadp-deletion-policy-1-3.adoc index 61fa41fa72..d5f70c578d 100644 --- a/modules/oadp-deletion-policy-1-3.adoc +++ b/modules/oadp-deletion-policy-1-3.adoc @@ -6,6 +6,7 @@ [id="oadp-deletion-policy-1-3_{context}"] = Deletion policy for OADP 1.3 +[role="_abstract"] The deletion policy determines rules for removing data from a system, specifying when and how deletion occurs based on factors such as retention periods, data sensitivity, and compliance requirements. It manages data removal effectively while meeting regulations and preserving valuable information. [id="oadp-deletion-policy-guidelines-1-3_{context}"] diff --git a/modules/oadp-kopia-algorithms-benchmarking.adoc b/modules/oadp-kopia-algorithms-benchmarking.adoc index 3cddfcd420..e6314d2a9d 100644 --- a/modules/oadp-kopia-algorithms-benchmarking.adoc +++ b/modules/oadp-kopia-algorithms-benchmarking.adoc @@ -6,6 +6,7 @@ [id="oadp-kopia-algorithms-benchmarking_{context}"] = Benchmarking Kopia hashing, encryption, and splitter algorithms +[role="_abstract"] You can run Kopia commands to benchmark the hashing, encryption, and splitter algorithms. Based on the benchmarking results, you can select the most suitable algorithm for your workload. In this procedure, you run the Kopia benchmarking commands from a pod on the cluster. The benchmarking results can vary depending on CPU speed, available RAM, disk speed, current I/O load, and so on. .Prerequisites diff --git a/modules/oadp-kopia-configuring-algorithms.adoc b/modules/oadp-kopia-configuring-algorithms.adoc index ba8961851b..e5f3f5118d 100644 --- a/modules/oadp-kopia-configuring-algorithms.adoc +++ b/modules/oadp-kopia-configuring-algorithms.adoc @@ -6,6 +6,7 @@ [id="oadp-kopia-configuring-algorithms_{context}"] = Configuring the DPA to override Kopia hashing, encryption, and splitter algorithms +[role="_abstract"] You can use an {oadp-first} option to override the default Kopia algorithms for hashing, encryption, and splitter to improve Kopia performance or to compare performance metrics. You can set the following environment variables in the `spec.configuration.velero.podConfig.env` section of the DPA: * `KOPIA_HASHING_ALGORITHM` diff --git a/modules/oadp-usecase-kopia-override-algorithms.adoc b/modules/oadp-usecase-kopia-override-algorithms.adoc index 181616767b..e22946fa68 100644 --- a/modules/oadp-usecase-kopia-override-algorithms.adoc +++ b/modules/oadp-usecase-kopia-override-algorithms.adoc @@ -6,6 +6,7 @@ [id="oadp-usecase-kopia-override-algorithms.adoc_{context}"] = Use case for overriding Kopia hashing, encryption, and splitter algorithms +[role="_abstract"] The use case example demonstrates taking a backup of an application by using Kopia environment variables for hashing, encryption, and splitter. You store the backup in an {aws-short} S3 bucket. You then verify the environment variables by connecting to the Kopia repository. .Prerequisites