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__vrealize-automation-appliance-FQDN@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.

    Even in a distributed deployment, you might sometimes install more than one IaaS component on the same Windows server.

    If you install more than one IaaS component, always install them to the same 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 redundant agents on different servers.

    Name and configure redundant agents identically.

    Standalone agent

    Assign a unique name to the 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 IaaS Manager Service host.

    Option

    Description

    With a load balancer

    Enter the fully qualified domain name and port number of the load balancer for the Manager Service component, mgr-svc-load-balancer.mycompany.com:443.

    Do not enter IP addresses.

    Without a load balancer

    Enter the fully qualified domain name and port number of the machine where you installed the Manager Service component, mgr-svc.mycompany.com:443.

    Do not enter IP addresses.

    The default port is 443.

  15. Configure a connection to the IaaS Web server.

    Option

    Description

    With a load balancer

    Enter the fully qualified domain name and port number of the load balancer for the Web server component, web-load-balancer.mycompany.com:443.

    Do not enter IP addresses.

    Without a load balancer

    Enter the fully qualified domain name and port number of the machine where you installed the Web server component, web.mycompany.com:443.

    Do not enter IP addresses.

    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.