When you're going through the set up and installation steps for you VIRL Server, you'll get to the step where you need to enter your license key. Here are a few key points to help ensure that this is successful!
- Make sure that you have a valid NTP clock source - See the installation instructions on the VIRL Micro-Site
- Make a note of your license key file name. Your key is the Salt ID and domain. The filename format appears like this: 123abc78.virl.info.pem or 123abc78.virl30.info.pem so you will need to remove the .pem when entering into the appropriate field.
- Your license key is a .pem file. A PEM file is a Base64 encoded certificate that can be opened with a regular text editor. We recommend using a text editor like TextEdit, TextWrangler, notepad, or notepad++ instead of a word processor like Microsoft Word, Pages, or Word Pad.
- When entering your key in UWM; under VIRL Server > Salt Configuration and Status, click on "Reset keys and ID" button to display: Reset Salt settings window. Ensure you have the entire text of your .pem file. Including the last line that reads:
- -----END RSA PRIVATE KEY-----
The picture below shows an example of the Reset Salt Settings page:
Here we can see the Salt ID and Domain set to ABCD1234.virl.info - NOTE that there is no trailing '.' (period or dot)
We can see the salt master list - this is a comma-seperated list of the Cisco salt masters. Take a look at T-Shoot: Failed to collect current salt contact status for the complete list of current Cisco Salt Masters. (Users based in the US; click on "Defaults" button to auto populate)
The entire License key .pem file is pasted into the 'Minion private RSA key in PEM format' field, including the final line:
-----END RSA PRIVATE KEY-----
You're now ready to press the 'Reset' button