Menu
Amazon Inspector
User Guide (Version Latest)

Working with AWS Agents on Windows-based Operating Systems

Sign in to your EC2 instance running a Windows-based operating system and run any of the following procedures. For more information about operating systems supported for Amazon Inspector see Amazon Inspector Supported Operating Systems and Regions.

Note

The following commands are functional in all regions that are supported by Amazon Inspector.

To install the AWS agent

  1. Download the following .exe file: https://d1wk0tztpsntt1.cloudfront.net/windows/installer/latest/AWSAgentInstall.exe

  2. Open a command prompt window (with Administrative permissions), navigate to the location where you saved the downloaded AWSAgentInstall.exe, and run AWSAgentInstall.exe to install the AWS agent.

    Note

    As updates for the AWS agent become available, they are automatically downloaded from Amazon S3 and applied. For more information, see AWS Agent Updates.

    If you want to skip this auto-update process, make sure to run this command to install the AWS agent.

    AWSAgentInstall.exe AUTOUPDATE=No

To uninstall the AWS agent

  1. On your EC2 instance, navigate to Control Panel, Add/Remove Programs.

  2. In the list of installed programs, choose AWS Agent, and then choose Uninstall.

To stop or start the AWS Agent or verify that the AWS agent is running

  1. On your EC2 instance, choose Start, then Run, and then type services.msc.

  2. If the agent is successfully running, two services are listed with their status set to Started or Running in the Services Window: AWS Agent Service and AWS Agent Updater Service.

  3. To start the agent, right-click AWS Agent Service and then choose Start. If the service is successfully started, the status is updated to Started or Running.

  4. To stop the agent, right-click AWS Agent Service and choose Stop. If the service is successfully stopped, the status is cleared ( appears as blank). We do not recommend stopping the AWS Agent Updater Service as it will disable the installation of all future enhancements and fixes to the AWS Agent.

  5. To verify that the AWS agent is installed and running, sign in to your EC2 instance, open a command prompt with Administrative permissions, navigate to C:/Program Files/Amazon Web Services/Aws Agent, and then run the following command:

    AWSAgentStatus.exe

    This command returns the status of the currently running agent, or an error stating that the agent cannot be contacted.

To modify AWS agent settings

Once the AWS agent is installed and running on your EC2 instance, you can modify the settings in the agent.cfg file to alter the agent's behavior. The agent.cfg file is located in the /opt/aws/awsagent/etc directory on Linux-based operating systems and in the C:\ProgramData\Amazon Web Services\AWS Agent directory on Windows-based operating systems. After you modify and save the agent.cfg file, you must stop and start the agent in order for the changes to take effect.

Important

We highly recommend that you modify the agent.cfg file only with the guidance of AWS Support.

To configure proxy support for AWS agents

Proxy support for AWS agents is achieved through the use of the WinHTTP proxy. To set up WinHTTP proxy using the netsh utility see: https://technet.microsoft.com/en-us/library/cc731131%28v=ws.10%29.aspx.

Complete one of the following procedures:

To install an AWS agent on an EC2 instance that uses a proxy server

  1. Download the following .exe file: https://d1wk0tztpsntt1.cloudfront.net/windows/installer/latest/AWSAgentInstall.exe

  2. Open a command prompt window or PowerShell window (with Administrative permissions), navigate to the location where you saved the downloaded AWSAgentInstall.exe, and run the following command:

    ./AWSAgentInstall.exe \install USEPROXY=1

To configure proxy support on an EC2 instance with a running AWS agent

  1. In order to configure proxy support, the version of the AWS agent that is running on your EC2 instance must be 1.0.0.59 or higher. If you have the auto-update process for the AWS agent enabled, you can verify that your AWS agent's version is 1.0.0.59 or higher by using the To stop or start the AWS Agent or verify that the AWS agent is running procedure. If you don't have the auto-update process for the AWS agent enabled, you must install the agent on this EC2 instance again by following the To install the AWS agent procedure.

  2. Open the registry editor (regedit.exe).

  3. Navigate to the following Registry key "HKEY_LOCAL_MACHINE/SOFTWARE/Amazon Web Services/AWS Agent Updater".

  4. Inside this registry key, create a registry DWORD(32bit) value called "UseProxy".

  5. Double click on the value and set the value to 1.

  6. Type services.msc, locate the AWS Agent Service and the AWS Agent Updater Service in the Services Window, and restart each process. After both processes have successfully restarted, run AWSAgentStatus.exe (see Step 5 in To stop or start the AWS Agent or verify that the AWS agent is running) to view the status of your AWS agent and verify that it is using the configured proxy.