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.
- 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 (o11nplugin-sovlabs.vmoapp
)
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
# | 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
In the SovLabs Configuration workflow form wizard:
4. Accept the EULA and click Next
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 |
6. Click Next
7. In the Upgrade Options section of the form:
Field | Value | Note |
---|---|---|
Upgrade existing SovLabs vRA Content | No |
8. Click Next
9. In the Install/Update section of the form:
Field | Value | Note |
---|---|---|
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.4 License
Please note that the SovLabs 2018.3.4 Plugin needs a 2018.x license key.
# | Step | Location | Notes |
---|---|---|---|
3.2 | Add SovLabs License | vRA tenant |
Steps
- Login to the desired vRA tenant (e.g. sov_admin@vsphere.local 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
Field | Value |
---|---|
License key | Copy & paste the entire SovLabs license file provided (including the header) |
View Progress
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.
Results
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.