Agent Installation on Windows - AWS Application Discovery Service

Agent Installation on Windows

Complete the following procedure to install an agent on Windows. Be sure that your Migration Hub home region has been set before you begin this procedure.

To install AWS Application Discovery Agent in your data center

  1. Navigate to the Microsoft Download Center and choose Download to be taken to the download selection page, then on this page, select only vc_redist.x86.exe (do not select the "x64" version) regardless of the architecture of the machine you are installing on, then choose Next. Your download begins immediately.

  2. Download the Windows agent installer but do not double-click to run the installer within Windows.

    Important

    Do not double-click to run the installer within Windows as it will fail to install. Agent installation only works from the command prompt. (If you already double-clicked on the installer, you must go to Add/Remove Programs and uninstall the agent before continuing on with the remaining installation steps.)

  3. Open a command prompt as an administrator and navigate to the location where you saved the installation package.

  4. To install the agent, choose one of the following installation methods.

    To... Do this...

    Install Discovery Agent

    To install the agent, run the agent install msiexec.exe command as shown in the following example. In the example, replace your-home-region with the name of your home region, aws-access-key-id with your access key id, and aws-secret-access-key with your secret access key.

    msiexec.exe /i AWSDiscoveryAgentInstaller.msi REGION="your-home-region" KEY_ID="aws-access-key-id" KEY_SECRET="aws-secret-access-key" /q

    By default, agents automatically download and apply updates as they become available.

    We recommend using this default configuration.

    However, if you don't want agents to download and apply updates automatically, include the following parameter when running the agent install command: AUTO_UPDATE=false

    Warning

    Disabling auto-upgrades will prevent the latest security patches from being installed.

    (Optional) Install Discovery Agent and configure a non-transparent proxy

    To configure a non-transparent proxy, add the following public properties to the agent install msiexec.exe command:

    • PROXY_HOST The name of the proxy host.

    • PROXY_SCHEME The the proxy scheme.

    • PROXY_PORT The proxy port number

    • PROXY_USER The proxy username.

    • PROXY_PASSWORD The proxy user password.

    The following is an example of the agent install msiexec.exe command using the non-transparent proxy properties.

    msiexec.exe /i AWSDiscoveryAgentInstaller.msi REGION="your-home-region" KEY_ID="aws-access-key-id" KEY_SECRET="aws-secret-access-key" PROXY_HOST="myproxy.mycompany.com" PROXY_SCHEME="https" PROXY_PORT="proxy-port-number" PROXY_USER="myusername" PROXY_PASSWORD="mypassword" /q

    If your proxy doesn't require authentication, then leave out the PROXY_USER and PROXY_PASSWORD properties. The example msiexec.exe command uses https, if your proxy uses HTTP, specify http for the PROXY_SCHEME value.

  5. If outbound connections from your network are restricted, you'll need to update your firewall settings. Agents require access to arsenal over TCP port 443. They don't require any inbound ports to be open.

    • For example, if your home region is eu-central-1, you'd use https://arsenal-discovery.eu-central-1.amazonaws.com:443

    • Or substitute your home region as needed for all other regions except us-west-2.

    • If us-west-2 is your home region, use https://arsenal.us-west-2.amazonaws.com:443

Package Signing on Windows 2003

For Windows Server 2008 and later, Amazon cryptographically signs the Application Discovery Service agent installation package with an SHA256 certificate. However, because the SHA2 certificate family is not supported by Windows Server 2003, the installation package for that platform is signed with an SHA1 certificate. Microsoft has published hotfixes that might allow your Windows 2003 systems to read an SHA256 certificate. If you require SHA256 in your Windows 2003 environment, contact AWS Support for assistance.

Manage the Discovery Agent Process on Windows

You can manage the behavior of the Discovery Agent at the system level through the Windows Server Manager Services console. The following table describes how.

Task Service Name Service Status/Action
Verify that an agent is running

AWS Discovery Agent

AWS Discovery Updater

Started
Start an agent

AWS Discovery Agent

AWS Discovery Updater

Choose Start
Stop an agent

AWS Discovery Agent

AWS Discovery Updater

Choose Stop
Restart an agent

AWS Discovery Agent

AWS Discovery Updater

Choose Restart

To uninstall a discovery agent on Windows

  1. Open Control Panel in Windows.

  2. Choose Programs.

  3. Choose Programs and Features.

  4. Select AWS Discovery Agent.

  5. Choose Uninstall.

Agent Troubleshooting on Windows

If you encounter problems while installing or using the Application Discovery Agent on Windows, consult the following guidance about logging and configuration. When helping to troubleshoot potential issues with the agent or its connection to the Application Discovery Service, AWS Support often requests these files.

  • Installation logging

    In some cases, the msiexec command described preceding appears to fail. For example, a failure can appear with the Windows Services Manager showing that the discovery services are not being created. In this case, add /L*V install.log to the command to generate a verbose installation log.

     

  • Operational logging

    On Windows Server 2008 and later, agent log files can be found under the following directory.

    C:\ProgramData\AWS\AWS Discovery\Logs

    On Windows Server 2003, agent log files can be found under the following directory.

    C:\Documents and Settings\All Users\Application Data\AWS\AWSDiscovery\Logs

    Logs files are named to indicate whether generated by the main service, automatic upgrader, or installer.

     

  • Configuration file

    On Windows Server 2008 and later, the agent configuration file can be found at the following location.

    C:\ProgramData\AWS\AWS Discovery\config

    On Windows Server 2003, the agent configuration file can be found at the following location.

    C:\Documents and Settings\All Users\Application Data\AWS\AWS Discovery\config
  • For instructions on how to remove older versions of the Discovery Agent, see Prerequisites for Agent Installation.