「概要」ページには、環境内の管理エージェントおよび管理ゲートウェイに関するサマリー情報が表示されます。次のチャートで構成されています。

各チャートをクリックして詳細を表示できます。

次のスクリーンショットは、管理エージェントの概要ページの例です。

• エージェントとゲートウェイ
  • エージェント詳細
  • ゲートウェイ詳細
• DataSourceを含むエージェント

エージェントとゲートウェイ

エージェントおよびゲートウェイ・ページには、インストールされているすべての管理エージェントおよび管理ゲートウェイをリストする表が表示されます。

この表は次の列で構成されています:

次のスクリーンショットは、エージェントおよびゲートウェイ・リストの例です。

特定のエージェントまたはゲートウェイをクリックして詳細ページを開き、すぐに詳細情報を取得できます。

• エージェント詳細
• ゲートウェイ詳細

エージェント詳細

「エージェント詳細」ページには、選択したエージェントに関する情報が表示されます。

• 「プラグインのデプロイ」を使用して、選択したエージェントにプラグインをデプロイします。

• 「エージェント・ログの有効化」を使用して、ログ・アナリティクス・サービスを有効にし、選択したエージェントの管理エージェントのログ・ファイルを収集します。詳細は、エージェント・ログの有効化を参照してください。

• 「DataSourcesの管理」を使用して、選択したエージェントで構成されたデータソース・タイプのプロパティおよびディメンションを表示または編集します。詳細は、DataSourcesの管理を参照してください。

• 「他のアクション」を使用して、エージェントを「タグの追加」または「削除」します。
• 「エージェント情報」タブには、詳細なエージェント情報が表示されます。ホスト名、コンパートメント名、エージェント・バージョン、オペレーティング・システム、それにデプロイされたサービス・プラグイン、作業リクエスト、データ・ソースなどが表示されます。

  • サービス・プラグイン: 「サービス・プラグイン」リンクを使用して、この特定の管理エージェントにデプロイされたすべてのサービス・プラグインをリストします。詳細は、「サービス・プラグインのデプロイ」を参照してください。
  • DataSources: この特定の管理エージェントに構成されているすべてのデータソースをリストするには、DataSourcesリンクを使用します。詳細は、DataSourcesの管理を参照してください。

ゲートウェイ詳細

「ゲートウェイの詳細」ページには、ゲートウェイに関する詳細情報が表示されます。

「ゲートウェイ情報」タブには、ゲートウェイの詳細情報が表示されます。ホスト名、コンパートメント名、ゲートウェイ・バージョン、オペレーティング・システム、関連エージェントなどが表示されます。

関連エージェント: 「関連エージェント」リンクを使用して、この特定の管理ゲートウェイを使用するように構成されているすべての管理エージェントをリストします。「関連付けられたエージェント」ペインには、管理エージェントのID、ホスト、可用性およびオペレーティング・システムの情報が表示されます。

DataSourceを含むエージェント

DataSourceを持つエージェント・ページには、データソースが構成されているすべてのエージェントをリストする表が表示されます。

特定のエージェントをクリックすると、詳細ページが開き、すぐに詳細情報を取得できます。

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

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

キーを作成するには:

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

「インストール・キー」ペインで、インストール・キーをクリップボードにコピーできます。

「キーをクリップボードにコピー」オプションは、エージェントの構成プロセス中にレスポンス・ファイルを作成するときに、キーの値をコピーして貼り付けるために役立ちます。詳細は、レスポンス・ファイルの作成を参照してください。

「インストール・キー」ペインで、インストール・キーをダウンロードできます。

「キーをファイルにダウンロード」オプションは、エージェント・パラメータを含むファイルをダウンロードするために役立ちます。このファイルは、エージェントのインストール・プロセスでレスポンス・ファイルとして使用できます。詳細は、レスポンス・ファイルの作成を参照してください。

「インストール・キー」ペインで、インストール・キーを削除できます。

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

   「インストール・キー」ペインが表示され、既存のすべてのキーがリスト表示されます。

2. インストール・キーのリストから、削除するキーを選択します。

3. 選択したキーの右側で、アクション・メニューをクリックし、「キーの削除」を選択します。

   

4. 「キーの削除」をクリックします。
5. 「削除」を押して操作を確定します。

「キーの削除」オプションは、認可されていないユーザーがエージェント・インストール・キーの値を入手したと思われる場合に役立ちます。

管理エージェント・サービスでは、自動アップグレードがサポートされています。

自動アップグレード機能の有効化はテナンシ・レベルで行われます: ユーザーは、現在のテナンシに存在するすべての管理エージェントで自動アップグレードを有効にできます。

要件:

デフォルトの自動アップグレード・ステータス: 無効。

自動アップグレードの有効化

自動アップグレードは、管理エージェント・コンソールを使用して有効化できます。

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

  「エージェント自動アップグレード」ペインがページの上部に表示されます。

  

• 「エージェント自動アップグレード」ペインで、「自動アップグレードの有効化」をクリックします。

  「自動アップグレードの有効化」ウィンドウが表示されます。

• 「自動アップグレードの有効化」ウィンドウで、「OK」をクリックして、現在のテナンシのすべての管理エージェントの自動アップグレードを有効にします

自動アップグレードの無効化

自動アップグレードは、管理エージェント・コンソールを使用して無効化できます。

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

  「エージェント自動アップグレード」ペインがページの上部に表示されます。

  

• 「エージェント自動アップグレード」ペインで、「自動アップグレードの無効化」をクリックします。

  「自動アップグレードの無効化」ウィンドウが表示されます。

• 「自動アップグレードの無効化」ウィンドウで、「OK」をクリックして、現在のテナンシのすべての管理エージェントの自動アップグレードを無効にします

自動アップグレードの有効化または無効化に使用できるCLIコマンドのリストは、Oracle Cloud Infrastructure CLIコマンド・リファレンスを参照してください。

管理エージェントでは、次のオペレーティング・システムでの手動アップグレードがサポートされています:

• Linux手動アップグレード(RPMファイル)
• Linux手動アップグレード(ZIPファイル)
• Windowsでの手動アップグレード
• Solarisでの手動アップグレード
• AIX手動アップグレード

Linux手動アップグレード(RPMファイル)

Linux手動アップグレード(ZIPファイル)

Windowsでの手動アップグレード

Solarisでの手動アップグレード

AIX手動アップグレード(ZIPファイル)

エージェントの資格証明ストアには、エージェントが把握して認識する資格証明(Oracle Database資格証明など)と、特定のサービスのみが認識する資格証明が格納されます。エージェントは、組込み資格証明タイプを検証しますが、検証なしで他の自由形式タイプも受け入れます。

資格証明を追加するには、upsertCredentials操作とともにcredential_mgmt.shスクリプトを使用します。

credential_mgmt.shスクリプトは/opt/oracle/mgmt_agent/agent_inst/binディレクトリにあります。

構文

credential_mgmt.sh -o upsertCredentials -s [service-name]

1. 資格証明情報を含むJSONファイルを作成します。

   次の例は、orcl123という名前のdatasafe_dbソース用の資格証明タイプの形式です:

   {"source":"datasafe_db.orcl123", 
   "name":"audit_cred", 
   "description":"This is the audit credential for orcl123 Oracle RDBMS system.", 
   "properties":[ 
   {"name":"username","value":"CLEAR[scott]"}, 
   {"name":"password","value":"CLEAR[tiger]"}]
   }

   たとえば、このファイルをmy_credentials.jsonとして保存できます。

2. JSONファイルを使用して資格証明を追加します。

   credential_mgmt.sh -o upsertCredentials -s [service-name]

   たとえば、my_credentials.jsonファイルを使用して、DataSafeサービスに対して次を実行できます:

   cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s datasafe

3. ステップ1で作成したJSONファイルを削除します。

   資格証明のJSONファイルには機密情報が含まれます。ユーザーは、資格証明の追加または更新操作を完了した後で、資格証明のJSONファイルを削除する必要があります。

資格証明を削除するには、deleteCredentials操作とともにcredential_mgmt.shスクリプトを使用します。

credential_mgmt.shスクリプトは/opt/oracle/mgmt_agent/agent_inst/binディレクトリにあります。

構文

credential_mgmt.sh -o deleteCredentials -s [service-name]

1. 次の形式を使用してJSONファイルを作成します:

   {"source":"datasafe_db.orcl123"
    "name":"audit_cred"} 

   たとえば、このファイルをmy_credentials.jsonとして保存できます。

2. JSONファイルを使用して資格証明を削除します。

   credential_mgmt.sh -o deleteCredentials -s [service-name]

   たとえば、my_credentials.jsonファイルを使用して、DataSafeサービスに対して次を実行できます:

   cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o deleteCredentials -s datasafe

3. ステップ1で作成したJSONファイルを削除します。

   資格証明のJSONファイルには機密情報が含まれます。ユーザーは、資格証明の削除操作を完了した後で、資格証明のJSONファイルを削除する必要があります。

資格証明別名を追加したり、既存の資格証明別名を更新したりするには、aliasCredentials操作とともにcredential_mgmt.shスクリプトを使用します。

credential_mgmt.shスクリプトは/opt/oracle/mgmt_agent/agent_inst/binディレクトリにあります。

構文

credential_mgmt.sh -o aliasCredentials -s [service-name]

1. 次の形式を使用してJSONファイルを作成します:

   {"alias":
    {"source":"datasafe_db.orcl123",
     "name":"audit_cred"},
    "credential":
     {"source":"datasafe_db.host.1521.orcl123",
      "name":"datasafe_cred"}}
   

   たとえば、このファイルをmy_credentials.jsonとして保存できます。

2. JSONファイルを使用して資格証明別名を追加します。

   credential_mgmt.sh -o aliasCredentials -s [service-name]

   たとえば、my_credentials.jsonファイルを使用して、DataSafeサービスに対して次を実行できます:

   cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o aliasCredentials -s datasafe

3. ステップ1で作成したJSONファイルを削除します。

   資格証明のJSONファイルには機密情報が含まれます。ユーザーは、資格証明別名の追加または更新操作を完了した後で、資格証明のJSONファイルを削除する必要があります。

資格証明別名を削除するには、unaliasCredentials操作とともにcredential_mgmt.shスクリプトを使用します。

credential_mgmt.shスクリプトは/opt/oracle/mgmt_agent/agent_inst/binディレクトリにあります。

構文

credential_mgmt.sh -o unaliasCredentials -s [service-name]

1. 次の形式を使用してJSONファイルを作成します:

   {"source":"datasafe_db.orcl123",
    "name":"audit_cred"}

   たとえば、このファイルをmy_credentials.jsonとして保存できます。

2. JSONファイルを使用して資格証明別名を削除します。

   credential_mgmt.sh -o unaliasCredentials -s [service-name]

   たとえば、my_credentials.jsonファイルを使用して、DataSafeサービスに対して次を実行できます:

   cat my_credentials.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o unaliasCredentials -s datasafe

3. ステップ1で作成したJSONファイルを削除します。

   資格証明のJSONファイルには機密情報が含まれます。ユーザーは、資格証明別名の削除操作を完了した後で、資格証明のJSONファイルを削除する必要があります。

この手順では、Linux 64ビット・プラットフォーム(Oracle Linux、CentOS、Ubuntu、SUSE Linuxなど)上でJREをアップグレードする方法について説明します。

このトピックでは、管理エージェントを実行するために、サポートされているWindows 64ビット・プラットフォームでJREをアップグレードする方法について説明します。

Windows環境に管理エージェントをインストールするには、インストール前に環境変数JAVA_HOMEを設定する必要があります。詳細は、Windows環境のカスタムJAVA_HOMEの更新を参照してください。将来変更できる場所にJAVA_HOME変数を設定します。

Windows上のJREをアップグレードするには、次を実行します:

環境によってはシステムのデフォルトのJavaの場所がありません。このような場合、JREのアップグレード・プロセスを開始する前に、OracleではカスタムのJAVA_HOMEの場所を更新することをお薦めします。

管理エージェントのインストールにカスタムJAVA_HOMEの場所を使用しているときに、JavaバージョンがJAVA_HOMEパスに含まれている場合、JREのアップグレードによって問題が発生する可能性があります。この解決策は、JREバージョン番号を参照しないJAVA_HOMEパスのシンボリック・リンクを作成することです。

問題: アップグレード後の実際のJREバージョンがjre1.8.311であっても、JAVA_HOMEパスの値が'jre1.8.301'であるため、前述の設定ではJREバージョンの混乱が発生します。

解決策: バージョン番号を含まないシンボリック・リンクを作成し、それをJAVA_HOME設定として使用して管理エージェントをインストールします。