7 Oracleリモート管理エージェントのインストール

Oracle Management Agent (管理エージェント)は、Enterprise Managerのコア・コンポーネントの1つで、Enterprise Managerシステムで管理対象外ホストを管理対象ホストに変換できます。管理エージェントはプラグインと連携することにより、管理対象ホスト上で実行されているターゲットをモニターします。

管理エージェント・タイプ

管理エージェントには様々なタイプがあります:

• スタンドアロン・エージェント: ローカル・ターゲットにインストールされたエージェント。ローカル・エージェントとも呼ばれます。
• リモート・エージェント: ホストやデータベースなどのリモート・ターゲットをモニターするためにホストにインストールされたエージェント。
• セントラル・エージェント: Enterprise Managerミドルウェアとともにインストールされたエージェント。ここに、OMSホームとエージェント・ホームが存在しています。

この章では、管理対象外のホストにリモート管理エージェントをインストールし、管理対象のホストにリモート管理エージェントを変換して、リモート・ホスト上のターゲットをモニターする方法について説明します。

ノート:

エージェント・ゴールド・イメージを使用した管理エージェント(スタンドアロン・エージェント)のインストールの詳細は、「Oracle Management Agentのインストール」を参照してください。

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

• リモート・エージェントのインストールの概要
• リモート管理エージェントのインストール

リモート・エージェントのインストールの概要

Oracleリモート管理エージェント(リモート・エージェント)は、リモート・ホスト上のターゲットをモニターするために専用ホストにインストールされるエージェントです。

Enterprise Managerは、ターゲットを検出してモニターおよび管理できるようにするためにエージェントに依存します。従来、ソフトウェアが実行されるのと同じホストにエージェントをインストールする必要があるため、インストールされたエージェントはターゲットの状態をモニターできます。非常に多くのホストにソフトウェアが分散している顧客は、非常に多くのエージェントをインストールすることになり、時間の経過とともに、これらのすべてのエージェントのライフサイクルを管理することが大きな運用コストになります。

リモート・エージェントとは

リモート・エージェントを使用すると、ターゲットと同じホストにローカル・エージェントをインストールするのではなく、別々のホストにインストールされているエージェントを使用して、Enterprise Managerでターゲットをモニターおよび管理できます。これらのエージェントは、ホストのモニターにリモート・プロトコルを使用し、必要に応じてSSHを使用してターゲット・ホストでコマンドを実行します。

リモート・ホスト上のターゲットがリモート・エージェントによって検出されると、Enterprise Managerの機能は、ローカル・エージェントによってモニターされているかのように動作します。たとえば、ジョブ・システム、デプロイメント・プロシージャ、パッチ適用などのモニターおよび管理機能を使用できます。

リモート・エージェントは多くのホスト上のターゲットをモニターできるため、Enterprise Manager管理者がメンテナンスする必要があるエージェントの数が大幅に減少します。

エージェントの可用性をチェックする場合、スタンドアロン・エージェント/ローカル・エージェントは、ホストが停止しているためにアクセスできないエージェントのみを処理する必要があります。一方、リモート・エージェントでは、エージェントが稼働中であり、他のホスト上のターゲットをモニターしているが、ターゲットのホストが停止している場合があります。

リモート・キャッシュ: すべてのリモート・エージェント構成を格納するモニター対象リモート・ホスト内の領域です。

リモート・エージェントは、モニター対象のホストでこの領域を自動的に保持します。たとえば、適用されたパッチのレプリケートまたはメトリック拡張スクリプトのプッシュを実行します。リモート・キャッシュには、javaランタイム、Perlインストール、Perlスクリプトでデータベースに接続するために使用されるクライアント・インストールなどの依存関係も含まれます。

ノート:

• ローカル・エージェントをリモート・エージェントに変換することはできません。
• リモート・エージェントにエージェント・ゴールド・イメージを介してパッチを適用することはできません。

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

• サポートされているオペレーティング・システム
• サポートされているEnterprise Managerターゲット
• リモート管理エージェントの利点と制限事項

サポートされているオペレーティング・システム

リモート・エージェントのインストールでは、次のオペレーティング・システムがサポートされます:

表7-1 リモート・エージェントでサポートされるオペレーティング・システム

オペレーティング・システム	バージョン
Oracle Linux x86-64 Red Hat Linux x86-64	「Oracle Management Agent用のパッケージ要件」を参照してください。

サポートされているEnterprise Managerターゲット

リモート・エージェントは、ホストおよびデータベース・ターゲットでのみサポートされます。

サポートされているデータベース・ターゲット

すべてのデータベース関連のターゲット・タイプは、リモート・エージェントを使用して検出およびモニターできます。

これには、データベース・インスタンス、クラスタ・データベース、自動ストレージ管理、Autonomous Transaction Processing (ATP)、Autonomous Data Warehouse (ADW)、クラスタおよび関連するすべてのタイプが含まれます。

サポート対象外: 次のデータベース・ターゲット・タイプは、リモート管理エージェントを使用して検出できません:

• データベース・マシン(オンプレミスExadata)。
• Zero Data Loss Recovery Appliance (ZDLRA),

リモート管理エージェントの利点と制限事項

利点

• エージェントのインストール数が少ないエージェント・ライフサイクルを簡素化します。

  Enterprise Managerは、ターゲットを検出してモニターおよび管理できるようにするためにエージェントに依存します。これまでは、ターゲットが実行されているホストと同じホストにエージェントをインストールする必要がありました。リモート・エージェントでは、インストールされるエージェントの数が少なくなり、すべてのエージェントの管理が容易になります。

• リモート・エージェントを使用する場合、スケール・アップして複数のホスト上のターゲットをモニターできます。たとえば、1つのリモート・エージェントで10個を超えるリモート・ホスト(規模が大きい場合は数百個のリモート・ホスト)をモニターできます。

制限事項

• 既存のスタンドアロン/ローカル・エージェントをリモート・エージェントに変更することはできません。
• すでに検出されたEnterprise Managerターゲットは、リモート・エージェントに更新または変更できません。
• リモート・エージェント・ホストとリモート・ターゲット・ホスト間のクロス・プラットフォーム・モニタリングはサポートされていません。
• スタンバイ・エージェントが構成されている場合、ATPおよびADWターゲットのリモート・エージェントは許可されません。

リモート管理エージェントのインストール

ホスト上で実行されているターゲットをリモートでモニターする場合は、任意の時点で、リモートの管理エージェント(リモート・エージェント)をインストールすることによりその管理対象外ホストを管理対象ホストに変換する必要があります。この項では、リモート管理エージェントのインストール方法について説明します。

ノート:

続行する前に、「リモート・エージェントのインストールの概要」を確認してください。

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

• リモート管理エージェントのインストールのワークフロー
• リモート管理エージェントをインストールするための前提条件
• リモート・ホスト・ターゲットの追加またはEM CLIを使用したリモート管理エージェントのインストール
• リモート管理エージェントをインストールした後のインストール後のタスクの実行

リモート管理エージェントのインストールのワークフロー

リモート管理エージェント(リモート・エージェント)のインストールを開始するには、次のステップを実行します:

表7-2

リモート・エージェントの前提条件の確認	「リモート管理エージェントをインストールするための前提条件」を参照してください
専用ホストへのリモート・エージェントのインストール	「リモート・ホスト・ターゲットの追加またはEM CLIを使用したリモート管理エージェントのインストール」を参照してください
インストール後のタスクの確認	「リモート管理エージェントをインストールした後のインストール後のタスクの実行」を参照してください

リモート管理エージェントをインストールするための前提条件

リモート・ホスト・ターゲットの追加ウィザード、EM CLIまたはエージェント・インストールをサイレント・モードで使用してリモート管理エージェントをインストールするには、次の前提条件を確認します:

表7-3 リモート管理エージェントをインストールするための一般的な前提条件

要件	説明
ハードウェア要件	ディスク領域: リモート・キャッシュ用に1Gb。
オペレーティング・システム要件	「サポートされているオペレーティング・システム」を参照してください。
接続先ホストの要件	リモート・ホストがEnterprise Managerによって検出されていないことを確認します。
宛先ホストの資格証明の要件	SSHキーまたはパスワードベースの資格証明が必要です。 SSH資格証明を選択した場合、リモート管理エージェントをインストールする前にSSHキーを構成する必要があります
sudo/pbrun/sesu/su SSH要件	リモート・ホスト・ターゲットの追加ウィザードまたはEM CLIを使用して名前付き資格証明を追加する場合は、sudoを使用します。 Enterprise Manager 24aiリリース1では、Power Brokerはサポートされていません。
ユーザーがパスワードなしのsudoを構成する必要があるかどうかを確認します	リモート・ホスト・ターゲットの追加の構成中、次の資格証明を使用できます: モニタリング資格証明: root特権資格証明を持たない通常のユーザー資格証明。権限のない操作の実行に使用されます。 管理資格証明: rootアクセスを必要とする特権操作の実行に使用される資格証明。管理資格証明は必須入力ではありません。ユーザーは、リモート・エージェントから次のコマンドを実行して、いつでもそれをオプションにできます: emctl setproperty agent -name _remoteHostRequireAdminCreds -value false
リモート・ホスト上のユーザーに対してパスワードなしのsudoが構成されているかどうかを確認します	リモート・ホスト上のモニタリング・ユーザーは、パスワードを要求しないように構成する必要があります。確認するには、次の手順を実行します: sudo -sを実行します 前述のコマンドでは、パスワードの入力は要求されません。 /usr/bin/id -uを実行して、rootユーザーに変更します 前述のコマンドの出力はrootです。 /etc/sudoersファイルを編集して、UIからのターゲットの検出に使用されるユーザーをプロビジョニングします。/etc/sudoersファイルの# User privilege specificationセクションに次を追加する必要があります: # User privilege specification root ALL=(ALL) ALL <username> ALL=NOPASSWD:ALL 例: presharm ALL=(ALL) NOPASSWD: ALL /etc/sudoersファイルの権限をchmod 440に変更します。

その他の前提条件は、「ホスト・ターゲットの追加ウィザードまたはEM CLIを使用してスタンドアロン管理エージェントをインストールするための汎用前提条件を満たす」を参照してください。

リモート・ホスト・ターゲットの追加またはEM CLIを使用したリモート管理エージェントのインストール

リモート管理エージェントは、次の方法を使用してインストールできます:

• ホスト・ターゲットのリモートでのモニター・ウィザードを使用したリモート管理エージェントのインストール
• EM CLIを使用したリモート管理エージェントのインストール

ノート:

リモート・ホスト・ターゲットの追加ウィザードまたはEM CLIを使用して名前付き資格証明を追加する場合は、sudoを使用します。Enterprise Manager 24aiリリース1では、Power Brokerはサポートされていません。

ホスト・ターゲットのリモートでのモニター・ウィザードを使用したリモート管理エージェントのインストール

この項では、ホスト・ターゲットのリモートでのモニター・ウィザードを使用してリモート管理エージェント(リモート・エージェント)をインストールする方法について説明します。

ホスト・ターゲットのリモートでのモニター・ウィザードを使用してリモート管理エージェントをインストールするには、次のステップを実行します:

1. コンソールの左上隅にあるナビゲーション・メニューを開き、「設定」をクリックします。

   「設定」で、「ターゲットの追加」、「ターゲットの手動追加」の順に選択します。

   「ホスト・ターゲットのリモートでのモニター」セクションで、「ホストにリモート・エージェントをインストール」を選択します。

   

2. 「ホストにリモート・エージェントをインストール: ホストとプラットフォームの詳細」ページで、次を実行します:

   1. このセッションに割り当てられたデフォルトの名前のままにするか、選択した一意の名前を入力します。

      入力するカスタム名は直観的な名前にすることができ、必ずしもデフォルトの名前と同じフォーマットにする必要はありません。たとえば、add_host_operation_1のようになります。

      一意のデプロイメント・アクティビティ名によって、このデプロイメント・セッションで指定されたインストール詳細を保存し、新規セッションですべての詳細を入力しなおすことなく、将来再利用できます。

   2. 「追加」メニューから「手動」を選択して「ホスト」の完全修飾名を入力し、リモート管理エージェントをインストールするリモート・ホストの「プラットフォーム」を選択します。

      インストールするためにシステムから取得されたリモート・ホスト名は、IPアドレスと短縮名を含んでいる場合があります。ただし、foo.example.comのように対象リモート・ホスト全体を表した、完全修飾されたホスト名を使用することをお薦めします。メンテナンスの簡素化および全体的なセキュリティのためにお薦めします。

      ノート:

      • リモート・ホストの完全修飾ドメイン名を入力することをお薦めします。モニタリングのため、Enterprise Managerは、ここで入力した正確な名前でリモート・ホストおよび管理エージェントを追加します。

      • 行当たり入力するリモート・ホスト名は1つのみにする必要があります。複数のリモート・ホスト名をカンマで区切って入力することはサポートされていません。

      • リモート・ホスト名にアンダースコア("_")が含まれていないことを確認する必要があります。

      または、「追加」メニューから「ファイルから」を選択してファイルに格納されたホスト名を追加するか、「検出されたホスト」を選択してEnterprise Managerで検出されたホストのリストからホスト名を追加できます。ホスト・ファイルでホスト名のエントリがどのように表示される必要があるかについては、ホスト・リスト・ファイルのフォーマットを参照してください。

      ノート:

      「追加」メニューから「検出されたホスト」を選択して検出されたホストのリストからリモート・ホストを追加すると、ホストのプラットフォームが自動的に検出されて表示されます。プラットフォーム名は、自動検出から得られたヒントやOMSホストのプラットフォームなど、複数の要素の組合せを使用して検出されます。このデフォルトのプラットフォーム名は提案であり、次のステップに進む前に必ずプラットフォームの詳細を確認することをお薦めします。

      ノート:

      • 自動検出の結果ページからこのページ(ホストとプラットフォーム・ページ)にアクセスする場合、そのページで選択したホストが表に自動的に表示されます。その場合、ホスト名およびそのプラットフォームの検証のみ行う必要があります。

   3. 「次」をクリックします。

3. 「ホストにリモート・エージェントをインストール: インストールの詳細」ページで、次を実行します:

   1. 「デプロイメント・タイプ」セクションで、「リモート・エージェント・インストール」と表示されていることを確認します。
   2. 表から、共通のプラットフォーム名でグループ化されたホストを示す最初の行を選択します。
   3. 「エージェントのインストール詳細」セクションで、ステップ3 (b)で選択したホストに共通するインストールの詳細を指定します。
   4. 「インストールのベース・ディレクトリ」に、管理エージェントのソフトウェア・バイナリ、セキュリティ・ファイルおよびインベントリ・ファイルをコピーするエージェント・ベース・ディレクトリへの絶対パスを入力します。

      たとえば、/u01/software/em24/agentbasedir/です

      入力したパスが存在しない場合は、指定されたパスにディレクトリが作成され、管理エージェントのソフトウェア・バイナリ、セキュリティ・ファイルおよびインベントリ・ファイルがその場所にコピーされます。

      ノート:

      インストールのベース・ディレクトリは、基本的にはエージェント・ベース・ディレクトリです。指定するディレクトリが空であることを確認します。以前に実行したデプロイメント・セッションがなんらかの理由で失敗した場合、エージェント・ベース・ディレクトリにADATMP_<timestamp>サブディレクトリがある可能性があります。この場合は、「ホストにリモート・エージェントをインストール」ページから、サブディレクトリを削除してデプロイメント・セッションを新たに開始するか、失敗したセッションを再試行します。

   5. 「インスタンス・ディレクトリ」で、デフォルトのインスタンス・ディレクトリの場所のままにするか、すべての管理エージェント構成ファイルを格納できるディレクトリへの絶対パスを入力します。

      たとえば、/u01/software/em24/agentbasedir/agent_instです

      カスタムの場所を入力する場合、そのディレクトリに書込み権限があることを確認してください。エージェント・ベース・ディレクトリ内にインスタンス・ディレクトリを保持することをお薦めします。

      入力したパスが存在しない場合は、指定されたパスにディレクトリが作成され、管理エージェントに関連するすべての構成ファイルがその場所にコピーされます。

   6. 「名前付き資格証明」ドロップダウン・リストから、資格証明がOMSとリモート・ホスト間のSSH接続を設定し、各リモート・ホストに管理エージェントをインストールするのに使用できる適切なプロファイルを選択します。

      ノート:

      • 資格証明プロファイルがない場合、または資格証明プロファイルはあるが「名前付き資格証明」リストで見つからない場合、このリストに対するプラス・アイコンをクリックします。名前付き資格証明の新規作成ウィンドウに、資格証明を入力し、適切なプロファイル名で格納して、管理エージェントのインストールに選択および使用できるようにします。また、作成している名前付き資格証明から、インストールの実行権限を持つ別のユーザーに切り替えるには、実行権限を設定します。

      • このリストに対するプラス・アイコンが無効な場合、資格証明があるプロファイルを作成する権限がありません。この場合、管理者に連絡して、新規プロファイルの作成権限を付与してもらうようリクエストするか、プロファイルを作成してもらい、「名前付き資格証明」リストにプロファイルを表示するアクセス権を付与してもらうようリクエストします。

      • ホストにリモート・エージェントをインストールを使用して名前付き資格証明を作成する場合、Power Brokerはサポートされません。かわりにsudoを使用する必要があります。

   7. 「ルート資格証明」リストから、rootユーザーの権限を取得するための適切なルート資格証明を選択します。これはオプションのフィールドです。このオプションは、お使いの資格証明にrootユーザーの権限として特定の権限が含まれていない場合にのみ使用できます。これはお使いの資格証明と一緒に使用します。
   8. 「権限委任設定」で、ルート・スクリプトの実行に使用する権限委任設定を検証します。デフォルトでは、Enterprise Managerで構成されている権限委任設定に設定されます。

      たとえば、「権限委任設定」フィールドには、次のいずれかを指定できます。

      /usr/bin/sudo -u %RUNAS% %COMMAND%
      /usr/bin/sudo -u -S %RUNAS% %COMMAND% (if a pseudo terminal is required for remote command execution via SSH)
      /usr/bin/sesu - %RUNAS% -c "%COMMAND%"
      /usr/bin/su - %RUNAS% -c "%COMMAND%"
      

      ノート:

      Power Brokerはリモート・エージェントではサポートされていません。

      「権限委任設定」フィールドを空白のままにすると、rootスクリプトはウィザードによって実行されません。インストール後にrootスクリプトを手動で実行する必要があります。

      この設定は、選択した名前付き証明の「別名実行」属性で設定されたユーザーとしてのインストールの実行にも使用されます(この名前付き資格証明の作成時にユーザーを設定している場合)。

      ノート:

      権限委任設定での%RUNAS%は、ルート・スクリプトを実行するルート・ユーザー、および名前付き資格証明の「別名実行」属性で設定された、インストールを実行するユーザーとしての権限を持ちます。

   9. 「ポート」で、管理エージェントの通信用に割り当てられたデフォルトのポート(3872)のままにするか、選択したポートを入力します。

      入力するカスタム・ポートはビジー状態ではない必要があります。不明な場合、このフィールドを空白にしておくことができます。Enterprise Managerによって、1830 - 1849の範囲から最初の使用可能な空きポートが自動的に割り当てられます。

   10. (オプション)「オプションの詳細」セクションで、実行するインストール前スクリプトおよびインストール後スクリプトが使用可能な、アクセス可能な場所への絶対パスを入力します。サポートされているのはシェル・スクリプトのみであり、インストール前スクリプトまたはインストール後スクリプトを1つのみ指定できることに注意してください。

       スクリプトをrootとして実行するには、「Rootとして実行」を選択します。管理エージェントをインストールするホスト上ではなく、OMSが実行されているホスト上にスクリプトがある場合、「OMSのスクリプト」を選択します。この場合、スクリプトはOMSホストから接続先ホストにコピーされてから、接続先ホストで実行されます。

   11. (オプション)「追加パラメータ」で、インストール時に渡す追加パラメータの空白区切りのリストを入力します。サポートされている追加パラメータの詳細なリストは、表6-2を参照してください。

       たとえば、インベントリ・ポインタの場所ファイルを指定する場合、-invPtrLocの後ろにファイルの場所への絶対パスを入力します。ただし、このパラメータはUNIXプラットフォームでのみサポートされ、Microsoft Windowsプラットフォームではサポートされないことに注意してください。

   12. 表にある他のすべての行に対して、ステップ3 (b)からステップ3 (i)までを繰り返します。
   13. 「次」をクリックします。

4. 各デプロイメント・フェーズで失敗したホストを無視して、あるデプロイメント・フェーズから別のデプロイメント・フェーズにデプロイメントが途切れることなく進むように、選択したホストにローリング形式で管理エージェントをデプロイする場合、$ORACLE_HOME/sysman/prov/agentpush/agentpush.propertiesファイルで次のように指定します。

   oracle.sysman.prov.agentpush.continueIgnoringFailedHost=true

5. 「確認」ページでインストールに指定した詳細を確認し、次のいずれかを実行します:

   • 詳細を変更する場合、変更を加えるページに到達するまで、「戻る」をクリックします。

   • なんらかの理由でデプロイメント・セッションを取り消す場合、「取消」をクリックします。「ターゲットの手動追加」ページに自動的に移動します。

   • 詳細に問題がない場合、「エージェントのデプロイ」をクリックしてリモート管理エージェントをインストールします。「ホストにリモート・エージェントをインストール」ページが自動的に表示され、デプロイメント・セッションの進行をモニターできます。

     実行中のデプロイメント・セッションを取り消す場合、「ホスト・ターゲットのリモートでのモニター」ページで「取消」をクリックします。セッションを取り消すと、そのセッションの追跡や再開はできません。 ただし、リモート・ホストで現在起動されているコマンドは、完了まで実行が続けられます。

     ホスト・ターゲットのリモートでのモニター・ウィザードを使用して、すべてのリモート・ホストの追加セッションの詳細の表示または進捗状況の追跡を実行するには、次の手順を実行します:

     「設定」メニューで、「ターゲットの追加」、「ターゲットの手動追加」の順に選択します。「ターゲットの手動追加」ページで、「リモート・エージェントおよびホスト追加の結果の表示」をクリックします。

6. 特定のインストール・フェーズが失敗したか警告が表示された場合は、「ホストにリモート・エージェントをインストール」ページの「エージェント・デプロイメントの詳細」セクションにある各フェーズの詳細を確認し、次のうちの1つを実行します:

   ノート:

   失敗の原因を特定するには、ログ・ファイルを確認します。ホストごとにログ・ファイルが1つ生成されるため、複数のホストに管理エージェントをインストールした場合は、すべてのログ・ファイルを確認してください。ログ・ファイルのアクセス方法の詳細は、Oracle Enterprise Managerアドバンスト・インストレーションおよび構成ガイドのインストールおよび構成ログ・ファイルの概要を参照してください。

   • エラーの説明を慎重に確認し、原因を理解し、Oracle推奨のアクションを実行することで、問題を解決します。

     • インストール詳細が同じであるリモート管理エージェントのデプロイを再試行できます。

       これを行うには、「ホストにリモート・エージェントをインストール」ページで、「再試行」をクリックして、「同じ入力を使用して再試行」を選択します。

     • インストール詳細が変更されたリモート管理エージェントのデプロイを再試行できます。

       これを行うには、「ホストにリモート・エージェントをインストール」ページで、「再試行」をクリックして、「入力を更新して再試行」を選択します。

   • 警告または失敗を無視し、必要な場合、セッションを続行します。

     • チェックを正常にクリアしたリモート・ホストのみでリモート管理エージェントのデプロイを続行することを選択し、警告または失敗のステータスを持つホストは無視できます。

       これを行うには、「ホストにリモート・エージェントをインストール」ページで、「続行」をクリックして、「失敗したホストは無視して続行」を選択します。

     • 警告または失敗のステータスを持つホストを含むすべてのホストで、リモート管理エージェントのデプロイを続行することを選択できます。

       このオプションを選択すると、リモート管理エージェント・インストールを続行するための前提条件を無視します。このオプションで続行するには、手動ですべての前提条件が満たされていることを確認してください。前提条件チェックの無視は、Oracle Supporの支援を得て実行するか、これらのチェックを実行しない場合の影響を十分理解したうえで行ってください。

       これを行うには、「ホストにリモート・エージェントをインストール」ページで、「続行」をクリックして、「すべてのホストで続行」を選択します。

EM CLIを使用したリモート管理エージェントのインストール

EM CLIを使用してリモート管理エージェントをインストールするには、次のステップを実行します:

1. Oracleホーム内に存在する/binディレクトリからEM CLIにサイン・インします。

   <ORACLE_HOME>/bin/emcli login -username=<user_name>

   このコマンドを実行すると、EM CLIによってパスワードが求められます。指定したユーザー名のパスワードを入力します。

2. EM CLIを同期します。

   <ORACLE_HOME>/bin/emcli sync

3. get_targets動詞を実行して、管理対象外のホストを一覧表示します。

   emcli get_targets -unmanaged -targets="%:host" -format=name:script
   

   リモート管理エージェントをインストールする、管理対象外ホストをノートにとっておきます。

   get_targets動詞に関する構文や使用法の詳細を表示するには、次のコマンドを実行します。

   <ORACLE_HOME>/bin/emcli help get_targets

4. list_add_host_platforms動詞を実行し、ソフトウェア・ライブラリ内にある管理エージェント・ソフトウェアのプラットフォームを一覧表示します。

   <ORACLE_HOME>/bin/emcli list_add_host_platforms 
                         [-all] 
                         [-noheader] 
                         [-script | -format]
   

   [ ]内のパラメータはオプションであることに注意してください。

   たとえば、<ORACLE_HOME>/bin/emcli list_add_host_platforms -allです

   list_add_host_platforms動詞に関する構文や使用法の詳細を表示するには、次のコマンドを実行します。

   <ORACLE_HOME>/bin/emcli help list_add_host_platforms

   ノート:

   リモート管理エージェントは、Linux x86-64プラットフォームでのみサポートされています。(プラットフォームID = 226)。詳細は、「サポートされているオペレーティング・システム」を参照してください。
5. 各デプロイメント・フェーズで失敗したホストを無視して、あるデプロイメント・フェーズから別のデプロイメント・フェーズにデプロイメントが途切れることなく進むように、選択したホストにローリング形式でリモート管理エージェントをデプロイする場合、<ORACLE_HOME>/sysman/prov/agentpush/agentpush.propertiesファイルで次のように指定します:

   oracle.sysman.prov.agentpush.continueIgnoringFailedHost=true

   このデプロイメント方法の詳細は、ホスト・ターゲットの追加ウィザードまたはEM CLIを使用したスタンドアロン管理エージェントのインストールを開始する前にを参照してください。

6. submit_add_host動詞を実行して、ホストの追加セッションを投入し、リモート管理エージェントをインストールします:

   <ORACLE_HOME>/bin/emcli submit_add_host
         -host_names=<names_of_hosts>
         -platform=<platform number_only 226 is supported>
         -credential_name=<software owner name>
         -installation_base_directory=<path to agent base directory>
         -privilege_delegation_setting="usr/bin/sudo -u %RUNAS% %COMMAND%"
         -additional_parameters=-ignorePrereqs
         -remote_agent

   たとえば、<ORACLE_HOME>/bin/emcli submit_add_host -host_names=example.com -platform=226 -installation_base_directory=/u01/software/em24/agentbasedir -credential_name=oracle -privilege_delegation_setting=sudoです

   この例では、/u01/software/em24/agentbasedirディレクトリにあるプラットフォームIDが226のexample.comホストに、oracleという名前付き資格証明を使用してリモート管理エージェントをインストールします。

   -platformパラメータは、プラットフォームIDを定義します。前述の例では、プラットフォームID 226はLinux x86-64に対応しています。図6-2に示すように、各プラットフォームには固有のプラットフォームIDが関連付けられています。

   -credential_nameパラメータは、特定のホストにリモート管理エージェントをインストールするために使用する名前付き資格証明を定義します。名前付き資格証明をまだ作成していないときは、create_named_credential動詞を使用して作成してください。この動詞の使用方法の詳細は、『Oracle Enterprise Managerコマンドライン・インタフェース』の create_named_credentialを参照してください。

   submit_add_host動詞に関する構文や使用法の詳細を表示するには、次のコマンドを実行します。

   <ORACLE_HOME>/bin/emcli help submit_add_host

7. get_add_host_status動詞を実行して、作成したホストの追加セッションのステータスを表示します。

   <ORACLE_HOME>/bin/emcli get_add_host_status 
                         -session_name 
                         [-details] 
                         [-show_only_failed_hosts] 
                         [-host_name] 
                         [-noheader] 
                         [-script | -format]
   

   [ ]内のパラメータはオプションであることに注意してください。

   たとえば、/u01/software/em24/oms_home/bin/emcli get_add_host_status -session_name=ADD_HOST_SYSMAN_operationです

   この例では、ADD_HOST_SYSMAN_operationホストの追加セッションのステータスを表示します。

   特定のホストのリモート管理エージェントに関するデプロイメント・ステータスの詳細を表示するには、-host_nameパラメータを指定してget_add_host_status動詞を実行します。たとえば:

   /u01/software/em24/oms_home/bin/emcli get_add_host_status -session_name=ADD_HOST_SYSMAN_operation -host_name=example.com

   このコマンドはまた、特定のホストへのリモート管理エージェントのデプロイメントのログ・ファイルの場所を表示します。デプロイメントが失敗したときは、ログ・ファイルを確認して、失敗の原因を調べることができます。各ホストにつき、ログ・ファイルは1つ作成されます。

   図6-3は、このコマンドのサンプル出力を表示します。

   図 7-1 emcli get_add_host_statusの出力

   
   

   

   
   

   他の方法として、管理エージェントのログ・ファイルの場所がどこにあるかは、Oracle Enterprise Managerアドバンスト・インストレーションおよび構成ガイドのインストールおよび構成ログ・ファイルの概要を参照してください。

   list_add_host_sessions動詞を実行して、すべてのホストの追加セッションの詳細と進行状況を表示します。

   <ORACLE_HOME>/bin/emcli list_add_host_sessions 
                         [-host_name]
                         [-session_name]
                         [-match_all]
                         [-noheader] 
                         [-script | -format]
   

   たとえば、<ORACLE_HOME>/bin/emcli list_add_host_sessions -host_name=example.comです

   この例は、example.comホストの一部分であるすべてのホストの追加セッションを表示します。

   get_add_host_status動詞や、list_add_host_sessions動詞に関する構文や使用法の詳細を表示するには、次のコマンドを実行します。

   <ORACLE_HOME>/bin/emcli help get_add_host_status
   <ORACLE_HOME>/bin/emcli help list_add_host_sessions
   

8. get_add_host_status EM CLI動詞の出力で、特定のインストール・フェーズが失敗したか警告が発生した場合は、次のいずれかを実行します。

   • エラーの説明を慎重に確認し、原因を理解し、Oracle推奨のアクションを実行することで、問題を解決します。

     • インストール詳細が同じであるリモート管理エージェントのデプロイを再試行できます。

       これをEM CLIを使用して行うには、retry_add_host動詞を、-retry_using_same_inputsオプションと使用します。

       <ORACLE_HOME>/bin/emcli retry_add_host 
                             -session_name 
                             -retry_using_same_inputs 
                             [-wait_for_completion]
       

       [ ]内のパラメータはオプションであることに注意してください。

       たとえば、/u01/software/em24/oms_home/bin/emcli retry_add_host -session_name='ADD_HOST_SYSMAN_operation2' -retry_using_same_inputsです

     • インストール詳細が変更されたリモート管理エージェントのデプロイを再試行できます。

       これをEM CLIを使用して行うには、retry_add_host動詞を、-update_inputs_and_retryオプションと使用します。

       <ORACLE_HOME>/bin/emcli retry_add_host 
               -session_name="session_name"
               -retry_using_same_inputs | -update_inputs_and_retry"
               [-host_names="Host names"]
               [-platform="Platform id"]
               [-installation_base_directory="Installation base directory"]
               [-credential_name="Credential Name"]
               [-credential_owner="Credential Owner"]
               [-instance_directory="Instance directory"]
               [-port="Agent port"]
               [-deployment_type="Type of agent deployment"]
               [-privilege_delegation_setting="Privilege delegation setting"]
               [-additional_parameters="parameter1 parameter2 ..."]
               [-source_agent="Source agent"]
               [-master_agent="Master agent"]
               [-preinstallation_script="Preinstallation script"]
               [-preinstallation_script_on_oms]
               [-preinstallation_script_run_as_root]
               [-postinstallation_script="Postinstallation script"]
               [-postinstallation_script_on_oms]
               [-postinstallation_script_run_as_root]
               [-configure_hybrid_cloud_agent]
               [-remote_agent]
               [-wait_for_completion]
       

       [ ]内のパラメータはオプションであることに注意してください。

       たとえば、/u01/software/em24/oms_home/bin/emcli retry_add_host -session_name='ADD_HOST_SYSMAN_operation2' -update_inputs_and_retry -credential_name=oracle2です

       この例では、ADD_HOST_SYSMAN_operation2のホストの追加セッションをoracle2名前付き資格証明を使用して、管理エージェントのデプロイメントを再試行します。

     retry_add_host動詞に関する構文や使用法の詳細を表示するには、次のコマンドを実行します。

     <ORACLE_HOME>/bin/emcli help retry_add_host

   • 警告または失敗を無視し、必要な場合、セッションを続行します。

     • チェックを正常にクリアしたリモート・ホストのみで管理エージェントのデプロイを続行することを選択し、警告または失敗のステータスを持つホストは無視できます。

       これをEM CLIを使用して行うには、continue_add_host 動詞を、-continue_ignoring_failed_hostsオプションとともに使用します。

       <ORACLE_HOME>/bin/emcli continue_add_host 
                             -session_name
                             -continue_ignoring_failed_hosts
                             [-wait_for_completion]
       

       [ ]内のパラメータはオプションであることに注意してください。

       たとえば、/u01/software/em24/oms_home/bin/emcli continue_add_host -session_name='ADD_HOST_SYSMAN_operation2' -continue_ignoring_failed_hostsです

     • 警告または失敗のステータスを持つホストを含むすべてのホストで、管理エージェントのデプロイを続行することを選択できます。

       このオプションを選択すると、管理エージェント・インストールを続行するための前提条件を無視します。このオプションで続行するには、手動ですべての前提条件が満たされていることを確認してください。前提条件チェックの無視は、Oracle Supporの支援を得て実行するか、これらのチェックを実行しない場合の影響を十分理解したうえで行ってください。

       これをEM CLIを使用して行うには、continue_add_host動詞を、-continue_all_hostsオプションと使用します。

       <ORACLE_HOME>/bin/emcli continue_add_host 
                             -session_name
                             -continue_all_hosts
                             [-wait_for_completion]
       

       [ ]内のパラメータはオプションであることに注意してください。

       たとえば、/u01/software/em24/oms_home/bin/emcli continue_add_host -session_name='ADD_HOST_SYSMAN_operation2' -continue_all_hostsです

     continue_add_host動詞に関する構文や使用法の詳細を表示するには、次のコマンドを実行します。

     <ORACLE_HOME>/bin/emcli help continue_add_host

ノート:

この項で説明したEM CLI verbの使用方法の詳細は、『Oracle Enterprise Managerコマンドライン・インタフェース・ガイド』のEMCLIの概要および概念に関する項を参照してください。

リモート管理エージェントをインストールした後のインストール後のタスクの実行

ホスト・ターゲットのリモートでのモニター・ウィザードまたはEM CLIを使用してリモート管理エージェントをインストールした後で、次のステップを実行します:

1. 「ホストにリモート・エージェントをインストール」ページまたはEM CLIのget_add_host_status動詞で、インストールを確認します。デプロイ操作の各フェーズ(初期化、リモートの前提条件チェックおよびエージェント・デプロイ)における進行状況を確認します。

   ホストにリモート・エージェントをインストール・ウィザードで、「エージェントのデプロイ」をクリックしてリモート管理エージェントをインストールすると、デプロイメント・セッションの進行状況をモニターできる「ホストにリモート・エージェントをインストール」ページに自動的に移動します。

   get_add_host_statusの使用方法は、EM CLIを使用したスタンドアロン管理エージェントのインストールを参照してください。

2. 必要があれば、手動でインストールを検証します。
   1. 管理エージェント・ホームに移動して次のコマンドを実行すると、管理エージェントが動作していることを確認するメッセージが表示されます。

      $<AGENT_INSTANCE_HOME>/bin/emctl status agent

   2. 管理エージェント・ホームに移動して次のコマンドを実行すると、EMDアップロードが正常に完了したことを確認するメッセージが表示されます。

      $<AGENT_INSTANCE_HOME>/bin/emctl upload agent

   3. 「設定」メニューから、「マネージャの管理」を選択し、「エージェント」を選択します。
      「エージェント」ページで、インストールしたリモート管理エージェントが稼働中であり、「エージェント・タイプ」列で「リモート」と表示されていることを確認します。
3. plug-ins listed in $<AGENT_HOME>/sysman/install/plugins.txtに一覧されたすべてのプラグインが正常にインストールされたかどうか確認します。これを行うには、次のコマンドを実行します。

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

4. 制限的な権限委任プロバイダ(PDP)構成設定がある場合は、PDP構成ファイルにnmosudoの場所を入力します。

   Enterprise Managerでは、SUDOやPowerBrokerなど、特定のユーザーが特定のコマンドを実行することを管理者が制限できるPDPがサポートされます。

   Enterprise Manager 24aiでは、nmosudoはエージェント・ホーム内のsbinディレクトリに配置されています。たとえば、<AGENT_HOME>/sbin/nmosudoです。

   したがって、Enterprise Manager 24ai管理エージェントをインストールする場合は、nmosudoの新しい場所を更新するようにPDP構成ファイルを変更する必要があります。

   たとえば、PDPとしてSUDOを使用する場合、SUDOの構成ファイルは通常/etc/sudoersです。このファイルで、次のエントリをnmosudoへの新しい場所で更新します。

   sudouser ALL : oracle /eminstall/basedir/sbin/nmosudo *

5. root権限やSUDO/PBRUNバイナリ、SUDO/PBRUN権限がないことに関する前提条件チェックの警告を無視した場合、インストールが行われた各ホストから、rootユーザーとして手動で次のスクリプトを実行します。SUDO/PBRUN権限を持っていない場合、権限を持つ管理者にこれらのスクリプトの実行を依頼してください。

   • これがホストにインストールした最初のOracle製品である場合、orainstRoot.shスクリプトを、管理エージェントのホームで使用可能なoraInst.locファイルで指定されたインベントリの場所から実行します。

     たとえば、oraInst.locファイルで指定されたインベントリの場所が$HOME/oraInventoryである場合、次のコマンドを実行します。

     $HOME/oraInventory/orainstRoot.sh

   • 管理エージェント・ホームからroot.shスクリプトを実行します。

     $<AGENT_HOME>/root.sh

6. 間違ったタイムゾーンの設定に関する前提条件チェックの警告を無視した場合、次のコマンドを実行して表示されるステップに従います。

   $<AGENT_INSTANCE_HOME>/bin/emctl resetTZ agent

7. デフォルトでは、リモート・ホストおよびリモート管理エージェントは、モニタリングのためにEnterprise Managerコンソールに自動的に追加されます。ただし、そのリモート・ホストで実行中のターゲットは、自動的に検出およびモニターされません。

   リモート・ターゲットの検出:

   その他のターゲットをモニターするには、「自動検出の結果」ページ、「ホスト・ターゲットのリモートでのモニター」ページ、またはモニターするターゲットに提供されている検出ウィザードを使用して、そのターゲットをEnterprise Managerに追加する必要があります。

   Enterprise Managerのターゲットの検出の詳細は、Oracle Enterprise Managerモニタリング・ガイドのターゲットの検出および追加の概要を参照してください。

8. Oracle Cloud Infrastructure (OCI)にあるホストにリモート管理エージェントをインストールする場合、前述のステップも適用されます。

   • エージェントがEnterprise Managerのすべてのターゲット・ページに表示されていることを確認します。

   • Enterprise Managerでエージェントに権限委任が設定されていることを確認します。Enterprise Managerを開き、「設定」→「セキュリティ」に移動して「権限委任」をクリックします。

   リモート管理エージェントのインストールが完了したら、ターゲットの検出に進むことができます。Enterprise Managerのターゲットの検出の詳細は、Oracle Enterprise Managerモニタリング・ガイドのターゲットの検出および追加の概要を参照してください。

ノート:

• 既存の管理エージェントを新しいOracle Management Service (OMS)に再指定できます。この方法の詳細は、Oracle Enterprise Managerアドバンスト・インストレーション・ガイドのOracle Management Agentの別のOracle Management Serviceへのリダイレクトを参照してください。

  既存の管理エージェントを新しいOMSに対して再指定する場合、管理エージェントのモニター対象ターゲット、ターゲットの履歴および管理エージェントの履歴は移行できません。モニター対象ターゲットおよび履歴データは失われます。