View a markdown version of this page

Creating a vCenter connector - Amazon Elastic VMware Service

Creating a vCenter connector

To set up Windows Server entitlements for your virtual machines (VMs), you first create a vCenter connector. With this connector, Amazon EVS can communicate with vCenter Server in your environment. It uses the fully qualified domain name (FQDN) and credentials that you store in an AWS Secrets Manager secret to authenticate with the appliance.

Before you create a connector, make sure that you meet the requirements in Prerequisites for Windows Server entitlements.

Note the following connector constraints:

  • Each connector maps to a single appliance FQDN, and only one vCenter connector is allowed per environment. The FQDN must match the domain name that you used when you created your Amazon EVS environment, and it must be unique across all connectors in the environment.

  • Connector creation does not validate appliance reachability or credentials. After the connector shows as Active, EVS runs a reachability check every 10 minutes and updates the connector’s status to Passed, Failed, or Unknown.

To create an Amazon EVS environment connector

Example
Amazon EVS console

  1. Go to the Amazon EVS console.

  2. In the navigation pane, choose Environments.

  3. Select the environment where you want to create the connector.

  4. Select the Connectors tab.

  5. Choose Create connector.

  6. For Appliance FQDN, enter the fully qualified domain name of the appliance.

  7. For the Secret Manager dropdown, select the Secret containing the appliance credentials.

  8. Choose Create connector.

  9. To verify completion, check that the connector state is Active and the reachability check result is Passed.

AWS CLI

  1. Open a new terminal session.

  2. Create a new connector. See example command below for reference.

    • secret-identifier can be the secret name or ARN

      aws evs create-environment-connector \
    --environment-id env-abcde12345 \
    --type VCENTER \
    --appliance-fqdn vcenter.example.com \
    --secret-identifier arn:aws:secretsmanager:us-east-2:123456789012:secret:vcenter-creds-AbCdEf

  3. To verify completion, use the list-environment-connectors command and check that the connector state is Active and the reachability check result is Passed.

    aws evs list-environment-connectors \
    --environment-id env-abcde12345

After the connector is Active and the reachability check has Passed, you can create entitlements for your Windows VMs. See Creating Windows Server entitlements for your VMs.