New Install

Download the SovLabs Plug-in

A download link to the SovLabs Plug-in along with a license key will be provided in an email


Install the SovLabs Plugin

# Step Location Notes
3 Install SovLabs Plugin vRO Control Center  

Steps

1. Login to the vRO Control Center as user root: https://[vRO-FQDN]:8283/vco-controlcenter/#/

Note: If it says page is unavailable (503 error) - Please start the Service manually.

  1. Built-in vRO: Browse to the vRA VAMI > Orchestrator > Orchestrator User Interface > Start.
  2. Stand-alone vRO: SSH to the vRO appliance. Run service vco-configurator start as root. Wait a couple minutes for the service to start.

2. Validate the Cluster Health by clicking on Validate Configuration and letting the checks Complete.

New Install-Step 2 Screenshot

3. Click on the Manage Plug-Ins icon

New Install-Step 3 Screenshot

4. In the Install plug-in section, browse for the SovLabs Plugin file (o11nplugin-sovlabs.vmoapp)

New Install-Step 4 Screenshot

5. Select the SovLabs plugin file (o11nplugin-sovlabs.vmoapp) to upload

New Install-Step 5 Screenshot

6. Click on Install

New Install-Step 6 Screenshot

7. Accept the EULA and click on Install

New Install-Step 7 Screenshot

8. Successful plugin install message will appear

New Install-Step 8 Screenshot

9. Restart the vRO server

  1. On the Home page, click on the Startup Options icon and click on Restart
  2. Optionally, SSH to the vRO appliance and type in:
 
service vco-server restart

Wait for vRO to restart successfully

10. Login again to the vRO Control Center and validate Cluster Health (See Step 2 above)

11. Click on the Manage Plug-Ins icon

12. Verify that the SovLabs Plugin is listed among the installed vRO plugins

New Install-Step 11 Screenshot

13. Restart vRA Appliance(s) (Typically 10-15 minutes for Services to all ‘Register’ in the VAMI)

Note: Restart vRA/vRO is necessary during a new install or else the SovLabs ‘types’ defined in our plugin will not be available and cause the Configuration Workflow to fail.


If Using Clustered vRO

  1. Install the plugin on one appliance first
  2. Restart the vRO service on that appliance
  3. Wait until the vRO service is completely up in vRO Cluster Manager
  4. The configurations should automatically sync

Configure the SovLabs Plugin

# Step Location Notes
3.1 Run the SovLabs Configuration workflow vRO client  

1. Login to the vRO client

2. In the Workflows tab, go to SovLabs > Configuration folder and expand it

3. Right-click on the SovLabs Configuration workflow and click Start Workflow

New Install - Configure SovLabs Steps 1-3 Screenshot

In the SovLabs Configuration workflow form wizard:

4. Accept the EULA and click Next

New Install - Configure SovLabs Step 4 Screenshot

5. In Service and Content section of the form:

Field Value Note
vRA Tenant Name Choose the appropriate tenant The drop-down may contain multiple tenants
Business Group Name Choose the sovlabs Business Group Step 1.3
Create SovLabs vRA Catalog Service Yes  
Security Group Defined in vRA Type in sov_admins@[tenant] Step 1.2
Publish License Content Yes  
New Install - Configure SovLabs Step 5 Screenshot

6. Click Next

7. In the Upgrade Options section of the form:

Field Value Note
Upgrade existing SovLabs vRA Content No  
New Install - Configure SovLabs Step 7 Screenshot

8. Click Next

9. In the Install/Update section of the form:

Field Value Note
Install or Update SovLabs Workflow Subscriptions Yes  
New Install - Configure SovLabs Step 9 Screenshot

10. Click Submit

If the SovLabs Configuration workflow fails when executed.
Check the vRO Logs for the error message 'Please reboot the VMware vRealize Automation Appliance and try re-running the SovLabs Configuration workflow again.' or 'THIS SHOULD NOT HAPPEN'(legacy).

1. Fix is to reboot vRA appliances - wait for services to Register in VAMI (10-15 minutes).

2. Re-run SovLabs Configuration Workflow. (This is caused by failing to reboot vRO/vRA in the previous section)


Next: Add License