1. Cloud Controlアドバンスト・インストレーションおよび構成ガイド
  2. Oracle Management Agentの別のOracle Management Serviceへのリダイレクト

B Oracle Management Agentの別のOracle Management Serviceへのリダイレクト

この付録では、すでにOracle Management Service (OMS)と通信しているOracle Management Agent (管理エージェント)を、異なるEnterprise Manager Cloud Control (Cloud Control)のデプロイメントの一部である別のOMSにデータを通信またはアップロードするために、リダイレクトまたは再指定する方法を説明します。

ノート:

  • 別のCloud Controlデプロイメントの一部である別のOMSへの管理エージェントのリダイレクトは、新規にデプロイされ初期バージョンからアップグレードされていない管理エージェントの場合にのみサポートされています。初期バージョンからアップグレードされた管理エージェントはリダイレクトできません。

  • 異なるCloud Controlデプロイメントの一部である別のOMSに管理エージェントをリダイレクトすると、ユーザー定義のメトリック収集やemd.propertiesファイルに加えられた変更などのエージェント・インスタンス・ホームへのすべての変更が失われます。

この付録の具体的な内容は次のとおりです。

管理エージェントを別のOMSにリダイレクトするための前提条件

管理エージェントをリダイレクトまたは再指定する前に、次の前提条件を満たしていることを確認してください。

  • 管理エージェントを指定する新しいOMSが管理エージェントと同じまたはそれ以上のバージョンであることを確認します。

    再指定する管理エージェントのバージョンを確認するには、「設定」メニューから「Cloud Controlの管理」を選択し、「エージェント」を選択します。管理エージェントの名前をクリックします。管理エージェントのバージョンが「サマリー」セクションに表示されます。

    新しいOMSのバージョンを確認するには、「設定」メニューから、「Cloud Controlの管理」、「管理サービス」の順に選択します。新しいOMSの名前をクリックします。OMSのバージョンが「サマリー」セクションに表示されます。

    新しいOMSが管理エージェントと互換性のある場合にのみ、管理エージェントを再指定できます。Enterprise Managerの動作保証マトリックスを使用すると、OMSのバージョンと管理エージェントのバージョンとの互換性を確認できます。このマトリックスにアクセスするには、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』のEnterprise Manager動作保証マトリックスへのアクセスに関する項を参照してください。

  • 管理エージェントで指定していた以前のOMSと、管理エージェントで指定しようとしている新しいOMSには、同じセットのプラグインがデプロイされており、管理エージェントに設定されているすべてのプラグインが新しいOMSにデプロイされていることを確認します。また、新しいOMSにデプロイされたこれらすべてのプラグインが同じバージョン(管理エージェントまたは以前のOMSで設定されたバージョン)か、それ以上のバージョンであることも確認します。

    特定のOMSにデプロイされたプラグインの一覧を確認するには、Enterprise Managerシステムにログインし、「設定」メニューから「拡張性」、「プラグイン」の順に選択します。

    特定の管理エージェント上で設定されたプラグインの一覧を表示するには、次のコマンドを実行します。

    $<AGENT_INSTANCE_HOME>/bin/emctl listplugins agent -type all

  • リダイレクトする管理エージェントが稼働していることを確認してから、次のコマンドを実行し、plugins.txtファイルを再作成します。

    $<AGENT_HOME>/perl/bin/perl $<AGENT_HOME>/sysman/install/create_plugin_list.pl -instancehome <AGENT_INSTANCE_HOME>

    ノート:

    デフォルトでは、Perlインストールの場所はcreate_plugin_list.plで/usr/local/binとして指定されています。別の場所にある管理エージェントにPerlがインストールされている場合は必ず、create_plugin_list.plの最初の行を編集し、Perlがインストールされている場所を指定してください。

  • ターゲット・タイプまたはコレクション・メタデータを変更する、管理エージェントに適用されたすべてのパッチも、管理エージェントで指定する新しいOMSに適用されます。

    管理エージェントに適用されているすべてのパッチを確認するには、「ターゲット」メニューから「すべてのターゲット」を選択します。管理エージェントのOracleホーム・ターゲットの名前をクリックします。管理エージェントに適用されたすべてのパッチが「適用済パッチ」セクションに表示されます。

    表示されたパッチの一覧から必要なパッチ(ターゲット・タイプまたはコレクション・メタデータを変更するパッチ)を新しいOMSに適用します。OMSにパッチを適用する方法の詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』のOracle Management Serviceおよびリポジトリのパッチ適用に関する項を参照してください。

  • 再指定する管理エージェントに個別パッチを適用している場合には、必ず管理エージェントおよび新しいOMSにバグ15904425の修正を適用してください。

別のOMSへの管理エージェントのリダイレクト

管理エージェントをリダイレクトまたは再指定するには、次のステップを実行します。

  1. 管理エージェントを停止します。

    $<AGENT_INSTANCE_HOME>/bin/emctl stop agent

  2. 元のOMSで管理エージェント・ターゲットを削除します。

    $<ORACLE_HOME>/bin/emcli delete_target -delete_monitored_targets -name=<name_of_agent_target> -type="oracle_emd"

    delete_target EMCLIコマンドの詳細は、Oracle Enterprise Manager Cloud Controlコマンドライン・インタフェース・ガイドのdelete_targetに関する項を参照してください。

  3. 管理エージェント・インスタンス・ホームを削除します。

    rm -rf <absolute_path_to_agent_instance_home>

    エージェント・ベース・ディレクトリおよびエージェント・インスタンス・ホームが同じ物理的場所を指している場合には、このコマンドは実行しないでください。かわりに、<AGENT_INSTANCE_HOME>/bin, <AGENT_INSTANCE_HOME>/sysman, <AGENT_INSTANCE_HOME>/diag,および<AGENT_INSTANCE_HOME>/installディレクトリを削除してください。

  4. 管理エージェントの新しいインスタンス・ホームを作成し、新しいOMSにリダイレクトします。これには、agentDeploy.shスクリプト(Microsoft WindowsホストではagentDeploy.bat)に-configOnlyオプションを指定して実行します。

    $<AGENT_BASE_DIR>/agent_13.4.0.0.0/sysman/install/agentDeploy.sh AGENT_BASE_DIR=<absolute_path_to_agent_base_dir> AGENT_INSTANCE_HOME=<absolute_path_to_agent_base_dir>/agent_inst AGENT_PORT=<port_for_agent_process> OMS_HOST=<new_oms_host_name> EM_UPLOAD_PORT=<upload_port> AGENT_REGISTRATION_PASSWORD=<agent_reg_password> -configOnly

    次に例を示します。

    /scratch/emga/agt4agi/agent_13.4.0.0.0/sysman/install/agentDeploy.sh AGENT_BASE_DIR=/u01/software/em13c/agentbasedir AGENT_INSTANCE_HOME=/u01/software/em13c/agentbasedir/agent_inst AGENT_PORT=3880 OMS_HOST=newoms.example.com EM_UPLOAD_PORT=4900 AGENT_REGISTRATION_PASSWORD=<password> -configOnly

    agentDeploy.shまたはagentDeploy.batの実行時に指定できるパラメータの詳細は、表6-4を参照してください。-configOnlyオプションの詳細は、表 6-7を参照してください。

    ノート:

    指定したエージェント・ベース・ディレクトリ位置および新しいエージェント・インスタンス・ホーム位置は、管理エージェントがすでに構成されているホストと同じホスト上にマップされます。当然、OMSホスト名は、新しいOMS(今回通信する管理エージェント)が構成されている他のホストにマップされます。