Oracle Cloud Infrastructureドキュメント

概要

Oracle Cloud Infrastructureの管理者は、管理エージェントをデプロイして、モニターするためにサービスやソースからデータを収集できます。管理エージェント・サービスは、管理エージェントのライフサイクルとサービスのプラグインを管理します。

管理エージェントの概念

次の用語と概念は、管理エージェントのデプロイメントとライフサイクルを理解するために役立ちます。

Oracle Cloud Infrastructureは、可用性の高いホスト環境で幅広いアプリケーションおよびサービスを構築および実行できる、補完的なクラウド・サービスのセットです。Oracle Cloud Infrastructure (OCI)のコンポーネントは、httpsプロトコルを使用して相互に通信します。

ソフトウェア・リソースやハードウェア・リソースおよびビジネス・オブジェクト(プロパティ、構成、ステータス、パフォーマンスが追跡されて分析される)は、データ・ソースと呼ばれます。

管理エージェント(エージェント)を使用すると、管理エージェントをインストールしたホストからサービス・プラグインがデータを収集できるようになります。これは管理エージェント・クラウド・サービスを使用して、Oracle Cloud Infrastructureに直接接続できます。管理エージェントはホストにインストールされます。これは、ホストまたは仮想ホストに存在するソースのデータをモニターおよび収集します。

管理エージェント・クラウド・サービス(MACS)(管理エージェント・サービスとも呼ばれる)は、Oracle Cloud Infrastructureのクラウド・サービスです。これは管理エージェントとそのライフサイクルを管理します。管理エージェントを使用すると、Oracle Cloudサービスは、それらによって管理されるエンティティとやり取りしてデータを収集できます。

エージェント・インストール・キーは、管理エージェントのインストールに必要なトークンです。これは管理エージェントがOracle Cloud Infrastructureと通信することを認可します。1つのエージェント・インストール・キーを複数の管理エージェント・インストールで使用できます。管理エージェントをインストールするときに、エージェント・インストール・キー値を指定する必要があります。エージェント・インストール・キー値は、管理エージェント・サービスのユーザー・インタフェースで取得できます。

サービス・プラグインを使用すると、管理エージェントがデータ・ソースとやり取りし、データをクラウド・サービスに送り返すことができます。

管理ゲートウェイは、管理エージェント・サービスのコンポーネントであり、顧客側の製品(管理エージェントなど)とOracle Cloud側とのすべての通信が行われる単一ポイントを提供します。管理ゲートウェイの構成とインストールの詳細は、管理ゲートウェイを参照してください。

Oracle Cloud Agentは、Oracle Cloud Infrastructureに存在するコンピュート・インスタンス(ホストまたはVMとも呼ばれる)上で実行するプラグインを管理する軽量プロセスです。コンピュート・インスタンスを使用している場合は、Oracle Cloud Agentを使用して管理エージェントをデプロイできます。Oracle Cloud Infrastructureコンピュート・インスタンス使用時のOracle Cloud Agentを使用した管理エージェントのデプロイの詳細は、コンピュート・インスタンスへの管理エージェントのデプロイを参照してください。

Oracle Cloud Infrastructureのサービスとデータ・ソースを示す管理エージェントの図。

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

管理エージェントをインストールするには、次のタスクを実行します。

タスク 詳細情報
OCI環境を確認します。

管理エージェントの使用を開始する前に、OCI環境が正しく設定されていることを確認します。管理エージェント・サービスのためのOracle Cloud Infrastructureの設定を参照してください。

一般的な前提条件を確認します。

管理エージェントをインストールする前に前提条件を確認します。管理エージェントのデプロイに関する一般的な前提条件を参照してください。

エージェント・ソフトウェアをダウンロードし、インストール・キーを作成します。

管理エージェントを環境にデプロイする最初のステップは、エージェント・ソフトウェアのダウンロードとエージェント・インストール・キーの作成です。エージェント・ソフトウェアのダウンロードおよびインストール・キーの作成を参照してください。

管理エージェントをインストールします。

管理エージェント・ソフトウェアのダウンロード・ファイルには、管理エージェントのインストールに必要なすべてのファイルが含まれます。Install Management Agentを参照してください。

Windowsでの管理ゲートウェイのインストール

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

  1. 管理ゲートウェイ・ソフトウェアを抽出します。

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

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

  3. installer.batスクリプトを実行して、管理ゲートウェイをインストールします。 
    installer.bat
    出力は次のようになります: 
    Checking pre-requisites
        Checking if previous gateway service exists
        Checking if C:\Oracle\mgmt_agent\agent_inst directory exists       
        Checking if C:\Oracle\mgmt_agent\agent_inst\plugins directory exists
        Checking Java version
                Java version: 1.8.0_371 found at C:\Program Files\Java\jdk-1.8
        Checking if C:\Oracle\mgmt_agent\231214.1713 directory exists
Executing install
        Unpacking software zip
        Copying files to destination dir (C:\Oracle\mgmt_agent) 
        Initializing software from template
        Checking if JavaScript engine is available to use
        Creating mgmt_gateway service
Gateway install successful
Setup gateway using input response file
       Usage:         
       C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat [FULL_PATH_TO_INPUT.RSP]
  4. レスポンス・ファイルを使用してsetupGateway.batスクリプトを実行し、管理ゲートウェイを構成します。
    <Management_Agent_path>\setupGateway.bat <full_path_of_response_file>
    例:
    C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat c:\tmp\input.rsp
    次のように出力されます。
    Validating response file
Validating certificate properties
Successfully validated response file

Executing configure     
        Parsing input response file
        Validating install key       
        Generating communication wallet
        Generating security artifacts     
        Registering Management Gateway
                Found service plugin(s): [GatewayProxy]

The Oracle Management Gateway service is starting...
The Oracle Management Gateway service was started successfully.

Starting plugin deployment for: [GatewayProxy]
Deploying service plugin(s)...Done.
        GatewayProxy : Successfully deployed external plugin

Management Gateway setup completed and is running
In the future agent can be started by directly running: NET START mgmt_gateway
Please use OCI CLI or OCI Management Agent console to validate the successful activation of your agent."

Please make sure that you delete C:\tmp\input.rsp or store it in secure location.

Checking for plugin to be deployed
Plugin deployed successfully
Setting up Gateway
Creating gateway system properties file
Creating properties file
Creating or validating certificates
Waiting for Management Gateway to create or validate certificates ...
Waiting for Management Gateway to create or validate certificates ...
Waiting for Management Gateway to create or validate certificates ...
Waiting for Management Gateway to create or validate certificates ...
Waiting for Management Gateway to create or validate certificates ...
Wallets created successfully
Waiting for Management Gateway to setup ...
Management Gateway Plugin set up successfully.
ゲートウェイのインストール・プロセスでは、次が実行されます:
  • 新しいディレクトリC:\Oracle\mgmt_agentがエージェント・インストール・プロセスの一部として作成されます。
  • エージェント・インストール・ベース・ディレクトリは、ゲートウェイがインストールされるディレクトリです。

    デフォルトでは、ゲートウェイはC:\Oracleディレクトリにインストールされます。デフォルト・ディレクトリは、installer.batスクリプトを実行する前にAGENT_INSTALL_BASEDIR環境変数を設定することで変更できます。

  • 管理ゲートウェイ・インストールのログ・ファイルは、C:\Oracle\mgmt_agent\installer-logsおよび C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\logsディレクトリにあります。