T-Shoot: VIRL Installation / Deployment Failure



    Where can I find my license, download my software or find optional Cisco Virutal

    Machine image files?

    A: Click on My Account and be sure to log in with the same Cisco user ID which was used during the purchase of VIRL. From there you will see links to Downloads and your purchased License(s). When downloading your software, it is recommended that you use Google Chrome or Mozilla Firefox browsers.

    How do I add the license to my server and why does UWM say ‘Not Connected’?

    A: Follow the steps outlined in the beginning of the T-Shoot: "Failed to collect current salt contact status"; but if you are not able to successfully authenticate

    your server, be sure to continue reading the guide to ensure all pre-requisites have been met.

    Common errors include:

    • License ID not correctly entered. Make sure to use this format 123abc78.virl30.info or 123abc78.virl.info
    • Default PEM key is not replaced with your issued key. In some cases, you may see a PEM key already entered in the Minion Private RSA key field. This is not a valid key and you must completely remove it and replace it with the unique key issued to you.
    • NTP is not configured or your network has restrictions on NTP traffic.
    • Your network restricts traffic on ports TCP 4505-4506. These ports are needed to license and perform software upgrades for your VIRL server. If they are blocked, you need to speak with your systems administrator for assistance.

    I added my license but now I receive an error message about NTP?

    A: VIRL uses NTP time service as part of the license authentication system. If your environment (network) limits or restricts NTP

    service, you may get an error stating that your license has not been applied. When this happens make sure that:

    1. Your network allows use of external NTP servers or
    2. Set the NTP server in UWM to point to allowed server name or IP address
      • UWM > VIRL Server > System Configuration > NTP Server
    3. Connect to your VIRL server via SSH and ensure that a NTP peer has been established
      • ssh virl@<ip-address>
      • sudo ntpq -p


    If output is similar to this, you may need to give your server more time to find a peer (typically about 5 minutes) or NTP may be restricted.

    More information and troubleshooting tips can be found here: T-Shoot: NTP errors and connectivity on VIRL


    virl@sbsc-sim1:~$ sudo ntpq -p

        remote        refid        st t when poll reach  delay  offset  jitter


    triangle.kansas  .INIT.        16 u    -  64    0    0.000  0.000  0.000


    A good NTP service connection would look like this:

    virl@sbsc-sim1:~$ sudo ntpq -p

        remote          refid      st t when poll reach  delay  offset  jitter


    *triangle.kansas    2 u    1  256  377  71.419    3.339  3.343



    I can’t connect to User Workspace Management (UWM) to finish my VIRL deployment. How can I connect to UWM?

    A: This typically happens on new deployments or when modification to hostname, IP address or physical interface settings needed to be made. If care is not taken during edits, some services will not be able to start due to misconfiguration. The VIRL server uses eth4 (internalnet) to communicate with Openstack services which run in the background. If this interface is modified or not properly assigned, UWM may fail to load as it tries to communicate with Openstack. It is possible that after an extended period of time, UWM web page will become available but display errors.

    When this happens take a look at T-Shoot: UWM admin page unavailable; error: "unable to connect"

    If you need to open a support thread run VIRL Server Config Validation to collect key configuration settings. This script will create a single text file that can be attached to your post.

    Where are the installation guides for VIRL Server?

    A: All of the installation guides can be found in the VIRL Documentation index under the heading Installing VIRL.