This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

On this page:

Related pages:

To upgrade the AppDynamics Java Agent, you simply copy the existing agent directory to a backup location and replace it with the new agent directory. You then copy configuration file changes made in the old directory to the new agent directory and restart the application server.

This topic provides additional background information and step-by-step instructions.

About the Upgrade

Before you begin, review the Release Notes for changes that affect your environment. If you are upgrading both the Controller and agents, first upgrade the Controller and then upgrade the Java Agents.

Also, if upgrading multiple agents in your monitored environment, upgrade the agents for the tiers on which business transactions are originated last. For more information about this requirement, along with Controller and agent compatibility information, see Agent and Controller Compatibility

Upgrading the agent requires a restart of the application server.

Before starting, download the latest version of the Java Agent for your JVM from the AppDynamics Download Center

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: 



  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.
  8. Restart the application server.

When done you can archive the original directory and remove it from the application server home.