Upgrade the Java Agent

  1. Shut down the application server where the Java Agent is installed.
  2. Create a backup copy of the current agent installation directory.
  3. Extract the Java Agent archive to a new directory.
  4. Rename the existing agent directory.
  5. Rename the new directory to the original name of the old agent directory.
    The new agent directory and its containing files should have the same directory path as the original one. Using the same directory path avoids the task of manually changing the agent-related configurations in your JVM startup script.
  6. Copy controller-info.xml, and if necessary, agent.properties from the old agent config directory to the following location in the new directory:
    For example: 
    <agent_home>/<version>/confappd_javaagent/ver4.0.0.0/conf
  7. If you previously made changes to the app-agent-config.xml or other configuration files, copy those changes to the new file as well.
    Note: If you are using an SSL port (ssl-enabled=true) to communicate with the Controller UI, make sure that you copy the TrustStore files to the new directory. For example, copy the cacerts.jks from the old backup agent directory (<version>/conf/) to the new upgraded directory (<agent_home>/<version>/conf/). Also, make sure that the agent TrustStore file (cacerts.jks) is readable by the agent user.
  8. Restart the application server.
Once completed, you can archive the original directory and remove it from the application server home.