11.1 Initializing the vSphere Provisioning Adapter on the Orchestration Server

You must configure a vsphere provisioning adapter job that authenticates to a VMware vSphere environment. After you configure the adapter, you can discover VMs in that environment.

To configure multiple vSphere environments, see Section 11.4, Discovering Enterprise Resources in Multiple vSphere Environments.

  1. Ensure that the Orchestration Agent is installed and started on a supported VMware vSphere host. See Section 5.0, Installing Cloud Manager Orchestration Components.

    You can install the agent either locally on the vCenter Server (the vCenter appliance is not supported), or on a dedicated system (virtual or physical) as long as the OS in that system is supported for the Orchestration Agent.

    NOTE:If you want to connect multiple vCenter Server environments, see Section 11.4, Discovering Enterprise Resources in Multiple vSphere Environments.

  2. In the Cloud Manager Orchestration Console, log in to the Orchestration Server that you want to use to manage vSphere VMs.

  3. In the Explorer tree of the Orchestration Console, select the Orchestration Server or “grid” object, then select the Authentication tab in the admin view to open the Authentication page.

  4. Create a credential to authenticate to the vCenter Server. In most cases, the credential is for “administrator” account of the Windows machine where the vCenter Server is running.

    1. On the Authentication page, scroll to the Credential Manager (consisting of the Stored Credentials panel and the Stored Certificates panel), then click Add Credential to display the Edit Credential dialog.

    2. Fill in the fields of the dialog:

      • Name: Enter a value in that identifies the vCenter Web Service to log in to.

      • User: Enter the user name used to connect to the vCenter Web Service.

      • Secret: Enter the password of the vCenter Web Service user.

      • Type: (Optional) Enter any string that lets you categorize similar credentials into a category or group. For example, for the vSphere provisioning adapter you might enter a “type” called vsphere.

      For more information, see Authentication Page in the.Cloud Manager Administrator Reference.

    3. Click Add.

  5. In the Explorer tree, expand the Jobs container, then expand the provisionAdapters container to expose all of the provisioning adapter jobs.

  6. In the Explorer tree, select the vsphere job to open the Admin view.

  7. In the Admin view, select the Job Configuration tab to open the Job Configuration page, then expand the Accounts table on this page.

  8. On the Accounts table, select Add to open the Add a New Account dialog.

    1. Fill in the fields of the dialog:

      • Account Name: Enter the name you wish to use to refer to this vCenter server as within Orchestrator. This name can be any value, but once selected, it should not be changed.

      • vSphere Web Service URL: Enter the URL of the vCenter Web Service server.

        • Syntax: https://address-of-vcenter-server/sdk
        • Example: https://vcenter.server.test/sdk, where vcenter.server.test is the fully qualified domain name (FQDN) of the vCenter server. You can use the IP address rather than the FQDN.
      • Credential Name: Enter the name of the credential from the Credential Manager that you want to use for logging in to the vCenter Web Service server.

      • Auto Portgroup Creation: (Optional) If it is selected and the vsphere_ignoreNetwork policy is used, port groups are automatically created on a host if it does not have access to the specified network.

      • Auto Portgroup Disconnect: (Optional) If it is selected, the vNIC on a VM is disconnected when it is shut down.

      • Auto Portgroup Deletion: (Optional) If it is selected, when the VM is shut down, it checks for port groups on the VM host that has no VMs associated with it and deletes them, if possible. This setting is best used with Auto Portgroup Creation and Auto Portgroup Disconnect.

  9. Associate the vsphere_client policy to the resource that will access the vCenter Server.

    When the vsphere provisioning adapter job starts, this policy constrains the resource for the job to run the Web Service commands.

    1. In the Explorer tree, expand the Resources group, select the client resource that is to access the vCenter Web Service server, then select the Policies tab in the admin view to open the Policies page.

    2. On the Policies page, click Choose to open the Policy Selection dialog, then in the Source Policies list, select the vsphere_client policy, click Add, then click OK to associate this policy with this resource.

      For more information, see Resource Policies Page in the Cloud Manager Administrator Reference.

After you have completed the authentication configuration, continue with Running Discovery for a vSphere Environment.