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
|3||Install SovLabs Plugin||vRO Control Center|
1. Login to the vRO Control Center as user root:
Note: If it says page is unavailable (503 error) - Please start the Service manually.
- Built-in vRO: Browse to the vRA VAMI > Orchestrator > Orchestrator User Interface > Start.
- Stand-alone vRO: SSH to the vRO appliance. Run
service vco-configurator startas 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.
3. Click on the Manage Plug-Ins icon
4. In the Install plug-in section, browse for the SovLabs Plugin file (
5. Select the SovLabs plugin file (
o11nplugin-sovlabs.vmoapp) to upload
6. Click on Install
7. Accept the EULA and click on Install
8. Successful plugin install message will appear
9. Restart the vRO server
- On the Home page, click on the Startup Options icon and click on Restart
- 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
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
- Install the plugin on one appliance first
- Restart the vRO service on that appliance
- Wait until the vRO service is completely up in vRO Cluster Manager
- The configurations should automatically sync
Configure the SovLabs Plugin
|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
In the SovLabs Configuration workflow form wizard:
4. Accept the EULA and click Next
5. In Service and Content section of the form:
|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
|Publish License Content||Yes|
6. Click Next
7. In the Upgrade Options section of the form:
|Upgrade existing SovLabs vRA Content||No|
8. Click Next
9. In the Install/Update section of the form:
|Install or Update SovLabs Workflow Subscriptions||Yes|
10. Click Submit
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.3.0 License
Please note that the SovLabs 2018.3.0 Plugin needs a 2018.x license key.
|3.2||Add SovLabs License||vRA tenant|
- Login to the desired vRA tenant (e.g. firstname.lastname@example.org user)
- Click on the Catalog tab
- Click on the catalog item: Add License - SovLabs Modules
- Fill out the form and click Submit
- Under Requests in vRA, the request should complete successfully.
- Once the SovLabs license has been added, SovLabs vRA Catalog Item(s) will appear for the modules licensed
Add License Form
|License key||Copy & paste the entire SovLabs license file provided (including the header)|
To watch the progress of the license install workflow:
- Login to the vRO client
- In the Workflows tab, go to SovLabs > License > vRA ASD > Add License
- A vRO workflow token should appear and complete successfully.
After the license is successfully added, SovLabs Catalog Items and SovLabs vRA Event Broker Subscriptions will appear/generate
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:
- 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)
- 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.