How do I deploy a Machine Agent?

[#1]

What are the steps to installing and validating a Machine Agent?

Table of Contents

How do I install the AppDynamics Machine Agent?

Validate that your deployed Machine Agent is reporting

How do I install the AppDynamics Machine Agent?

1. Download the latest Machine Agent from download.appdynamics.com
   
   
2. Unzip the folder on the server to be monitored
   
   
3. Navigate to Machine Agent home folder > conf > controller-info.xml
   
   
4. Input the following information
   

   Host name or IP address	a	The same host used to access AppDynamics browser-based UI <controller-host>xxx.saas.appdynamics.com/On-prem controller</controller-host> Can be overridden with the environment variable CONTROLLER_HOST_NAME or the system property ‘-Dappdynamics.controller.HostName'
   HTTPS port	b	Same port used to access AppDynamics browser-based UI <controller-port>443(for SaaS)/On prem controller port</controller-port> If <Controller-ssl-enabled> below (“c”), is set to “true” specify the HTTPS port of the Controller (default is 8181); if it is not, instead specify the HTTP port (default is 8090) Can be overridden with the environment variable  CONTROLLER_CONTROLLER_PORT or the system property ‘-Dappdynamics.controller.port’
   Specify whether to use SSL (HTTPS) to connect	c	<controller-ssl-enabled>true(SaaS)/false</controller-ssl-enabled> If <Controller-ssl-enabled>, is set to “true” here, specify the HTTPS port of the Controller above (“b”) (default is 8181); if it is not set to true, instead specify the HTTP port (default is 8090). Can be overridden with the environment variable CONTROLLER_CONTROLLER_SSL_ENABLED or the system property ‘-Dappdynamics.controller.ssl.enabled'
   Account access key	d	The account access key is generated at installation. You can find it with the License information in the Controller Settings.  <account-access-key> xxxxxx</account-access-key> Can be overridden with the environment variable APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY or the system property ‘-Dappdynamics.agent.accountAccessKey'
   Account name	e	If the AppDynamics Controller is running in multi-tenant mode, or if you’re using the AppDynamics SaaS Controller, you must specify the account name for this agent to authenticate with the controller: <account-name>xxxxx</account-name> If you’re running in single-tenant mode (the default), you don’t need to configure this value. Can be overridden with the environment variable APPDYNAMICS_AGENT_ACCOUNT_NAME or the system property ‘-Dappdynamics.agent.accountName'
   Server monitoring enabled/disabled	f	If this agent is licensed for server monitoring, set this flag to true to enable Server Monitoring expanded metrics. <sim-enabled>true(for server visibility)</sim-enabled> Can be overridden with the environment variable APPDYNAMICS_AGENT_SIM_ENABLED or the system property ‘-Dappdynamics.sim.enabled'
   .NET compatibility mode enabled/disabled	g	Optional  If there is a .NET Agent on the same server, enable .NET compatibility <dotnet-compatibility-mode>true</dotnet-compatibility-mode>

5. Navigate to <MachineAgent-Home> and run cscript InstallService.vbs. This will configure the Machine Agent as a service as well as start it.

Validate that your deployed Machine Agent is reporting

Validate that the Machine Agent is reporting on the controller under the Settings AppDynamics Agents Machine Agent tab.