Configure the Machine Agent Properties

You can configure the Machine Agent by:

  • Editing the controller-info.xml file located in the <machine_agent_home>/conf directory.
  • Adding Agent system properties (-D<system_property>) to the Machine Agent start-up script or on the command line.
  • Using environment variables. To configure the Agent with environment variables, set the value of the environment variable in the environment where the monitored application runs and restart the Agent. Environment variables exist for most of the Agent settings in the controller-info.xml file , but not all settings are configurable through environment variables. For those settings, you need to use system properties or controller-info.xml . See Machine Agent Configuration Properties.
Warning: Empty spaces and special characters are not allowed in either the full path to the Machine Agent home directory, or in the directory name itself. If the Machine Agent does not start up, review the path to determine if it contains empty spaces or special characters. For example, the path /opt/appdynamics/machine agent is problematic, however, the path /opt/appdynamics/machine-agent works correctly.

The JVM system properties and environment variables override the settings in the controller-info.xml

  1. Environment variables
  2. System properties passed in the start command for the JVM

  3. Global configuration file:

See Where to Specify Machine Agent Configuration for OS environment and install package details