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

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

エージェント管理 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 にあるログファイルから成功ステータスを確認してください。

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

スマートエージェントをアンインストールしてから再インストールすることにより、スマートエージェントを手動でアップグレードできます。

アップグレードの前にいくつかのファイルをバックアップし、アップグレード後にこれらのファイルを追加する必要があります。

次のファイルをバックアップして、アップグレード後にこれらのファイルを Smart Agent ディレクトリに追加します。

  • <smartagent-hostname>/config.ini：これは、同じ Smart Agent config.ini 設定を維持するために必要です。

  • <smartagent-hostname>/id：これは、アップグレード後に同じスマートエージェント ID を使用するために必要です。

  • <smartagent-hostname>/lib/ld_preload.json：これは、サポート対象エージェントをプロセスに自動付加するために必要です。

  • <smartagent-hostname>/store.yaml：これは、スマートエージェントを使用してインストールされたすべてのパッケージを追跡するために必要です。

  • <smartagent-hostname>/.process.json：このファイルが存在しない場合は、このファイルを無視できます。これは、マシンエージェントプロセスの動作を維持するために必要です。

スマートエージェントをアップグレードするには、次の手順が必要です。
  1. 前提条件の記述に従って、必要なファイルをバックアップします。
  2. スマートエージェントのアンインストール。
  3. スマートエージェントのインストール。1
  4. バックアップしたファイルをスマート エージェント ディレクトリに追加します。