OEMにパッチを適用する（Oracle Enterprise Manager 13c Release 2)


 # パッチの適用
 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.

$

```