License Troubleshooting
Note: If you install OcNOS SP 3.0 (or later) for the first time on a device and then perform license activation, the activated license is deactivated if you install any version before OcNOS SP 3.0. To recover, the license has to be activated/installed again.
Symptom/Cause
Error
Solution
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Failure: license get <url> / license refresh
License file (IPI-DEVICEID.bin) Not Found
license is not present on system, use "license get <url>" to install the license
License installation failed due to incorrect Device ID in the License file, please use the relevant device specific license file
Downloaded license is not for the current device and it is removed. Use "license get <url>" to install the correct license.
The allowed time to process the license is expired, please download the fresh license from the FNO portal
License file lifetime has expired, but this is not an actual license expiration error. Also this lifetime value is not visible to the user. So download the license from FNO portal using "license get <url>" again.
 
Note: The Lifetime field is the lifetime of the capability response, in seconds, after which the response is considered “stale” and cannot be processed by the client or server. IPInfusion has the lifetime set to 3628800 seconds or 42 days. If a capability response is created and held without installing for more than the specified period (42 days), it turns stale and the target device would not be able to process this.
Response is out of order with previous responses, also show license is not reflecting the new license features.
User have already installed a license which is downloaded more recently than the current license. But once you land in this error case, re-installation of either of these two licenses will not be helpful anymore. So download the license from portal freshly and install "license get <url>" command.
Failed to create trusted storage
Remove the contents of /cfg/license/ then install the license using "license get <url>" CLI.
Invalid license file
License file might be corrupt, so download and install the license from FNO license portal using "license get <url>". If it still fails, validate the checksum of the license file in /cfg/license/bin/ with the one downloaded from the FNO portal.
Start date for the license is in the future
Correct the system clock and issue the "license refresh" command to install the license
Empty license file
Download the license from FNO license portal, and install using "license get <url>".
Failed to process capability response / Failed to process the license file
Remove the contents of /cfg/license/ then install the license using "license get <url>" CLI.
Command "license get" is not installing the given license file, but processes old license and fails.
Correct the system clock and issue "license get <url>" to install the license again.
 
License is not matching with device software
License file SKU is not compatible with device software, please map the right SKU, then generate and install the license.
 
Empty license response received: license is not mapped with SKU or the license server exhausted its limit
Select a SKU while generating license from FNO license portal or increase the license pool on the license server to accommodate more devices.
Last modified date: 06/08/2023