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

エージェント・ソフトウェアのダウンロード

エージェント・ソフトウェアをダウンロードするには、次の手順を実行します:

  1. 管理エージェントのホーム・ページで、左側のメニューの「ダウンロードとキー」をクリックして、「ソフトウェア・ダウンロード」ペインを表示します。

    「ソフトウェアのダウンロード」ペインが表示されます。

  2. 「ソフトウェアのダウンロード」ペインで、管理エージェントをインストールするオペレーティング・システムを「ダウンロード」列で選択します。

  3. オペレーティング・システムに対応するリンクをクリックして、エージェント・ソフトウェア・ファイルをダウンロードします。

    たとえば、Windowsの場合は「Agent for WINDOWS (X86_64)」をクリックします。

ソフトウェア・ダウンロード表とソフトウェア・ファイルをダウンロードするためのリンクを示すソフトウェア・ダウンロード・ページ。

Note

For Exadata systems, download the Agent for LINUX (x86_64) ZIP file since Exadata Cloud Lifecycle looks for unknown RPMs and might remove the Management Agent RPM before installing it.

これで、ソフトウェア・ファイルがホストに保存されました。

ファイルの整合性を検証するには、SHA-256 Checksum列の値が次のコマンドの出力と一致するかどうかを確認します: sha256sum <download_file>

Note

The Agent software image download URL is available only via agent-image list CLI command or ListManagamentAgents API with valid OCI authentication. For details, see Download the Agent Software Using CLI.

CLIを使用したエージェント・ソフトウェアのダウンロード

CLIを使用して管理エージェント・ソフトウェアをダウンロードするには、次を実行します:
  1. agent- image list CLIコマンドを使用して、object-url値を取得します。
    oci management-agent agent-image list --compartment-id <tenancyId>

    戻り値のobject-urlは次のようになります。

    https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_agent.rpm

    前述の<namespace>および<bucketName>値をノートにとります。

  2. ステップ1の<namespace>および<bucketName>値を使用して、OCI認証済プリンシパルで管理エージェント・ソフトウェアをダウンロードします:
    • Linuxの場合:
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-x86_64/latest/oracle.mgmt_agent.rpm --file oracle.mgmt_agent.rpm
    • Windowsの場合:
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Windows-x86_64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Solarisの場合:
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Solaris-Sparc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • AIXの場合:
      oci os object get --namespace <namespace> --bucket-name  <bucketName> --name AIX-ppc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip 
    • Linux ARMの場合:
      oci os object get --namespace <namespace> --bucket-name  <bucketName> --name Linux-Aarch64/latest/oracle.mgmt_agent.rpm  --file oracle.mgmt_agent.rpm

    ファイルの整合性を確認するには、SHA-256 Checksum列の値が次のコマンドの出力と一致するかどうかを確認します: sha256sum <download_file>

Oracle Cloud Infrastructure (OCI)コマンドライン・インタフェース(CLI)は、コマンドライン・インタフェース・ツールです。詳細については、Command Line Interface (CLI)を参照してください。

ノート

object-url値を取得するには、管理エージェントAPI ListManagementAgentImagesも使用できます。

インストール・キーの作成

管理エージェントのインストールを実行する前に、インストール・キーを作成する必要があります。

インストール・キーはアイデンティティ・ドメインに対して発行され、インストールの信頼性を検証します。管理エージェントのインストール・プロセスを開始する前にこれを作成したことを確認してください。

キーを作成するには:

  1. 管理エージェントのホーム・ページで、左側のメニューの「ダウンロードとキー」をクリックして、「インストール・キー」ペインを表示します。

    ページの下部に「インストール・キー」ペインが表示されます。

  2. 「インストール・キー」ペインで、「キーの作成」をクリックしてキーを作成します。

  3. 「キーの作成」ウィンドウに、必要な詳細を入力します。

    1. 「キー名」フィールドに、キーを識別するための名前を指定します。

    2. 「コンパートメント」フィールドで、ドロップダウン・リストからコンパートメントを選択します。これは、エージェント・リソースが作成されるコンパートメントです。

    3. 「最大インストール」フィールドに、キーに関連付けることができるインストールの最大数を示す数値を指定します。デフォルト値は1000です。

    4. 「有効な対象」フィールドに、キーの有効期間を示す数値を指定します。デフォルト値は1週間です。

    5. 「無制限」チェック・ボックスはオプションです。

      これを選択すると、エージェントおよびゲートウェイのインストールを無制限に使用でき、キーは期限切れになりません。

      無制限キーを使用するリスク: Oracleでは、インストール・キーの存続期間を、最小限必要な時間と限られた数のエージェントに保持することをお薦めします。機密性を保護するために、ダウンロードしたキーをセキュアな場所に保持します。無制限のインストール・キーが危険にさらされた場合、攻撃者はテナンシに不正エージェントをインストールできます。テナンシのエージェントを定期的に監査することで、無制限のインストール・キーに関連する潜在的なリスクを軽減できます。無制限のインストール・キーが不要になった場合は、管理エージェント・コンソールまたはCLIを使用して必ず削除してください。

    「キーの作成」ダイアログ・ボックス。

    新しいキーが作成されました。

「インストール・キー」ペインには、キーの管理に使用できる様々なオプションが用意されています。「キーをファイルにダウンロード」オプションは、レスポンス・ファイルの構成の説明に従って、レスポンス・ファイル・テンプレートとして使用できるファイルをダウンロードするのに役立ちます。

インストール・キーの管理の詳細は、インストール・キーの管理を参照してください。

ノート

管理ゲートウェイをインストールしている場合、同じインストール・キーを使用して管理ゲートウェイと管理エージェントをインストールできます。管理ゲートウェイの詳細は、管理ゲートウェイを参照してください。

レスポンス・ファイルの構成

管理エージェントのインストール・スクリプトは、レスポンス・ファイルを使用して、環境固有のエージェント・パラメータを読み取ります。

エージェント・パラメータの確認

エージェント設定スクリプトを実行する際には、エージェント・パラメータを含むレスポンス・ファイルが必要です。

次の項では、レスポンス・ファイルでサポートされるパラメータについて説明します:

表3-1 レスポンス・ファイルのパラメータ

パラメータ名 パラメータ・タイプ 説明
ManagementAgentInstallKey 必須 ドメインのアイデンティティとインストールの信頼性を検証するために必要なインストール・キー。
CredentialWalletPassword オプション エージェント・ウォレットのパスワード(ユーザーが機密情報を格納するためにウォレットのカスタム・パスワードとして指定する場合)。
パスワードの長さは8文字以上で仕様は次のとおりです:
  • 少なくとも1つの小文字(a-z)
  • 少なくとも1つの大文字(A-Z)
  • 少なくとも1つの数字(0-9)
  • 次の特殊文字を少なくとも1つ: !、@、#、%、^、&、*'

パスワードの文字はすべて、前述の文字を使用する必要があります。たとえば、パスワードの一部に$文字が含まれる場合、そのパスワードは有効性チェックに合格しません。$は前述の特殊文字の中にないためです。

GatewayServerHost オプション 管理ゲートウェイ・サーバーまたはプロキシ・サーバーのホスト名またはアドレス。

指定する場合は、GatewayServerPortも指定する必要があります。

管理ゲートウェイが高可用性モードで構成されている場合は、ロード・バランサのホスト名をGatewayServerHost値として指定する必要があります。詳細は、管理ゲートウェイの高可用性の構成を参照してください。

GatewayServerPort オプション 管理ゲートウェイ・サーバーまたはプロキシ・サーバーのポート番号。

指定する場合は、GatewayServerHostも指定する必要があります。

管理ゲートウェイが高可用性モードで構成されている場合は、ロード・バランサのポート番号をGatewayServerPort値として指定する必要があります。詳細は、管理ゲートウェイの高可用性の構成を参照してください。

GatewayServerUser オプション ユーザー名(管理ゲートウェイ・サーバーまたはプロキシ・サーバーで認証が必要な場合)。

指定する場合は、GatewayServerPasswordも指定する必要があります。

GatewayServerPassword オプション パスワード(管理ゲートウェイ・サーバーまたはプロキシ・サーバーで認証が必要な場合)。

指定する場合は、GatewayServerUserも指定する必要があります。

GatewayServerRealm オプション プロキシ・サーバーの認証レルム。

管理ゲートウェイを使用する場合、この値は不要です。

AgentDisplayName オプション エージェントの表示名。空にしておくと、デフォルト値がAgent (host-name)に設定されます。
Service.plugin.<plugin_name>.download=true オプション エージェントのインストール時にデプロイするプラグインの名前。<plugin_name>は、管理エージェント・サービスでサポートされるプラグインです。

たとえば、エージェントのインストール時にDataSafeプラグインをデプロイしようとする場合は、次のように指定します: Service.plugin.datasafe.download=true

FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}] オプション OCIでタグを使用する場合のタグ・メタデータの関連付け。

これはキーと値で構成されます。キーは、タグを参照するために使用する任意の名前です。値は、タグを適用するユーザーがタグ・キーに追加する値です。

「関連付けられたエージェント」で、この管理エージェントが管理ゲートウェイを介して接続するように構成されている場合は、"GatewayGroup"という名前のタグを追加します。

たとえば: "GatewayGroup":"<User_Defined_ClusterName>

DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}] オプション OCIでタグを使用する場合のタグ・メタデータの関連付け。タグ管理者がすべてのタグを作成および管理し、ユーザーがそれらをリソースに適用します。ユーザーはタグ・ポリシーを定義しておく必要があります。

タグ・ネームスペースは、タグ・キーのコンテナです。タグ・キーはネームスペース内のキーです。ネームスペース内の定義済タグに対してタグ・キーを作成する必要があります。

定義済タグでは、タグ値のタイプが文字列または文字列リストのいずれかになります。タグ値タイプを定義する際に、定義されたタイプが文字列である場合は、任意の値を入力できます。一方、文字列リストである場合、この値はそのリストのいずれかの文字列である必要があります。

GatewayServerRootCACertOcid オプション このパラメータは、エージェント・バージョン221019.0021から使用できます。

エージェントがバージョン221019.0021.1667404647以上の管理ゲートウェイに接続すると、接続が暗号化されます。

このパラメータは、使用するルート認証局証明書のOCIDを指定します。エージェントとゲートウェイの両方が同じコンパートメントにある必要があります。

importTrustedCertsDirectory オプション

追加のルートCA証明書の場所(PEM形式)。

PEM形式でルートCA証明書を追加する場合は、このパラメータを使用します。管理エージェントはその場所で検索し、インストール時に証明書を追加します。

たとえば: importTrustedCertsDirectory=/tmp/crt

maxHeapInMb オプション 最大ヒープの量(MB)。

デフォルトのヒープ値は512MBです。このパラメータを使用して、エージェントがログやデータベースなどの大きな負荷で構成される前のインストール時間がわかっている場合に、より多くのヒープを使用するようにエージェントをチューニングします。

例: maxHeapInMb=1024

BufferingEnabled オプション ログ・アナリティクスやオブジェクト・ストレージOCIサービスなどの管理ゲートウェイを介した様々なエンドポイントのバッファリングを有効にします。

レスポンス・ファイルの作成

進める前に、エージェント・パラメータのレビューに記載されている情報を確認して理解したことを確認してください。

エージェントをインストールおよび構成するには、レスポンス・ファイルを作成し、新たに作成したレスポンス・ファイルを使用してスクリプトを実行する必要があります。このレスポンス・ファイルが、エージェントに正しいOCIリージョンを示し、エージェントのためのリソースの作成を許可します。

ノート

レスポンス・ファイルを作成する場合は、ファイルの場所と権限を確認してください。レスポンス・ファイルにmgmt_agent OSユーザーの読取り権限があることを確認します。

レスポンス・ファイルを作成するには、次のいずれかのオプションを使用します:

オプション1: レスポンス・ファイル・テンプレートをダウンロードして、レスポンス・ファイルを作成します

エージェント・パラメータを含むテンプレート・ファイルをダウンロードできます。このテンプレート・ファイルを保存して、エージェントのインストール時にレスポンス・ファイルとして使用することができます。

レスポンス・ファイル・テンプレートをダウンロードするには、「エージェント・インストール・キー」リストの「キーをファイルにダウンロード」メニュー・オプションを使用します。
  • 左側のメニューで「ダウンロードとキー」をクリックして、「エージェント・インストール・キー」ペインを開きます。エージェント・インストール・キーのリストから、ダウンロードするキーを選択します。

  • 選択したキーの右側で、アクション・メニューアクション・メニューをクリックし、「キーをファイルにダウンロード」を選択します。

    ファイルがダウンロードされます。詳細は、インストール・キーのダウンロードを参照してください。

エージェント・インストール・キーをファイルにダウンロードすると、ダウンロードされたファイルには、特定のエージェント・インストール・キーなど、エージェントのパラメータが含まれます。

ファイルをダウンロードした後で、環境に応じてカスタマイズする必要があります:
  • テキスト・エディタを使用してファイルを開き、確認してから、必須のエージェント・パラメータを編集します。エージェント・パラメータの確認を参照してください。
  • 特定のエージェント構成で不要なエージェント・パラメータは、コメント・アウト(行の先頭に#記号を追加)するか削除します。
  • 特定のエージェント構成で必要なエージェント・パラメータは、コメント解除(行の先頭の#記号を削除)し、必要な場合にはエージェント・パラメータ値を更新します。
  • 更新したレスポンス・ファイルを保存します。たとえば、input.rspレスポンス・ファイルとして保存できます。

オプション2: テキスト・エディタを使用してレスポンス・ファイルを作成します

レスポンス・ファイルは、テキスト・エディタを使用して手動で作成できます。たとえば、任意のテキスト・エディタを使用してファイルを作成し、エージェント構成に必要なエージェント・パラメータをそのレスポンス・ファイルに追加して保存します。たとえば、レスポンス・ファイルはinput.rspとして保存できます。

input.rspレスポンス・ファイルのサンプル:
managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5
CredentialWalletPassword = Abcdefgh1#

前述のオプションのいずれかを使用してレスポンス・ファイルを作成した後で、ファイルの権限を確認し、mgmt_agentユーザー(管理エージェントのインストール・プロセス中に作成されたOSユーザー)の読取り権限があることを確認します。

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

エージェント・ソフトウェアをダウンロードしてインストール・キーを作成した後、管理エージェントのインストールを続行して、Oracle Cloud Infrastructureから管理および監視するソースからデータを収集できます。

Linux (RPMファイル)への管理エージェントのインストール

RPMファイルを使用して管理エージェント・ソフトウェアをLinuxにインストールするには、次のステップを実行します。
  1. sudo権限を持つユーザーとしてログインします。

  2. 管理エージェント・ソフトウェアをインストールします。

    管理エージェント・ソフトウェアのRPMファイルをダウンロードしたディレクトリに移動し、次のコマンドを実行してRPMファイルをインストールします:
    sudo rpm -ivh <rpm_file_name.rpm>

    例: sudo rpm -ivh oracle.mgmt_agent-<VERSION>.rpm

    出力は次のようになります:
    Preparing... ################################# [100%]
    Checking pre-requisites
    
          Checking if any previous agent service exists
          Checking if OS has systemd or initd
          Checking available disk space for agent install
          Checking if /opt/oracle/mgmt_agent directory exists
          Checking if 'mgmt_agent' user exists
          'mgmt_agent' user already exists, the agent will proceed installation without creating a new one.
          Checking Java version
          JAVA_HOME is not set. Trying default path
          Java version: 1.8.0_281 found at /usr/bin/java
    
    Updating / installing...
          1:oracle.mgmt_agent-<VERSION>################################# [100%]
    Executing install
          Unpacking software zip
          Copying files to destination dir (/opt/oracle/mgmt_agent)
          Initializing software from template
          Creating 'mgmt_agent' daemon
          Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer-log-0
          Setup agent using input response file (run as any user with 'sudo' privileges)
          Usage:sudo
          /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=[RESPONSE_FILE]
    Agent install successful
    
    エージェントのインストール・プロセスでは、次が実行されます:
    • mgmt_agentという新しいユーザーが作成されます。これが管理エージェント・ユーザーになります。mgmt_agentユーザーがすでに存在する場合、エージェント・インストール・プロセスはこれを使用してエージェント・ソフトウェアをインストールします。
    • mgmt_agentデーモンが作成され、hardおよびsoftのnofile ulimitが5000に設定されます。
    • すべてのエージェント・ファイルがmgmt_agentユーザーによってコピーおよびインストールされます。エージェント・インストール・ベース・ディレクトリは、エージェントがインストールされるディレクトリです。このディレクトリは、エージェント・インストール・プロセスの一部として/opt/oracle/mgmt_agentディレクトリ内に作成されます。
    • デフォルトでは、mgmt_agentサービスが、エージェントのインストール後に自動的に有効化および起動されます。
    エージェント・インストールのログ・ファイルは、/opt/oracle/mgmt_agent/installer-logsディレクトリにあります。ログ・ファイルまたはその他のエージェント・インストール・ファイルを表示するには、次を実行してmgmt_agentユーザーとしてログインします:
    sudo -u mgmt_agent sh
  3. レスポンス・ファイルを使用してsetup.shスクリプトを実行し、管理エージェントを構成します。
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<full_path_of_response_file>
    出力は次のようになります:
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<response_file_directory>/input.rsp
    Executing configure
          Generating communication wallet
          Parsing input response file
          Validating install key
          Generating security artifacts
          Registering management agent
          Configuration Logs: /opt/oracle/mgmt_agent/configure-logs
    
    Agent configuration successful
    
    Starting agent...
    Agent started successfully
    In future agent can be started by directly running: sudo systemctl start mgmt_agent
    Please make sure that you delete input.rsp or store it in a secure location.

レスポンス・ファイルの作成の詳細は、レスポンス・ファイルの作成を参照してください。

Linuxでの管理エージェントのインストール(ZIPファイル)

ZIPファイルを使用してLinuxに管理エージェント・ソフトウェアをインストールするには、次のステップを実行します:
ノート

デフォルトのインストール場所は、/optボリュームの下にあります。管理エージェントのインストールに外部ボリュームを使用する場合は、Linux ZIPファイルを使用した外部ボリュームへの管理エージェントのインストールを参照してください。
  1. 管理エージェント・ソフトウェアを抽出します。

    管理エージェント・ソフトウェアのZIPファイルをダウンロードしたディレクトリに移動し、このファイルを任意の場所に解凍します。

  2. sudo権限を持つユーザーとしてログインします。

  3. レスポンス・ファイルを提供するinstaller.shスクリプトを実行して、管理エージェントをインストールして設定します。レスポンス・ファイルの作成方法の詳細は、レスポンス・ファイルの作成を参照してください。

    管理エージェント・ソフトウェアのZIPファイルを解凍したディレクトリに移動し、次を実行します:
    sudo ./installer.sh <full_path_of_response_file>

    例: sudo ./installer.sh /tmp/input.rsp

    出力は次のようになります:
    sudo ./installer.sh <user_home_directory>/input.rsp 
    Checking pre-requisites
        Checking if any previous agent service exists
        Checking if OS has systemd or initd
        Checking available disk space for agent install
        Checking if /opt/oracle/mgmt_agent directory exists
        Checking if 'mgmt_agent' user exists
        Checking Java version
            JAVA_HOME is not set or not readable to root
            Trying default path /usr/bin/java
            Java version: 1.8.0_282 found at /usr/bin/java
        Checking agent version
    
    Executing install
        Unpacking software zip
        Copying files to destination dir (/opt/oracle/mgmt_agent)
        Initializing software from template
        Creating 'mgmt_agent'daemon
        Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0
    
    Agent install successful
    
    Executing configure
    
        Parsing input response file
        Validating install key
        Generating communication wallet
        Generating security artifacts
        Registering Management Agent
    
    Starting agent...
    Agent started successfully
    
    
    Agent setup completed and the agent is running.
    In the future agent can be started by directly running: sudo systemctl start mgmt_agent 
    
    Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
    エージェントのインストール・プロセスでは、次が実行されます:
    • mgmt_agentという新しいユーザーが作成されます。これが管理エージェント・ユーザーになります。mgmt_agentユーザーがすでに存在する場合、エージェント・インストール・プロセスはこれを使用してエージェント・ソフトウェアをインストールします。
    • mgmt_agentデーモンが作成され、hardおよびsoftのnofile ulimitが5000に設定されます。
    • すべてのエージェント・インストール・ファイルは、mgmt_agentユーザーによって所有されます。エージェント・インストール・ベース・ディレクトリは、エージェントがインストールされるディレクトリです。このディレクトリは、エージェント・インストール・プロセスの一部として/opt/oracle/mgmt_agentディレクトリ内に作成されます。
    • デフォルトでは、mgmt_agentサービスが、エージェントのインストール後に自動的に有効化および起動されます。

    エージェント・インストールのログ・ファイルは、/opt/oracle/mgmt_agent/installer-logsディレクトリにあります。

    実行中のエージェントのログ・ファイルは、/opt/oracle/mgmt_agent/agent_inst/logにあります。

    ログ・ファイルまたはその他のエージェント・インストール・ファイルを表示するには、次を実行してmgmt_agentユーザーとしてログインします:
    sudo -u mgmt_agent sh
Linux ZIPファイルを使用した外部ボリュームへの管理エージェントのインストール

一部のLinux環境では、/optボリュームのディスク領域が制限されており、ソフトウェアのインストールに使用できません。その場合は、LinuxのZIPファイルを使用して外部ボリュームに管理エージェントをインストールし、シンボリック・リンクを作成できます。

Linux上の外部ボリュームに管理エージェントをインストールするには、次を実行します:

  1. 外部ボリュームに管理エージェントのインストール・ディレクトリを作成します。
    例:
    sudo mkdir -p /devext/oracle/mgmt_agent

    前述の例では、/devextは外部ボリュームです。

  2. 外部ボリュームを指すシンボリック・リンクを/opt/oracleディレクトリに作成します。

    次のコマンドを実行する前に、ディレクトリ/opt/oracleがすでに存在することを確認します。

    例:
    sudo ln -s /devext/oracle/mgmt_agent /opt/oracle/mgmt_agent
  3. 管理エージェント・ソフトウェアのLinux ZIPファイルがダウンロードされたことを確認します。詳細は、「エージェント・ソフトウェアのダウンロード」を参照してください。
  4. rootシェルに切り替え、環境変数OPT_ORACLE_SYMLINK = trueを設定し、管理エージェント・ソフトウェアをrootユーザーとしてインストールします。
    sudo /bin/bash
    export OPT_ORACLE_SYMLINK=true
    ./installer.sh <full_path_of_response_file>
    例:
    sudo /bin/bash
    export OPT_ORACLE_SYMLINK=true
    ./installer.sh ./input.rsp
  5. インストール・プロセスが完了したら、mgmt_agent Linuxユーザーが管理エージェントのインストール場所の所有者であることを確認します。
    stat -c '%U' /opt/oracle/mgmt_agent
    mgmt_agent
    
    sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst
    mgmt_agent

Windowsでの管理エージェントのインストール

Windowsに管理エージェント・ソフトウェアをインストールするには、次のステップを実行します:
  1. 管理エージェント・ソフトウェアを抽出します。

    管理エージェント・ソフトウェアのZIPファイルをダウンロードしたディレクトリに移動し、このファイルを任意の場所に解凍します。

  2. 管理者ユーザーとしてログインし、「コマンド・プロンプト」ウィンドウを開きます。

  3. レスポンス・ファイルを使用してinstall.batスクリプトを実行し、管理エージェントをインストールして構成します。
    installer.bat <full_path_of_response_file>
    出力は次のようになります:
    installer.bat C:\<user_home_directory>\input.rsp
    Checking pre-requisites
    
            Checking if previous agent service exists
            Checking if C:\Oracle\mgmt_agent\agent_inst directory exists
            Checking if C:\Oracle\mgmt_agent\200820.0751 directory exists
            Checking available disk space for agent install
            Checking Java version
                    Java version: 1.8.0_281 found at C:\Program Files\Java\jdk1.8.0_281
     
    Executing install
            Unpacking software zip
            Copying files to destination dir (C:\Oracle\mgmt_agent)
            Initializing software from template
            Creating mgmt_agent service 
    
    Agent install successful 
    
    Executing configure
    
            Parsing input response file
            Generating communication wallet
            Validating install key
            Generating security artifacts
            Registering Management Agent
    
    The mgmt_agent service is starting....
    The mgmt_agent service was started successfully.
    
    
    Agent setup completed and the agent is running
    In the future agent can be started by directly running: NET START mgmt_agent
    Please make sure that you delete C:\<user_home_directory>\input.rsp or store it in secure location.
    

レスポンス・ファイルの作成の詳細は、レスポンス・ファイルの作成を参照してください。

エージェントのインストール・プロセスでは、次が実行されます:
  • 新しいディレクトリC:\Oracle\mgmt_agentがエージェント・インストール・プロセスの一部として作成されます。
  • エージェント・インストール・ベース・ディレクトリは、エージェントがインストールされるディレクトリです。デフォルトでは、エージェントはC:\Oracleディレクトリにインストールされます。このデフォルト・ディレクトリは、install.batスクリプトを実行する前にAGENT_INSTALL_BASEDIR環境変数を設定することで変更できます。
  • エージェント・インストールのログ・ファイルは、C:\Oracle\mgmt_agent\installer-logsディレクトリにあります。

Solarisでの管理エージェントのインストール

Solarisに管理エージェント・ソフトウェアをインストールするには、次のステップを実行します:
  1. 管理エージェント・ソフトウェアを抽出します。

    管理エージェント・ソフトウェアのZIPファイルをダウンロードしたディレクトリに移動し、このファイルを任意の場所に解凍します。

  2. sudoのパスを使用してSUDO_PATH環境変数を設定します。sudo -Eオプションを使用すると、sudoとしてコマンドを実行するときに環境変数を保持できます。

    useraddおよびgroupaddPATH環境変数にあることを確認します。たとえば、/sbin/useraddという場所にある場合は、それがご使用のパスにあることを確認します。

    sudoPATH環境変数にあることを確認します。たとえば、sudoが/usr/bin/sudoという場所にある場合は、PATH環境変数に"/usr/bin"があることを確認します。

  3. sudo権限を持つユーザーとしてログインします。

  4. レスポンス・ファイルを使用してinstaller.shスクリプトを実行し、管理エージェントをインストールして構成します。

    レスポンス・ファイルの作成の詳細は、レスポンス・ファイルの作成を参照してください。

    管理エージェント・ソフトウェアのZIPファイルを解凍したディレクトリに移動し、次を実行します:
    sudo ./installer.sh <full_path_of_response_file>
    出力は次のようになります:
    sudo ./installer.sh <user_home_directory>/input.rsp 
    Checking pre-requisites
        Checking if any previous agent service exists
        Checking if OS has systemd or initd
        Checking available disk space for agent install
        Checking if /opt/oracle/mgmt_agent directory exists
        Checking if 'mgmt_agent' user exists
        Checking Java version
            JAVA_HOME is not set or not readable to root
            Trying default path /usr/bin/java
            Java version: 1.8.0_282 found at /usr/bin/java
        Checking agent version
    
    Executing install
        Unpacking software zip
        Copying files to destination dir (/opt/oracle/mgmt_agent)
        Initializing software from template
        Creating 'mgmt_agent'daemon
        Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0
    
    Agent install successful
    
    Executing configure
    
        Parsing input response file
        Validating install key
        Generating communication wallet
        Generating security artifacts
        Registering Management Agent
    
    Starting agent...
    Agent started successfully
    
    
    Agent setup completed and the agent is running.
    In the future agent can be started by directly running: sudo systemctl start mgmt_agent 
    
    Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.

    エージェントのインストール・プロセスでは、次の操作が実行されます。
    • mgmt_agentという新しいユーザーが作成されます。これが管理エージェント・ユーザーになります。mgmt_agentユーザーがすでに存在する場合、エージェントのインストール・プロセスではエージェント・ソフトウェアのインストールに使用されます。
    • mgmt_agentデーモンが作成されると、ハードおよびソフトのnofileulimitは5000に設定されます。
    • すべてのエージェント・インストール・ファイルは、mgmt_agentユーザーが所有します。エージェント・インストール・ベース・ディレクトリは、エージェントがインストールされているディレクトリです。このディレクトリは、エージェントのインストール・プロセスの一部として/opt/oracle/mgmt_agentディレクトリに作成されます。
    • デフォルトでは、mgmt_agentサービスはエージェントのインストール後に自動的に有効化および起動されます。

    エージェント・インストールのログ・ファイルは、/opt/oracle/mgmt_agent/installer-logsディレクトリにあります。

    実行中のエージェントからのログ・ファイルは、/opt/oracle/mgmt_agent/agent_inst/logにあります。

    ログ・ファイルまたはその他のエージェント・インストール・ファイルを表示するには、次を実行しているmgmt_agentユーザーとしてログインします。
    sudo -u mgmt_agent sh

AIXへの管理エージェントのインストール

AIXに管理エージェント・ソフトウェアをインストールするには、次のステップを実行します:
ノート

管理エージェントのインストールを続行する前に、AIXのsudounzipおよびOpenJDK 8が必要です。
  1. 管理エージェント・ソフトウェアのZIPファイルを抽出します。

    管理エージェント・ソフトウェアのZIPファイルをダウンロードしたディレクトリに移動し、このファイルを任意の場所に解凍します。

    インストールにはunzipユーティリティが必要です。AIXのunzipの詳細は、「オープン・ソース・ソフトウェア用のAIXツールボックス」を参照してください。

  2. sudo権限を持つユーザーとしてログインします。

  3. レスポンス・ファイルを提供するinstaller.shスクリプトを実行して、管理エージェントをインストールして設定します。

    レスポンス・ファイルの作成方法の詳細は、レスポンス・ファイルの作成を参照してください。

    管理エージェント・ソフトウェアのZIPファイルを解凍したディレクトリに移動し、次を実行します:

    sudo sh installer.sh <full_path_of_response_file>

    たとえば: sudo sh installer.sh /usr/input.rsp

    出力は次のようになります:
    Checking pre-requisites
        Checking if any previous agent service exists
        Checking if OS has systemd or initd
        Checking available disk space for agent install
        Checking if /opt/oracle/mgmt_agent directory exists
        Checking if 'mgmt_agent' user exists
        Checking Java version
            Trying /tmp/java/jdk8u372-b07
            Java version: 1.8.0_372 found at /tmp/java/jdk8u372-b07/bin/java
        Checking agent version
    
    Executing install
        Unpacking software zip
        Copying files to destination dir (/opt/oracle/mgmt_agent)
        Initializing software from template
        Checking if JavaScript engine is available to use       
        Creating mgmt_agent daemon
        Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0
    
    Agent install successful
    
    Executing configure
    
        Parsing input response file
        Validating install key
        Generating communication wallet
        Generating security artifacts
        Registering Management Agent
    
    Starting agent...
    0513-059 The mgmt_agent Subsystem has been started. Subsystem PID is 16122232.
    Agent started successfully
    
    
    Agent setup completed and the agent is running.
    In the future agent can be started by directly running: sudo startsrc -s mgmt_agent 
    
    Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
    エージェントのインストール・プロセスでは、次が実行されます:
    • mgmt_agentという新しいユーザーが作成されます。これが管理エージェント・ユーザーになります。mgmt_agentユーザーがすでに存在する場合、エージェント・インストール・プロセスはこれを使用してエージェント・ソフトウェアをインストールします。
    • mgmt_agentデーモンが作成され、hardおよびsoftのnofile ulimitが5000に設定されます。
    • すべてのエージェント・インストール・ファイルは、mgmt_agentユーザーによって所有されます。エージェント・インストール・ベース・ディレクトリは、エージェントがインストールされるディレクトリです。このディレクトリは、エージェント・インストール・プロセスの一部として/opt/oracle/mgmt_agentディレクトリ内に作成されます。
    • デフォルトでは、mgmt_agentサービスが、エージェントのインストール後に自動的に有効化および起動されます。

    エージェント・インストールのログ・ファイルは、/opt/oracle/mgmt_agent/installer-logsディレクトリにあります。

    実行中のエージェントのログ・ファイルは、/opt/oracle/mgmt_agent/agent_inst/logにあります。

    ログ・ファイルまたはその他のエージェント・インストール・ファイルを表示するには、次を実行してmgmt_agentユーザーとしてログインします:
    sudo -u mgmt_agent sh

複数の管理エージェントのインストール

管理エージェントでは、同じマシンに複数の管理エージェント・インスタンスをインストールして、リージョン間でエージェント収集データをレプリケートできます。各管理エージェントは、同じソースからの収集中に異なるOCIリージョンを指すようにインストールされます。
ノート

複数の管理エージェントのインストール機能は、現在Linuxでのみ使用可能です。

エージェント・サービス識別子

エージェント・サービス識別子は、混乱を避けるために、特定のマシン上に他のエージェント・インスタンスが存在する場合にエージェント・サービスを識別するために使用されます。各管理エージェントサービスは、特定のエージェントインスタンスを見つけて管理するために使用される特定の識別子を使用してインストールできます。

サービス識別子を指定せずに管理エージェントのインストールを開始すると、デフォルトのインストールとみなされます。

すべてのサービス識別子は、mgmt_agent-で始まり、その後に、使用できる唯一の文字として英数字値、ハイフンまたはアンダースコアのみで構成される文字列が続く必要があります。例:
mgmt_agent-oc1_phx-abc123

サービス識別子を持つ管理エージェントをインストールするには、次のステップを実行します:

  1. 管理エージェント・ソフトウェアを抽出します。

    管理エージェント・ソフトウェアのZIPファイルをダウンロードしたディレクトリに移動し、このファイルを任意の場所に解凍します。

  2. sudo権限を持つユーザーとしてログインします。

  3. レスポンス・ファイルを使用してinstaller.shスクリプトを実行し、管理エージェントをインストールして設定します。

    レスポンス・ファイルの作成の詳細は、レスポンス・ファイルの作成を参照してください。

    管理エージェント・ソフトウェアのZIPファイルを解凍したディレクトリに移動し、次を実行します:
    sudo ./installer.sh <full_path_of_response_file> <service identifier>
    例:
    sudo ./installer.sh /tmp/input.rsp mgmt_agent-oc1_phx-abc123
    出力は次のようになります:
    sudo ./installer.sh <user_home_directory>/input.rsp mgmt_agent-oc1_phx-abc123
    Checking pre-requisites
    	Checking if any previous agent service exists
    	Checking if OS has systemd or initd
    	Checking available disk space for agent install
    	Checking if /opt/oracle/mgmt_agent-oc1_phx-abc123 directory exists
    	Checking if 'mgmt_agent' user exists
    	Checking Java version
    		JAVA_HOME is not set or not readable to root
    		Trying default path /usr/bin/java
    		Java version: 1.8.0_282 found at /usr/bin/java
    	Checking agent version
    
    Executing install
    	Unpacking software zip
    	Copying files to destination dir (/opt/oracle/mgmt_agent-oc1_phx-abc123)
    	Initializing software from template
    	Checking if JavaScript engine is available to use
    	Creating mgmt_agent-oc1_phx-abc123 daemon
    	Agent Install Logs: /opt/oracle/mgmt_agent-oc1_phx-abc123/installer-logs/installer.log.0
    
    Agent install successful
    
    Executing configure
    
    	Parsing input response file
    	Validating install key
    	Generating communication wallet
    	Generating security artifacts
    	Registering Management Agent
    
    Starting agent...
    Agent started successfully
    
    
    Agent setup completed and the agent is running.
    In the future agent can be started by directly running: sudo systemctl start mgmt_agent-oc1_phx-abc123
    
    Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
エージェントのインストール・プロセスでは、次が実行されます:
  • mgmt_agentという新しいユーザーが作成されます。これが管理エージェント・ユーザーになります。mgmt_agentユーザーがすでに存在する場合、エージェント・インストール・プロセスはこれを使用してエージェント・ソフトウェアをインストールします。
  • サービス識別子を名前として使用するデーモンが作成されます。
  • ハードおよびソフトのnofile ulimitが5000に設定されています。
  • すべてのエージェント・インストール・ファイルは、mgmt_agentユーザーによって所有されます。エージェント・インストール・ベース・ディレクトリは、エージェントがインストールされるディレクトリです。このディレクトリは、エージェント・インストール・プロセスの一部として/opt/oracle/<service-identifier> ディレクトリ内に作成されます。
  • デフォルトでは、<service-identifier>デーモン・サービスが、エージェントのインストール後に自動的に有効化および起動されます。
  • エージェントの起動や停止など、エージェント・デーモン・サービスとのすべての対話は、<service-identifier>を使用して実行できます。例:
    sudo systemctl start <service-identifier>
    sudo systemctl stop <service-identifier>

エージェント・インストールのログ・ファイルは、/opt/oracle/<service-identifier>/installer-logsディレクトリにあります。

実行中のエージェントのログ・ファイルは、/opt/oracle/<service-identifier>/agent_inst/logにあります。

ログ・ファイルまたはその他のエージェント・インストール・ファイルを表示するには、次を実行してmgmt_agentユーザーとしてログインします:
sudo -u mgmt_agent sh

管理エージェントのインストールの確認

ユーザー・インタフェースを使用したエージェントのインストールの確認

ユーザー・インタフェースを使用してエージェントのインストールを確認するには、次のステップを実行します:

  1. メインの管理エージェント・ページで、左側のメニューの「エージェント」をクリックします。

    エージェント・ページが表示され、インストールされたすべてのエージェントとゲートウェイのリストが表示されます。

    エージェントのみを表示するには、左側のメニューの「フィルタ」セクションを使用できます:

    「フィルタ」に移動し、「インストール・タイプ」ドロップダウン・リストを使用して「エージェント」を選択します。

    すべてのエージェントが表示されます。

    インストールされたすべての管理エージェントが表示されるエージェント・リストのページ。

  2. 「エージェント」リストで、最近インストールされたエージェントを探します。これには、エージェントのインストール日付を表示する「作成済」列、またはエージェントがインストールされたホスト名を表示する「ホスト」列を使用します。

Linuxのコマンドライン・インタフェースを使用したエージェントのインストールの確認

  1. sudo権限を持つユーザーとしてホストにログインします。

  2. 次のコマンドを実行します:

    Oracle Linux 6の場合:
    sudo /sbin/initctl status mgmt_agent
    Oracle Linux 7の場合:
    sudo systemctl status mgmt_agent

    詳細は、ログ・ファイル/opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.logを参照してください。

Windowsのコマンドライン・インタフェースを使用したエージェントのインストールの確認

  1. Administratorアカウントのコマンド・シェルを使用してホストにログインします。

  2. 次のコマンドを実行します:
    sc query mgmt_agent

    詳細は、ログ・ファイルC:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.logを参照してください。

Solarisのコマンドライン・インタフェースを使用したエージェントのインストールの確認

  1. rootユーザーとしてコマンドを実行するsudo権限を持つユーザーとしてログインします。

  2. 次のコマンドを実行します:
    sudo /etc/init.d/mgmt_agent status

    詳細は、ログ・ファイル/opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.logを参照してください。

管理エージェントのインストールの問題のトラブルシューティング