スマートエージェントのアップグレード

エージェント管理ユーザーインターフェイスを使用してスマートエージェントをアップグレードできます。

エージェント管理 UI を使用したスマートエージェントのアップグレード

スマートエージェントをアップグレードするには、エージェント管理 UI で次の手順を実行します。

注: これらの手順は、ルートログイン情報を使用してスマートエージェントをインストールした場合に適用されます。

  1. [Smart Agents] タブをクリックします。
  2. アップグレードする必要があるスマートエージェントを選択します。
  3. Upgrade をクリックします。
  4. 必要なアップグレードタイプを選択します。
    • Default Upgrade：これにより、スマートエージェントが既存の設定を使用して最新バージョンにアップグレードされます。[Available Versions] リストからスマートエージェントのバージョンを選択できます。
    • Custom Upgrade：これにより、スマートエージェントがカスタム更新でアップグレードされます。次のフィールドを更新できます。
      フィールド名目的
      Download Sourceスマートエージェントのインストールファイルをダウンロードするソースを選択します。
      • Using AppDynamics Portal：ダウンロードポータルを使用してスマートエージェントをインストールする場合は、これを使用します。
      • Using Local Directory：ローカルディレクトリを使用してスマートエージェントをインストールする場合は、これを使用します。
      • Custom HTTP URL：カスタム HTTP サーバーを使用してスマートエージェントをインストールする場合は、これを使用します。[Custom HTTP URL] フィールドにサーバーの URL を指定します。https://artifactory.custom.url/content/custom-agent/java_agent-X.Y.ZBasic 認証の場合、スマートエージェントは Nexus や Artifactory などの HTTP サーバー、またはカスタム HTTP サーバーと通信します。カスタムロケーション用に Basic 認証を設定するには、スマートエージェントの config.ini ファイルの [AnsibleConfig].EnvVars セクションに次の変数を含めます。
        • ENABLE_CUSTOM_HTTP
        • CUSTOM_HTTP_USERNAME
        • CUSTOM_HTTP_PASSWORD
      Install Versionインストールするスマートエージェントのバージョンを指定します。たとえば、24.10.0 のようになります。
  5. [Upgrade Now] をクリックします。
  6. （Linux の場合）[History] タブで成功ステータスを確認し、ホストマシンで次のコマンドを実行します。
    sudo systemctl restart smartagent
sudo systemctl daemon-reload
sudo systemctl restart smartagent
これにより、スマートエージェントが新しいバイナリに更新されます。
注: Windows の場合、スマートエージェントを再起動する必要はありません。ただし、<smartagent-dir>/upgrade-log.log にあるログファイルから成功ステータスを確認してください。

Upgrade Smart Agent Manually

You can upgrade the Smart Agent manually by uninstalling and reinstalling it.

You need to back up some files before the upgrade and add these files after the upgrade.

Back up the following files and add these files in the Smart Agent directory after the upgrade:

  • <smartagent-hostname>/storage/*: This is required to track metadata and ids of all the managed agents. .

  • <smartagent-hostname>/conf/*: This is required to keep the same Smart Agent additional configuration.

  • <smartagent-hostname>/config.ini: This is required to keep the same Smart Agent config.ini configuration.

  • <smartagent-hostname>/id: This is required to use the same Smart Agent ID after the upgrade.

  • <smartagent-hostname>/lib/ld_preload.json: This is required to auto attach supported agents to the process.

  • <smartagent-hostname>/store.yaml: This is required to track all the packages that were installed using Smart Agent.

  • <smartagent-hostname>/.process.json: If this file does not exist, you can ignore this file. This is required to keep the Machine Agent process alive.

The following steps are needed to upgrade Smart Agent:
  1. Back up the required files, as stated in the prerequisites.
  2. Uninstall Smart Agent.
  3. Install Smart Agent.
  4. Add the backed up files in the Smart Agent directory.