diff --git a/_attributes/common-attributes.adoc b/_attributes/common-attributes.adoc index 7dc7854f3293..a38bf2959ec1 100644 --- a/_attributes/common-attributes.adoc +++ b/_attributes/common-attributes.adoc @@ -42,8 +42,10 @@ endif::openshift-origin[] :insights-advisor-url: link:https://console.redhat.com/openshift/insights/advisor/[Insights Advisor] :hybrid-console: Red Hat Hybrid Cloud Console :hybrid-console-second: Hybrid Cloud Console +// OADP :oadp-first: OpenShift API for Data Protection (OADP) :oadp-full: OpenShift API for Data Protection +:oadp-short: OADP :oc-first: pass:quotes[OpenShift CLI (`oc`)] :product-registry: OpenShift image registry :rh-storage-first: Red Hat OpenShift Data Foundation @@ -253,3 +255,7 @@ endif::[] :coo-first: Cluster Observability Operator (COO) :coo-full: Cluster Observability Operator :coo-short: COO +//ODF +:odf-first: Red Hat OpenShift Data Foundation (ODF) +:odf-full: Red Hat OpenShift Data Foundation +:odf: ODF diff --git a/backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc b/backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc index 00d89855dc8d..13d920e4de88 100644 --- a/backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc +++ b/backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc @@ -57,3 +57,4 @@ include::modules/about-installing-oadp-on-multiple-namespaces.adoc[leveloffset=+ * xref:../../../operators/understanding/olm/olm-understanding-olm.adoc#olm-csv_olm-understanding-olm[Cluster service version] include::modules/oadp-velero-cpu-memory-requirements.adoc[leveloffset=+1] +include::modules/oadp-backup-restore-for-large-usage.adoc[leveloffset=+2] diff --git a/backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc b/backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc index b660ef48c6a7..23cc9ed6981f 100644 --- a/backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc +++ b/backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc @@ -37,6 +37,7 @@ include::modules/oadp-secrets-for-different-credentials.adoc[leveloffset=+2] You can configure the Data Protection Application by setting Velero resource allocations or enabling self-signed CA certificates. include::modules/oadp-setting-resource-limits-and-requests.adoc[leveloffset=+2] +include::modules/oadp-odf-cpu-memory-requirements.adoc[leveloffset=+3] include::modules/oadp-self-signed-certificate.adoc[leveloffset=+2] include::modules/oadp-installing-dpa-1-2-and-earlier.adoc[leveloffset=+1] diff --git a/modules/oadp-backup-restore-for-large-usage.adoc b/modules/oadp-backup-restore-for-large-usage.adoc new file mode 100644 index 000000000000..e620a7b38098 --- /dev/null +++ b/modules/oadp-backup-restore-for-large-usage.adoc @@ -0,0 +1,16 @@ +// Module included in the following assemblies: +// about-installing-oadp.adoc + +:_mod-docs-content-type: CONCEPT +[id="oadp-backup-restore-for-large-usage_{context}"] += NodeAgent CPU for large usage + +Increasing `NodeAgent` CPU shows a significant impact on improving backup and restore times when using {oadp}. + +It is not recommended to use Kopia without limits in production environments on nodes running production workloads due to Kopia’s aggressive consumption of resources. + +However running Kopia with limits that are too low results in CPU limiting and slow-performing backups and restore situations. + +The testing undertaken, observed that running with around 20 cores limit, and 32 Gi memory limit covered most of our largest cases effectively. + +Testing detected no CPU limiting or memory saturation with these resource specifications. diff --git a/modules/oadp-odf-cpu-memory-requirements.adoc b/modules/oadp-odf-cpu-memory-requirements.adoc new file mode 100644 index 000000000000..178b31c54514 --- /dev/null +++ b/modules/oadp-odf-cpu-memory-requirements.adoc @@ -0,0 +1,26 @@ +// Module included in the following assemblies: +// +// * backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc + +:_mod-docs-content-type: CONCEPT +[id="oadp-odf-cpu-memory-requirements_{context}"] += Adjust Ceph CPU and memory requirements based on collected data + +The following recommendations are based on observations of performance made in the scale and performance lab. The changes are specifically related to {odf-first}. If working with {odf}, consult the appropriate tuning guides for official recommendations. + +[id="oadp-odf-config-cpu-memory-requirements_{context}"] +== CPU and memory requirement for configurations + +Backup and restore operations require large amounts of Ceph-FS `PersistentVolumes` (PVs), and to avoid Ceph MDS pods restarting with an `out-of-memory` (OOM) error, the following configuration is suggested: + +|=== +| Configuration types | Request | Max limit + +| CPU +| Request changed to 3 +| Max limit to 3 + +| Memory +| Request changed to 8Gi +| Max limit to 128Gi +|===