You configure Agent system properties in different ways based on your operating system and whether you are starting the Agent from the command line or as a service.

Linux As a Service

  • SysV service launcher: 
    Specify the Agent system properties in the <machine_agent_home>/etc/sysconfig/appdynamics-machine-agent configuration file, and edit the JAVA_OPTS environment variable.
  • systemd: 
    Specify the Agent system properties in the <machine_agent_home>/etc/systemd/system/appdynamics-machine-agent.service file, and edit the JAVA_OPTS environment variable.

Any UNIX-like System 

When starting the Agent application on the command line for an UNIX-like system ((Linux, Solaris, Mac, AIX, and so on) using the machine-agent command, specify the agent system properties on the command line:

  • Run agent in the background: 
          % nohup <machine_agent_home>/bin/machine-agent -D<system_property1>=<value1> -D<system_property2>=<value2> ...  &
  • Run agent in the foreground: 
          % <machine_agent_home>/bin/machine-agent -D<system_property1>=<value1> -D<system_property2>=<value2> ...  


Admin privileges are required to install and start a Windows service. 

When installing and starting a Windows service, specify AppDynamics-specific -D options on the command line or in controller-info.xml.

If the Machine Agent is a VM (non-container), you can start or run it as a non-privileged user. Non-privileged users should have read access to the following WMI classes:

  • Win32_PerfRawData_PerfDisk_LogicalDisk
  • Win32_LogicalDisk
  • Win32_Processor
  • Win32_PerfRawData_PerfOS_Processor
  • Win32_NetworkAdapter
  • Win32_NetworkAdapterConfiguration
  • Win32_PerfRawData_Tcpip_NetworkInterface
  • Win32_Process
  • Win32_PerfRawData_PerfProc_Process
  • Win32_ComputerSystem
  • Win32_PerfRawData_PerfOS_System
  • Win32_OperatingSystem
  • Win32_PerfRawData_vmGuestLib_VCPU (VMWare)

Mac OS X

Start the Agent service using the <machine_agent_home>/ script and specify the Agent system properties on the command line:

     > sh <machine_agent_home>/ -D<system_property1>=<value1> -D<system_property2>=<value2> ... 

When you run the <machine_agent_home>/ script, the <machine_agent_home>/com.appdynamics.machineagent.plist.template is updated with the installation directory and the java properties set for the Machine Agent.