External provisioning integration (EPI) PowerShell agents integrate external systems into the machine provisioning process. Use the EPI PowerShell agent to integrate with Citrix provisioning server to enable provisioning of machines by on-demand disk streaming.

Prerequisites

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 EPIPowerShell from the Agent type list.
  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. 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.

  14. 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.

  15. Click Test to verify connectivity to each host.
  16. Select the EPI type.
  17. Enter the fully qualified domain name of the managed server in the EPI Server text box.
  18. Click Add.
  19. Click Next.
  20. Click Install to begin the installation.

    After several minutes a success message appears.

  21. Click Next.
  22. Click Finish.
  23. Verify that the installation is successful.
  24. (Optional) : Add multiple agents with different configurations and an endpoint on the same system.

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.