License Management, License Key Not Available

1	Introduction
1.1	Alarm Description
1.2	Prerequisites
2	Procedure
2.1	Analyzing the Alarm
2.2	Actions to Order and Install a New License Key File
Reference List

1 Introduction

This document describes the License Management, License Key Not Available alarm and provides instructions for fault management.

Note:: This alarm is not applicable to Network License Server (NeLS) deployments.

1.1 Alarm Description

License Management, License Key Not Available is raised when the requested licensed features or capacities cannot be used because the corresponding license keys are unavailable.

This primary alarm is issued by the ManagedElement=1,SystemFunctions=1,Lm=1,LicenseId=<licenseId> Managed Object (MO).

Possible alarm causes and fault locations are explained in Table 1.

Table 1 Alarm Causes
Alarm Cause	Description	Fault Reason	Fault Location	Impact
159	License Management, License Key Not Available	A license is about to expire or is unavailable for one of the following reasons: The license has expired. The license is not present in the corresponding license key file.	License Key File	The licensed feature may not be available.

The following consequences are expected if the alarm condition is not resolved:

The licensed feature may not be available.

The alarm attributes are listed and explained in Table 2.

Table 2 Alarm Attributes
Attribute Name	Attribute Value
activeSeverity	MINOR: The license identified by the `FeatureKey.featureKeyId` or `CapacityKey.capacityKeyId` has entered the expiration warning period defined by the `Lm.licenseExpirationWarning` parameter, but has not yet expired. MAJOR: The license identified by the `FeatureKey.featureKeyId` or `CapacityKey.capacityKeyId` has expired, or is not present in the corresponding license key file.
additionalInfo	Not Applicable
additionalText	MINOR: "License is about to expire = <licenseId>." MAJOR: "License expired = <licenseId>." "License not found = <licenseId>."
eventType	QUALITYOFSERVICEALARM
lastEventTime	A time stamp of the last alarm update, such as an alarm status change or severity change.
majorType	193
minorType	393217
originalAdditionalText	Content of the `additionalText` field when the alarm was raised.
originalEventTime	Time stamp when the alarm was raised.
originalSeverity	Value of the `activeSeverity` level when the alarm was raised.
probableCause	159 (Configuration or Customization Error)
sequenceNumber	The notification identity for this object instance. It is not the same as the `fmAlarmId` since multiple notifications may be sent for one alarm instance. This value changes for every notification (such as a severity change or alarm clear).
source	ManagedElement=1,SystemFunctions=1,Lm=1,License=<licenseId>
specificProblem	License Management, License Key Not Available

1.2 Prerequisites

This section lists the prerequisite documents, tools, and conditions for the alarm handling procedure.

1.2.1 Documents

Review the following documents before starting the procedure:

Personal Health and Safety Information (Reference [1])
System Safety Information (Reference [2])
The User Guide for your LM deployment:
- "Installing License Key Files" in the LM User Guide for Sentinel RMS (Reference [3])
- "Installing License Key Files" in the LM User Guide for ELIM (Reference [4])
"Configuration Management Using CLI" in the COM Management Guide for your version of the product software.

1.2.2 Tools

Ensure that the following tools are available before starting the procedure:

Element Management System (for example: OSS)
Ericsson Command-Line Interface (ECLI)

For more information on these tools, refer to the documentation for your version of the product software.

1.2.3 Conditions

Ensure that the following conditions are met before starting the procedure:

Know the IP address of the blade where ECLI is running.
Have the proper authority to handle configuration management of the Network Elements.
Be familiar with basic Unix commands.

2 Procedure

This section describes the alarm handling procedure.

License Management, License Key Not Available is a persistent alarm that remains on the alarm list until the associated license is replaced or all application instances release the license. The alarm is raised when a license is about to expire, has expired, or is not present in the corresponding license key file. The exact cause is printed in the alarm additionalText field. If License Management, License Key Not Available relates to license expiration, you can verify the license status by checking the license expiration date. For more information on obtaining license information, refer to "License Information" in the User Guide for your LM deployment.

LM User Guide for Sentinel RMS (Reference [3])
LM User Guide for ELIM (Reference [4])

Note:: Missing or expired licenses require new license keys, or an application procedure to release the affected licenses. Application procedures are outside the scope of this instruction.

2.2 Actions to Order and Install a New License Key File

To order and install a new license key file:

If necessary, contact your Ericsson supplier to order a new license key file.
Install the new license key file.
For more information on installing a new license key file, refer to "Installing License Key Files" in the User Guide for your LM deployment.
- LM User Guide for Sentinel RMS (Reference [3])
- LM User Guide for ELIM (Reference [4])
After installing the new license, check the alarm status.
If the alarm is still active, navigate to the Lm MO in ECLI, for example:
>ManagedElement=NODE06ST,SystemFunctions=1,Lm=1
Trigger an extra refresh of the license inventory to ensure that the license changes are applied:
(Lm=1)>refreshLicenseInventory

The system returns true if the action was executed successfully.
Verify that LM has the latest license information by checking the lastLicenseInventoryRefresh time stamp:
(Lm=1)>show lastLicenseInventoryRefresh

A recent time stamp indicates a successful update.
Check the alarm status.
If the alarm is still active, consult the next level of maintenance support. Further actions are outside the scope of this instruction.

Reference List


[1] Personal Health and Safety Information, 12446-2885 Uen
[2] System Safety Information, 12446-2886 Uen
[3] LM User Guide for Sentinel RMS, 1/1553-APR 901 0503/6 Uen
[4] LM User Guide for ELIM, 2/1553-APR 901 0503/6 Uen