This page describes how to install Windows using ZIP with bundled JRE.
For some versions of Windows Server 2008 and Windows Vista, the Avg Read and Write Time disk metrics are reported as 0. This is due to a known Microsoft Windows bug. See Microsoft Knowledge Base. If this affects you, download the available hotfix. This refers to the following metrics:
Hardware Resources|Disks|<mount_point>|Avg Read Time (ms)
Hardware Resources|Disks|<mount_point>|Avg Write Time (ms)
Install the Agent
Before installing, see Install the Machine Agent.
Install all available Windows updates.
If you have not restarted your machine recently, you must restart it. Failure to do so may cause your machine to experience a CPU spike when you start the Machine Agent.
- Download and unzip the Windows ZIP bundle. Extract the contents to the agent installation directory
- Gather your configuration details and configure the agent by editing the <machine_agent_home>/conf/controller-info.xml file or by adding system properties to the JVM startup script file. See Plan the Machine Agent Configuration.
- (Required) Configure the Controller host name, port number, and account access key.
- (Required for Multi-Tenant Mode or SaaS installations) Configure the Agent Account Information. See Multi-Tenant Controller Accounts.
- (Optional) Review memory requirements. See Machine Agent Requirements and Supported Environments.
- (Optional) Configure the agent to use SSL. See Enable SSL for Machine Agent.
- (Optional) Configure the agent to use proxy settings. See Machine Agent Configuration Properties.
- (Optional) Determine if you need to specify an application name and tier name. See Machine Agent Installation Scenarios.
However, if you are installing the Machine Agent on the same server with any APM app agent, do not specify the application name and tier name.
- Start the agent. If no
-Doptions are required on the command line, you can run the following
.vbsscripts by selecting them from Windows Explorer.
As a Windows Service - Administrative privileges are required. You can specify AppDynamics-specific
-Doptions from the command line or edit the controller-info.xml. You can also add other JVM properties as needed.
Open a terminal window and enter:
cscript <machine_agent_home>\InstallService.vbs <jvm_options>CODE
You can now start or stop the AppDynamics Machine Agent service from Windows Services.
From an application in the terminal window, enter:
The usage parameters for
> machine-agent.vbs -h Usage: machine-agent.vbs[-h] [-j JAVA_HOME][-Dprop1 ...] [-Xprop2 ...] Start the machine agent. -h print command line options -j JAVA_HOME set java home for the agent -Dprop1 set standard system properties for the agent -Xprop2 set non-standard system properties for the agentVB
The following is an example of machine-agent.vbs:
> cscript machine-agent.vbs -Dappdynamics.controller.hostName=192.168.1.20 -Dappdynamics.controller.port=8090CODE
Unquoted Service Path Enumeration Vulnerability
If you have installed Machine Agent primarily as a Windows service, you may encounter a security vulnerability known as Unquoted Service Path Enumeration Vulnerability.
Unquoted Service Path Enumeration Vulnerability occurs when the remote Windows host has at least one service installed that uses an unquoted service path, which contains at least one whitespace. A local attacker can gain elevated privileges by inserting an executable file in the path of the affected service.
To address this vulnerability, perform either of the following methods.
- Navigate to
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Services\Appdynamics Machine Agent.
ImagePathdata value to enclose
C:\Program Files\AppDynamics\AppD_Infra_Monitoring\bin\MachineAgentService.exein double quotation marks.
- Download the
Windows_Path_Enumerate.ps1script and save it to a folder.
To list all vulnerabilities on the machine, open the powershell prompt and execute the following command:
<path containing downloaded Windows_Path_Enumerate.ps1>\Windows_Path_Enumerate.ps1 -FixUninstall -FixEnv -WhatIfCODE
Fix all vulnerabilities on the machine by executing the following command:
<path containing downloaded Windows_Path_Enumerate.ps1>\Windows_Path_Enumerate.ps1 -FixUninstall -FixEnvCODE