AWS Application Discovery Service
User Guide

Set Up Agentless Discovery

To set up agentless discovery, you must deploy the AWS Agentless Discovery Connector virtual appliance on a VMware vCenter Server host in your on-premises environment. After you deploy the virtual appliance, you must configure the connector using the web-based console.

Deploying the AWS Agentless Discovery Connector Virtual Appliance

Before you can download the AWS Agentless Discovery Connector virtual appliance, you must register with AWS to be whitelisted. You will receive information about how to download the virtual appliance (as an Open Virtualization Archive (OVA) file) after you register with AWS.

To deploy the connector virtual appliance

  1. Sign in to vCenter as a VMware administrator.

  2. Choose File, Deploy OVF Template. Enter the URL that was sent to you after you completed the registration and complete the wizard.

  3. On the Disk Format page, select one of the thick provision disk types. We recommend that you choose Thick Provision Eager Zeroed, because it has the best performance and reliability. However, it requires several hours to zero out the disk. Do not choose Thin Provision. This option makes deployment faster but significantly reduces disk performance. For more information, see Types of supported virtual disks in the VMware documentation.

  4. Locate and open the context (right-click) menu for the newly deployed template in the vSphere client inventory tree and choose Power, Power On. Open the context (right-click) menu for the template again and choose Open Console. The console displays the IP address of the connector console. Save the IP address in a secure location. You'll need it to complete the connector setup process.

Configuring the AWS Agentless Discovery Connector

To finish the setup process, open a web browser and complete the following procedure.

To configure the connector using the console

  1. In a web browser, type the following URL in the address bar: https://ip_address/, where ip_address is the IP address of the connector console that you saved earlier.

  2. In Step 1: License agreement, read and accept the agreement and choose Next.

  3. In Step 2: Create a password, type a strong password for access to the connector and choose Next.

  4. In Step 3: Network information, read the information provided and configure network settings.

  5. In Step 4: Log uploads and upgrades, select the right options and choose Next.

  6. In Step 5: Discovery Connector setup, choose Configure vCenter credentials.

    1. For vCenter IP address, type the IP address of your VMware vCenter Server host.

    2. For vCenter username, type the name of a local or domain user that the connector uses to communicate with vCenter. For domain users, use the form domain\username or username@domain.

    3. For vCenter password, type the user password.

    4. Choose Ignore security certificate to bypass SSL certificate validation with vCenter. Choose Save.

  7. Choose Configure AWS credentials and type the credentials for the IAM user who is assigned the AWSAgentlessDiscoveryService IAM policy that you created in Attach Required IAM User Policies. Choose Save.

  8. Choose Configure where to publish data and select the publishing options. Choose Save.


After you complete this initial setup, you can access connector settings by using SSH and the connector IP address: root@Connector_IP_address. The default user name is ec2-user and the default password is ec2pass. We strongly encourage you to change the value of the default user name and password.

You've completed the setup process and are ready to start using agentless discovery with Application Discovery Service. You can use the Application Discovery Service command line interface (CLI) to start collecting data, manage the service, tag and query configuration items, and export data. You can export data as a CSV or an XML file to an Amazon S3 bucket or an application that enables you to view and evaluate the data. For an example of how to use the API, see AWS Application Discovery Service CLI Walkthrough. For more information about the Application Discovery Service API, see the Application Discovery Service API Reference.