From fb3f745a062333bfc03cbfff96d935229b308276 Mon Sep 17 00:00:00 2001 From: Simon Pane Date: Fri, 24 Jan 2025 06:28:07 -0700 Subject: [PATCH] Add support for the latest RU patches (up to and including JAN2025). * Add 19c patch metadata to YAML configuration and documentation; Documentation fixes * Update documentation with details on the latest 12cR1 and 12cR2 patches (already in the toolkit) * Change markdown syntax format marker to lower-case (upper-case not always supported) * Update with JAN2025 patch details --- docs/patch-metadata.md | 21 +++-- docs/user-guide.md | 153 +++++++++++++++++++++------------ roles/common/defaults/main.yml | 7 +- 3 files changed, 114 insertions(+), 67 deletions(-) diff --git a/docs/patch-metadata.md b/docs/patch-metadata.md index 52008c62..3dd7401c 100644 --- a/docs/patch-metadata.md +++ b/docs/patch-metadata.md @@ -1,8 +1,8 @@ -#### A note on patch metadata +# A note on patch metadata -The patching code derives the patch metadata from the following blocks in the file role/common/default/main.yml: +The patching code derives the patch metadata from the following blocks in the file `role/common/default/main.yml`: -``` +```yaml gi_patches: ... - { category: "RU", base: "19.3.0.0.0", release: "19.9.0.0.201020", patchnum: "31720429", patchfile: "p31720429_190000_Linux-x86-64.zip", patch_subdir: "/31750108", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "tTZDYSasdnt7lrNJ/MYm1g==" } @@ -14,15 +14,15 @@ rdbms_patches: ``` These metadata numbers can be taken from consulting appropriate MOS Notes, such as: - -- Master Note for Database Proactive Patch Program (Doc ID 888.1) -- Oracle Database 19c Proactive Patch Information (Doc ID 2521164.1) -- Database 18c Proactive Patch Information (Doc ID 2369376.1) -- Database 12.2.0.1 Proactive Patch Information (Doc ID 2285557.1) +- [Assistant: Download Reference for Oracle Database/GI Update, Revision, PSU, SPU(CPU), Bundle Patches, Patchsets and Base Releases (Doc ID 2118136.2)](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2118136.2) +- [Master Note for Database Proactive Patch Program (Doc ID 888.1)](https://support.oracle.com/epmos/faces/DocContentDisplay?id=888.1) +- [Oracle Database 19c Proactive Patch Information (Doc ID 2521164.1)](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2521164.1) +- [Database 18c Proactive Patch Information (Doc ID 2369376.1)](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2369376.1) +- [Database 12.2.0.1 Proactive Patch Information (Doc ID 2285557.1)](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2285557.1) The md5sum can be determined by listing the file once in a GCS bucket: -``` +```bash $ gsutil ls -L gs://example-bucket/p32578973_190000_Linux-x86-64.zip | grep md5 Hash (md5): YLEOruyjCOdDvUOMBUazNQ== ``` @@ -50,5 +50,4 @@ Bearing in mind that the GI RU's patch zipfile contains the patch molecules that └── PatchSearch.xml ``` - -Accordingly the patch_subdir values can be edited, as noted in the foregoing. +Accordingly the `patch_subdir` values can be edited, as noted in the foregoing. diff --git a/docs/user-guide.md b/docs/user-guide.md index d6ad9622..0486b033 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -6,52 +6,55 @@ published: True ## Table of Contents -- [Command quick reference for single instance deployments](#command-quick-reference-for-single-instance-deployments) -- [Command quick reference for RAC deployments](#command-quick-reference-for-rac-deployments) -- [Command quick reference for DR deployments](#command-quick-reference-for-dr-deployments) -- [Overview](#overview) - - [Software Stack](#software-stack) - - [Requirements and Prerequisites](#requirements-and-prerequisites) - - [Control node requirements](#control-node-requirements) - - [Target server requirements](#target-server-requirements) -- [Installing the toolkit](#installing-the-toolkit) -- [Downloading and staging the Oracle Software](#downloading-and-staging-the-oracle-software) - - [Downloading the Oracle installation software](#downloading-the-oracle-installation-software) - - [Downloading Patches from My Oracle Support](#downloading-patches-from-my-oracle-support) - - [Required Oracle Software - Download Summary](#required-oracle-software---download-summary) - - [Staging the Oracle installation media](#staging-the-oracle-installation-media) - - [Cloud Storage bucket](#cloud-storage-bucket) - - [Cloud Storage FUSE](#cloud-storage-fuse) - - [NFS share](#nfs-share) - - [Validating Media](#validating-media) -- [Prerequisite configuration](#prerequisite-configuration) - - [Data mount configuration file](#data-mount-configuration-file) - - [ASM disk group configuration file](#asm-disk-group-configuration-file) - - [Specifying LVM logical volumes](#specifying-lvm-logical-volumes) -- [Configuring Installations](#configuring-installations) - - [Configuration defaults](#configuration-defaults) - - [Oracle User Directories](#oracle-user-directories) - - [Database backup configuration](#database-backup-configuration) - - [Parameters](#parameters) - - [Target environment parameters](#target-environment-parameters) - - [Software installation parameters](#software-installation-parameters) - - [Storage configuration parameters](#storage-configuration-parameters) - - [Database configuration parameters](#database-configuration-parameters) - - [RAC configuration parameters](#rac-configuration-parameters) - - [Backup configuration parameters](#backup-configuration-parameters) - - [Additional operational parameters](#additional-operational-parameters) - - [Example Toolkit Execution](#example-toolkit-execution) -- [Post installation tasks](#post-installation-tasks) - - [Reset passwords](#reset-passwords) - - [Validate the environment](#validate-the-environment) - - [Listing Oracle ASM devices](#listing-oracle-asm-devices) - - [Displaying cluster resource status](#displaying-cluster-resource-status) - - [Verify an Oracle cluster](#verify-an-oracle-cluster) - - [Oracle validation utilities](#oracle-validation-utilities) - - [Patching](#patching) - - [A note on patch metadata](#a-note-on-patch-metadata) - - [Patching RAC databases](#patching-rac-databases) - - [Destructive Cleanup](#destructive-cleanup) +- [Toolkit for Bare Metal Solution: User Guide](#toolkit-for-bare-metal-solution-user-guide) + - [Table of Contents](#table-of-contents) + - [Command quick reference for single instance deployments](#command-quick-reference-for-single-instance-deployments) + - [Command quick reference for RAC deployments](#command-quick-reference-for-rac-deployments) + - [Command quick reference for DR deployments](#command-quick-reference-for-dr-deployments) + - [Overview](#overview) + - [Software Stack](#software-stack) + - [Requirements and Prerequisites](#requirements-and-prerequisites) + - [Control node requirements](#control-node-requirements) + - [Target server requirements](#target-server-requirements) + - [Installing the toolkit](#installing-the-toolkit) + - [Downloading and staging the Oracle Software](#downloading-and-staging-the-oracle-software) + - [Downloading the Oracle installation software](#downloading-the-oracle-installation-software) + - [Downloading Patches from My Oracle Support](#downloading-patches-from-my-oracle-support) + - [Required Oracle Software - Download Summary](#required-oracle-software---download-summary) + - [Staging the Oracle installation media](#staging-the-oracle-installation-media) + - [Cloud Storage bucket](#cloud-storage-bucket) + - [Cloud Storage FUSE](#cloud-storage-fuse) + - [NFS share](#nfs-share) + - [Validating Media](#validating-media) + - [Prerequisite configuration](#prerequisite-configuration) + - [Data mount configuration file](#data-mount-configuration-file) + - [ASM disk group configuration file](#asm-disk-group-configuration-file) + - [Specifying LVM logical volumes](#specifying-lvm-logical-volumes) + - [Configuring Installations](#configuring-installations) + - [Configuration defaults](#configuration-defaults) + - [Oracle User Directories](#oracle-user-directories) + - [Database backup configuration](#database-backup-configuration) + - [Parameters](#parameters) + - [Target environment parameters](#target-environment-parameters) + - [Software installation parameters](#software-installation-parameters) + - [Storage configuration parameters](#storage-configuration-parameters) + - [Database configuration parameters](#database-configuration-parameters) + - [RAC configuration parameters](#rac-configuration-parameters) + - [Backup configuration parameters](#backup-configuration-parameters) + - [Additional operational parameters](#additional-operational-parameters) + - [Example Toolkit Execution](#example-toolkit-execution) + - [Post installation tasks](#post-installation-tasks) + - [Reset passwords](#reset-passwords) + - [Validate the environment](#validate-the-environment) + - [Listing Oracle ASM devices](#listing-oracle-asm-devices) + - [Displaying cluster resource status](#displaying-cluster-resource-status) + - [Verify an Oracle cluster](#verify-an-oracle-cluster) + - [Oracle validation utilities](#oracle-validation-utilities) + - [Patching](#patching) + - [A note on patch metadata](#a-note-on-patch-metadata) + - [Patching RAC databases](#patching-rac-databases) + - [BMS RAC install with latest RU](#bms-rac-install-with-latest-ru) + - [Destructive Cleanup](#destructive-cleanup) ## Command quick reference for single instance deployments @@ -358,6 +361,24 @@ Support") Patch - MOS +COMBO OF OJVM RU COMPONENT 19.26.0.0.250100 + GI RU 19.26.0.0.250100 +p00000000_190000_Linux-x86-64.zip + + + +Patch - MOS +COMBO OF OJVM RU COMPONENT 19.25.0.0.241015 + GI RU 19.25.0.0.241015 +p36866740_190000_Linux-x86-64.zip + + + +Patch - MOS +COMBO OF OJVM RU COMPONENT 19.24.0.0.240716 + GI RU 19.24.0.0.240716 +p36522439_190000_Linux-x86-64.zip + + + +Patch - MOS COMBO OF OJVM RU COMPONENT 19.23.0.0.240416 + GI RU 19.23.0.0.240416 p36209493_190000_Linux-x86-64.zip @@ -391,7 +412,6 @@ Support") COMBO OF OJVM RU COMPONENT 19.10.0.0.210119 + GI RU 19.10.0.0.210119 p32126842_190000_Linux-x86-64.zip - @@ -459,7 +479,6 @@ href="https://support.oracle.com/epmos/faces/PatchResultsNDetails?releaseId=6000 COMBO OF OJVM RU COMPONENT 18.13.0.0.210119 + GI RU 18.13.0.0.210119 p32126862_180000_Linux-x86-64.zip - @@ -525,6 +544,12 @@ x86-64 Patch - MOS +COMBO OF OJVM RU COMPONENT 12.2.0.1.220118 + 12.2.0.1.220118 GIJAN2022RU +p33559966_122010_Linux-x86-64.zip + + + +Patch - MOS COMBO OF OJVM RU COMPONENT 12.2.0.1.211019 + 12.2.0.1.211019 GIOCT2021RU p33248546_122010_Linux_Linux-x86-64.zip @@ -623,6 +648,24 @@ V46096-01_2of2.zip Patch - MOS +COMBO OF OJVM COMPONENT 12.1.0.2.220719 DB PSU + GIPSU 12.1.0.2.220719 +p34163645_121020_Linux-x86-64.zip + + + +Patch - MOS +COMBO OF OJVM COMPONENT 12.1.0.2.220419 DB PSU + GIPSU 12.1.0.2.220419 +p33859511_121020_Linux-x86-64.zip + + + +Patch - MOS +COMBO OF OJVM COMPONENT 12.1.0.2.220118 DB PSU + GIPSU 12.1.0.2.220118 +p33560011_121020_Linux-x86-64.zip + + + +Patch - MOS COMBO OF OJVM COMPONENT 12.1.0.2.211019 DB PSU + GIPSU 12.1.0.2.211019 p33248580_121020_Linux-x86-64.zip @@ -2150,10 +2193,10 @@ both the Grid Infrastructure and Database homes by using the By default, `install-oracle.sh` updates to the latest available patch. To apply a specific patch instead, use the `--no-patch` option in `install-oracle.sh` -to skip patching at installation time. After installation is complete, execute -`apply-patch.sh` with the `--ora-release` option. Specify the full release name including -timestamp; a list of release names is available in -https://github.com/google/bms-toolkit/tree/master/roles/common/defaults/main.yml +to skip patching at installation time. After installation is complete, execute +`apply-patch.sh` with the `--ora-release` option. Specify the full release name including +timestamp; a list of release names is available in [roles/common/defaults/main.yml]( +https://github.com/google/bms-toolkit/tree/master/roles/common/defaults/main.yml) under `gi-patches` and `rdbms-patches`. A digest of the required patch files, including checksum hashes is provided in @@ -2184,13 +2227,13 @@ $ ./apply-patch.sh \ --ora-swlib-path /u02/oracle_install \ --ora-staging /u02/oracle_install \ --ora-version 19.3.0.0.0 \ - --ora-release 19.6.0.0.200114 \ + --ora-release 19.25.0.0.241015 \ --inventory-file inventory_files/inventory_toolkit-db2_ORCL Running with parameters from command line or environment variables: ORA_DB_NAME=ORCL -ORA_RELEASE=19.6.0.0.200114 +ORA_RELEASE=19.25.0.0.241015 ORA_STAGING=/u02/oracle_install ORA_SWLIB_BUCKET=gs://oracle-software ORA_SWLIB_PATH=/u02/oracle_install @@ -2218,7 +2261,7 @@ TASK [patch : Update OPatch in GRID_HOME] #### A note on patch metadata -See [patching-metadata.md](./patching-metadata.md) for details on +See [patch-metadata.md](./patch-metadata.md) for details on updating quarterly Release Update metadata. ### Patching RAC databases diff --git a/roles/common/defaults/main.yml b/roles/common/defaults/main.yml index 0ae7fdcf..4763f320 100644 --- a/roles/common/defaults/main.yml +++ b/roles/common/defaults/main.yml @@ -314,6 +314,9 @@ gi_patches: - { category: "RU", base: "19.3.0.0.0", release: "19.21.0.0.231017", patchnum: "35742441", patchfile: "p35742441_190000_Linux-x86-64.zip", patch_subdir: "/35642822", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "XCHpxqMlJ0/4dTUeMYNcSg==" } - { category: "RU", base: "19.3.0.0.0", release: "19.22.0.0.240116", patchnum: "36031453", patchfile: "p36031453_190000_Linux-x86-64.zip", patch_subdir: "/35940989", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "HEUyMq/Zdugnxn76ebihgA==" } - { category: "RU", base: "19.3.0.0.0", release: "19.23.0.0.240416", patchnum: "36209493", patchfile: "p36209493_190000_Linux-x86-64.zip", patch_subdir: "/36233126", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "CTM7Xpq2rSWtetdERsi4IQ==" } + - { category: "RU", base: "19.3.0.0.0", release: "19.24.0.0.240716", patchnum: "36522439", patchfile: "p36522439_190000_Linux-x86-64.zip", patch_subdir: "/36582629", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "ysQplJ/kY19rRPZmntFsMA==" } + - { category: "RU", base: "19.3.0.0.0", release: "19.25.0.0.241015", patchnum: "36866740", patchfile: "p36866740_190000_Linux-x86-64.zip", patch_subdir: "/36916690", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "f8DKaIiP7v811/WaRyacTQ==" } + - { category: "RU", base: "19.3.0.0.0", release: "19.26.0.0.250121", patchnum: "37262208", patchfile: "p37262208_190000_Linux-x86-64.zip", patch_subdir: "/37257886", prereq_check: FALSE, method: "opatchauto apply", ocm: FALSE, upgrade: FALSE, md5sum: "zqZeJ3/ujDWcLr+reZOHpw==" } rdbms_patches: # 11.2.0.4 OJVM packages from Combo @@ -379,4 +382,6 @@ rdbms_patches: - { category: "RU_Combo", base: "19.3.0.0.0", release: "19.21.0.0.231017", patchnum: "35742441", patchfile: "p35742441_190000_Linux-x86-64.zip", patch_subdir: "/35648110", prereq_check: TRUE, method: "opatch apply", ocm: FALSE, upgrade: TRUE, md5sum: "XCHpxqMlJ0/4dTUeMYNcSg==" } - { category: "RU_Combo", base: "19.3.0.0.0", release: "19.22.0.0.240116", patchnum: "36031453", patchfile: "p36031453_190000_Linux-x86-64.zip", patch_subdir: "/35926646", prereq_check: TRUE, method: "opatch apply", ocm: FALSE, upgrade: TRUE, md5sum: "HEUyMq/Zdugnxn76ebihgA==" } - { category: "RU_Combo", base: "19.3.0.0.0", release: "19.23.0.0.240416", patchnum: "36209493", patchfile: "p36209493_190000_Linux-x86-64.zip", patch_subdir: "/36199232", prereq_check: TRUE, method: "opatch apply", ocm: FALSE, upgrade: TRUE, md5sum: "CTM7Xpq2rSWtetdERsi4IQ==" } - + - { category: "RU_Combo", base: "19.3.0.0.0", release: "19.24.0.0.240716", patchnum: "36522439", patchfile: "p36522439_190000_Linux-x86-64.zip", patch_subdir: "/36414915", prereq_check: TRUE, method: "opatch apply", ocm: FALSE, upgrade: TRUE, md5sum: "ysQplJ/kY19rRPZmntFsMA==" } + - { category: "RU_Combo", base: "19.3.0.0.0", release: "19.25.0.0.241015", patchnum: "36866740", patchfile: "p36866740_190000_Linux-x86-64.zip", patch_subdir: "/36878697", prereq_check: TRUE, method: "opatch apply", ocm: FALSE, upgrade: TRUE, md5sum: "f8DKaIiP7v811/WaRyacTQ==" } + - { category: "RU_Combo", base: "19.3.0.0.0", release: "19.26.0.0.250121", patchnum: "37262208", patchfile: "p37262208_190000_Linux-x86-64.zip", patch_subdir: "/37102264", prereq_check: TRUE, method: "opatch apply", ocm: FALSE, upgrade: TRUE, md5sum: "zqZeJ3/ujDWcLr+reZOHpw==" }