Skip to content

Commit cfae7ce

Browse files
sheriff-rhsheriff-rh
authored
Merge pull request #78272 from apurvabhide17/OADP-4002-1.4.0-release-notes
2 parents 790f168 + 96d5cb2 commit cfae7ce

File tree

5 files changed

+130
-0
lines changed

5 files changed

+130
-0
lines changed

‎_topic_maps/_topic_map.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3179,6 +3179,8 @@ Topics:
31793179
- Name: OADP release notes
31803180
Dir: release-notes
31813181
Topics:
3182+
- Name: OADP 1.4 release notes
3183+
File: oadp-1-4-release-notes
31823184
- Name: OADP 1.3 release notes
31833185
File: oadp-release-notes-1-3
31843186
- Name: OADP 1.2 release notes

‎backup_and_restore/application_backup_and_restore/release-notes/oadp-1-4-release-notes.adoc

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
:_mod-docs-content-type: ASSEMBLY
2+
[id="oadp-1-4-release-notes"]
3+
= OADP 1.4 release notes
4+
include::_attributes/common-attributes.adoc[]
5+
include::_attributes/attributes-openshift-dedicated.adoc[]
6+
:context: oadp-1-4-release-notes
7+
8+
toc::[]
9+
10+
The release notes for OpenShift API for Data Protection (OADP) describe new features and enhancements, deprecated features, product recommendations, known issues, and resolved issues.
11+
12+
include::modules/oadp-1-4-0-release-notes.adoc[leveloffset=+1]
13+
include::modules/oadp-backing-up-dpa-configuration-1-4-0.adoc[leveloffset=+3]
14+
include::modules/oadp-upgrading-oadp-operator-1-4-0.adoc[leveloffset=+3]
15+
[role="_additional-resources"]
16+
.Additional resources
17+
* xref:../../../operators/admin/olm-upgrading-operators.adoc#olm-changing-update-channel_olm-upgrading-operators[Updating installed Operators]
18+
19+
[id="oadp-converting-dpa-to-new-version-1-4-0_{context}"]
20+
=== Converting DPA to the new version
21+
22+
To upgrade from OADP 1.3 to 1.4, no Data Protection Application (DPA) changes are required.
23+
24+
[id="verifying-upgrade-1-4-0_{context}"]
25+
=== Verifying the upgrade
26+
27+
Verify the installation by following steps from the link:https://docs.openshift.com/container-platform/4.15/backup_and_restore/application_backup_and_restore/release-notes/oadp-release-notes-1-2.html#verifying-upgrade-1-2-0_oadp-release-notes[Verifying the upgrade] section.

‎modules/oadp-1-4-0-release-notes.adoc

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
:_newdoc-version: 2.18.3
2+
:_template-generated: 2024-06-28
3+
// Module included in the following assemblies:
4+
//
5+
// * backup_and_restore/oadp-1-4-release-notes.adoc
6+
7+
:_mod-docs-content-type: REFERENCE
8+
9+
[id="oadp-1-4-0-release-notes_{context}"]
10+
= OADP 1.4.0 release notes
11+
12+
The {oadp-first} 1.4.0 release notes lists resolved issues and known issues.
13+
14+
[id="resolved-issues-1-4-0_{context}"]
15+
== Resolved issues
16+
17+
.Restore works correctly in {product-title} 4.16
18+
19+
Previously, while restoring the deleted application namespace, the restore operation partially failed with the `resource name may not be empty` error in {product-title} 4.16.
20+
With this update, restore works as expected in {product-title} 4.16.
21+
link:https://issues.redhat.com/browse/OADP-4075[OADP-4075]
22+
23+
.Data Mover backups work properly in the {product-title} 4.16 cluster
24+
25+
Previously, Velero was using the earlier version of SDK where the `Spec.SourceVolumeMode` field did not exist. As a consequence, Data Mover backups failed in the {product-title} 4.16 cluster on the external snapshotter with v4.2 version.
26+
With this update, external snapshotter is upgraded to v7.0 version and later. As a result, backups do not fail in the {product-title} 4.16 cluster.
27+
link:https://issues.redhat.com/browse/OADP-3922[OADP-3922]
28+
29+
For a complete list of all issues resolved in this release, see the list of link:https://issues.redhat.com/issues/?filter=12438505[OADP 1.4.0 resolved issues] in Jira.
30+
31+
32+
[id="known-issues-1-4-0_{context}"]
33+
== Known issues
34+
35+
.Backup fails when checksumAlgorithm is not set for MCG
36+
37+
While performing a backup of any application with Noobaa as the backup location, if the `checksumAlgorithm` configuration parameter is not set, backup fails. To fix this problem, if you do not provide a value for `checksumAlgorithm` in the Backup Storage Location (BSL) configuration, an empty value is added.
38+
The empty value is only added for BSLs that are created using Data Protection Application (DPA) custom resource (CR), and this value is not added if BSLs are created using any other method.
39+
link:https://issues.redhat.com/browse/OADP-4274[OADP-4274]
40+
41+
For a complete list of all known issues in this release, see the list of link:https://issues.redhat.com/issues/?filter=12438506[OADP 1.4.0 known issues] in Jira.
42+
43+
44+
[id="upgrade-notes-1-4-0_{context}"]
45+
== Upgrade notes
46+
47+
[NOTE]
48+
====
49+
Always upgrade to the next minor version. *Do not* skip versions. To update to a later version, upgrade only one channel at a time. For example, to upgrade from {oadp-first} 1.1 to 1.3, upgrade first to 1.2, and then to 1.3.
50+
====
51+
52+
[id="changes-oadp-1-3-to-1-4_{context}"]
53+
=== Changes from OADP 1.3 to 1.4
54+
55+
The Velero server has been updated from version 1.12 to 1.14. Note that, there are no changes in the Data Protection Application (DPA).
56+
57+
This changes the following:
58+
59+
* The `velero-plugin-for-csi` code is now available in the Velero code, which means no `init` container is needed for the plugin anymore.
60+
61+
* Velero changed client Burst and QPS defaults from 30 and 20 to 100 and 100 respectively.
62+
63+
* The `velero-plugin-for-aws` plugin updated default value of the `spec.config.checksumAlgorithm` field in BackupStorageLocations (BSLs) from `""` (no checksum calculation) to the `CRC32` algorithm. For more information, see link:https://github.com/vmware-tanzu/velero-plugin-for-aws/blob/release-1.10/backupstoragelocation.md[Velero plugins for AWS Backup Storage Location]. The checksum algorithm types are known to work only with AWS.
64+
Several S3 providers require the `md5sum` to be disabled by setting the checksum algorithm to `""`. Confirm `md5sum` algorithm support and configuration with your storage provider.
65+
+
66+
In OADP 1.4, the default value for BSLs created within DPA for this configuration is `""`. This default value means that the `md5sum` is not checked, which is consistent with OADP 1.3. For BSLs created within DPA, update it by using the `spec.backupLocations[].velero.config.checksumAlgorithm` field in the DPA. If your BSLs are created outside DPA, you can update this configuration by using `spec.config.checksumAlgorithm` in the BSLs.

‎modules/oadp-backing-up-dpa-configuration-1-4-0.adoc

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * backup_and_restore/oadp-1-4-release-notes.adoc
4+
5+
:_mod-docs-content-type: PROCEDURE
6+
7+
[id="oadp-backing-up-dpa-configuration-1-4-0_{context}"]
8+
= Backing up the DPA configuration
9+
10+
You must back up your current `DataProtectionApplication` (DPA) configuration.
11+
12+
.Procedure
13+
* Save your current DPA configuration by running the following command:
14+
+
15+
.Example
16+
[source,terminal]
17+
----
18+
$ oc get dpa -n openshift-adp -o yaml > dpa.orig.backup
19+
----

‎modules/oadp-upgrading-oadp-operator-1-4-0.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/oadp-1-4-release-notes.adoc
4+
5+
:_mod-docs-content-type: PROCEDURE
6+
7+
[id="oadp-upgrading-dpa-operator-1-4-0_{context}"]
8+
= Upgrading the OADP Operator
9+
10+
Use the following procedure when upgrading the {oadp-first} Operator.
11+
12+
.Procedure
13+
14+
. Change your subscription channel for the OADP Operator from `stable-1.3` to `stable-1.4`.
15+
. Wait for the operator and containers to update and restart.
16+

0 commit comments

Comments
 (0)