エージェントのアップグレードの前提条件は次のとおりです。
-
エージェントを最新バージョンにアップグレードする必要があります。また、アップグレードを実行する前に、エージェント固有のドキュメントを参照して、すべての前提条件を満たします。
-
マシンエージェントをアップグレードする場合は、アップグレードを開始する前にすべての拡張プロセスを停止してください。
-
既存の変更済みまたは追加設定の更新で Java またはマシンエージェントをアップグレードする場合は、次のことを確認します。
注: これは、以前の手動設定を任意のファイルに保持する場合にのみ必要です。<agent-type>.zip が存在しない場合でも、controller-info.xml 設定は保持されます。
- 一時ディレクトリがエージェントのダウンロードファイルサイズの 4 倍サイズであることを確認します。
- 現在のエージェントディレクトリにある <agent-type>.zip ファイルを変更しないでください。
- 現在のディレクトリのサイズは、
<agent-type>.zip ファイルのサイズの 3 倍である必要があります。
- (スマート エージェント バージョン 25.2 以下を使用して Java エージェントがすでにインストールされている場合)ディレクトリに zip ファイルがないため、
<agent-type>.zip ファイルを手動で更新する必要があります。そのため、ダウンロードポータルから <agent>.zip ファイルをダウンロードし、<agent-type>.zip という名前でエージェントディレクトリに配置します。たとえば、java.zip または machine.zip。
同じタイプの複数のエージェントをアップグレードできます。[App Agents] または [Machine Agents] で、アップグレードの対象となる目的のエージェントタイプを選択します。
注: 選択したエージェントは、元々インストールされていたのと同じフォルダ(またはディレクトリ)でアップグレードされます。
- アップグレードする同じタイプのエージェントを選択し、[Upgrade] をクリックします。
- 次のオプションのいずれかを選択します。
- [Default Upgrade:] は、デフォルト設定で最新バージョンを使用する場合に選択します。
- [Custom Upgrade:] は、バージョンを指定し、それ以外にも設定を変更する場合に選択します。
- カスタムアップグレードの場合:
- [Available Versions] でアップグレードするバージョンを選択します。
- エージェントをダウンロードするソースを選択します。
このソースには、AppDynamics ダウンロードポータル([Using AppDynamics Portal]
)、ローカルディレクトリ([Using Local Directory]
)、またはカスタム HTTP サーバー([Custom HTTP URL]
)を指定できます。[Custom HTTP URL] を選択し、HTTP サーバーで認証が必要な場合は、Basic 認証を使用するようにスマートエージェントを設定します。
カスタム Artifactory の場所の Basic 認証の設定 を参照してください。
- 同じ設定を保持するか、必要に応じて編集します。属性は、選択したエージェントに基づいて表示されます。
- オプション: エージェント固有のカスタム設定を [Custom Configuration] に指定して使用します。使用できるキーのリストについては、 カスタム構成を参照してください。
注: コントローラでエージェント設定をカスタマイズする必要がある場合は、preserve_config=false を追加し、必要な設定オプションを使用します。
[Tasks in Progress] でアップグレードのステータスを確認します。特定のホストを検索し、ログファイルを確認できます。タスクが完了すると、[History] タブに追加されます。