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 

When installing and starting a Windows service (you need admin privileges), specify AppDynamics-specific -D options on the command line or in controller-info.xml.
Add other JVM properties on the command line:

<machine_agent_home>\cscript InstallService.vbs InstallService.cmd <jvm_options>

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.