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)


Add SovLabs 2018.2.7 License

Please note that the SovLabs 2018.2.7 Plugin needs a 2018.x license key.

# Step Location Notes
3.2 Add SovLabs License vRA tenant  

Steps

  1. Login to the desired vRA tenant (e.g. sov_admin@vsphere.local user)
  2. Click on the Catalog tab
  3. Click on the catalog item: Add License - SovLabs Modules
  4. Fill out the form and click Submit
  5. Under Requests in vRA, the request should complete successfully.
  6. Once the SovLabs license has been added, SovLabs vRA Catalog Item(s) will appear for the modules licensed
Add License Screenshot

Add License Form

Field Value
License key Copy & paste the entire SovLabs license file provided (including the header)
Add SovLabs 2018.x License Screenshot

View Progress

To watch the progress of the license install workflow:

  1. Login to the vRO client
  2. In the Workflows tab, go to SovLabs > License > vRA ASD > Add License
  3. A vRO workflow token should appear and complete successfully.
Add License vRO workflow Screenshot

Results

After the license is successfully added, SovLabs Catalog Items and SovLabs vRA Event Broker Subscriptions will appear/generate

SovLabs vRA Catalog Items Screenshot

Disable SovLabs DNS Subscriptions


It is recommended once the SovLabs plug-in installation is completed to Disable DNS subscriptions until a ‘Proper’ DNS configuration is created.
Two options are available. Either:

  1. Login to vRA > Administration > Events > Subscriptions. Select and Unpublish the ‘SovLabs_DNS_machineBuilding’ and ‘SovLabs_DNS_machineDisposing’ subscriptions. (these will be restored any time the plug-in is updated)
  2. Create the Custom property: ‘SovLabs_DisableDNS’ - value ‘true’. Then apply to all the vRA > Infrastructure > ‘EndPoint(s)’ attached to vRA. This will prevent the DNS subscriptions from executing.
SovLabs Disable DNS Screenshot