パッチの適用
Oracle Database や Oracle Gird Infrastructure にパッチを適用するにはOPatchユーティリティを使います。一方Oracle Enterprise Managerに対してパッチを適用するには OMSPacher ユーティリティを使います。ここでは OMSPacher の使い方と、注意点について書きます。
OMSParcherとは
OMSPatcherはOracle Enterprise Managerにパッチを適用するためのユーティリティです。${ORACLE_HOME}/OMSPatcher ディレクトリのomspatcherコマンドを実行します。
ORACLE_HOMEはOracle Enterprise Managerのホーム・ディレクトリです。例えば /u01/software/em13c/middleware等です。-helpパラメータを指定すると、利用方法が表示されます。
$ ./omspatcher -help
OMSPatcher Automation Tool
Copyright (c) 2017, Oracle Corporation. All rights reserved.
Usage: omspatcher [ -help ] [ -analyze ] [ command ]
command := apply
rollback
checkApplicable
lspatches
version
saveConfigurationSnapshot
<global_arguments> := -help Displays the help message for the command.
-analyze Print the actions, steps to be performed without any execution.
example:
'omspatcher -help'
'omspatcher apply -help'
'omspatcher rollback -help'
'omspatcher checkApplicable -help'
'omspatcher lspatches -help'
'omspatcher saveConfigurationSnapshot -help'
OMSPatcher succeeded.
OEMにパッチを適用するには、My Oracle SupportからダウンロードしたOEMのパッチを展開し、OMSPatcherユーティリティを起動します。
$ export PATH=$ORACLE_HOME/OMSPatcher:$PATH
$ unzip 26625183.zip
...
$ cd 26625183
$ omspatcher apply
OMSPatcher Automation Tool
Copyright (c) 2017, Oracle Corporation. All rights reserved.
OMSPatcher version : 13.8.0.0.2
OUI version : 13.9.2.0.0
...
OMSPatcherユーティリティはいくつかの原因で失敗します。失敗メッセージが表示された場合はログ・ファイルを確認してください。
ログ・ファイルは、$ORACLE_HOME/cfgtoollogs/omspatcher/{PatchID} ディレクトリに作成されます。
ファイル名は omspatcher_{YYYY}-{MM}-{DD}{HH}-{MI}-{SS}{AM|PM}{deploy|analyze}.logです。
$ORACLE_HOME/cfgtoollogs/omspatcher/ディレクトリには opatch-{YYYY}-{MM}-{DD}_{HH}-{MI}-{SS}{AM|PM}_1.logファイルも作成されます。
OEM用のOPatchのアップデート
OMSPatcher ユーティリティは、内部的にOPatchユーティリティを使っています。このため OMSPatcher を使う場合には、OPatch のアップデートが必要な場合があります。以下のようなエラーが発生します。
[Dec 23, 2017 10:27:40 AM] Stack Description: java.lang.RuntimeException: OMSPatcher version is not compatible to apply the given patch
OEM 用 OPatch ユーティリティは、データベースと同じく Patch# 6880880 を検索して入手します。OEM 用 OPatch のバージョンは 13.X を指定してください。
パッチの展開
ダウンロードしたOPatchを展開します。
$ unzip ../p6880880_139000_Generic.zip
Archive: ../p6880880_139000_Generic.zip
creating: 6880880/
inflating: 6880880/README.txt
inflating: 6880880/opatch_generic.jar
inflating: 6880880/version.txt
$ cd 6880880
バージョンアップ
README.txt に従ってバージョンアップを行います。
$ java -jar 6880880/opatch_generic.jar oracle_home=$ORACLE_HOME
Launcher log file is /tmp/OraInstall2017-12-23_11-06-29AM/launcher2017-12-23_11-06-29AM.log.
Extracting the installer . . . . Done
This installer must be executed using a Java Development Kit (JDK)
but /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64/jre is not a valid JDK Java Home.
The log is located here: /tmp/OraInstall2017-12-23_11-06-29AM/launcher2017-12-23_11-06-29AM.log.
README.txtには書いていますが、使用した Java コマンドが JRE で提供されるものだとエラーになっています。
このため、JDK に含まれる java コマンドを使用して再度挑戦します。
$ /u01/software/em13c/middleware/oracle_common/jdk/bin/java -jar 6880880/opatch_generic.jar oracle_home=$ORACLE_HOME
Launcher log file is /tmp/OraInstall2017-12-23_11-22-53AM/launcher2017-12-23_11-22-53AM.log.
Extracting the installer . . . . Done
Checking if CPU speed is above 300 MHz. Actual 2807.831 MHz Passed
Checking monitor: must be configured to display at least 256 colors. Actual 16777216 Passed
Checking swap space: must be greater than 512 MB. Actual 3967 MB Passed
Checking if this platform requires a 64-bit JVM. Actual 64 Passed (64-bit not required)
Checking temp space: must be greater than 300 MB. Actual 13433 MB Passed
Preparing to launch the Oracle Universal Installer from /tmp/OraInstall2017-12-23_11-22-53AM
Session log file is /tmp/OraInstall2017-12-23_11-22-53AM/install2017-12-23_11-22-53AM.log
Logs successfully copied to /u01/app/oraInventory/logs.
$
OMSPatcherの再実行
OPatch ユーティリティのバージョンアップに成功したため、OMSPatcher を実行します。
まず apply -analyze パラメーターを指定して、分析を行います。途中で OMS Server のパスワードや接続URLの入力が必要です。
$ cd 26625183
$ omspatcher apply -analyze
OMSPatcher Automation Tool
Copyright (c) 2017, Oracle Corporation. All rights reserved.
OMSPatcher version : 13.8.0.0.2
OUI version : 13.9.2.0.0
Running from : /u01/software/em13c/middleware
Log file location : /u01/software/em13c/middleware/cfgtoollogs/omspatcher/opatch2017-12-23_11-27-15AM_1.log
OMSPatcher log file: /u01/software/em13c/middleware/cfgtoollogs/omspatcher/26625183/omspatcher_2017-12-23_11-27-20AM_analyze.log
Please enter OMS weblogic admin server URL(t3s://omehost1:7102):>
Please enter OMS weblogic admin server username(weblogic):>
Please enter OMS weblogic admin server password:>
Configuration Validation: Success
Running apply prerequisite checks for sub-patch(es) "26625183" and Oracle Home "/u01/software/em13c/middleware"...
Sub-patch(es) "26625183" are successfully analyzed for Oracle Home "/u01/software/em13c/middleware"
Complete Summary
================
All log file names referenced below can be accessed from the directory "/u01/software/em13c/middleware/cfgtoollogs/omspatcher/2017-12-23_11-27-15AM_SystemPatch_26625183_1"
Prerequisites analysis summary:
-------------------------------
The following sub-patch(es) are applicable:
Featureset Sub-patches Log file
---------- ----------- --------
oracle.sysman.top.oms 26625183 26625183_opatch2017-12-23_11-27-20AM_1.log
Log file location: /u01/software/em13c/middleware/cfgtoollogs/omspatcher/26625183/omspatcher_2017-12-23_11-27-20AM_analyze.log
OMSPatcher succeeded.
分析が成功したら -analyze パラメーターを削除して、パッチを適用します。
途中で実行するか聞かれるため、「Y」を入力します。
$ omspatcher apply
OMSPatcher Automation Tool
Copyright (c) 2017, Oracle Corporation. All rights reserved.
OMSPatcher version : 13.8.0.0.2
OUI version : 13.9.2.0.0
Running from : /u01/software/em13c/middleware
Log file location : /u01/software/em13c/middleware/cfgtoollogs/omspatcher/opatch2017-12-23_11-31-40AM_1.log
OMSPatcher log file: /u01/software/em13c/middleware/cfgtoollogs/omspatcher/26625183/omspatcher_2017-12-23_11-31-45AM_deploy.log
Please enter OMS weblogic admin server URL(t3s://oemhost1:7102):>
Please enter OMS weblogic admin server username(weblogic):>
Please enter OMS weblogic admin server password:>
Configuration Validation: Success
<< 途中省略 >>
Do you want to proceed? [y|n]
y
User Responded with: Y
Applying sub-patch(es) "26625183"
Please monitor log file: /u01/software/em13c/middleware/cfgtoollogs/opatch/opatch2017-12-23_11-31-44AM_1.log
<< 途中省略 >>
Log file location: /u01/software/em13c/middleware/cfgtoollogs/omspatcher/26625183/omspatcher_2017-12-23_11-31-45AM_deploy.log
OMSPatcher succeeded.
$