Checking license information

Nominal case

The show log service license provides the licensing logs, including license activation and health check details.

vsr running license# show log service license
-- Logs begin at Wed 2020-04-22 21:06:14 UTC, end at Thu 2020-04-23 12:17:01 UTC. --
Apr 22 21:24:54 vsr systemd[1]: Starting vRouter License Daemon...
Apr 22 21:24:54 vsr vrld[3368]: license_code: xxxxxxxxxxxxxxx
Apr 22 21:24:54 vsr vrld[3368]: product: vsr
Apr 22 21:24:54 vsr vrld[3368]: workdir: /var/cache/license
Apr 22 21:24:54 vsr vrld[3368]: Using cloud license server
Apr 22 21:24:54 vsr vrld[3368]: License status from cache -1
Apr 22 21:24:54 vsr vrld[3368]: Dumping state to /var/cache/license/state.json
Apr 22 21:24:54 vsr vrld[3368]: healthcheck period: 21600 seconds
Apr 22 21:24:55 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 22 21:24:55 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 22 21:24:55 vsr vrld[3368]: started
Apr 22 21:24:55 vsr systemd[1]: Started vRouter License Daemon.
Apr 22 21:25:00 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 22 21:25:00 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 23 03:25:00 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 03:25:00 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 23 09:25:00 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 09:25:00 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
vsr running license#

In the nominal case, license key activation success is indicated by the following messages:

Apr 22 21:24:55 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 22 21:24:55 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 22 21:24:55 vsr vrld[3368]: started

Then, health check occurs and succeeds regularly:

Apr 23 03:25:00 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 03:25:00 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 23 09:25:00 vsr vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 09:25:00 vsr vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su

Troubleshooting license activation failures

The following messages indicates that the licensing server could not be reached.

Note

The following hosts must be reachable: nsa.nalpeiron.com, my.nalpeiron.com.

  • Server address cannot be resolved

    vsr> show license
    Expired license.
    vsr> show log service license
    (...)
    Apr 23 15:53:29 vsr vrld[24700]: healthcheck: cannot get license: SOAP Host can't be resolved (-4303)
    Apr 23 15:53:29 vsr vrld[24700]: License status from cache -1
    Apr 23 15:53:29 vsr vrld[24700]: license code: xxxxxxxxxxxxxx
    Apr 23 15:53:29 vsr vrld[24700]: healthcheck: Expired license (-1)
    Apr 23 15:53:29 vsr vrld[24700]: computer id: mLgk6tN3nKRB5Z9Jp1su
    Apr 23 15:53:29 vsr vrld[24700]: Failed to get maintenance expiry date: Lookup of tag failed (-6003)
    (...)
    
  • Server is not accessible

    vsr> show license
    Expired license.
    vsr> show log service license
    (...)
    Apr 27 13:55:14 vsr vrld[4535]: healthcheck: cannot get license: SOAP Couldn't connect to host (-4304)
    Apr 27 13:55:14 vsr vrld[4535]: License status from cache -1
    Apr 27 13:55:14 vsr vrld[4535]: license code: xxxxxxxxxxxxxx
    Apr 27 13:55:14 vsr vrld[4535]: healthcheck: Expired license (-1)
    Apr 27 13:55:14 vsr vrld[4535]: computer id: mLgk6tN3nKRB5Z9Jp1su
    Apr 27 13:55:14 vsr vrld[4535]: Failed to get maintenance expiry date: Lookup of tag failed (-6003)
    (...)
    

The following messages indicate license key activation errors.

  • Non-existing license key (likely wrong serial)

    vsr> show license
    Expired license.
    vsr> show log service license
    (...)
    Apr 25 04:35:47 vsr vrld[13156]: healthcheck: cannot get license: SOAP invalid license number (-4212)
    Apr 25 04:35:47 vsr vrld[13156]: License status from cache -1
    Apr 25 04:35:47 vsr vrld[13156]: license code: xxxxxxxxxxxx
    Apr 25 04:35:47 vsr vrld[13156]: healthcheck: Expired license (-1)
    Apr 25 04:35:47 vsr vrld[13156]: computer id: 7A6YS9Kc+dfN3MGmuWJD
    Apr 25 04:35:47 vsr vrld[13156]: Failed to get maintenance expiry date: Lookup of tag failed (-6003)
    (...)
    
  • Disabled license key

    vsr> show license
    LicenseCode is inactive.
    vsr> show log service license
    (...)
    Apr 25 04:36:20 vsr vrld[13852]: license code: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Apr 25 04:36:20 vsr vrld[13852]: healthcheck: LicenseCode is inactive (-114)
    Apr 25 04:36:20 vsr vrld[13852]: computer id: d23nbSAwfJRVVWIBEGKo
    Apr 25 04:36:20 vsr vrld[13852]: Failed to get maintenance expiry date: Lookup of tag failed (-6003)
    (...)
    
  • Maintenance expired prior to Virtual Service Router release date

    vsr> show license
    Maintenance Expired.
    vsr> show log service license
    (...)
    Apr 25 04:36:53 vsr vrld[14569]: Maintenance expiry date too old for version 3.0.0.ga (xxxxxxxxxxxx)
    Apr 25 04:36:53 vsr vrld[14569]: Returning license to server
    Apr 25 04:36:53 vsr vrld[14569]: license code: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Apr 25 04:36:53 vsr vrld[14569]: healthcheck: Maintenance Expired (-6001)
    Apr 25 04:36:53 vsr vrld[14569]: computer id: DL/g0aO9evIUvk+ror1t
    (...)
    
  • Maximum number of activations reached

    vsr> show license
    Number of Allowed Activations Exceeded.
    vsr> show log service license
    (...)
    Apr 25 04:37:26 vsr vrld[15250]: license code: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Apr 25 04:37:26 vsr vrld[15250]: healthcheck: Number of Allowed Activations Exceeded (-115)
    Apr 25 04:37:26 vsr vrld[15250]: computer id: ie128hMf9mXLC/P/hUtf
    Apr 25 04:37:26 vsr vrld[15250]: Failed to get maintenance expiry date: Lookup of tag failed (-6003)
    (...)
    

License key cache

When the license key is replaced by a new one and activation fails, the previous license key remains valid until it expires. This is to prevent interruption of service in case of configuration mistake or temporary connection issue. After the new license key is successfully activated, the previous one is discarded.

However, activation may succeed but the resulting license key be invalid, for example if the key has been disabled on the server or has no activations left. In that case, the license will be discarded and the features and capacities will be restricted. It may be necessary to perform Day-1 configuration again to setup a valid license.