The Hyper-V agent manages Hyper-V server instances. The XenServer agent manages XenServer server instances.

About this task

Prerequisites

  • The IaaS components, including the Manager Service and Website, are installed.

  • Download the vRealize Automation IaaS Installer.

  • Verify that Hyper-V Hypervisor proxy agents have system administrator credentials.

  • Verify that the credentials under which to run the agent service have administrative access to the installation host.

  • Verify that all XenServer or Hyper-V instances on the hosts to be managed by the agent have administrator-level credentials.

  • If you are using Xen pools, note that all nodes within the Xen pool must be identified by their fully qualified domain names.

    vRealize Automation cannot communicate with or manage any node that is not identified by its fully qualified domain name within the Xen pool.

  • Configure Hyper-V for remote management to enable Hyper-V server communication with vRealize Automation Hyper-V proxy agents.

    See the Microsoft Windows Server documentation for information about how to configure Hyper-V for remote management.

Procedure

  1. Right-click the setup__vra-va-hostname.domain.name@5480.exe setup file and select Run as administrator.
  2. Click Next.
  3. Accept the license agreement and click Next.
  4. On the Log in page, supply administrator credentials for the vRealize Automation appliance and verify the SSL Certificate.
    1. Type the user name, which is root, and the password.

      The password is the password that you specified when you deployed the vRealize Automation appliance.

    2. Select Accept Certificate.
    3. Click View Certificate.

      Compare the certificate thumbprint with the thumbprint set for the vRealize Automation appliance. You can view the vRealize Automation appliance certificate in the client browser when the management console is accessed on port 5480.

  5. Select Custom Install on the Installation Type page.
  6. Select Component Selection on the Installation Type page.
  7. Accept the root install location or click Change and select an installation path.
  8. Click Next.
  9. Log in with administrator privileges for the Windows services on the installation machine.

    The service must run on the same installation machine.

  10. Click Next.
  11. Select the agent from the Agent type list.
    • Xen

    • Hyper-V

  12. Enter an identifier for this agent in the Agent name text box.

    Maintain a record of the agent name, credentials, endpoint name, and platform instance for each agent. You need this information to configure endpoints and to add hosts in the future.

    Important:

    For high availability, you may add redundant agents and configure them identically. Otherwise, keep agents unique.

    Option

    Description

    Redundant agent install

    Install redundant agents on different servers.

    Name and configure redundant agents identically.

    Single agent install

    Select a unique name for this agent.

  13. Communicate the Agent name to the IaaS administrator who configures endpoints.

    To enable access and data collection, the endpoint must be linked to the agent that was configured for it.

  14. Configure a connection to the Manager Service component.

    Option

    Description

    If you are using a load balancer

    Enter the fully qualified domain name and port number of the load balancer for the Manager Service component. For example, manager-load-balancer.eng.mycompany.com:443. IP addresses are not recognized.

    With no load balancer

    Enter the fully qualified domain name and port number of the machine where you installed the Manager Service component. For example, manager_service.mycompany.com:443. IP addresses are not recognized.

    The default port is 443.

  15. Configure a connection to the Manager Website component.

    Option

    Description

    If you are using a load balancer

    Enter the fully qualified domain name and port number of the load balancer for the Manager Website component. For example, website-load-balancer.eng.mycompany.com:443. IP addresses are not recognized.

    With no load balancer

    Enter the fully qualified domain name and port number of the machine where you installed the Manager Website component. For example, website_component.mycompany.com:443. IP addresses are not recognized.

    The default port is 443.

  16. Click Test to verify connectivity to each host.
  17. Enter the credentials of a user with administrative-level permissions on the managed server instance.
  18. Click Add.
  19. Click Next.
  20. (Optional) : Add another agent.

    For example, you can add a Xen agent if you previously added the Hyper-V agent.

  21. Click Install to begin the installation.

    After several minutes a success message appears.

  22. Click Next.
  23. Click Finish.
  24. Verify that the installation is successful.

What to do next

For high-availability, you can install and configure a redundant agent for your endpoint. Install each redundant agent on a separate server, but name and configure the agents identically.

Configure the Hyper-V or XenServer Agent.