Wie wird Cloud Control 13.5 gepatcht?

Im letzten Blogeintrag wurde die Installation des Enterprise Manager Cloud Control 13c vorgestellt. In diesem Beitrag soll das Patchen der drei EM Komponenten WLS, OMS und Agent auf den aktuellen Stand gezeigt werden.
Beachten Sie, dass das Patchen von Cloud Control oft mit vielen Stolpersteinen verbunden ist. Zudem gibt es regelmäßig neue Updates für alle Komponenten und die Patchtools.

Zum Patch-Szenario von Cloud Control gehören die Komponenten

• Weblogic Server mit "WLS Patch Set Update"
• OMS  mit „OMS Release Update“
• Agent mit „Agent Release Update“.

Am Beispiel des aktuellen Patches RU 04 (Februar 2022) für eine Neuinstallation möchte ich dieses Szenario vorstellen.

Nach Entpacken des WLS PATCH SET UPDATE 33727616 und dem Lesen der README Datei sollte im ersten Schritt die OPatch Version getestet werden.

$ /u01/app/oracle/mw5/OPatch/opatch version 
OPatch Version: 13.9.4.2.5

Doch diese Version ist wie so oft zu „alt“.
Unter 28186730 im Oracle Support ist die neueste Version von OPatch zu finden.

Nach dem Auspacken in einem Hilfsordner (hier immer /temp ), sieht es jetzt wie die bekannte Nummer zu
OPatch 6880880 aus, aber es sind nur drei Dateien in der *.zip Datei enthalten.  

$ ll /temp/6880880/
-rw-r--r-- 1 oracle oinstall 52692716 Dec  2 02:09 opatch_generic.jar   
-rw-rw-r-- 1 oracle oinstall    13592 Jan 19 06:53 README.txt
-rw-r--r-- 1 oracle oinstall       10 Dec  2 02:09 version.txt

Das Besondere ist, dass diese OPatch Version mit JAVA eingespielt werden muss.
Mit dem Status des EM Commandline Interfaces emcli findet man die aktuelle JAVA_HOME Variable der OMS Umgebung.

$ emcli status 
Oracle Enterprise Manager 13c Release 5 EM CLI.
. . .
EM CLI Home            : /u01/app/oracle/mw5/bin
EM CLI Version         : 13.5.0.0.0
Java Home              : /u01/app/oracle/mw5/oracle_common/jdk/jre
Java Version           : 1.8.0_261
. . .

Jetzt wird das OPatch silent in das OMS_HOME eingespielt und die OPatch Version getestet.
Hinweis: Die Verzeichnisse müssen im Statement immer komplett angegeben werden.

$ export JAVA_HOME=/u01/app/oracle/mw5/oracle_common/jdk/jre

$ $JAVA_HOME/bin/java -jar /temp/6880880/opatch_generic.jar -silent ORACLE_HOME=/u01/app/oracle/mw5

$ $ORACLE_HOME/OPatch/opatch version 
OPatch Version: 13.9.4.2.8

Zum Einspielen des Patches werden der OMS und der Weblogic Server heruntergefahren.

$ emctl stop oms -all

$ cd /temp/33727616/

$ /u01/app/oracle/mw5/OPatch/opatch apply 
Oracle Interim Patch Installer version 13.9.4.2.8
Copyright (c) 2022, Oracle Corporation.  All rights reserved.
Oracle Home       : /u01/app/oracle/mw5
Central Inventory : /u01/app/oraInventory
   from           : /u01/app/oracle/mw5/oraInst.loc
OPatch version    : 13.9.4.2.8
OUI version       : 13.9.4.0.0
Log file location : /u01/app/oracle/mw5/cfgtoollogs/opatch/opatch2022-03-24_14-55-57PM_1.log
OPatch detects the Middleware Home as "/u01/app/oracle/mw5"
Verifying environment and performing prerequisite checks...
OPatch continues with these patches:   33727616  
. . .

Jetzt erfolgt der Start des OMS (mit Weblogic Server) und die Prüfung, ob der Patch registriert ist.

$ emctl start oms

$ /u01/app/oracle/mw5/OPatch/opatch lspatches
33727616;WLS PATCH SET UPDATE 12.2.1.4.220105

Alle Agenten sollten auch mit dem Agent Release Update (siehe Doc ID 2760230.2) gepatchet werden.
Es ist gibt verschiedene Methoden, einen Patch für Agenten anzuwenden.

In diesem Beitrag konzentrieren wir uns auf das im Release 13.5 neu eingeführte Tool AgentPatcher, welches das bis 13.4 verwendete OPatch ersetzt.

Leider findet man nach der Neuinstallation keinen Ordner AgentPatcher im Agentverzeichnis.
Deshalb muss der AgentPatcher zunächst neu installiert werden.

Wichtig: Das ORACLE_HOME muss auf das Agent Verzeichnis gesetzt werden.

$ export ORACLE_HOME=/u01/app/oracle/agent/agent_13.5.0.0.0  
$ ls $ORACLE_HOME/AgentPatcher   -->  gibt es noch nicht ! 

Den aktuellen AgentPatcher finden Sie unter 33715880 beim Oracle Support.
Wie der OMSPatcher wird das *.zip in das  ORACLE_HOME des Agents kopiert, entpackt und die Version getetstet.

$ scp p33355570_135000_Generic.zip $ORACLE_HOME

$ cd $ORACLE_HOME
$ unzip p33355570_135000_Generic.zip 

$ ./agentpatcher version 
AgentPatcher Version: 13.9.5.2.0
OPlan Version: 12.2.0.1.16
OsysModel build: Tue Apr 28 18:16:31 PDT 2020
AgentPatcher succeeded.

Aus dem entpackten Patch 33715880 im Hilfsordner kann der Patch wieder mit analyze getestet werden.
Wenn es keine Fehler gibt, wird der Agent gestoppt, das Patch angewendet und der Agent wieder gestartet.

$ cd /temp/33715880

$ $ORACLE_HOME/AgentPatcher/agentpatcher apply -analyze


$ $ORACLE_HOME/bin/emctl stop agent

$ Temp/33715880]$ $ORACLE_HOME/AgentPatcher/agentpatcher apply 
AgentPatcher Automation Tool
Copyright (c) 2021, Oracle Corporation.  All rights reserved.

AgentPatcher version : 13.9.5.2.0
OUI version        : 13.9.4.0.0
…
AgentPatcher succeeded.


$ $ORACLE_HOME/bin/emctl start  agent 
Oracle Enterprise Manager Cloud Control 13c Release 5  
Copyright (c) 1996, 2021 Oracle Corporation.  All rights reserved.
Starting agent .............. started.

Mit lspatches kontrollieren Sie schließlich die erfolgreiche Anwendung des Agenten Patches.

$ $ORACLE_HOME/AgentPatcher/agentpatcher lspatches

oder 

$ /u01/app/oracle/agent/agent_13.5.0.0.0/OPatch/opatch lspatches
33737167;Oracle Enterprise Manager for Exadata 13c Release 5 Plug-in Update 4 (13.5.1.4) for Oracle Management Agent (Discovery)
33737139;Oracle Enterprise Manager for Fusion Middleware 13c Release 5 Plug-in Update 4 (13.5.1.4) for Oracle Management Agent
...

In diesem Blogeintag wurde gezeigt, wie alle Komponenten des Enterprise Managers Cloud Control 13.5 gepatched werden können. Damit werden Fehler in den Produkten beseitigt, Security Lücken geschlossen und die neuesten Features integriert.

Weitergehende Informationen zu diesem Thema finden Sie in unserem zweitägigen Praxisworkshop Oracle Enterprise Manager Cloud Control: Installation und Wartung.