レスポンス・ファイル・テンプレートをダウンロードするには、「インストール・キー」リストの「キーをファイルにダウンロード」メニュー・オプションを使用します。

• 左側のメニューで「ダウンロードとキー」をクリックして、「インストール・キー」ペインを開きます。インストール・キーのリストから、ダウンロードするキーを選択します。

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

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

ファイルをダウンロードした後で、環境に応じてカスタマイズする必要があります:

• テキスト・エディタを使用してファイルを開き、確認してから、必須のゲートウェイ・パラメータを編集します。管理ゲートウェイ・パラメータの確認を参照してください。
• Service.plugin.*パラメータを削除します。これはエージェント固有のパラメータです。エージェントのインストールにのみ使用されます。
• 特定のゲートウェイ構成で必要なゲートウェイ・パラメータは、コメント解除(行の先頭の#記号を削除)し、ゲートウェイ・パラメータ値を更新します。たとえば、GatewayPort、GatewayUsernameおよびGatewayPasswordパラメータをファイルに追加する必要があります。
• 特定のゲートウェイ構成で不要なパラメータは、コメント・アウト(行の先頭に#記号を追加)するか削除します。
• 更新したレスポンス・ファイルを保存します。たとえば、gateway.rspレスポンス・ファイルとして保存できます。

gateway.rspレスポンス・ファイルのサンプル:

managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5

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

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

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

   管理ゲートウェイのRPMファイルをダウンロードしたディレクトリに移動し、次のコマンドを実行してRPMファイルをインストールします:

   sudo rpm -ivh <rpm_file_name.rpm>

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

   出力は次のようになります:

   
   Preparing...        ################################# [100%]
   Checking pre-requisites
        Checking if any previous gateway service exists        
   Checking if OS has systemd or initd
        Checking available disk space for gateway 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 gateway version
   Updating /  installing...
      1:oracle.mgmt_gateway-<VERSION>################################# [100%]
   
   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_gateway' daemon        
           Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0
   
           Setup gateway using input response file (run as any user with 'sudo' privileges)
           Usage:
                   sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=[FULL_PATH_TO_INPUT.RSP]
   
            Gateway install successful

   インストール・プロセスでは、次が実行されます:

   • mgmt_agentという新しいユーザーが作成されます。これが管理ゲートウェイ・ユーザーになります。mgmt_agentユーザーがすでに存在する場合、インストール・プロセスはこれを使用してゲートウェイ・ソフトウェアをインストールします。
   • すべてのファイルがmgmt_agentユーザーによってコピーおよびインストールされます。インストール・ベース・ディレクトリは、ゲートウェイがインストールされるディレクトリです。このディレクトリは、ゲートウェイ・インストール・プロセスの一部として/opt/oracle/mgmt_agent内に作成されます。
   • デフォルトでは、mgmt_gatewayサービス/デーモンがゲートウェイのインストール後に自動的に有効化および起動されます。
   ゲートウェイ・インストールのログ・ファイルは、/opt/oracle/mgmt_agent/installer-logsディレクトリにあります。ログ・ファイルまたはその他のインストール・ファイルを表示するには、次を実行してmgmt_agentユーザーとしてログインします:

   sudo -u mgmt_agent sh

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

   sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>

   出力は次のようになります:

   sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp
   
   Executing configure
          Parsing input response file
          Validating install key
          Generating communication wallet
          Generating security artifacts
          Registering Management Gateway
                  Found service plugin(s): [GatewayProxy]
   
   Starting gateway...
   Gateway started successfully
   
   Starting plugin deployment for: [GatewayProxy]
   Deploying service plugin(s)......Done.
           GatewayProxy : Successfully deployed external plugin
   
   Gateway setup completed and the gateway is running.
   In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway
   
   Please make sure that you delete <user_home_directory>/gateway.rsp or store it in secure location.
   
   Creating Wallets
   Wallets created successfully
   Waiting for Gateway to start...
   Gateway Proxy started successfully
   

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

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

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

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

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

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

   sudo ./installer.sh

   たとえば: sudo ./installer.sh

   出力は次のようになります:

   sudo ./installer.sh
   Checking pre-requisites    
       Checking if any previous gateway service exists    
       Checking if OS has systemd or initd    
       Checking available disk space for gateway install    
       Checking if /opt/oracle/mgmt_agent directory exists    
       Checking if 'mgmt_agent' user exists        
           'mgmt_agent' user already exists, the gateway will proceed installation without creating a new one.    
       Checking Java version        
           JAVA_HOME is not set or not readable to root        
           Trying default path /usr/bin/java        
           Java version: 1.8.0_272 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    
       Checking if JavaScript engine is available to use    
       Creating 'mgmt_gateway' daemon    
       Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0    
       Setup gateway using input response file (run as any user with 'sudo' privileges)    
       Usage:        
           sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=[FULL_PATH_TO_INPUT.RSP] 
   
   Gateway install successful

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

   sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>

   出力は次のようになります:

   sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=/u01/oracle/management_agent/input.rsp
   Validating response file
   Successfully validated response file
   /opt/oracle/mgmt_agent/agent_inst/bin/setupAgent.sh opts=/u01/oracle/management_agent/input.rsp 
   
   Executing configure     
       Parsing input response file        
       Validating install key    
       Generating communication wallet    
       Generating security artifacts    
       Registering Management Gateway        
           Found service plugin(s): [GatewayProxy] 
   
   Starting gateway...
   Gateway started successfully 
   
   Starting plugin deployment for: [GatewayProxy]
   Deploying service plugin(s).........Done.    
       GatewayProxy : Successfully deployed external plugin 
   
   Gateway setup completed and the gateway is running.
   In the future gateway can be started by directly running: sudo systemctl 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 /u01/oracle/management_agent/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 ...
   Creating wallets
   Wallets created successfully
   Waiting for Management Gateway to setup ...
   Management Gateway Plugin set up successfully.

管理ゲートウェイ・ソフトウェアを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ディレクトリにあります。