You can upgrade multiple Database Agents. Under Database Agents, select the required agents that you want to upgrade. 

It is recommended to upgrade to the latest version. Also, refer to the Database Agent documentation to meet all the prerequisites before performing an upgrade.

  1. Select the Database Agent and click Upgrade.
  2. Select one of the following options:
    • Default Upgrade: to use the latest version with the default configuration.
    • Custom Upgrade: to specify the version and change other settings.
  3. For Custom Upgrade:
    1. Select the version that you want to upgrade in Available Versions.
    2. Select the source from where you are downloading the agent.
    3. Retain the same configuration or edit it as required.
  4. (Optional) Enable Override JVM Args to override the JVM arguments specified in the previous installation. You can specify new JVM arguments, each argument separated by a space.
  5. (Optional) You can use the Database Agent custom configurations to specify in Custom Configuration. When you add a new key-value pair, it gets added to the existing configuration. The old configuration does not get overwritten.
  6. Check the upgrade status in Tasks in Progress.
    You can search for the specific host and check the log file. After the task is completed it is added to the History tab.

JVM Arguments (Optional)

You can specify JVM arguments by using one of the following ways. However, JVM arguments specified via UI supersedes arguments specified in the text file.

The following table describes the usage of JVM arguments:

ScenarioThen, during an upgrade
JVM arguments were specified in the dbagent-jvm-args.txt file after the Database Agent installation
  • If you override the existing JVM arguments, Database Agent is upgraded and it runs with the new arguments (arguments that you specify newly on the text box)
  • If you do not override the existing JVM arguments, Database Agent is upgraded and it runs with the existing arguments.
JVM arguments were specified on the UI during the Database Agent installation

Existing JVM arguments are displayed in the text box.

  • If you override the existing JVM arguments, Database Agent is upgraded and it runs with the new arguments (arguments that you specify newly on the text box)
  • If you do not override the existing JVM arguments, Database Agent is upgraded and it runs with the existing arguments.

When you upgrade multiple Database Agents, the JVM Args field is empty. When you specify the JVM arguments, those apply to all the agents.

When you restart the Database Agent:

  • If the JVM arguments were specified both via UI and the dbagent-jvm-args.txt  file, then the arguments specified via UI are retained and the text file is ignored.
  • If the JVM arguments were specified only in the dbagent-jvm-args.txt  file, then the text file arguments are retained.

When you rollback the Database Agent, JVM arguments specified in the rolled-back version are retained.