AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.


    Skip to end of metadata
    Go to start of metadata

    This page describes how to install Windows using ZIP with bundled JRE. 

    Related pages:

    Your Rating:
    Results:
    1 Star2 Star3 Star4 Star5 Star
    29 rates

    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

    1. Before installing, see Install the Machine Agent

    2. Install all available Windows updates.

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

    4. Download and unzip the Windows ZIP bundle. Extract the contents to the agent installation directory <machine_agent_home>.
    5. 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
      1. (Required) Configure the Controller host name, port number, and account access key.
      2. (Required for Multi-Tenant Mode or SaaS installations) Configure the Agent Account Information. See Controller Accounts (Multi-Tenancy)
      3. (Optional) Review memory requirements. See Machine Agent Requirements and Supported Environments
      4. (Optional) Configure the agent to use SSL. See Enable SSL for Standalone Machine Agent
      5. (Optional) Configure the agent to use proxy settings. See Standalone Machine Agent Configuration Properties
      6. (Optional) Determine if you need to specify an application name and tier name. See Standalone Machine Agent Installation Scenarios
        However, if you are installing the Standalone Machine Agent on the same server with any APM app agent, do not specify the application name and tier name.
    6. Start the agent. If no -D options are required on the command line, you can run the following .vbs scripts by selecting them from Windows Explorer.
      1.  As a Windows Service - Administrative privileges are required. You can specify AppDynamics-specific -D options 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>


        You can now start or stop the Appdynamics Machine Agent service from Windows Services.

      2. From an application in the terminal window, enter:

         cscript <machine_agent_home>\bin\machine-agent.vbs.

        The usage parameters for machine-agent.vbs are: 

        Using machine-agent.vbs
        > 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 agent

        The following is an example of machine-agent.vbs:

        > cscript machine-agent.vbs -Dappdynamics.controller.hostName=192.168.1.20 -Dappdynamics.controller.port=8090
    • No labels