Add License

Only perform if upgrading to a SovLabs 2019.x plug-in version for the FIRST time
-OR- if you obtained a new SovLabs License Key


SKIP this entire 'Add License' section if upgrading within SovLabs 2019.x plug-in versions

Delete Old SovLabs License

Delete previous SovLabs License key(s) if upgrading or applying a new license key

Steps

  1. Login to the desired vRA tenant (e.g. sov_admin@vsphere.local user)
  2. Click on the Deployments tab
  3. Click on SovLabs License filter
  4. Select the SovLabs license key and go to Actions and click Delete License
  5. Submit the form
  6. Under Requests in vRA, the request should complete successfully.
  7. Repeat if you have multiple licenses

Add SovLabs 2019.24.0 License

Please note that the SovLabs 2019.24.0 Plug-in needs a 2019.x license key.

Type Step Location
License with NO Activation Add License with no Activation vRA Tenant

If prompted to activate your license key

The email received from SovLabs will note if license activation is required or not

Type Step Location  
Single vRO with Activation Add License with Activation vRA Tenant Will note in email that the license key requires activation
Clustered vROs with Activation Add Licenses in vRO with Activation vRO Client Will note in email that the license key requires activation

No Activation

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 (see Add License Form below)
  5. After updating the License Key field, please click outside of the textarea on the form to trigger a refresh
  6. The Status field should be: Valid License, click Submit to Install
  7. Click Submit
  8. Under Deployments in vRA, the request should complete successfully.
  9. Once the SovLabs license has been added, SovLabs vRA Catalog Item(s) will appear for the modules licensed (may take up to 10 minutes for all items to appear)
Add License Screenshot

Add License Form

Field Value
License key Copy & paste the entire SovLabs license file provided (including the header)
Add License 1 Screenshot
Submit 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

Done with Licensing!


Single vRO with Activation

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. Paste the SovLabs License Key obtained into the License Key field
  5. After updating the License Key field, please click outside of the textarea on the form to trigger a refresh
  6. The form will refresh and present an updated view with an Activation Key in a readonly textarea
  7. Copy the Activation Key presented
  8. Go to https://license.sovlabs.com
  9. Paste the Activation Key, check the CAPTCHA and click Submit
  10. Copy the Activated License from https://license.sovlabs.com
  11. Paste the Activated License back in the form
  12. After updating the Activated License field, please click outside of the textarea on the form to trigger a refresh
  13. The Activated License Status field should be: Valid License, click Submit to Install
  14. Click Submit
  15. Under Deployments in vRA, the request should complete successfully.
  16. Once the SovLabs license has been added, SovLabs vRA Catalog Item(s) will appear for the modules licensed (may take up to 10 minutes for all items to appear)
Add License Screenshot
Copy Activation Key Screenshot
Activate Key Screenshot

Add License Form

Field Value
License key Copy & paste the entire SovLabs license file provided (including the header)
Activation Key Copy & paste the Activation key to https://license.sovlabs.com
Activated License Copy & paste the Activated license back to the form
Activated License Screenshot

View Progress

To watch the progress of the license install workflow:

  1. A vRO workflow token should appear and complete successfully.
Add License vRO workflow Screenshot

Done with Licensing!


Clustered vROs with Activation

  1. Login to the first vRO node
  2. Click on the Workflow tab
  3. Navigate to: SovLabs > License > vRA ASD
  4. Right-click on the vRO workflow Add License and click Start workflow
  5. Paste the SovLabs License Key obtained into the License Key field
  6. After updating the License Key field, please click outside of the textarea on the form to trigger a refresh
  7. The form will refresh and present an updated view with an Activation Key in a readonly textarea
  8. Copy the Activation Key presented
  9. Go to https://license.sovlabs.com
  10. Paste the Activation Key, check the CAPTCHA and click Submit
  11. Copy the Activated License from https://license.sovlabs.com
  12. Paste the Activated License back in the form
  13. After updating the Activated License field, please click outside of the textarea on the form to trigger a refresh
  14. The Activated License Status field should be: Valid License, click Submit to Install
  15. Click Submit
  16. Once the SovLabs license has been added, SovLabs vRA Catalog Item(s) will appear for the modules licensed (may take up to 10 minutes for all items to appear)
  17. Repeat Steps 1-15 for all remaining vRO Clustered Nodes
Add License in vRO Screenshot
Copy Activation Key in vRO Screenshot
Activate Key Screenshot

Add License Form

Field Value
Tenant Type in the vRA tenant name
vRA Business Group Type in the vRA Business Group for SovLabs
License key Copy & paste the entire SovLabs license file provided (including the header)
Activation Key Copy & paste the Activation key to https://license.sovlabs.com
Activated License Copy & paste the Activated license back to the form
Activated License to vRO Screenshot

View Progress

To watch the progress of the license install workflow:

  1. A vRO workflow token should appear and complete successfully.
Add License vRO workflow Screenshot

Done with Licensing!


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.

Disable SovLabs DNS vRA EBS

  1. Login to vRA tenant
  2. Go to Administration > Events > Subscriptions
  3. Select and Unpublish the SovLabs_DNS_machineBuilding subscription
  4. Select and Unpublish the SovLabs_DNS_machineDisposing subscription

*These will be restored any time the SovLabs plug-in is updated


Attach a vRA Custom Property to vRA Endpoint(s)

  1. Create the vRA Custom property: SovLabs_DisableDNS with the value true.
  2. Apply to all the vRA tenant > Infrastructure > Endpoint(s) attached to vRA.

*This will prevent the DNS subscriptions from executing.

SovLabs Disable DNS Screenshot

Next: Setup Modules