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