OMSPatcherセッションの再開

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

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

単一OMS構成での再開機能

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

  1. 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
  2. 不完全なパッチ適用セッションが残っている場合、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
    
  3. これで、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に対するパッチ適用を自動的に完了します。

  1. 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
  2. 不完全なパッチ適用セッションが残っている場合、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
    
  3. これで、OMS管理者は、プライマリOMSでomspatcher resumeコマンドを実行して、失敗したパッチ適用セッションを完了できます。

    例:

    OMSPatcher/omspatcher resume