External provisioning integration (EPI) PowerShell agents allow integrate external systems into the machine provisioning process. Use an EPI agent to run Visual Basic Scripts as extra steps during the provisioning process.

Prerequisites

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 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 redundant agents on different servers.

    Name and configure redundant agents identically.

    Standalone agent

    Assign a unique name to the agent.

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

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

  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.