プライマリ・コンテンツに移動
Oracle® Enterprise Manager Cloud Control管理者ガイド
13c リリース2
E78869-07
目次へ移動
目次
索引へ移動
索引

前
前へ
次
次へ

24.7 OMSPatcherの機能

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

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

24.7.1 単一OMS構成での再開機能

単一OMSシステムでは、OMSPatcherにより、パッチ適用手順のエンドツーエンドの自動化が実行されます。障害が発生した場合、OMSPatcherにより、すべての不完全な(または)失敗した手順のリストを含むbashスクリプトを生成できます。OMS管理者は、OMSPatcherによって作成されたマスター・ログ・ファイルを参照して失敗の根本的な原因を確認し、解決してから、OMSPatcherで指定されたbashスクリプトを実行する必要があります。bashスクリプトは、障害発生時点からの手順を実行します。

  1. 自動システム・パッチの適用中に、ファイルの権限の問題によってOMSPatcherが失敗します。

    例:

    omspatcher apply /scratch/patch_2nd_nov/em13_1/bundle_patches/1111191
    OMSPatcher Automation Tool
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
    OMSPatcher version : 13.8.0.0.0
    OUI version        : 13.8.0.0.0
    Running from       : /scratch/kamlesku/mw
    Log file location  : /scratch/kamlesku/mw/cfgtoollogs/omspatcher/opatch2015-12-01_01-06-42AM_1.log
    OMSPatcher log file: /scratch/kamlesku/mw/cfgtoollogs/omspatcher/1111191/omspatcher_2015-12-01_01-06-50AM_deploy.log
    Please enter OMS weblogic admin server URL(t3s://slc09jcy.us.oracle.com:7101):> 
    Please enter OMS weblogic admin server username(weblogic):> 
    Please enter OMS weblogic admin server password:> 
    
    WARNING: Could not apply the patch "1111155" because the "oracle.samples.xohs.oms.plugin with
     version 13.1.4.0.0" core component of the OMS or the plug-in for which the patch is intended 
    is either not deployed or deployed with another version in your Enterprise Manager system.
    
    Configuration Validation: Success
    Running apply prerequisite checks for sub-patch(es) "1111126 1111137" and
    Oracle Home "/scratch/kamlesku/mw"...
    Sub-patch(es) "1111126 1111137" are successfully analyzed for Oracle Home "/scratch/kamlesku/mw"
    To continue, OMSPatcher will do the following:
    [Patch and deploy artifacts]   : Apply sub-patch(es) [ 1111126 ]
                    	       Apply sub-patch(es) [ 1111137 ]                                      
                                     Register MRS artifact "eventsaux";
                                     Register MRS artifact "VCPUUtilization"
    
    Do you want to proceed? [y|n]
    y
    User Responded with: Y
    Applying sub-patch "1111126 " 
    Applying sub-patch "1111137 " 
    OMSPatcher failed to apply following patch(es) "1111137"  to core/plugin Oracle home(s).
    
    Complete Summary
    ================
    All log file names referenced below can be accessed from the directory
    "/scratch/kamlesku/mw/cfgtoollogs/omspatcher/2015-12-01_01-06-42AM_SystemPatch_1111191_1"
    Patching summary:
    -----------------
    Binaries of the following sub-patch(es) have been applied successfully:
                            Featureset   Sub-patches                                    Log file
                            ----------   -----------                                    --------
      oracle.sysman.top.oms_13.1.0.0.0       1111126   1111126_opatch2015-12-01_01-07-32AM_3.log
    
    Binaries of the following sub-patch(es) failed to get applied:
                                    Featureset   Sub-patches                                    Log file
                                    ---------- -----------                                    --------
      oracle.sysman.emas.oms.plugin_13.1.1.0.0       1111137   1111137_opatch2015-12-01_01-08-06AM_4.log
    The following sub-patches are incompatible with components installed in the OMS system:
    1111155
    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 script to complete patching session:
    "/scratch/kamlesku/mw/.omspatcher_storage/oms_session/scripts_2015-12-01_01-06-42AM/run_script_singleoms_resume.sh"
    
    ------------------------------------------------------------------------------------------------
    OMSPatcher wont allow any other patching operations unless the script is executed successfully
    ------------------------------------------------------------------------------------------------
    [ Error during Patch and deploy artifacts Phase]. Detail: OMSPatcher failed to apply
     some of the patches to the OMS instance home(s).
    OMSPatcher failed: OMSPatcher failed to execute some of the OMS operations.
     Please refer log file(s) for details.
    --------------------------------------------------------------------------------
    The following warnings have occurred during OPatch execution:
    1)  Could not apply the patch "1111155" because the "oracle.samples.xohs.oms.plugin with
     version 13.1.4.0.0" core component of the OMS or the plug-in for which the patch is intended
     is either not deployed or deployed with another version in your Enterprise Manager system.
    --------------------------------------------------------------------------------
    Log file location: /scratch/kamlesku/mw/cfgtoollogs/omspatcher/1111191/omspatcher_2015-12-01_01-06-50AM_deploy.log
    
    Recommended actions: Please refer log file(s) for more details on the errors. Please contact Oracle Support.
    
  2. 不完全なパッチ適用セッションが残っている場合、OMS管理者は新しいパッチ適用セッションを開始することができません。OMSPatcherは、失敗に関する詳細な情報によって、エラーとその問題を修正するためにとるべきアクションを明確にします。

    例:

    omspatcher apply /scratch/patch_2nd_nov/em13_1/bundle_patches/1111191
    OMSPatcher Automation Tool
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
     
    OMSPatcher version : 13.8.0.0.0
    OUI version        : 13.8.0.0.0
    Running from       : /scratch/kamlesku/mw
    Log file location  : /scratch/mw/cfgtoollogs/omspatcher/opatch2015-12-01_01-15-09AM_1.log
    OMSPatcher failed: 
    OMSPatcher finds that previous patching session is not yet completed. Please refer log file
    "/scratch/mw/cfgtoollogs/omspatcher/1111191/omspatcher_2015-12-01_01-06-50AM_deploy.log"
    for the previous session and execute the script
    "/scratch/mw/.omspatcher_storage/oms_session/scripts_2015-12-01_01-06-42AM/run_script_singleoms_resume.sh"
    to complete the previous session. OMSPatcher can proceed to execute new operations only if previous session is completed successfully.
    Log file location: /scratch/mw/cfgtoollogs/omspatcher/opatch2015-12-01_01-15-09AM_1.log
    OMSPatcher failed with error code 73
    
  3. OMS管理者は、単一OMSの再開スクリプトを実行して、失敗したパッチ適用セッションを完了させることができます。

    例:

    /scratch/mw/.omspatcher_storage/oms_session/scripts_2015-12-01_01-06-42AM/run_script_singleoms_resume.sh
    Verifying embedded script host-address "myserver.myco.com" against the network interface for a match...
    Trying for a match with: fe80:0:0:0:221:f6ff:feb6:424%2(fe80:0:0:0:221:f6ff:feb6:424%2)
    Trying for a match with: myserver.myco.com(10.252.41.52)
    Script-host address matched with host network interface.
     
    Please provide credential for OMS repository SYSMAN user: 
    Command to execute (Step 1): echo /scratch/patch_2nd_nov/em13_1/bundle_patches/1111191/1111137 >> /scratch/mw/.phBaseFile2015-12-01_01-06-42AM.txt
    Command to execute (Step 1): /scratch/mw/OPatch/opatch napply -phBaseFile /scratch/mw/.phBaseFile2015-12-01_01-06-42AM.txt -invPtrLoc /scratch/mw/oraInst.loc -oh /scratch/mw -silent
    Command to execute (Step 1): rm /scratch/mw/.phBaseFile2015-12-01_01-06-42AM.txt
    Command to execute (Step 1): mkdir -p /scratch/mw/.omspatcher_storage/1111137_Aug_31_2015_01_01_58; cp -Rf /scratch/mw/.patch_storage/1111137_Aug_31_2015_01_01_58/original_patch /scratch/mw/.omspatcher_storage/1111137_Aug_31_2015_01_01_58
    Oracle Interim Patch Installer version 13.8.0.0.0
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
    
    
    Oracle Home       : /scratch/kamlesku/mw
    Central Inventory : /scratch/kamlesku/oraInventory
       from           : /scratch/kamlesku/mw/oraInst.loc
    OPatch version    : 13.8.0.0.0
    OUI version       : 13.8.0.0.0
    Log file location : /scratch/mw/cfgtoollogs/opatch/opatch2015-12-01_01-16-33AM_1.log
     
    OPatch detects the Middleware Home as "/scratch/mw"
     
    Verifying environment and performing prerequisite checks...
    OPatch continues with these patches:   1111137  
     
    Do you want to proceed? [y|n]
    y
    Y (auto-answered by -silent)
    User Responded with: Y
    All checks passed.
    Backing up files...
    Applying interim patch '1111137' to OH '/scratch/mw'
     
    Patching component oracle.sysman.emas.oms.plugin, 13.1.1.0.0...
    Patch 1111137 successfully applied.
    Log file location: /scratch/mw/cfgtoollogs/opatch/opatch2015-12-01_01-16-33AM_1.log
     
    OPatch succeeded.
    Command to execute (Step 2): /scratch/mw/bin/emctl register oms metadata -service eventsaux -file /scratch/mw/sysman/metadata/events/auxiliary/metric_alert_aux.xml -core -sysman_pwd %EM_REPOS_PASSWORD%
    Oracle Enterprise Manager Cloud Control 13c Release 1  
    Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.
    Metadata registration successful
    Command to execute (Step 3): /scratch/mw/bin/emctl register oms metadata -service VCPUUtilization -file /scratch/mw/plugins/oracle.sysman.emas.oms.plugin_13.1.1.0.0/metadata/vcpu/vcpu-exalogic-registration.xml -pluginId oracle.sysman.emas -sysman_pwd %EM_REPOS_PASSWORD%
    Oracle Enterprise Manager Cloud Control 13c Release 1  
    Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.
    Metadata registration successful
    Command to execute (Step 4): /scratch/mw/OMSPatcher/omspatcher commit -id 1111126 -oh /scratch/mw -invPtrLoc /scratch/mw/oraInst.loc
    OMSPatcher Automation Tool
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
     
     
    OMSPatcher version : 13.8.0.0.0
    OUI version        : 13.8.0.0.0
    Running from       : /scratch/kamlesku/mw
    Log file location  : /scratch/mw/cfgtoollogs/omspatcher/opatch2015-12-01_01-17-14AM_1.log
     
    OMSPatcher will now mark the patch "1111126,1111137" as auto-executed.
    Log file location: /scratch/mw/cfgtoollogs/omspatcher/opatch2015-12-01_01-17-14AM_1.log
     
    OMSPatcher succeeded.

24.7.2 複数OMS構成での再開機能

スクリプトの開始時に、OMSPatcherにより、SYSMANパスワードを入力するように求められます。OMSPatcherは、複数OMS構成でのパッチ適用手順を実行することができず、各ホストに固有のすべてのパッチ適用手順を含むbashスクリプトをすべてのノードに対して生成します。スクリプト名には、ホスト名およびユーザー名が含まれます。OMS管理者は、すべてのノードで各ホストに固有のスクリプトを実行し、パッチ適用セッションを完了させることができます。

  1. OMSPatcherのapplyは、bashスクリプトを実行することなくパッチ適用手順のみを生成するため、正常に実行されます。

    例:

    omspatcher apply /scratch/opatchdev/targetPatchingImplRegistration/1111118
    OMSPatcher Automation Tool
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
      
    OMSPatcher version : 13.8.0.0.0
    OUI version        : 13.8.0.0.0
    Running from       : /scratch/aime1/work/midnew9693/oms
    Log file location  : /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/opatch2014-05-05_22-43-08PM_1.log
     
    OMSPatcher log file: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/omspatcher/1111118/opatch_oms_2014-05-05_22-43-14PM_deploy.log
     
    Please enter OMS weblogic admin server URL(t3s://linux01amd.myco.com:7101):> 
    Please enter OMS weblogic admin server username:> weblogic
    Please enter OMS weblogic admin server password:>           
     
     
    Configuration Validation: Success
     
    WARNING: OMSPatcher cannot run patching steps in multi-OMS environment.
     
     
    Please perform the following steps to complete patching operations.
    -------------------------------------------------------------------
            1. Please copy the script "/scratch/aime1/work/midnew9693/oms/.omspatcher_storage/oms_session/scripts_2014-05-05_22-43-51/run_script#1_on_host_linux07jdx_us_oracle_com_as_user_aime1.sh" to "linux07jdx.myco.com" and execute the script.
            2. Please execute the script "/scratch/aime1/work/midnew9693/oms/.omspatcher_storage/oms_session/scripts_2014-05-05_22-43-51/run_script#2_on_host_linux01amd_us_oracle_com_as_user_aime1.sh" on local host.
     
    --------------------------------------------------------------------------------
    The following warnings have occurred during OMSPatcher execution:
    1)  OMSPatcher cannot run patching steps in multi-OMS environment.
     
    --------------------------------------------------------------------------------
    OMSPatcher Session completed with warnings.
    Log file location: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/omspatcher/1111118/opatch_oms_2014-05-05_22-43-14PM_deploy.log
     
    OMSPatcher completed with warnings.
    
    

    ローカル・ホスト(複数OMS構成でのプライマリ・ホスト)に対応するbashスクリプトを実行します。スクリプト実行は、誤ったsysmanパスワードによるデータベース・リポジトリへの接続の問題のために失敗しました。

    例:

    $ /scratch/aime1/work/midnew9693/oms/.omspatcher _storage/oms_session/scripts_2014-05-05_22-43-51/run_script#2_on_host_linux01amd_us_oracle_com_as_user_aime1.sh
    Creating  master log file /scratch/aime1/work/midnew9693/oms/.omspathcer_storage/oms_session/oms_session_log_2014-05-05_22-43-08PM...
    Creating  session file /scratch/aime1/work/midnew9693/oms/.omspatcher_storage/oms_session/oms_session_2014-05-05_22-43-08PM...
     
    Please provide credential for OMS repository SYSMAN user: 
    Command to execute (Step 2): /scratch/aime1/work/midnew9693/oms/OMSPatcher/omspatcher checkApplicable -ph /scratch/opatchdev/targetPatchingImplRegistration/1111118 -oh /scratch/aime1/work/midnew9693/oms -invPtrLoc /scratch/aime1/work/midnew9693/oms/oraInst.loc
    OMSPatcher Automation Tool
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
    
    OMSPatcher version : 13.8.0.0.0
    OUI version        : 13.8.0.0.0
    Running from       : /scratch/aime1/work/midnew9693/oms
    Log file location  : /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/opatch2014-05-05_22-45-52PM_1.log
     
    OMSPatcher log file: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/omspatcher/1111118/opatch_oms_2014-05-05_22-45-53PM_analyze.log
       
    Running apply prerequisite checks for sub-patch(es) "1111118" and Oracle Home "/scratch/aime1/work/midnew9693/oms"...
    Please monitor OPatch log file: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/1111118_May_05_2014_22_45_52/ApplyPrereq2014-05-05_22-45-57PM_2.log
    Sub-patch(es) "1111118" are successfully analyzed for Oracle Home "/scratch/aime1/work/midnew9693/oms"
     
    Complete Summary
    ================
     
    All log file names referenced below can be accessed from the directory "/scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/2014-05-05_22-45-52PM_SystemPatch_1111118_1"
     
    Prerequisites analysis summary:
    -------------------------------
     
    The following sub-patch(es) are applicable:
     
    Oracle Home Name   Sub-patches             Log file
    ----------------   -----------             --------
         oms12c1       1111118   1111118_ApplyPrereq2014-05-05_22-45-57PM_2.log
     
      
    Log file location: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/omspatcher/1111118/opatch_oms_2014-05-05_22-45-53PM_analyze.log
     
    OMSPatcher succeeded.
    Command to execute (Step 4): echo /scratch/opatchdev/targetPatchingImplRegistration/1111118/1111118 >> /scratch/aime1/work/midnew9693/oms/.phBaseFile2014-05-05_22-43-08PM.txt
    Command to execute (Step 4): /scratch/aime1/work/midnew9693/oms/OPatch/opatch napply -phBaseFile /scratch/aime1/work/midnew9693/oms/.phBaseFile2014-05-05_22-43-08PM.txt -invPtrLoc /scratch/aime1/work/midnew9693/oms/oraInst.loc -oh /scratch/aime1/work/midnew9693/oms -silent
    Command to execute (Step 4): rm /scratch/aime1/work/midnew9693/oms/.phBaseFile2014-05-05_22-43-08PM.txt
    Oracle Interim Patch Installer version 13.6.0.0.0
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
     
     
    Oracle Home       : /scratch/aime1/work/midnew9693/oms
    Central Inventory : /ade/aime1_opatchauto_fix_lat/oracle/work/DB112/oraInventory
       from           : /scratch/aime1/work/midnew9693/oms/oraInst.loc
    OPatch version    : 13.8.0.0.0
    OUI version       : 13.8.0.0.0
    Log file location : /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/opatch2014-05-05_22-46-00PM_1.log
      
    OPatch detects the Middleware Home as "/scratch/aime1/work/midnew9693"
     
    Verifying environment and performing prerequisite checks...
    OPatch continues with these patches:   1111118  
     
    Do you want to proceed? [y|n]
    Y (auto-answered by -silent)
    User Responded with: Y
    All checks passed.
    Backing up files...
    Applying interim patch '1111118' to OH '/scratch/aime1/work/midnew9693/oms'
     
    Patching component oracle.sysman.oms.core, 13.1.0.0.0...
     
    Verifying the update...
    Patch 1111118 successfully applied.
    Log file location: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/opatch2014-05-05_22-46-00PM_1.log
     
    OPatch succeeded.
    Command to execute (Step 6): /scratch/aime1/work/midnew9693/oms/bin/emctl register oms metadata -service TargetPatchingImplRegistration -debug -file /scratch/aime1/work/midnew9693/oms/sysman/metadata/targetpatchingregister/RegisterAgentTarget.xml -core -sysman_pwd %EM_REPOS_PASSWORD%
    Oracle Enterprise Manager Cloud Control 12c Release 4  
    Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
    Starting output for debug mode.
     Debug logs will be written to /scratch/aime1/work/insthome9693/em/EMGC_OMS1/sysman/log/emctl.log
    EM-04036: Unable to get a connection to the repository!  Exiting...
    The command failed with error code 36
     
    Script execution has failed. Please refer to log file: /scratch/aime1/work/midnew9693/oms/.omspatcher_storage/oms_session/oms_session_log_2014-05-05_22-43-08PM for more details
            
    Please fix the failures and re-run the same script to complete the patching session.
    
    

    OMS管理者は、問題を修正(データベース・リポジトリへの接続で、正確なsysmanパスワードを指定)することで、スクリプトを再実行することができます。スクリプトは、失敗時点からの実行を再開し、正常に実行されます。

    例:

    $ /scratch/aime1/work/midnew9693/oms/.omspatcher _storage/oms_session/scripts_2014-05-05_22-43-51/run_script#2_on_host_linux01amd_us_oracle_com_as_user_aime1.sh
     
    Please provide credential for OMS repository SYSMAN user: 
    Command to execute (Step 2): /scratch/aime1/work/midnew9693/oms/OMSPatcher/omspatcher checkApplicable -ph /scratch/opatchdev/targetPatchingImplRegistration/1111118 -oh /scratch/aime1/work/midnew9693/oms -invPtrLoc /scratch/aime1/work/midnew9693/oms/oraInst.loc
    SKIP command for step 2...
    Command to execute (Step 4): echo /scratch/opatchdev/targetPatchingImplRegistration/1111118/1111118 >> /scratch/aime1/work/midnew9693/oms/.phBaseFile2014-05-05_22-43-08PM.txt
    Command to execute (Step 4): /scratch/aime1/work/midnew9693/oms/OPatch/opatch napply -phBaseFile /scratch/aime1/work/midnew9693/oms/.phBaseFile2014-05-05_22-43-08PM.txt -invPtrLoc /scratch/aime1/work/midnew9693/oms/oraInst.loc -oh /scratch/aime1/work/midnew9693/oms -silent
    Command to execute (Step 4): rm /scratch/aime1/work/midnew9693/oms/.phBaseFile2014-05-05_22-43-08PM.txt
    SKIP command for step 4...
    Command to execute (Step 6): /scratch/aime1/work/midnew9693/oms/bin/emctl register oms metadata -service TargetPatchingImplRegistration -debug -file /scratch/aime1/work/midnew9693/oms/sysman/metadata/targetpatchingregister/RegisterAgentTarget.xml -core -sysman_pwd %EM_REPOS_PASSWORD%
    Oracle Enterprise Manager Cloud Control 12c Release 4  
    Copyright (c) 1996, 2014 Oracle Corporation.  All rights reserved.
    Starting output for debug mode. 
    Debug logs will be written to /scratch/aime1/work/insthome9693/em/EMGC_OMS1/sysman/log/emctl.log
    Metadata registration successful
    Command to execute (Step 7): /scratch/aime1/work/midnew9693/oms/OMSPatcher/omspatcher commit -id 1111118 -oh /scratch/aime1/work/midnew9693/oms -invPtrLoc /scratch/aime1/work/midnew9693/oms/oraInst.loc
    OMSPatcher Automation Tool
    Copyright (c) 2016, Oracle Corporation.  All rights reserved.
     
     
    OMSPatcher version : 13.8.0.0.0
    OUI version        : 13.8.0.0.0
    Running from       : /scratch/aime1/work/midnew9693/oms
    Log file location  : /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/opatch2014-05-05_22-49-34PM_1.log
     
     
    OMSPatcher will now mark the patch "1111118" as auto-executed.
    Log file location: /scratch/aime1/work/midnew9693/oms/cfgtoollogs/opatch/opatch2014-05-05_22-49-34PM_1.log
     
    OMSPatcher succeeded.
      
    All operations for this script are appended to log file: /scratch/aime1/work/midnew9693/oms/.omspatcher_storage/oms_session/oms_session_log_2014-05-05_22-43-08PM