View License Information

1 Description

This instruction describes how to view license information.

The user can check the list of license keys available on the ME and their validity for preventive maintenance purpose and in problem resolution situations.

2 Procedure

2.1 View License Information

Prerequisites

No documents are required.
No tools are required.
The following conditions must apply:
- An Ericsson Command-Line Interface (ECLI) session in Exec mode is in progress.

Steps

Navigate to the Lm Managed Object (MO), for example:
>dn ManagedElement=NODE06ST,SystemFunctions=1,Lm=1
Trigger a synchronization of the latest license information to the Management Information Base (MIB):
(Lm=1)>publishLicenseInventory

The system returns true if the operation is successful.
Verify that the license information has been updated by checking the time stamp, for example:
(Lm=1)>show lastInventoryChange

A recent time stamp indicates a successful update, for example:
lastInventoryChange="2017-09-12T00:00:00"

View the license information:

(Lm=1)>show -r

The following is an example output:

Lm=1
   fingerprint="NODE06ST"
   fingerprintUpdateable=false
   lastInventoryChange="2017-01-01T00:00:00"
   lastLicenseInventoryRefresh="2017-09-02T10:01:52"
   lmState=NORMAL
   lockingCode=""
   referenceToLicenseServer
      ""
   AutonomousMode=1
      activationState=INACTIVE
      expiration="NULL"
   CapacityKey=1
      capacityUnit="token"
      expiration="2017-9-5"
      grantedCapacityLevel=0
      keyId="FAT102122"
      licensedCapacityLimitReached=false
      name="Test Capacity Key"
      productType="NODE"
      validFrom="2017-8-20"
      version=""
      licensedCapacityLimit
         value=700
   EmergencyUnlock=1
      activationsLeft=2
      activationState=INACTIVE
      expiration="NULL"
   FeatureKey=1
      expiration="2017-10-19"
      granted=false
      keyId="#emergencyResetKey"
      name="Emergency Reset Key"
      productType="NODE"
      validFrom="2017-8-20"
      version=""
   FeatureKey=2
     expiration="2017-10-10"
      granted=false
      keyId="FAT102113"
      name="Test Feature Key"
      productType="NODE"
      validFrom="2017-9-11"
      version=""
[...]

This is an example printout of an ME using string NODE06ST as a fingerprint value. The LM mode is the normal mode indicating that all installed license keys are available to the ME functionalities. There are two activations left for the emergency lock, which implies that there is no immediate need to order an emergency reset key. One capacity key and two feature keys are installed on the ME.

The name attribute is the license description from the License Key File (LKF). In case of licenses that are not installed, but granted in Integration Unlock or Emergency Unlock mode, then this attribute shall be empty as there is no description of the license available. In case of Network License Server (NeLS) deployment, this attribute contains the description returned by NeLS.

Note:: In NeLS deployments, only license keys that have been requested by functions executing on the ME are visible. License keys installed in NeLS but not yet used on this particular ME are not shown, and neither are capacity license keys that have been used through the reporting pattern rather than the request and release pattern.