You configure agent system properties in different ways depending 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:
- 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:
- 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, such as:
- 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
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>/osx-install.sh script and specify the agent system properties on the command line, such as:
> 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.