Download the SovLabs Plugin
A download link to the SovLabs Plugin 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.
- For 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 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.
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 Applaince(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
Note: 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).
- Fix is to reboot vRA appliances - wait for services to Register in VAMI (10-15 minutes). ReRun SovLabs Configuration Workflow. (This is caused by failing to reboot vRO/vRA in the previous section)
Add SovLabs latest License
Please note that the SovLabs latest Plugin needs a 2018.x .x license key.
|3.2||Add SovLabs License||vRO Console|
- 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 reccomended once the Sovlabs plugin 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 plugin is updated)
- Create the Custom property: ‘SovLabs_DisableDNS’ - value ‘true’. Then apply to all the vRA > Instrastructure > ‘EndPoint(s)’ attached to vRA. This will prevent the DNS subscriptions from executing.