Oracle Cloud Infrastructure Documentation

Upgrade APM Java Agent

You can upgrade the APM Java Agents to the latest version available.

Upgrading APM Java agent is supported by provisioning a newer version of the APM Java Agent installer file.

The new APM Java agent can be provisioned to the existing agent destination while the agent is running, and existing running agent instances will not get updated during the upgrade process. The new agent will be used only after the appserver is restarted.

The upgrade process does the following:
  • All binaries and base configurations are provisioned to a versioned install directory.
  • Configuration files from current version are copied and upgraded to versioned config directory.
To upgrade the APM Java agent, perform the following:
  1. Run the agent installer with provision-agent-upgrade action. 
    java -jar apm-java-agent-installer-<version>.jar provision-agent-upgrade -destination=<parent_directory_of_oracle-apm-agent>
    For example: 
    java -jar apm-java-agent-installer-1.1.jar provision-agent-upgrade -destination=/home/user

    To see additional upgrade options, run the following: 

    java -jar apm-java-agent-installer-<version>.jar provision-agent-upgrade -help
  2. Restart the appserver.

    After provisioning the agent upgrade, you need to restart the appserver to use the new upgraded version of the agent.