AWS AmazonRDS documentation change
Summary
Added documentation about Spatial Patch Bundles (SPBs) alongside Release Updates (RUs), clarified upgrade paths between RU and SPB versions, updated examples, and added CLI command examples. Removed PSU references and integrated downgrade note.
Security assessment
The change adds explicit documentation that Release Updates (RUs) include security fixes, which qualifies as security documentation. However, there's no mention of addressing a specific vulnerability or security incident - this appears to be routine documentation of standard update types containing security patches.
Diff
diff --git a/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.Minor.md index a70a667c2..dabbc50c7 100644 --- a/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.Minor.md +++ b/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.Minor.md @@ -5 +5 @@ -Turning on automatic minor version upgrades for OracleAdvance notice of automatic minor version upgrade schedulingWhen RDS schedules automatic minor version upgrades for OracleManaging an automatic minor version upgrade for Oracle +Release Updates (RUs) and Spatial Patch Bundles (SPBs)Turning on automatic minor version upgrades for OracleAdvance notice of automatic minor version upgrade schedulingWhen RDS schedules automatic minor version upgrades for OracleManaging an automatic minor version upgrade for Oracle @@ -9 +9 @@ Turning on automatic minor version upgrades for OracleAdvance notice of automati -A minor version upgrade applies an Oracle Database Patch Set Update (PSU) or Release Update (RU) to a major engine version. For example, if your DB instance runs major version Oracle Database 21c and minor version 21.0.0.0.ru-2024-04.rur-2024-04.r1, you can upgrade your upgrade to minor version 21.0.0.0.ru-2024-07.rur-2024-07.r1. Typically, a new minor version is available every quarter. +In RDS for Oracle, a minor version upgrade is an update to a major DB engine version. In RDS, a minor engine version is either a Release Update (RU) or Spatial Patch Bundle (SPB). For example, if your DB instance runs major version Oracle Database 21c and minor version 21.0.0.0.ru-2024-10.rur-2024-10.r1, you can upgrade your DB engine to minor version 21.0.0.0.ru-2025-01.rur-2025-01.r1. RDS for Oracle doesn't support minor version downgrades. @@ -11,5 +11 @@ A minor version upgrade applies an Oracle Database Patch Set Update (PSU) or Rel -###### Note - -RDS for Oracle doesn't support minor version downgrades. - -You can upgrade your DB engine to a minor version manually or automatically. To learn how to upgrade manually, see [Manually upgrading the engine version](./USER_UpgradeDBInstance.Upgrading.html#USER_UpgradeDBInstance.Upgrading.Manual). To learn how to configure automatic upgrades, see [Automatically upgrading the minor engine version](./USER_UpgradeDBInstance.Upgrading.html#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades). Whether you upgrade manually or automatically, a minor version upgrade entails downtime. Keep this in mind when planning your upgrades. +You can upgrade your DB engine to a minor version manually or automatically. To learn how to upgrade manually, see [Manually upgrading the engine version](./USER_UpgradeDBInstance.Upgrading.html#USER_UpgradeDBInstance.Upgrading.Manual). To learn how to configure automatic upgrades, see [Automatically upgrading the minor engine version](./USER_UpgradeDBInstance.Upgrading.html#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades). Whether you upgrade manually or automatically, a minor version upgrade entails downtime. Consider this downtime when you plan your upgrades. @@ -22,0 +19,2 @@ Make sure that you thoroughly test any upgrade to verify that your applications + * Release Updates (RUs) and Spatial Patch Bundles (SPBs) + @@ -29,0 +31,42 @@ Make sure that you thoroughly test any upgrade to verify that your applications + +## Release Updates (RUs) and Spatial Patch Bundles (SPBs) + +In RDS, a release update (RU) is a quarterly minor engine version that includes security fixes, bug fixes, and new features for Oracle Database. A Spatial Patch Bundle (SPB) is an RU engine version that includes patches designed for the Oracle Spatial option. For example, the SPB named 19.0.0.0.ru-2025-01.spb-1.r1 includes all patches in the corresponding RU 19.0.0.0.ru-2025-01.rur-2025-01.r1 plus patches specific to Spatial. SPBs are supported only for Oracle Database 19c. + +When your instance is configured for automatic minor version upgrades, RUs and SPBs are on separate upgrade paths. Typically, an SPB is released 2–3 weeks after its corresponding RU. The following table shows sample minor versions for Oracle Database 19c. + +Standard RU upgrade path | SPB upgrade path +---|--- +19.0.0.0.ru-2025-01.rur-2025-01.r1 | 19.0.0.0.ru-2025-01.spb-1.r1 +19.0.0.0.ru-2025-04.rur-2025-04.r1 | 19.0.0.0.ru-2025-04.spb-1.r1 +19.0.0.0.ru-2025-07.rur-2025-07.r1 | 19.0.0.0.ru-2025-07.spb-1.r1 +19.0.0.0.ru-2025-10.rur-2025-10.r1 | 19.0.0.0.ru-2025-10.spb-1.r1 + +If your DB instance is configured for automatic upgrades, your instance is on the upgrade path corresponding to your current version. For example, if your DB instance runs version 19.0.0.0.ru-2025-01.rur-2025-01.r1, then when 19.0.0.0.ru-2025-04.rur-2025-04.r1 is released, your instance automatically upgrades to this RU. Similarly, if your DB instance runs 19.0.0.0.ru-2025-01.spb-1.r1, then when 19.0.0.0.ru-2025-04.spb-1.r1 is released, your instance automatically upgrades to this SPB. An instance running 19.0.0.0.ru-2025-01.rur-2025-01.r1, which is an RU, won't automatically upgrade to 19.0.0.0.ru-2025-04.spb-1.r1, which is an SPB on a separate upgrade path. + +You can upgrade your DB instance to SPBs even if your instance doesn't use Spatial, but the Spatial patches apply only to Oracle Spatial. You can upgrade manually from an RU to an SPB at the same engine version or higher. For example, you can upgrade your instance from 19.0.0.0.ru-2025-01.rur-2025-01.r1 to either of the following engine versions: + + * 19.0.0.0.ru-2025-01.spb-1.r1 + + * 19.0.0.0.ru-2025-04.spb-1.r1 + + + + +You can upgrade your instance from an SPB to an RU only if the RU is a higher engine version. For example, you can upgrade from SPB version 19.0.0.0.ru-2025-04.spb-1.r1 to a higher RU version 19.0.0.0.ru-2025-07.rur-2025-07.r1 but not to the same RU version 19.0.0.0.ru-2025-04.rur-2025-04.r1. + +If your DB instance is configured for automatic minor version upgrades, and you manually upgrade from an RU to an SPB or from an SPB to an RU, your automatic upgrade path changes. Suppose that you manually upgrade from RU version 19.0.0.0.ru-2025-01.rur-2025-01.r1 to SPB version 19.0.0.0.ru-2025-01.spb-1.r1. Your next automatic minor version upgrade will be to SPB version 19.0.0.0.ru-2025-04.spb-1.r1. + +Because SPBs function as RUs, the RDS APIs for upgrading your instance to RUs and SPBs are identical. The following commands demonstrate upgrading to an RU and to an SPB. + + + aws rds modify-db-instance \ + --db-instance-identifier mydbinstance \ + --engine-version 19.0.0.0.ru-2025-01.rur-2025-01.r1 + + aws rds modify-db-instance \ + --db-instance-identifier mydbinstance \ + --engine-version 19.0.0.0.ru-2025-01.spb-1.r1 + +For more information about the Oracle Spatial option, see [How Spatial Patch Bundles (SPBs) work](./Oracle.Options.Spatial.html#Oracle.Options.Spatial.SPBs). For supported RUs and SPBs for Oracle Database 19c, see [Amazon RDS for Oracle Database 19c (19.0.0.0)](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/oracle-version-19-0.html). + @@ -67 +110 @@ You can also get the upgrade availability date by using the `describe-pending-ma - "CurrentApplyDate": "2022-12-02T08:10:00Z", + "CurrentApplyDate": "2024-12-02T08:10:00Z",