管理ゲートウェイ・ポート

管理ゲートウェイのポート値を変更するには、gateway.propertiesファイルを編集して、GatewayPortプロパティの現在の値を目的のポート番号で置き換えます。

GatewayPortプロパティ値が変更された場合、そのManagement Gatewayを使用する管理エージェントは、新しいポート値を使用するように変更する必要があります。詳細は、管理ゲートウェイ構成の変更後の管理エージェントの更新を参照してください

Management Gateway資格証明

ゲートウェイは通常、資格証明を使用するように構成されます。接続するにはユーザー名とパスワードが必要です。

このような資格証明はOracleウォレットに格納されます。資格証明を追加、更新または削除する方法の詳細は、管理ゲートウェイ資格証明の構成を参照してください。

管理ゲートウェイ資格証明が変更された場合、新しい資格証明を使用するには、管理ゲートウェイを使用するすべての管理エージェントを変更する必要があります。詳細は、管理ゲートウェイ構成の変更後の管理エージェントの更新を参照してください。

管理ゲートウェイは、資格証明などの機密情報をOracleウォレットに格納します。

管理ゲートウェイのインストール後、資格証明の構成が必要になる場合があります。

• Linuxでの管理ゲートウェイのアップグレード
• Zipファイルを使用したLinuxでの管理ゲートウェイのアップグレード
• Windowsでの管理ゲートウェイのアップグレード

Linuxでの管理ゲートウェイのアップグレード

Zipファイルを使用したLinuxでの管理ゲートウェイのアップグレード

Zipファイルを使用してLinux上のゲートウェイをアップグレードするには、次を実行します:

• ゲートウェイ・ソフトウェア・ダウンロード・ファイルを含むZIPファイルの最新バージョンをダウンロードします。詳細は、管理ゲートウェイ・ソフトウェアのダウンロードを参照してください
• 管理ゲートウェイ・ソフトウェアのZIPファイルをダウンロードしたディレクトリに移動し、このファイルを任意の場所に解凍します。
• ゲートウェイをアップグレードするには、次のオプションを指定してinstaller.shスクリプトを実行します:-u

  installer.sh -u

• 次のように出力されます。

  sudo ./installer.sh -u
  Checking pre-requisites
          Checking available disk space for gateway upgrade
          Checking agent version 
  
  Executing install
          Unpacking software zip
          Copying files to destination dir (/opt/oracle/mgmt_agent)
          Updating communication wallet 
          Creating 'mgmt_gateway' daemon
          Starting mgmt_gateway
          Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log
  
  Gateway upgrade successful

Windowsでの管理ゲートウェイのアップグレード

管理ゲートウェイをホストから削除すると、管理ゲートウェイは、ホストから削除される前にManagement Agents Cloud Serviceから登録解除されます。

管理ゲートウェイを次のオペレーティング・システムから削除またはアンインストールするには、次のステップに従います。

• RPMコマンドを使用したLinux
• アンインストーラ・スクリプトを使用するLinux
• Windows

RPMコマンドを使用して、Linuxの管理ゲートウェイを削除します。

sudo rpm -e <rpm_name>

アンインストーラ・スクリプトを使用したLinuxでの管理ゲートウェイの削除

ZIPファイルを使用して管理ゲートウェイをインストールした場合は、uninstaller.shスクリプトを実行します。

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

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Gateway from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Gateway from Management Agent Cloud service,please do not interrupt...
Gateway was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_gateway...
Removing mgmt_gateway daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_gateway.service.
Gateway was removed from the host successfully.
Executing post-remove step from uninstall
Gateway state directory was removed from the host successfully.

Windowsでの管理ゲートウェイの削除

「コマンド・プロンプト」ウィンドウを開き、管理ゲートウェイのインストール・ベース・ディレクトリに移動して、uninstaller.batスクリプトを実行します。

C:\Oracle>mgmt_agent\uninstaller.bat
Removing Management Gateway from the OCI service console.
Attempting to remove the agent from Management Agent Cloud service, do not interrupt...
Gateway was removed from the Management Agent Cloud service successfully.
Removing Management Gateway service from the host 
Management Gateway service was removed from the host successfully
Removing Management Gateway directories

uninstaller.batスクリプトを実行する前に、他のすべてのコマンド・プロンプト・ウィンドウが閉じていること、またはそれらが管理ゲートウェイ・ホーム・ディレクトリを指していないことを確認します。

1. Oracle Cloudコンソールで、ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」を選択します。
2. 「証明書」に移動し、「証明書」を選択します。
3. 「証明書の作成」をクリックします。
4. 証明書をインポートするコンパートメントを選択します。これは、管理ゲートウェイがインストールされているコンパートメントと同じコンパートメントである必要があります。
5. 認証局(CA)を使用して管理する予定の証明書をインポートするには、「証明書タイプ」として「インポート済」をクリックします。
6. 証明書の一意の表示名を入力します。機密情報を入力しないでください。
7. オプションで、証明書の説明を入力できます。
8. 秘密キーおよびチェーン証明書を入力する必要があります。

   Oracle Cloudコンソールで証明書ステータスが「アクティブ」の場合、証明書を使用する準備ができています。

9. 次に、証明書OCIDをコピーし、管理ゲートウェイのインストール中に、「管理ゲートウェイのレスポンス・ファイルの構成」の形式を使用して、管理ゲートウェイのレスポンス・ファイルにパラメータとしてOCIDを入力する必要があります。

   GatewayCertOcid=ocid1.certificate.oc1.iad.<unique-id>

10. 管理エージェントに同じ証明書をインポートして、エンドツーエンドの完全な相互作用が機能するように、次のステップを実行します。

前提条件

1. 管理ゲートウェイのインストールを実行するための有効なOSユーザーを識別し、それをRUN_AGENT_AS_USER変数の値として使用します。
   Oracleでは、選択したOSユーザーには最低限の権限が必要で、ログインシェルは不要であることを推奨しています。

   id -un <username>

   例1:

   id -un myexistinguser

   myexistinguser OSユーザーが存在します。出力は、選択したユーザーの値を返し、次のようになります。

   myexistinguser

   例2:

   id -un mytestuser2

   mytestuser2 OSユーザーは存在せず、有効なユーザーではありません。出力はユーザー値を返さず、次のようになります。

   id: mytestuser2: no such user

2. AGENT_USER_GROUP変数の値として使用するユーザーのプライマリ・グループを識別します。
   AGENT_USER_GROUPの値が、選択したOSユーザーのプライマリ・ユーザー・グループであることを確認します。

   ノート
   
   セカンダリ・グループの使用はサポートされていないため、管理ゲートウェイが破損する可能性があります。

   id -gn <username>

   例:

   id -gn myexistinguser

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

   staff

環境変数の設定および管理ゲートウェイのインストール

1. 次の環境変数を設定します。

   RUN_AGENT_AS_USER=<selected_OS_user_for_ManagementGateway_installation>
   AGENT_USER_GROUP=<OS_primary_group_of_selected_OS_user>

   例:

   RUN_AGENT_AS_USER=myexistinguser
   AGENT_USER_GROUP=staff

2. root OSユーザーが前述の環境変数にアクセスできることを確認します。

   デフォルトでは、環境変数はrootユーザーと共有されません。

3. 次のようにして、環境変数が正しく設定されていることを確認します。

   sudo su
   echo $RUN_AGENT_AS_USER
   echo $AGENT_USER_GROUP

   たとえば、出力は次のようになります。

   myexistinguser
   staff

   rootが環境変数にアクセスできない場合は、/etc/sudoersファイルを編集して、次を追加します。

   Defaults env_keep+=RUN_AGENT_AS_USER
   Defaults env_keep+=AGENT_USER_GROUP

   前述のとおり、RUN_AGENT_AS_USERおよびAGENT_USER_GROUP環境変数は保持され、rootユーザーがアクセスできます。

   /etc/sudoersファイルを更新した後、環境変数を再度設定し、rootが環境変数にアクセスできることを確認します。

4. 検証が完了したら、管理ゲートウェイのインストール(rootとしてログインし、環境変数を設定してから、管理ゲートウェイのインストールを開始)を開始できます。

   お好みの方法に応じて、Linux RPMファイルへの管理ゲートウェイのインストールまたはLinux ZIPファイルへの管理ゲートウェイのインストールの手順に従うことができます。

   たとえば、Linux RPMファイルへの管理ゲートウェイのインストールの手順に従います。この場合は、すでにrootであり、sudo権限が不要なため、ステップ1をスキップします。ステップ2から開始します: rpm -ivh <rpm_file_name.rpm>