プライマリ・コンテンツに移動
Oracle® Enterprise Manager Cloud Control拡張プログラマーズ・リファレンス
12cリリース4 (12.1.0.4)
B70762-06
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

14 プラグインの検証、パッケージ化およびデプロイ

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

14.1 プラグインの検証、パッケージ化およびデプロイの概要

プラグイン開発者は、検証、パッケージ化およびデプロイ・プロセスにおいて、次の手順に従う必要があります。

  1. ステージング・ディレクトリ(plugin_stage)を作成します。

    ステージング・ディレクトリの構造は、ファイルがOracle Management Serviceおよび管理エージェントにデプロイされる際のファイルの場所を定義します。

    詳細は、第14.2項「プラグインのステージング」を参照してください。

  2. プラグインを検証します。

    プラグインを設計し開発したら、empdk validate_pluginコマンドを使用して、その内容を検証します。このコマンドは、XMLメタデータ・ファイルが標準に準拠しているかどうかを検証します。

    詳細は、第14.3項「プラグインの検証」を参照してください。

  3. Oracleプラグイン・アーカイブ(OPAR)・ファイルを作成します。

    プラグイン・アーカイブは、Enterprise Manager Cloud Controlの様々なインストールにプラグインをインポートしデプロイするための、プラグインの標準的な配布方法です。

    詳細は、第14.4項「プラグイン・アーカイブの作成」を参照してください。

  4. OPARをEnterprise Managerにインポートします。

    emcli import_updateコマンドを使用して、Enterprise Managerにプラグインをインポートします。

    詳細は、第14.5項「Enterprise Managerへのプラグイン・アーカイブのインポートおよびデプロイ」を参照してください。

  5. プラグインをデプロイします。

    プラグインをターゲットの監視に使用するには、まずプラグインをOracle Management Serviceにデプロイする必要があります。

    詳細は、第14.5.3項「Oracle Management Service (OMS)へのプラグインのデプロイ」を参照してください。

  6. デプロイされたプラグインによって監視されるターゲット・インスタンスを追加します。

    詳細は、第14.6項「ターゲット・インスタンスの追加」を参照してください。

  7. メタデータ登録サービス(MRS)を使用して、更新されたメタデータ・ファイルをデプロイします。

    MRSを使用すると、1つ以上の更新されたメタデータ・ファイルを、プラグインがデプロイされているOracle Management Serviceおよび管理エージェントにアップロードできます。MRSは、更新されたメタデータ・ファイルをEnterprise Managerに登録し、その更新内容で既存のメタデータを上書きします。

    詳細は、14.7項「メタデータ登録サービス(MRS)を使用してデプロイされたメタデータ・ファイルの更新」を参照してください。

14.2 プラグインのステージング

プラグイン・ファイルを作成したら、次の手順としてプラグインをステージングし、検証およびパッケージ化の準備をします。ステージング・ディレクトリの構造は、ファイルがOracle Management Serviceおよび管理エージェントにデプロイされる際のファイルの場所を定義します。

例14-1はステージング・ディレクトリ構造の例を示し、表14-1はアーカイブ・ディレクトリ構造について説明しています。ファイルは、Oracle Management Service、管理エージェントまたは両方にデプロイされるのかに応じてアーカイブに配置されます。プラグインがOMSインスタンスまたは管理エージェントにデプロイされると、必要なファイルがそれぞれのディレクトリの場所にコピーされます。

例14-1 プラグインのディレクトリ構造

plugin_stage/
            |
             plugin.xml
             agent/
                   |
                    plugin_registry.xml
                    default_collection/
                                       |                    
                                        target_type.xml
                    metadata/
                             |            
                              target_type.xml
                    scripts/
                            |      
                             scripts
             oms/
                 |                 
                  metadata/
                           |                   
                            default_collection/
                                               |            
                                                target_type.xml
                            derivedAssoc/
                                         |
                                          derivedAssoc_rule.xml
                            discovery/
                                      |
                                       discovery.xml
                            gccompliance/
                                         |
                                          ComplianceContent_name.xml
                            jobTypes/
                                     |            
                                      job_type.xml
                            mpcui/
                                  |            
                                   mpcui.xml
                            reports/
                                    |                       
                                     report.xml
                            snapshotlive/
                                         |                 
                                          target-type_ecmdef.xml
                            targetType/
                                       |                           
                                        target_type.xml
             discovery/
                       |
                        discovery scripts

注意:

アーカイブ内で指定されているサブディレクトリ名の使用は必須ではありませんが、この名前の使用をお薦めします。

表14-1 プラグイン・アーカイブ構造におけるファイルの場所

ファイル ディレクトリ 注意

plugin.xml

plugin_stage/

必須。このファイルは、Oracle Management Serviceにデプロイされる汎用的なプラグイン・メタデータを定義します。アーカイブ構造内のルート・レベルに配置します。詳細は、第2.4項「plugin.xml Fileの作成」を参照してください。

plugin_registry.xml

plugin_stage/agent/

必須。このファイルは、管理エージェントによって使用されるプラグインを記述するメタデータを定義します。/agentディレクトリの最上位レベルに配置する必要があります。詳細は、plugin_registry.xmlファイルの作成に関する項を参照してください。

target_type.xml

plugin_stage/oms/metadata/targetType/

plugin_stage/agent/metadata/

必須。このファイルは、ターゲット・タイプについて収集または計算するメトリックを定義します。

このファイルの同一のコピーを/omsディレクトリと/agentディレクトリの両方に配置する必要があります。詳細は、項3.3「ターゲット・タイプ・メタデータ・ファイルの作成」を参照してください。

default_collections.xml

plugin_stage/oms/metadata/default_collection/

plugin_stage/agent/default_collection/

必須。このファイルは、メトリック・データ収集頻度やデフォルトのメトリック・アラートしきい値などのメトリック収集パラメータを定義します。

このファイルの同一のコピーを/omsディレクトリと/agentディレクトリの両方に配置する必要があります。詳細は、項3.5「デフォルトの収集ファイルの作成」を参照してください。

注意: デフォルト収集メタデータ・ファイルには、ターゲット・タイプのメタデータ・ファイルと同じファイル名を指定することをお薦めします。

target-type_ecmdef.xml

plugin_stage/oms/metadata/snapshotlive/

オプション。構成データ収集を定義します。詳細は、項7.3.1「構成収集表の定義」を参照してください。

job_type.xml

plugin_stage/oms/metadata/jobTypes/

オプション。すべてのジョブ・タイプ定義ファイルを/jobTypesディレクトリに配置します。詳細は、第8章「ジョブ・タイプの追加」を参照してください。

report.xml

plugin_stage/oms/metadata/reports/

オプション。レポート定義ファイルを/reportsディレクトリに配置します。

derivedAssoc_rule.xml

plugin_stage/oms/metadata/derivedAssoc/

オプション。アソシエーションの導出ルール(またはルール・セット)を定義するメタデータ・ファイルをこのディレクトリに配置します。詳細は、第11章「導出されたアソシエーションの使用」を参照してください。

ComplianceContent_name.xml

plugin_stage/oms/metadata/gccompliance/

オプション。ComplianceContent_name.xmlには、コンプライアンスの標準、ルールおよびフレームワークへの参照が含まれます。このディレクトリには、コンプライアンス・ルール、コンプライアンス標準およびコンプライアンス・フレームワークXMLファイルを含められます。詳細は、第13.8項「コンプライアンスXMLのパッケージ」を参照してください。

compliance.dlf

plugin_stage/oms/rsc/area/gccompliance/

オプション。コンプライアンスのルールまたは標準定義に関連付けられたすべてのデータ・ロード形式(DLF)マップ・エントリ・ファイルをこのディレクトリに配置します。

mpcui.xml

plugin_stage/oms/metadata/mpcui/

オプション。すべての管理ユーザー・インタフェースのメタデータ・ファイルをこのディレクトリに配置します。詳細は、第9章「管理ユーザー・インターフェースの定義」を参照してください。

discovery.xml

plugin_stage/oms/metadata/discovery/

オプション。検出メタデータ・ファイルをこの場所に配置します。詳細は、第12.4項「検出XMLおよび検出コンテンツのパッケージ化」を参照してください。

検出スクリプト・ファイル

plugin_stage/discovery/

オプション。自動検出を実行するために必要なPerlスクリプトおよびJARファイル(存在する場合)を、この場所に配置します。詳細は、第12.4項「検出XMLおよび検出コンテンツのパッケージ化」を参照してください。

スクリプト・ファイル

plugin_stage/agent/scripts/

オプション。fetchletによって起動されるメトリック収集スクリプトなど、管理エージェントにデプロイされるスクリプトをこの場所に配置します。

/scriptsディレクトリでは、target-type.xmlファイルおよびジョブ・タイプ・コマンド・リファレンスで定義されたメトリック問合せ記述子の%scriptsDir%トークンの使用が可能であるため、このディレクトリの使用は必須ではありませんが、推奨されています。


14.3 プラグインの検証

プラグインの検証は、開発サイクル全体を通して行い、パッケージ化する前にも行います。プラグインを設計し開発したら、empdk validate_pluginコマンドを使用してプラグインのコンテンツを検証し、XMLメタデータ・ファイルが標準に準拠していることを確認します。ツールは、指定されたプラグインのステージング・ディレクトリに対して実行され、検出された違反についてレポートを生成します。-formatオプションを使用して生成されたレポートの形式を指定します。

例14-2に、コマンドの使用方法を示します。

例14-2 empdk validate_pluginコマンドの使用方法

 empdk validate_plugin -stage_dir staging directory
                [-tmp_dir temporary working location]
                [-out_dir output directory] 
                [-format (html|text|xml)] 
                [-conn_desc] - not used by external developers
                [-repos_user Enterprise Manager repository owner] 
                [-debug [file to output debug information to]]

次の例は、指定されたステージング・ディレクトリにあるプラグイン・ソース・ファイルを検証し、検証レポートを現在の作業ディレクトリにテキスト・ファイルとして生成します。

edk\bin>empdk validate_plugin -stage_dir C:\plugin_staging -format text 

表14-2は、プラグインの検証に使用できるオプションを示しています。

表14-2 プラグインの検証オプション

オプション 説明

-tmp_dir

プラグイン・ファイルの抽出先となる一時的な場所を指定します。指定しない場合は、デフォルトで現在のディレクトリが使用されます。

-out_dir

検証レポート・ファイルの生成先となるディレクトリ。指定しない場合、レポート・ファイルは現在の作業ディレクトリに生成されます。

-debug

デバッグ情報を格納するファイルの名前を指定します。指定しない場合、デフォルト・ログ・ファイル(validateplugin.logtime)がoutディレクトリに作成され、警告およびエラー・メッセージのみを格納します。指定した場合、すべてのデバッグ情報がそのログ・ファイルに格納されます。

-format

検証レポートの生成に使用される形式。指定しない場合、レポートは、テキスト・ファイルとして生成されます。


14.4 プラグイン・アーカイブの作成

プラグインのステージング・ディレクトリを作成しプラグインを検証したら、次の手順として、Oracleプラグイン・アーカイブ(OPAR)・ファイルを作成します。OPARファイルは、プラグインのライフサイクルの様々な段階で重要な役割を果たします。次のように使用されます。

  • プラグイン・アーカイブは、Enterprise Manager Cloud Controlの様々なインストールにプラグインをインポートしデプロイするための、プラグインの標準的な配布方法です。

  • 開発中のプラグインをEnterprise Manager Cloud Controlインストールでテストする必要があります。

プラグインは、前述したファイルをEnterprise Manager拡張開発キット(EDK)を使用してOPARに追加することで作成します。EDKの詳細は、『Oracle Enterprise Manager Cloud Control拡張プログラマーズ・ガイド』を参照してください。

OPARコマンドを作成するには、コマンド・プロンプトでempdk create_pluginコマンドを入力します。create_plugin動詞の詳細は、コマンドライン・ヘルプを参照してください

empdk create_pluginコマンドの構文は次のとおりです。

empdk create_plugin -stage_dir staging dir -conn_desc repository_connection_string -repos_user username [-repos_password repos_password] 
           -out_dir output_directory [-debug] [-force]

例:

edk\bin>empdk create_plugin -stage_dir C:\pluginstagdir -conn_desc myhost.us.example.com:25055:$ORACLE_SID -repos_user sysman -out_dir /tmp/plugins

表14-3は、OPARの作成に使用できるオプションを示しています。

表14-3 OPARの作成オプション

オプション 説明

-tmp_dir

このオプションにより、コマンドの実行中に一時ディレクトリが作成されます。オプションの後に値を指定して、これに使用するパスを指定できます。既存のディレクトリを指定する必要があり、それ以外はエラーが返されます。指定しない場合、outディレクトリが一時的な場所に使用されます。outディレクトリが指定されていない場合、現在のディレクトリがデフォルトとなります。

-out_dir

プラグイン・アーカイブ(*.opar)・ファイルが作成されるディレクトリ。指定しない場合、プラグイン・アーカイブは現在のディレクトリに作成されます。

-debug

デバッグ情報を格納するファイルの名前を指定します。指定しない場合、デフォルト・ログ・ファイル(createplugin.logtime)がoutディレクトリに作成され、警告およびエラー・メッセージのみを格納します。指定した場合、すべてのデバッグ情報がそのログ・ファイルに格納されます。このデバッグ情報は、プラグインの作成中に発生する可能性のある問題の特定に使用できます。プラグインの作成に関連する問題についてサポート・リクエストを報告する際に、作成されたログを追加できます。

-force

outディレクトリに、同じ名前のOPARが含まれている場合、既存のOPARを上書きするかどうかを指定するプロンプトが表示されます。このオプションを指定した場合、既存のOPARは自動的に上書きされます。デフォルトでは、出力が無効化されます。

-conn_desc

プラグインがEnterprise Managerにインポートされるときにプラグイン・メタデータが書き込まれる管理リポジトリに接続する接続記述子。

構文: host:port:sidを使用して接続記述子を指定します。

例:

myhost.us.example.com:25055:$ORACLE_SID

-repos_user

管理リポジトリに接続されるユーザー。


コマンドの実行が成功すると、plugin_version.plugin_id.oparアーカイブがこのコマンドを実行したディレクトリに作成されます。

コマンドが失敗すると、対応するエラー・メッセージが表示されます。コマンドに渡されるパラメータは、ユーザーごと、およびプラグインが作成されるシステムごとに異なります。

プラグイン・アーカイブを作成する際の一般的なミスの例を次に示します。

  • ステージング・ディレクトリへのパスを誤って入力した場合、ファイルが見つからない、または入力が見つからないという例外がスローされます。

  • 現在のディレクトリを、展開されたEDKディレクトリに変更していない場合、empdkコマンドが見つからないという例外が表示されます。

  • OPARを作成しようとしているディスクのメモリーが不十分な場合、入力/出力関連の例外が発生する場合があります。

14.5 Enterprise Managerへのプラグイン・アーカイブのインポートおよびデプロイ

ユーザーの*.oparファイルでプラグイン・アーカイブを準備したら、プラグインをEnterprise Managerにインポートする必要があります。インポートすると、作成しパッケージ化したプラグインの内容がEnterprise Managerで使用できるようになります。


注意:

プラグインをEnterprise Managerにデプロイするには、まずプラグインをインポートする必要があります。

14.5.1 プラグインをインポートするための前提条件

プラグインをインポートする前に、次の前提条件を満たす必要があります。

14.5.1.1 ソフトウェア・ライブラリの設定

  1. Enterprise Managerがインストールされているシステムにフォルダを作成します。たとえば、/net/hostname/scratch/aime/swlib1のようになります。

  2. コンソールから、「Enterprise」「プロビジョニングとパッチ適用」「ソフトウェア・ライブラリ」の順に選択します。

  3. 「アクション」「管理」の順に選択します。

  4. 「追加」をクリックします。

  5. ポップ・アップ・ウィンドウで、名前および場所を入力します。たとえば、swlib1および/net/hostname/scratch/aime/swlib1のようになります。これはステップ1で作成したフォルダにする必要があります。

  6. 処理が終了するまで待ちます。

14.5.1.2 EM CLIユーティリティの設定

Enterprise Managerへのデプロイ用のプラグイン・アーカイブをインポートするには、Enterprise Managerコマンドライン・ユーティリティ、つまりEM CLIを使用します。

  • Cloud ControlコンソールにEM CLIの設定手順を示すページが表示されます。次のURLのページにアクセスします。

    https://em_host:em_port/em/console/emcli/download
    

    例:

    https://emserver.test.com:7799/em/console/emcli/download
    
  • EM CLIを設定した後、EM CLIクライアントとOracle Management Service (OMS)を同期化します。

    emcli sync
    

    同期化した後、このOMSで使用可能なすべての動詞および関連付けられたコマンドライン・ヘルプが、EM CLIクライアントで使用可能になります。

14.5.2 プラグイン・アーカイブのインポート

パッケージ化した後、emcli import_updateコマンドを使用して、プラグインをEnterprise Manager Cloud Controlにインポートする必要があります。EM CLIがインストールされている場所に応じて、2つのオプションがあります。

  • EM CLIがプラグイン・アーカイブ(*.oparファイル)を作成したシステムと同じシステム上にある場合は、次のコマンドを実行します。

    emcli import_update 
     -file=”<path to *.opar file you created>”
     -omslocal
    

    -omslocalフラグは、プラグイン・アーカイブがこのコマンドを実行中の同じシステム上にあることと、パスがこのシステムに存在することを示しています。

    例:

    emcli import_update -file=/tmp/sample_plugin.opar -omslocal

  • プラグイン・アーカイブ(*.oparファイル)を作成したシステムと異なるシステム上でEM CLIを実行している場合は、次のコマンドを実行します。

    emcli import_update 
             -file=”path to the .opar file”  
             -host="host name of plug-in host" 
             -credential_name="credential for plug-in host" 
             -credential_owner="credential owner on the plug-in host"
    

    詳細は次のとおりです。

    • -file: アーカイブを作成したシステム上の*.oparファイルへの絶対パス。

    • -host: ファイルが使用可能なホスト・ターゲットのホスト名。

    • -credential_name: 接続先のリモート・システムにある資格証明の名前。

    • -credential_owner: 接続先のホスト・システムにある資格証明の所有者。

    例:

    emcli import_update -file=/tmp/sample_plugin.opar -host="host1.test.com" -credential_name="myOracleCred" -credential_owner="mypassword"

  • 前述の手順の代替方法として、次のコマンドを実行することもできます。

    emcli import_update 
          -file=”path to *.opar file you created”          
          -host="hostname" 
          -credential_set_name="setname"
    

    -credential_set_name: ホスト・ターゲットに対する管理リポジトリに格納されている優先資格証明のセット名。次のいずれかになります。

    • HostCredsNormal: デフォルトの権限のない資格証明セット。

    • HostCredsPriv: 権限付きの資格証明セット。

14.5.3 Oracle Management Service (OMS)へのプラグインのデプロイ

プラグインをターゲットの監視に使用できるようにするには、最初にプラグインをOracle Management Service (OMS)にデプロイする必要があります。Enterprise Manager Cloud Controlでプラグインをデプロイするには、次の手順を実行します。


関連項目:

OMSにプラグインをデプロイし、それを使用してターゲットを検出する方法の視覚的デモンストレーションを表示するには、次のURLでOracle Learning LibraryからOracle Enterprise Manager 12c: Deploy a Pluginのビデオを選択してください。
https://apex.oracle.com/pls/apex/f?p=44785:24:942581250672901::NO::P24_CONTENT_ID,P24_PREV_PAGE:6000,1


注意:

管理エージェントにデプロイする前に、Oracle Management Serviceにプラグインをデプロイする必要があります。

特定のターゲット・タイプ用のプラグインは、それらのターゲット・タイプを監視する管理エージェントに自動的にデプロイされます。詳細は、第14.6項「ターゲット・インスタンスの追加」を参照してください。


Oracle Management Serverにプラグインをデプロイする手順:

  1. 「設定」メニューから「拡張性」「プラグイン」の順に選択します。

    ダウンロード済でプラグイン・ページにデプロイできるプラグインのリストが表示されます。

  2. プラグイン・ページで、デプロイする特定のプラグインを選択します。

  3. 「デプロイ先」をクリックし、「管理サーバー」を選択します。

    依存プラグインがデプロイされていることと、すべての既存の管理エージェントが指定されたプラグインのバージョンと互換性があることを確認します。管理エージェントが使用できない場合、資格証明の入力が求められます。

  4. 「プラグインのデプロイ」ウィンドウで、必要な詳細を指定します。デプロイ・プロセスの完了には、管理リポジトリのSYSユーザー・パスワードが必要になるので注意してください。

    バージョン・リストから、プラグインのバージョンを選択します。ターゲット・タイプ情報が表に表示されます。リポジトリSYSパスワードを入力して、「続行」をクリックします。

  5. 「プラグインのデプロイ」ウィンドウの手順に進みます。

  6. 「デプロイ」をクリックして、選択したプラグインをすべてのEnterprise Managerサーバーにデプロイします。

    デプロイ・ステータスを監視できるページが表示されます。選択したプラグインがすべてのEnterprise Managerサーバーにデプロイされます。

    デプロイ・ステータスを監視することもできます。これを行うにはEnterprise Manager Cloud Controlコンソールに移動し、ステップ1のようにプラグイン・ページに移動します。続いてプラグインを選択し、選択したプラグインのページ最下部で「最近のデプロイメント・アクティビティ」タブを選択します。この最下部セクションには、プラグインの詳細(プラグインID、バージョン、ベンダーなど)も表示されます。

    プラグインのデプロイ中にいずれかのステップが失敗した場合、ログ・ファイルは$ORACLE_HOME/cfgtoollogs/pluginca/*で入手できます。プラグインのデプロイ時の失敗に対するサポート・リクエストを記録する際は、これらのファイルも追加してください。また、このログは問題のデバッグに使用することもできます。

14.5.4 プラグインのデプロイに関する重要事項

  • 同じプラグインの複数のバージョンをインポートできます。デプロイするバージョンは、プラグインのデプロイにCloud Controlを使用する場合はリストから選択でき、EM CLIを使用する場合はコマンドラインで指定できます。

  • どの場合でも、Oracle Management Service (OMS)にデプロイできるのは1つのバージョンのみです。より最新のバージョンがすでにデプロイされている場合、以前のバージョンにダウングレードすることはできません。

  • プラグインを新規バージョンに更新しても、インポートされている以前のプラグインの内容は削除されません。

  • 管理エージェントは、OMSにデプロイされているプラグインと同じバージョンまたは以前のバージョンを保有できます。OMS上のバージョンよりも後のバージョンは、管理エージェント・ホストで使用できません。

  • OMS上および管理エージェント上のプラグインは、OMS上のバージョンが最新バージョンである限り、それぞれ個別に更新できます。

  • 使用可能な更新はプラグイン・ページに表示されます。これらは、Enterprise Managerストアからダウンロードするか、第14.5.2項「プラグイン・アーカイブのインポート」で説明しているように、EM CLIを使用してインポートできます。

14.6 ターゲット・インスタンスの追加

プラグインがOMSにデプロイされると、ターゲット・インスタンスを監視する準備が完了します。


注意:

現在のCloud Controlリリースでは、ターゲットを監視する管理エージェントへのプラグインのデプロイはもう必要ありません。かわりに、特定のターゲット・タイプに対するプラグインが、そのタイプのターゲットを監視する管理エージェントとともに自動的にデプロイされます。

これは、前のリリースから大きく変更された点であり、以前は、まずプラグインを管理エージェントに手動でデプロイする必要がありました。次に、ターゲット・インスタンスを管理エージェントに手動で追加する必要がありました。


プラグインがEnterprise Manager Cloud Controlから監視するターゲットを追加するには、「設定」メニューから「ターゲットの追加」を選択します。ターゲットを追加するプロセス、すなわちCloud Controlの用語におけるターゲット昇格は、選択するオプションによって異なります。

EM CLIユーティリティを使用して、ターゲット・インスタンスを追加することもできます。コマンド・プロンプトを開き、次のコマンドを実行します。

emcli add_target
        -name="name"
        -type="type"
        -host="hostname"
        [-properties="pname1:pval1;pname2:pval2;..."]...
        [-separator=properties="sep_string"]
        [-subseparator=properties="subsep_string"]
        [-credentials="userpropname:username;pwdpropname:password;..."]
        [-input_file="parameter_tag:file_path"]
        [-display_name="display name"]
        [-groups="groupname1:grouptype1;groupname2:grouptype2;..."]...
        [-timezone_region="gmt offset"]
        [-monitor_mode="monitor mode"]
        [-instances="rac database instance target name1:target type1;..."
]

例:

emcli add_target 
          -name="cluster_database"
          -type="rac_database"
          -host="myhost.us.example.com"
          -monitor_mode="1"
          -properties="ServiceName:service.us.example.com;ClusterName:newdb_cluster"
          -instances="database_inst1:oracle_database;database_inst2:oracle_database"

emcli help add_targetヘルプ・コマンドを使用すると、ターゲット・インスタンスを追加する際のその他のオプションを表示できます。

ターゲットが以前に追加されている場合、それらは、プラグインがデプロイされた後にそのプラグインによって昇格および監視されます。

14.7 メタデータ登録サービス(MRS)を使用したデプロイ済メタデータ・ファイルの更新

プラグイン開発プロセスの一環として、プラグインをアーカイブとしてパッケージ化し、Enterprise Manager Cloud Controlインストールにデプロイしてテストします。ただし、様々なメタデータ・ファイルに変更を加えるたびに、プラグインを再デプロイすることは避けたいのが一般的です。


注意:

メタデータ・ファイルを更新するたびに、メタデータのバージョンを更新する必要があります。

メタデータ登録サービス(MRS)を使用すると、1つ以上の更新されたメタデータ・ファイルを、プラグインがデプロイされているOracle Management Serviceおよび管理エージェントにアップロードできます。更新されたメタデータ・ファイルはEnterprise Managerに登録され、その更新内容で既存のメタデータを上書きします。


注意:

ターゲット・タイプおよびデフォルト収集については、MRSの使用に追加の手順が必要です。第14.7.1項「ターゲット・タイプおよびデフォルトの収集」を参照してください。

このサービスは、emctl register oms metadataコマンドを使用して起動します。構文は、次のとおりです。

emctl register oms metadata -service Metadata Service Id (-file metadata file to register | -file_list file containing list of files to register)  
          [-core | -pluginId Plugin Id] [-sysman_pwd "sysman password"]
 

たとえば、次のコマンドは、ターゲット・タイプのメタデータ・ファイルへの変更を登録します。

emctl register oms metadata -service targetType -file /staging/demo_hostsample.xml -pluginId test.demo.xyz -sysman_pwd myempassword

表14-4は、コマンドの使用方法を説明しています。

表14-4 emctlコマンドの使用方法

オプション 必須Y/N 説明

-service

Y

登録するメタデータの種類を指定します。値は次のとおりです。

  • targetType: ターゲット・タイプ・メタデータに指定します。

  • default_collection: デフォルト収集メタデータに指定します。

  • LiveSnapshotRegistration: 構成メタデータ登録に指定します

  • CredStoreMetadata: 指定します

  • jobTypes: 指定します

  • report: レポート・メタデータ登録に指定します

  • bipublisherreport: BI Publisherのレポート・メタデータに指定します。

  • discovery: 検出メタデータに指定します。

  • derivedAssocs: アソシエーション・メタデータに指定します。

  • gccompliance: コンプライアンス・ルール、コンプライアンス標準およびコンプライアンス・フレームワークのメタデータに指定します。

  • mpcui: 管理ユーザー・インタフェース・メタデータに指定します。

-file

N

アップロードおよび登録対象の単一メタデータ・ファイルのパスおよびファイル名。-fileまたは-file_listのいずれかを指定できます。

-file_list

N

メタデータ・ファイルのパス・リストを含むファイル(各行に1つ)のパスおよびファイル名。

-core

N

プラグイン開発では無効です。

-pluginId

N

更新対象のデプロイ済プラグインに付与される、3つの部分から構成される一意の識別子。詳細は、第2.2.1項「プラグインIDの定義」を参照してください。

-sysman_pwd

Y

Enterprise Managerユーザーのパスワード。


14.7.1 ターゲット・タイプおよびデフォルト収集

ターゲット・タイプおよびデフォルト収集については、このターゲット・タイプの既存のターゲットが存在する場合、MRSの使用に追加の手順が必要です。

既存のターゲットがあり、プラグインの開発プロセス中にメタデータ・ファイルを更新する場合、次の手順に従ってください。

  1. emctl register oms metadataコマンドを使用して、新しいメタデータ・ファイルを登録します。

    emctl register oms metadata -service targetType -file full path/TargetTypeMetadata.xml -pluginId Plugin Id -sysman_pwd sysman
    
    emctl register oms metadata -service storeTargetType -file full path/TargetTypeMetadata.xml -pluginId Plugin Id -sysman_pwd sysman
    
    emctl register oms metadata-service default_collection -file full path/TargetTypeCollection.xml -pluginId Plugin Id -sysman_pwd sysman 
    
    emctl register oms metadata-service systemStencil -file full path/TargetTypeStencil.xml -pluginId Plugin Id -sysman_pwd sysman
    
  2. 次に示すように、管理エージェント内のプラグイン・ホーム・ディレクトリ(PLUGIN_AGENT_HOME)の正しいディレクトリにメタデータXMLファイルを配置します。PLUGIN_AGENT_HOMEディレクトリは、プラグインが管理エージェントにデプロイされる際に作成されます。デフォルトの場所は、AGENT_BASE_DIR/pluginsです。

    $PLUGIN_AGENT_HOME/metadata/
    $PLUGIN_AGENT_HOME/default_collection 
    
  3. 管理エージェントを再起動します。

    AGENT_HOME/agent/bin/emctl stop agent
    AGENT_HOME/agent/bin/emctl start agent
    

    前のコマンドで、AGENT_HOME は管理エージェントのホーム・ディレクトリを表します。