AppDynamics Lite Agent Installation
--------------------------------------

1. Extract the appagent lite installation zip

2. Edit the script that starts your app server JVM and add a java agent argument.

You need to add the following as a java startup option/argument:

-javaagent:<agent_install_dir>/javaagent.jar

If the ApppDynamics Lite viewer is not running on 'localhost' then add the system property -Dappdynamics.viewer.host=<host-ip>.
Also if the ApppDynamics Lite viewer is not running on port '8990' then add the system property -Dappdynamics.viewer.port=<port-number>.
The agent by default logs to <agent-install-dir>/logs directory. To override it add the system property -Dappdynamics.agent.logs.dir=<logs-dir>

The objective is to have a startup line something like the following:

java -javaagent:/usr/local/agent/javaagent.jar <other optional system props> ...<your current args>... <your server class name>


3. Make sure the user running the app server process has read permissions on the agent installation directory, including its subdirectories.
This is needed for reading configuration files. The write permission is required for writing the log files to <install>/logs directory, which can be
changed by adding the system property -Dappdynamics.agent.logs.dir=<logs-dir> in JVM startup command as decribed in previous section.

4. The Application server has to be restarted/started for the install to be effective.

Check that you have received the following message in the agent.log file in your
<agent_install_dir>/logs/ folder when you start the application server.

'Started AppDynamics Java Agent Successfully'.
