Where to Specify Machine Agent Configuration

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> ...  

Windows 

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>/osx-install.sh script and specify the Agent system properties on the command line:

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

When you run the <machine_agent_home>/osx-install.sh 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.