From 3db2bd39d6bd5dae175ffcd3ada1a9bccef1d3c8 Mon Sep 17 00:00:00 2001 From: Prabha Kylasamiyer Sundara Rajan Date: Wed, 28 May 2025 10:41:50 +0530 Subject: [PATCH 1/2] OADP-5888 Add Line After Include Statements --- .../oadp-advanced-topics.adoc | 8 ++++++++ .../oadp-features-plugins.adoc | 7 +++++++ .../release-notes/oadp-1-4-release-notes.adoc | 5 +++++ 3 files changed, 20 insertions(+) diff --git a/backup_and_restore/application_backup_and_restore/oadp-advanced-topics.adoc b/backup_and_restore/application_backup_and_restore/oadp-advanced-topics.adoc index d77345385705..3c689612e259 100644 --- a/backup_and_restore/application_backup_and_restore/oadp-advanced-topics.adoc +++ b/backup_and_restore/application_backup_and_restore/oadp-advanced-topics.adoc @@ -12,23 +12,31 @@ This document provides information about advanced features and functionalities o == Working with different Kubernetes API versions on the same cluster include::modules/oadp-checking-api-group-versions.adoc[leveloffset=+2] + include::modules/oadp-about-enable-api-group-versions.adoc[leveloffset=+2] + include::modules/oadp-using-enable-api-group-versions.adoc[leveloffset=+2] [id="backing-up-data-one-cluster-restoring-another-cluster"] == Backing up data from one cluster and restoring it to another cluster include::modules/oadp-about-backing-and-restoring-from-cluster-to-cluster.adoc[leveloffset=+2] + include::modules/oadp-pod-volume-backup.adoc[leveloffset=+2] + include::modules/oadp-backing-up-opt-in.adoc[leveloffset=+3] + include::modules/oadp-backing-up-opt-out.adoc[leveloffset=+3] + include::modules/oadp-cluster-to-cluster-uid-and-gid-ranges.adoc[leveloffset=+2] + include::modules/oadp-backing-and-restoring-from-cluster-to-cluster.adoc[leveloffset=+2] [id="oadp-storage-class-mapping"] == OADP storage class mapping include::modules/oadp-storage-class-mapping.adoc[leveloffset=+2] + include::modules/oadp-storage-class-mapping-oadp.adoc[leveloffset=+3] [role="_additional-resources"] diff --git a/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc b/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc index bfd7b1c4cb7a..18b580695246 100644 --- a/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc +++ b/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc @@ -11,9 +11,13 @@ OpenShift API for Data Protection (OADP) features provide options for backing up The default plugins enable Velero to integrate with certain cloud providers and to back up and restore {product-title} resources. include::modules/oadp-features.adoc[leveloffset=+1] + include::modules/oadp-plugins.adoc[leveloffset=+1] + include::modules/oadp-configuring-velero-plugins.adoc[leveloffset=+1] + include::modules/oadp-plugins-receiving-eof-message.adoc[leveloffset=+2] + ifndef::openshift-rosa,openshift-rosa-hcp[] include::modules/oadp-supported-architecture.adoc[leveloffset=+1] endif::openshift-rosa,openshift-rosa-hcp[] @@ -29,8 +33,11 @@ OpenShift API for Data Protection (OADP) is platform neutral. The information th include::modules/oadp-ibm-power-test-support.adoc[leveloffset=+2] + include::modules/oadp-ibm-z-test-support.adoc[leveloffset=+2] + include::modules/oadp-ibm-power-and-z-known-issues.adoc[leveloffset=+3] + endif::openshift-rosa,openshift-rosa-hcp[] include::modules/oadp-fips.adoc[leveloffset=+1] diff --git a/backup_and_restore/application_backup_and_restore/release-notes/oadp-1-4-release-notes.adoc b/backup_and_restore/application_backup_and_restore/release-notes/oadp-1-4-release-notes.adoc index 9cc9f2c75379..b2fb50d50422 100644 --- a/backup_and_restore/application_backup_and_restore/release-notes/oadp-1-4-release-notes.adoc +++ b/backup_and_restore/application_backup_and_restore/release-notes/oadp-1-4-release-notes.adoc @@ -15,7 +15,9 @@ For additional information about {oadp-short}, see link:https://access.redhat.co ==== include::modules/oadp-1-4-4-release-notes.adoc[leveloffset=+1] + include::modules/oadp-1-4-3-release-notes.adoc[leveloffset=+1] + include::modules/oadp-1-4-2-release-notes.adoc[leveloffset=+1] [role="_additional-resources"] @@ -23,8 +25,11 @@ include::modules/oadp-1-4-2-release-notes.adoc[leveloffset=+1] * xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-deleting-backups.adoc#oadp-about-kopia-repo-maintenance_deleting-backups[About Kopia repository maintenance] include::modules/oadp-1-4-1-release-notes.adoc[leveloffset=+1] + include::modules/oadp-1-4-0-release-notes.adoc[leveloffset=+1] + include::modules/oadp-backing-up-dpa-configuration-1-4-0.adoc[leveloffset=+3] + include::modules/oadp-upgrading-oadp-operator-1-4-0.adoc[leveloffset=+3] // TODO: Include this xref when the Operators book is added to the ROSA HCP docs. From 98defa47dfb5f1d2c8485a13460fd880239f08f5 Mon Sep 17 00:00:00 2001 From: Prabha Kylasamiyer Sundara Rajan Date: Wed, 9 Jul 2025 15:46:22 +0530 Subject: [PATCH 2/2] Fixed validation errors --- .../oadp-features-plugins.adoc | 3 ++- modules/oadp-adp-controller-segmentation.adoc | 22 +++++++++++++++++++ .../oadp-plugins-receiving-eof-message.adoc | 12 ++++++++++ 3 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 modules/oadp-adp-controller-segmentation.adoc create mode 100644 modules/oadp-plugins-receiving-eof-message.adoc diff --git a/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc b/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc index 36a4047c7750..54130929e70e 100644 --- a/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc +++ b/backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc @@ -18,7 +18,7 @@ include::modules/oadp-configuring-velero-plugins.adoc[leveloffset=+1] include::modules/oadp-plugins-receiving-eof-message.adoc[leveloffset=+2] -======= + ifndef::openshift-rosa,openshift-rosa-hcp[] include::modules/oadp-supported-architecture.adoc[leveloffset=+1] endif::openshift-rosa,openshift-rosa-hcp[] @@ -45,6 +45,7 @@ endif::openshift-rosa,openshift-rosa-hcp[] include::modules/oadp-fips.adoc[leveloffset=+1] include::modules/avoiding-the-velero-plugin-panic-error.adoc[leveloffset=+1] + include::modules/workaround-for-openshift-adp-controller-segmentation-fault.adoc[leveloffset=+1] :!oadp-features-plugins: diff --git a/modules/oadp-adp-controller-segmentation.adoc b/modules/oadp-adp-controller-segmentation.adoc new file mode 100644 index 000000000000..9aef5746d4a1 --- /dev/null +++ b/modules/oadp-adp-controller-segmentation.adoc @@ -0,0 +1,22 @@ +// Module included in the following assemblies: +// +// applications/projects/working-with-projects.adoc + +:_mod-docs-content-type: PROCEDURE +[id="openshift-adp-controller-manager-seg-fault_{context}"] += OpenShift ADP Controller segmentation fault + +If you configure a DPA with both `cloudstorage` and `restic` enabled, the `openshift-adp-controller-manager` pod crashes and restarts indefinitely until the pod fails with a crash loop segmentation fault. + +You can have either `velero` or `cloudstorage` defined, because they are mutually exclusive fields. + +* If you have both `velero` and `cloudstorage` defined, the `openshift-adp-controller-manager` fails. +* If you have neither `velero` nor `cloudstorage` defined, the `openshift-adp-controller-manager` fails. + +For more information about this issue, see link:https://issues.redhat.com/browse/OADP-1054[OADP-1054]. + + +[id="openshift-adp-controller-manager-seg-fault-workaround_{context}"] +== OpenShift ADP Controller segmentation fault workaround + +You must define either `velero` or `cloudstorage` when you configure a DPA. If you define both APIs in your DPA, the `openshift-adp-controller-manager` pod fails with a crash loop segmentation fault. \ No newline at end of file diff --git a/modules/oadp-plugins-receiving-eof-message.adoc b/modules/oadp-plugins-receiving-eof-message.adoc new file mode 100644 index 000000000000..7bb4990943a8 --- /dev/null +++ b/modules/oadp-plugins-receiving-eof-message.adoc @@ -0,0 +1,12 @@ +// Module is included in the following assemblies: +// +// * openshift-docs/cicd/gitops/understanding-openshift-gitops.adoc + +:_mod-docs-content-type: CONCEPT +[id="oadp-plugins-receiving-eof-message_{context}"] += Velero plugins returning "received EOF, stopping recv loop" message + +[NOTE] +==== +Velero plugins are started as separate processes. After the Velero operation has completed, either successfully or not, they exit. Receiving a `received EOF, stopping recv` loop message in the debug logs indicates that a plugin operation has completed. It does not mean that an error has occurred. +==== \ No newline at end of file