Use these instructions to install the Java Agent using the Agent Download Wizard in the Controller.
If you downloaded the agent from the AppDynamics download zone, see Install the Java Agent.
Before You Begin
1. Confirm you have access to a Controller, the web application where you monitor your application performance:
- If you use a SaaS controller, AppDynamics sent you the Controller host location in your Welcome Email.
- If you use an on-premise Controller, you configured the host and port at install time.
2. Identify the startup script for you the JVM for your application. To enable the agent, you edit the startup script.
Show more information on startup scripts...
Instrumenting Your JVM with the Java Agent
There are four steps to instrument your JVM and begin monitoring:
1. Download: Use the Agent Download Wizard to configure and download the agent.
2. Install: Unzip the agent on your server and add it to your JVM startup script.
3. Apply Load: Restart your application and apply load to activate instrumentation.
4. View Your Application: Log on to the Controller to monitor application performance.
Download the Java Agent
The Agent Download Wizard walks you through configuration steps and helps you download the agent.
Show me the Download Agent Wizard steps...
1. Log on to the Controller and click the Agent Download Wizard tab.
2. Click Java, then click Next.
3. Click to Select JVM, then click Next.
4. The Controller Location URL window displays the connection info for the Controller. Click Next.
Click SSL to enable SSL encryption between the agent and the Controller. Enter the SSL port. For AppDynamics SaaS, the SSL port is 443.
5. Enter an application name or, click an existing application name if one exists. Then click Next.
For new users, it is OK to use the default MyApp. You can change it later when know more about how you want to organize your applications in AppDynamics.
6. Enter a tier name. Then click Next.
For new users, it is OK to use the default MyTier. You can change it later when know more about how you want to organize your applications in AppDynamics.
Install the Agent on the App Server
After you download the agent, install it to your app server. The final window of the Agent Download Wizard includes brief instructions for installing the agent.
Show me the steps to install the agent...
1. Log on as an administrator to the machine running your Java application. Unzip the AppServerAgent.zip file.
For example, on Linux unzip the agent to home/appdynamics
. This is the <agent home> directory.
unzip AppServerAgent.zip -d /opt/appdynamics/appagent
2. Edit your startup configuration file to include the Java Agent.
Show more information on startup scripts...
Now you're ready to restart your application and put some load on it.
Apply load to your application
- Restart the JVM.
- Apply load to your application.
The agent instruments the application code and reports metrics back to the Controller. You're ready to begin monitoring.
View your application
Log on to the Controller to see your application in action.
From here, you can install more agents or you can begin monitoring your application. The links below will help you get started:
Learn More