• OCIにサインインし、OCIコンソールでナビゲーション・メニューを開きます。

• 「監視および管理」で、「管理エージェント」をクリックします。

• 左側のメニューから、「コンパートメント」ドロップダウン・リストからコンパートメントを選択します。

  管理エージェント・コンソールが表示されます。

1. 追加の信頼できるルート認証局(CA)証明書をPEM形式で格納するディレクトリを作成します。次の例では、tmpディレクトリが例です。任意のディレクトリを使用して、エージェント・ユーザーが証明書のパス内のすべてのディレクトリへの読取りアクセス権を持っていることを確認できます。

   mkdir /tmp/crt

2. 次に、次のコマンドを入力して、PEM形式のすべてのカスタム信頼できる証明書を、前のステップで作成した新しいディレクトリにコピーします。

   cp *.pem /tmp/crt

3. スタンドアロン・エージェントが証明書にアクセスできるように、ディレクトリおよびそのコンテンツに対する権限を設定します。

   chmod 644 /tmp/crt

4. インストール時または構成時にカスタムの信頼できる証明書を管理エージェントに追加するには、input.rspレスポンス・ファイルで証明書のディレクトリを指定する必要があります。

   importTrustedCertsDirectory=/tmp/crt

5. これで、インストールを実行して証明書を管理エージェントにインポートできます。
6. インストール後、次のコマンドを使用し、次の値を環境の値に置き換えて、信頼できる証明書がエージェントのキーストアに正常にインポートされたことを確認できます。<CUSTOM_CERTIFICATE_FILE_NAME>を環境内のカスタム証明書ファイル名に置き換えます(例: my-cert.pem)。

   keytool -list -keystore /opt/oracle/mgmt_agent/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE_FILE_NAME>

   commwallet.pemファイルは、エージェントの信頼できる証明書ストアに追加されるカスタム証明書です。

1. 次のコマンドを使用して、trustedcertsディレクトリを作成し、信頼できる証明書を/var/lib/oracle-cloud-agent/plugins/oci-managementagent/にインポートします。oracle-cloud-agentユーザーがディレクトリの所有者であることを確認します。

   cd /var/lib/oracle-cloud-agent/plugins/oci-managementagent/
   mkdir trustedcerts
   chown oracle-cloud-agent:oracle-cloud-agent trustedcerts/

2. PEM形式のすべてのカスタム信頼できる証明書を、前のステップで作成した新しいディレクトリにコピーします。

   cp *.pem /var/lib/oracle-cloud-agent/plugins/oci-managementagent/trustedcerts

3. これで、OCAエージェントのインストールを実行して、証明書を管理エージェントにインポートできます。
4. インストール後、次のコマンドを使用すると、信頼できる証明書がエージェントのキーストアに正常にインポートされたことを確認できます。<CUSTOM_CERTIFICATE>を環境内のカスタム証明書ファイル名に置き換えます(例: my-cert.pem)。

   keytool -list -keystore /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE>

   commwallet.pemファイルは、エージェントの信頼できる証明書ストアに追加されるカスタム証明書です。

• エージェント・ページを使用したプラグインのデプロイ
• 管理エージェントのインストール中のプラグインのデプロイ

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

2. 「エージェント」リストで、プラグインをデプロイするエージェントをクリックします。

   エージェントの詳細ページが表示されます。

   
   
   

3. 「プラグインのデプロイ」をクリックします。

   「プラグインのデプロイ」ウィンドウが表示されます。

4. プラグインを選択し、「更新」を選択します。

   これで、選択したプラグインが目的のエージェントにデプロイされます。

1. 管理エージェント・ソフトウェアのダウンロードおよびインストール・キーの作成の説明に従って、エージェント・ソフトウェアをダウンロードし、エージェント・インストール・キーを作成します。

2. エージェント・インストール・キーのファイルをダウンロードします。

   エージェント・インストール・キー・ページに移動し、アクション・メニューから「キーをファイルにダウンロード」オプションを選択します。

   「キーをファイルにダウンロード」オプションを使用すると、レスポンス・ファイル・テンプレートをダウンロードできます。詳細は、インストール・キーのダウンロードを参照してください。

3. テキスト・エディタを使用してレスポンス・ファイル・テンプレートを編集し、カスタム・レスポンス・ファイルを作成します。

   オプション1: レスポンス・ファイル・テンプレートをダウンロードして、レスポンス・ファイルを作成しますで説明されている手順に従って、レスポンス・ファイルを作成します。

   レスポンス・ファイル・テンプレートには、プラグインのデプロイに必要なサービス・プラグイン・パラメータなどのエージェント・パラメータが含まれます。

   管理エージェントのインストール・プロセスの一部としてサービス・プラグインをデプロイするには、Service.plugin.<plugin_name>.downloadパラメータをカスタマイズします。

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

   レスポンス・ファイルでサポートされるエージェント・パラメータの詳細は、エージェント・パラメータの確認を参照してください。

4. 管理エージェントのインストールの説明に従って管理エージェントをインストールし、インストールを完了します。

• サービス・プラグイン・ステータスの確認
• 作業リクエスト・ステータスの確認

• [代理店]リストページで、目的のエージェントをクリックします。

  エージェントの詳細ページが表示されます。

• 「エージェント・ログの有効化」をクリックします。

  選択したエージェントの「ログの有効化: エージェント」ウィンドウが表示されます。

• ドロップダウン・リストから「ログ・グループ・コンパートメント」を選択します。
• ドロップダウン・リストから「ログ・グループ」を選択します。

  新しいログ・グループを作成する場合は、「ログ・グループの作成」をクリックします。

  「ログ・グループの作成」ウィンドウで、「ログ・グループ名」および「説明」を入力します。その後、「作成」をクリックします。

• 「有効化」をクリックします。

• 「監視および管理」に移動し、「Log Analytics」に移動します。
• 「Log Analytics」ページで、「管理」に移動します。

  左側のメニューから「ソース」を選択します。

  中央のペインから「Oracle Management Agentログ」を選択し、エージェントが「関連付けられたエンティティ」リストの下にリストされていることを確認します。

• 「エージェント・ログの無効化」をクリックします。

  選択したエージェントの「エージェント・ログの無効化」ウィンドウが表示されます。

• 「無効化」をクリックします。

• 管理エージェントは、管理エージェント・バージョン231231.0001以上を使用してデプロイされました。
• Prometheus Exporterの場合、管理エージェントは、同じ仮想マシン(VM)上、またはエクスポータのエンドポイントにアクセスできるVM上にある必要があります。この管理エージェントは、実行中のPrometheusエクスポータからメトリックをスクレイプするように構成されています。

• [代理店]リストページで、目的のエージェントをクリックします。

  エージェントの詳細ページが表示されます。

• 「データ・ソースの管理」をクリックします。

  「データ・ソース」ウィンドウに、次の列を含む表が表示されます:

  • 名前:データソース名
  • タイプ:データ・ソースのタイプ。例: プロメテウス。
  • 状態:データ・ソースのステータス。
  • 作成時間:データ・ソースが作成されたときのタイムスタンプ。
  • : 特定のデータ・ソースで使用可能な処理をさらに表示します。
• 特定のデータ・ソース名をクリックすると、「データ・ソースの表示」ウィンドウが表示されます。

  「データ・ソースの表示」を使用して、データ・ソースに関するすべての情報を表示します。

  たとえば、Prometheus Exporterからメトリック・データを表示できます。

• データ・ソースを追加するには、「データ・ソースの追加」を使用します。

  • 「データ・ソースのタイプ」をドロップダウン・リストから選択します。例: プロメテウス。
  • 「名前」を使用して、新しいデータ・ソース名を入力します。
  • ドロップダウン・リストから「メトリック・コンパートメント」を選択します。
  • メトリック・ネームスペースを入力します。
  • Prometheus Exporterがメトリックの公開に使用する「URL」を入力します。
  • メトリック・ディメンションを追加するには、カスタム・メトリック・ディメンションを使用します。
  • 必要に応じて、「オプションのプロパティ」を使用します。
• データ・ソースの削除: アクション・メニューを使用して、データ・ソースを削除します。
• データ・ソースの編集: アクション・メニューを使用して、データ・ソースのプロパティを編集します。

  たとえば、メトリック・データをOCIモニタリング・サービスに公開するPrometheusエクスポータURLを変更できます。

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

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

   Oracle Linux 6の場合: sudo /sbin/initctl start mgmt_agent

   Oracle Linux 7の場合: sudo systemctl start mgmt_agent

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

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

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

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

   sudo /etc/init.d/mgmt_agent start

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

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

   Oracle Linux 6の場合: sudo /sbin/initctl stop mgmt_agent

   Oracle Linux 7の場合: sudo systemctl stop mgmt_agent

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

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

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

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

   sudo /etc/init.d/mgmt_agent stop

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

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

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

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

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

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

• 自動アップグレード
• 手動アップグレード

• ターゲット・ホストにデプロイされたエージェントが必要なくなりました。
• 特定のターゲット・ホストからデータ、パフォーマンス・メトリックまたはログを収集する必要がなくなりました。
• デプロイメント・トポロジを変更しました。

• ユーザー・インタフェースでのエージェントの削除

• コマンドライン・インタフェースでのエージェントの削除

1. 「エージェント」リストでエージェントを選択し、アクション・メニューをクリックします。

   図4-1 エージェントの削除

   

2. 「エージェントの削除」をクリックします。

3. 「削除」を押して選択を確定します。

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

sudo rpm -e <rpm_name>

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

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

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

sudo sh /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected AIX:
Stopping mgmt_agent...
Waiting for mgmt_agent to exit...
Stopped mgmt_agent.
Removing mgmt_agent daemon...
0513-083 Subsystem has been Deleted.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

• オプション1。管理エージェント・サービスでは、Oracleでは、Oracle CloudコンソールまたはAPIを使用して名前付き資格証明を追加することをお薦めします。
• オプション2。エージェントの構成ファイルでソース資格証明を構成して、エージェントが様々なソースからデータを収集できるようにします。

• Oracle Cloudコンソール
• 管理エージェントの名前付き資格証明API

• 管理エージェントのバージョン: 250704.1404以上がインストールされていることを確認します。
• ユーザーに対して次を構成します。
  • 名前付き資格証明に必要な権限を追加します。ユーザー・シナリオおよび管理エージェント・サービス・ポリシー・リファレンスの詳細を参照してください。
  • 名前付き資格証明に次のポリシーを追加します。管理エージェントについては、表2-1を参照してください。

    ALLOW GROUP <group-name> TO MANAGE management-agent-named-credentials IN <compartment_name>

  • ボールトにシークレットの作成。そのためには、シークレットを作成するための追加の権限が必要です。Vaultでのシークレットの作成およびVault、キー管理およびシークレットの詳細を参照してください。ボールトとシークレットは、異なるコンパートメントに配置できます。また、ボールトとシークレットの両方をエージェントとは別のコンパートメントに配置できます。
  • シークレット・バンドルを読み取ることができるように、次の権限を構成します。Vault、キー管理およびシークレットの詳細を参照してください。
    • ボールトのVAULT_INSPECTおよびVAULT_READ権限をリストします。
    • シークレットSECRET_INSPECTおよびSECRET_READ権限をリストします。
• エージェント・リソースの権限およびポリシーを構成します。これを行うには:

  • 次の例を使用して、エージェント・リソースの動的グループを作成します。ocid1.compartment.oc1.agentcompartmentidをエージェントのコンパートメントOCIDに置き換えます。コンソールでの動的グループの作成方法および動的グループの管理を参照してください。

    ALL {resource.type='managementagent', resource.compartment.id='ocid1.compartment.oc1.agentcompartmentid'}

  • 次のポリシーを追加して、動的グループが特定のコンパートメント内のシークレットを読み取ることを許可し、ocid1.compartment.oc1.secretcompartmentidをシークレットのコンパートメントOCIDに置き換えます。ポリシーの文の更新を参照してください。

    allow dynamic-group X to read secret-bundles in compartment ocid1.compartment.oc1.secretcompartmentid

  • また、エージェントには、名前付き資格証明の作成に使用されるOCIリソースの権限およびポリシーも必要です。たとえば、エージェントが名前付き資格証明を使用して自律型データベースと対話する場合、エージェントの動的グループが自律型データベース・ウォレットを読み取ることを許可するポリシーを作成する必要があります。例:

    allow dynamic-group X to read autonomous-databases in compartment DB_COMPARTMENT

• MGMT_AGENT_NAMED_CREDENTIAL_APPLY権限を持つオペレータ・ユーザー、およびユーザーがアクセス権を持つエージェントは、名前付き資格証明を使用して、パスワードにアクセスすることなくアクションを実行できます。この権限を持つユーザーは、名前付き資格証明に含まれているボールトまたはシークレットOCIDsを表示できません。
• 次の権限を持つ管理者ユーザーは、名前付き資格証明に対して標準のCRUD操作を実行でき、ボールトからシークレットのバンドルを読み取るアクセス権がありません。

  • MGMT_AGENT_NAMED_CREDENTIAL_CREATE

  • MGMT_AGENT_NAMED_CREDENTIAL_UPDATE

  • MGMT_AGENT_NAMED_CREDENTIAL_DELETE

• ユーザーがMGMT_AGENT_DELETE権限を持っている場合、ユーザーはエージェント・リソースを削除でき、関連付けられた名前付き資格証明もすべて削除されます。
  ノート
  
  エージェントまたは名前付き資格証明を削除しても、OCIボールトに格納されているシークレットには影響しません。

1. ナビゲーション・メニューを開き、「監視および管理」を選択します。「管理エージェント」で、「エージェント」を選択します。
2. リストするエージェントを含むコンパートメントを選択します。子コンパートメントを含む、選択したコンパートメント全体のエージェント詳細の概要を取得するサブコンパートメントを含めるには、オプションを選択します。
3. 「アクション」メニューから、「名前付き資格証明の管理」を選択します。
   • または、「エージェントの詳細」ページに移動し、「他のアクション」オプションを選択して、「名前付き資格証明の管理」を選択できます。
4. 「資格証明名」を入力します。オプションで、説明を入力できます。
5. 「資格証明タイプ」ドロップダウン・リストから、追加する資格証明のタイプを選択します。
6. 選択した資格証明タイプのフィールドまたは属性ごとに、値を入力するか、リソース識別子を選択するか、ボールトおよびシークレット識別子を選択します。

   リソースが別のコンパートメントに存在する場合、「コンパートメントの変更」を選択してコンパートメントを変更し、リソースの値を検索できます。

7. タグを追加するには、「拡張オプションの表示」を選択します。
   • タグを追加するには、タグ・ネームスペースを選択し、タグ・キーおよびタグ値を入力して、「タグの追加」を選択します。タグを追加することで、資格証明へのアクセスを制限できます。名前付き資格証明の作成に必要な権限がある場合、フリーフォーム・タグを追加する権限もあります。定義済タグを追加するには、タグのネームスペースに対する権限も必要です。詳細は、タグ付けの概要を参照し、リソースの作成時にタグを追加する方法を学習するには、リソース・タグの操作を参照してください。
   • タグを削除するには、「X」を選択します。
8. 「保存」を選択して、エージェントに名前付き資格証明を追加します。名前付き資格証明を保存できない場合は、すべての必須フィールドを入力したことを確認します。

   名前付き資格証明が保存されると、作業リクエストがエージェントに送信されます。作業リクエストが完了すると、エージェントはこれらの名前付き資格証明を使用して、エージェントにデプロイされた複数のプラグインまたはサービス間で様々なタスクを実行できます。

   ノート
   
   作業リクエストが失敗した場合は、エージェントにSECRET_READ権限があることを確認し、ボールト・シークレットにアクセスしてGetSecret操作を実行します。Vault、キー管理およびシークレットの詳細を参照してください。

   エージェントの名前付き資格証明を編集または削除するには:

   1. 更新するエージェントを検索すると、次のことができます。
      • 「エージェント」リスト・ページに移動します。更新するエージェントの横で、「アクション」メニューを選択し、「名前付き資格証明の管理」を選択します。
      • または、「エージェントの詳細」ページに移動し、「他のアクション」オプションを選択して、「名前付き資格証明の管理」を選択できます。
   2. 「編集」または「削除」を選択します。ユーザー名およびパスワードのボールト詳細を編集できます。資格証明の名前またはタイプは編集できません。
      ノート
      
      アクティブに使用されている名前付き資格証明を削除すると、エージェント上のソースのモニタリングが中断される可能性があります。

• ソース資格証明タイプ
• 資格証明の追加または更新
• 資格証明の削除
• 資格証明別名の追加または更新
• 資格証明別名の削除

• ナビゲーション・メニューを開きます。「ガバナンスと管理」で、「ガバナンス」に移動し、「監査」をクリックします。

  監査サービスが表示されます。

• LinuxでのJREのアップグレード
  • RPMパッケージを使用したJREのアップグレード
  • 圧縮アーカイブを使用したJREのアップグレード
• WindowsでのJREのアップグレード
• カスタムJAVA_HOMEの更新