複数のデータベースエージェントをアップグレードできます。[Database Agents] で、アップグレードの対象となる目的のエージェントを選択します。 

最新バージョンへのアップグレードを推奨します。また、アップグレードを実行する前に、データベースエージェントのドキュメントを参照して、すべての前提条件を満たします。

  1. データベースエージェントを選択し、[Upgrade] をクリックします。
  2. 次のオプションのいずれかを選択します。
    • [Default Upgrade:] は、デフォルト設定で最新バージョンを使用する場合に選択します。
    • [Custom Upgrade:] は、バージョンを指定し、それ以外にも設定を変更する場合に選択します。
  3. カスタムアップグレードの場合：
    1. [Available Versions] でアップグレードするバージョンを選択します。
    2. エージェントをダウンロードするソースを選択します。
    3. 同じ設定を保持するか、必要に応じて編集します。
  4. （オプション）Override JVM Args を有効にして、以前のインストールで指定された JVM 引数をオーバーライドします。新しい JVM 引数を指定できます。各引数はスペースで区切ります。
  5. （オプション）データベースエージェントのカスタム設定を [Custom Configuration] に指定して使用できます。新しいキーと値のペアを追加すると、既存の設定に追加されます。古い設定は上書きされません。
  6. [Tasks in Progress] でアップグレードのステータスを確認します。
    特定のホストを検索し、ログファイルを確認できます。タスクが完了すると、[History] タブに追加されます。

JVM 引数（オプション）

次のいずれかの方法を使用して、JVM 引数を指定できます。ただし、UI を介して指定された JVM 引数は、テキストファイルで指定された引数よりも優先されます。

次の表に、JVM 引数の使用方法を示します。

シナリオその後、アップグレード中に
データベースエージェントのインストール後に dbagent-jvm-args.txtファイルで JVM 引数が指定された
  • 既存の JVM 引数をオーバーライドした場合、データベースエージェントがアップグレードされ、新しい引数（テキストボックスで新しく指定した引数）で実行されます。
  • 既存の JVM 引数をオーバーライドしない場合、データベースエージェントがアップグレードされ、既存の引数で実行されます。
データベースエージェントのインストール中に UI で JVM 引数が指定された

既存の JVM 引数がテキストボックスに表示されます。

  • 既存の JVM 引数をオーバーライドした場合、データベースエージェントがアップグレードされ、新しい引数（テキストボックスで新しく指定した引数）で実行されます。
  • 既存の JVM 引数をオーバーライドしない場合、データベースエージェントがアップグレードされ、既存の引数で実行されます。

複数のデータベースエージェントをアップグレードした場合、JVM Args フィールドは空になります。JVM 引数を指定した場合、それらはすべてのエージェントに適用されます。

データベースエージェントを再起動すると、次のようになります。

  • JVM 引数が UI と dbagent-jvm-args.txt ファイルの両方を介して指定されていた場合、UI を介して指定された引数は保持され、テキストファイルは無視されます。
  • JVM 引数が dbagent-jvm-args.txt ファイルでのみ指定されている場合、テキストファイル引数は保持されます。

データベースエージェントをロールバックすると、ロールバックされたバージョンで指定された JVM 引数が保持されます。