OMSPatcherセッションの再開

OMSPatcherでは、単一OMS構成と複数OMS構成の両方に対して障害時に再開する機能がサポートされています。

この項の内容は次のとおりです。

単一OMS構成での再開機能

単一OMSシステムでのOMSPatcherは、パッチ適用ステップのエンドツーエンドの自動化を実行します。障害が発生すると、失敗したステップからOMSPatcherを再開できます。OMS管理者は、OMSPatcherによって作成されたマスター・ログ・ファイルを参照して障害の根本的な原因を確認し、解決してから、omspatcher resumeコマンドを実行してパッチ適用を完了する必要があります。OMSPatcher resumeは、障害発生時点からステップを実行します。

例

OMSPatcherは、自動システム・パッチを適用しているときに、OMSの停止中に失敗します。

例:

$omspatcher apply /scratch/patches_april/24_1_latest/1111112
OMSPatcher Automation Tool
Copyright (c) 2024, Oracle Corporation.  All rights reserved.

OMSPatcher version : 13.9.24.2.0
OUI version        : 13.9.4.0.0
Running from       : /scratch/sm/work/omshome3308/oms_home
Log file location  : /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_15-28-54PM_1.log

OMSPatcher log file: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/1111112/omspatcher_2025-04-11_15-29-13PM_apply.log

Please enter OMS weblogic admin server URL(t3s://shortterm-16095.subnet1rg2phxsu.emdevinfraphx1.oraclevcn.com:7102):> 
Please enter OMS weblogic admin server username(weblogic):> 
Please enter OMS weblogic admin server password:> 

Enter SYS or Non-SYS (Admin User) username: sys
Enter 'sys' password : 
Checking if current repository database is a supported version
Current repository database version is supported

Prereq "checkComponents" for patch 1111140 passed.

Prereq "checkComponents" for patch 1111143 passed.

Prereq "checkComponents" for patch 1111142 passed.

Configuration Validation: Success

Running apply prerequisite checks for sub-patch(es) "1111140,1111143" and Oracle Home "/scratch/sm/work/omshome3308/oms_home"...
Sub-patch(es) "1111140,1111143" are successfully analyzed for Oracle Home "/scratch/sm/work/omshome3308/oms_home"

Running apply prerequisite checks for sub-patch(es) "1111142" and Oracle Home "/scratch/sm/work/omshome3308/ext_oms_home"...
Sub-patch(es) "1111142" are successfully analyzed for Oracle Home "/scratch/sm/work/omshome3308/ext_oms_home"

To continue, OMSPatcher will do the following:
[Patch and deploy artifacts]   : Apply sub-patch(es) [ 1111140 1111143 1111142 ]
                                 Apply sub-patch(es) [ 1111140 1111143 1111142 ]
                                 Apply RCU artifact with patch "/scratch/sm/work/omshome3308/ext_oms_home/.omspatcher_storage/1111142_Sep_12_2024_10_04_19/original_patch";
                                 Apply RCU artifact with patch "/scratch/sm/work/omshome3308/oms_home/.omspatcher_storage/1111143_Oct_9_2024_09_22_52/original_patch";
                                 Register MRS artifact "swlib";
                                 Register MRS artifact "eventsaux";
                                 Register MRS artifact "eventSpecificCustmzn";
                                 Register MRS artifact "compression";
                                 Register MRS artifact "oobrules";
                                 Register MRS artifact "targetType";
                                 Register MRS artifact "storeTargetType";
                                 Register MRS artifact "jobTypes";
                                 Register MRS artifact "default_collection";
                                 Register MRS artifact "omsPropertyDef";
                                 Register MRS artifact "runbooks";
                                 Register MRS artifact "TargetPrivilege"

Do you want to proceed? [y|n]
y
User Responded with: Y
Stopping all the services on primary OMS.....
Please monitor log file: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/2025-04-11_15-36-55PM_SystemPatch_1111112_9/stop_oms_all_2025-04-11_15-36-55PM.log

Complete Summary
================

All log file names referenced below can be accessed from the directory "/scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/2025-04-11_15-36-55PM_SystemPatch_1111112_9"

Patching summary:
-----------------

The following sub-patch(es) are applicable:

             Featureset       Sub-patches                                            Log file
             ----------       -----------                                            --------
  oracle.sysman.top.oms   1111140,1111143   1111140,1111143_opatch2025-04-11_15-30-27PM_2.log
  oracle.sysman.top.zdt           1111142           1111142_opatch2025-04-11_15-31-40PM_2.log

OMSPatcher failed to execute some of the patching steps. Please check the Patching summary,individual logs and try to resolve the issue. Once the issue is resolved,Please execute below command to complete patching session:
	omspatcher resume

------------------------------------------------------------------------------------------------
OMSPatcher wont allow any other patching operations unless the script is executed successfully
------------------------------------------------------------------------------------------------

Log file location: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/1111112/omspatcher_2025-04-11_15-29-13PM_apply.log

OMSPatcher failed with error code 240

不完全なパッチ適用セッションが残っている場合、OMS管理者は新しいパッチ適用セッションを開始することができません。OMSPatcherは、失敗に関する詳細な情報によって、エラーとその問題を修正するためにとるべきアクションを明確にします。

例:

omspatcher apply /scratch/patches_april/24_1_latest/1111112
OMSPatcher Automation Tool
Copyright (c) 2024, Oracle Corporation.  All rights reserved.

OMSPatcher version : 13.9.24.2.0
OUI version        : 13.9.4.0.0
Running from       : /scratch/sm/work/omshome3308/oms_home
Log file location  : /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_17-05-39PM_1.log

OMSPatcher finds that previous patching session is not yet completed. Please refer log file for the previous session and execute the below command to complete the previous session. OMSPatcher can proceed to execute new operations only if previous session is completed successfully.
	omspatcher resume

Log file location: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_17-05-39PM_1.log

OMSPatcher failed with error code 255

これで、OMS管理者は、単一OMSでomspatcher resumeコマンドを実行して、失敗したパッチ適用セッションを完了できます。

例:

OMSPatcher/omspatcher resume
OMSPatcher Automation Tool
Copyright (c) 2024, Oracle Corporation.  All rights reserved.

OMSPatcher version : 13.9.24.2.0
OUI version        : 13.9.4.0.0
Running from       : /scratch/sm/work/omshome3308/oms_home
Log file location  : /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_17-07-40PM_1.log

OMSPatcher log file: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/SystemPatch/omspatcher_2025-04-11_17-07-13PM_resume.log

[Info:Previous action was performed by user:'sys']
Enter 'sys' password : 
Enter SYSMAN Password : 
command /scratch/sm/work/omshome3308/oms_home/bin/emctl  stop oms  -all -force
/scratch/sm/work/omshome3308/oms_home/bin/emctl  stop oms  -all -force is Successfully run 
......

command /scratch/sm/work/omshome3308/oms_home/OMSPatcher/omspatcher executeCommand -cmdType POST_APPLY_SQL -oh /scratch/sm/work/omshome3308/oms_home -dbUser sys
/scratch/sm/work/omshome3308/oms_home/OMSPatcher/omspatcher executeCommand -cmdType POST_APPLY_SQL -oh /scratch/sm/work/omshome3308/oms_home -dbUser sys is Successfully run

command /scratch/sm/work/omshome3308/oms_home/bin/emctl start oms
/scratch/sm/work/omshome3308/oms_home/bin/emctl start oms is Successfully run

OMSPatcher succeeded.

複数OMS構成での再開機能

複数OMSシステムでは、OMSPatcherはパッチ適用ステップのエンドツーエンドの自動化を実行します。障害が発生すると、失敗したステップからOMSPatcherを再開できます。OMS管理者は、OMSPatcherによって作成されたマスター・ログ・ファイルを参照して障害の根本的な原因を確認し、解決してから、omspatcher resumeコマンドを実行してパッチ適用を完了する必要があります。OMSPatcher resumeは、障害発生時点からステップを実行します。

複数OMS構成の場合、OMSPatcherはプライマリOMS上で実行を再開し、ジョブを発行することでadd OMSesに対するパッチ適用を自動的に完了します。

例

OMSPatcherは、自動システム・パッチを適用しているときに、OMSの停止中に失敗します。

例:

$omspatcher apply /scratch/patches_april/24_1_latest/1111112
OMSPatcher Automation Tool
Copyright (c) 2024, Oracle Corporation.  All rights reserved.

OMSPatcher version : 13.9.24.2.0
OUI version        : 13.9.4.0.0
Running from       : /scratch/sm/work/omshome3308/oms_home
Log file location  : /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_15-28-54PM_1.log

OMSPatcher log file: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/1111112/omspatcher_2025-04-11_15-29-13PM_apply.log

Please enter OMS weblogic admin server URL(t3s://shortterm-16095.subnet1rg2phxsu.emdevinfraphx1.oraclevcn.com:7102):> 
Please enter OMS weblogic admin server username(weblogic):> 
Please enter OMS weblogic admin server password:> 

Enter SYS or Non-SYS (Admin User) username: sys
Enter 'sys' password : 
Checking if current repository database is a supported version
Current repository database version is supported

Prereq "checkComponents" for patch 1111140 passed.

Prereq "checkComponents" for patch 1111143 passed.

Prereq "checkComponents" for patch 1111142 passed.

Configuration Validation: Success

Running apply prerequisite checks for sub-patch(es) "1111140,1111143" and Oracle Home "/scratch/sm/work/omshome3308/oms_home"...
Sub-patch(es) "1111140,1111143" are successfully analyzed for Oracle Home "/scratch/sm/work/omshome3308/oms_home"

Running apply prerequisite checks for sub-patch(es) "1111142" and Oracle Home "/scratch/sm/work/omshome3308/ext_oms_home"...
Sub-patch(es) "1111142" are successfully analyzed for Oracle Home "/scratch/sm/work/omshome3308/ext_oms_home"

To continue, OMSPatcher will do the following:
[Patch and deploy artifacts]   : Apply sub-patch(es) [ 1111140 1111143 1111142 ]
                                 Apply sub-patch(es) [ 1111140 1111143 1111142 ]
                                 Apply RCU artifact with patch "/scratch/sm/work/omshome3308/ext_oms_home/.omspatcher_storage/1111142_Sep_12_2024_10_04_19/original_patch";
                                 Apply RCU artifact with patch "/scratch/sm/work/omshome3308/oms_home/.omspatcher_storage/1111143_Oct_9_2024_09_22_52/original_patch";
                                 Register MRS artifact "swlib";
                                 Register MRS artifact "eventsaux";
                                 Register MRS artifact "eventSpecificCustmzn";
                                 Register MRS artifact "compression";
                                 Register MRS artifact "oobrules";
                                 Register MRS artifact "targetType";
                                 Register MRS artifact "storeTargetType";
                                 Register MRS artifact "jobTypes";
                                 Register MRS artifact "default_collection";
                                 Register MRS artifact "omsPropertyDef";
                                 Register MRS artifact "runbooks";
                                 Register MRS artifact "TargetPrivilege"

Do you want to proceed? [y|n]
y
User Responded with: Y
Stopping all the services on primary OMS.....
Please monitor log file: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/2025-04-11_15-36-55PM_SystemPatch_1111112_9/stop_oms_all_2025-04-11_15-36-55PM.log

Complete Summary
================

All log file names referenced below can be accessed from the directory "/scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/2025-04-11_15-36-55PM_SystemPatch_1111112_9"

Patching summary:
-----------------

The following sub-patch(es) are applicable:

             Featureset       Sub-patches                                            Log file
             ----------       -----------                                            --------
  oracle.sysman.top.oms   1111140,1111143   1111140,1111143_opatch2025-04-11_15-30-27PM_2.log
  oracle.sysman.top.zdt           1111142           1111142_opatch2025-04-11_15-31-40PM_2.log

OMSPatcher failed to execute some of the patching steps. Please check the Patching summary,individual logs and try to resolve the issue. Once the issue is resolved,Please execute below command to complete patching session:
	omspatcher resume

------------------------------------------------------------------------------------------------
OMSPatcher wont allow any other patching operations unless the script is executed successfully
------------------------------------------------------------------------------------------------

Log file location: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/1111112/omspatcher_2025-04-11_15-29-13PM_apply.log

OMSPatcher failed with error code 240

例:

omspatcher apply /scratch/patches_april/24_1_latest/1111112
OMSPatcher Automation Tool
Copyright (c) 2024, Oracle Corporation.  All rights reserved.

OMSPatcher version : 13.9.24.2.0
OUI version        : 13.9.4.0.0
Running from       : /scratch/sm/work/omshome3308/oms_home
Log file location  : /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_17-05-39PM_1.log

OMSPatcher finds that previous patching session is not yet completed. Please refer log file for the previous session and execute the below command to complete the previous session. OMSPatcher can proceed to execute new operations only if previous session is completed successfully.
	omspatcher resume

Log file location: /scratch/sm/work/omshome3308/oms_home/cfgtoollogs/omspatcher/opatch2025-04-11_17-05-39PM_1.log

OMSPatcher failed with error code 255

これで、OMS管理者は、プライマリOMSでomspatcher resumeコマンドを実行して、失敗したパッチ適用セッションを完了できます。

例:
```
OMSPatcher/omspatcher resume
```