Checking license information

Nominal case

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

vrouter 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 localhost systemd[1]: Starting vRouter License Daemon...
Apr 22 21:24:54 localhost vrld[3368]: license_code: xxxxxxxxxxxxxxx
Apr 22 21:24:54 localhost vrld[3368]: product: turbo-router
Apr 22 21:24:54 localhost vrld[3368]: workdir: /var/cache/license
Apr 22 21:24:54 localhost vrld[3368]: Using cloud license server
Apr 22 21:24:54 localhost vrld[3368]: License status from cache -1
Apr 22 21:24:54 localhost vrld[3368]: Dumping state to /var/cache/license/state.json
Apr 22 21:24:54 localhost vrld[3368]: healthcheck period: 21600 seconds
Apr 22 21:24:55 localhost vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 22 21:24:55 localhost vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 22 21:24:55 localhost vrld[3368]: started
Apr 22 21:24:55 localhost systemd[1]: Started vRouter License Daemon.
Apr 22 21:25:00 localhost vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 22 21:25:00 localhost vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 23 03:25:00 vrouter vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 03:25:00 vrouter vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 23 09:25:00 vrouter vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 09:25:00 vrouter vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
vrouter running license#

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

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

Then, health check occurs and succeeds regularly:

Apr 23 03:25:00 vrouter vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 03:25:00 vrouter vrld[3368]: computer id: mLgk6tN3nKRB5Z9Jp1su
Apr 23 09:25:00 vrouter vrld[3368]: healthcheck: Concurrent License Activated (3)
Apr 23 09:25:00 vrouter 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

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

    vrouter> show license
    Expired license.
    vrouter> show log service license
    (...)
    Apr 27 13:55:14 vrouter vrld[4535]: healthcheck: cannot get license: SOAP Couldn't connect to host (-4304)
    Apr 27 13:55:14 vrouter vrld[4535]: License status from cache -1
    Apr 27 13:55:14 vrouter vrld[4535]: license code: xxxxxxxxxxxxxx
    Apr 27 13:55:14 vrouter vrld[4535]: healthcheck: Expired license (-1)
    Apr 27 13:55:14 vrouter vrld[4535]: computer id: mLgk6tN3nKRB5Z9Jp1su
    Apr 27 13:55:14 vrouter 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)

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

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

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

    vrouter> show license
    Number of Allowed Activations Exceeded.
    vrouter> show log service license
    (...)
    Apr 25 04:37:26 vrouter vrld[15250]: license code: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Apr 25 04:37:26 vrouter vrld[15250]: healthcheck: Number of Allowed Activations Exceeded (-115)
    Apr 25 04:37:26 vrouter vrld[15250]: computer id: ie128hMf9mXLC/P/hUtf
    Apr 25 04:37:26 vrouter 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.