User Guide 1/1553-AXM 101 04/1 Uen D

License Management
Virtual Multimedia Resource Function

Contents


1 Introduction

This document provides an overview of the management model and concepts associated with the License Management (LM) managed area, and describes the licenses required for providing vMRF functions.

A managed area is represented by a group of Managed Objects (MOs) within the Managed Object Model (MOM).

The Network License Server (NeLS) is a centralized license control server that is located inside the customer network. NeLS provides services to the License Manager on one or more Managed Elements (MEs). The product supports shared capacity between Managed Elements and allows a dynamic capacity distribution among the nodes that need it.

NeLS acts as a central repository for application license keys. When LM is deployed in NeLS mode, new license key files ordered from the Ericsson software supply organization must be installed on NeLS before the corresponding licenses can be used.

2 Functions and Concepts

LM provides a management interface for the ME license keys.

License keys grant the use of purchased functionality or capacity. License keys are generated by the Ericsson software supply organization based on the application licensing model. Licenses are made available in NeLS and do not need to be installed locally. Each license is identified by a license name and version number. All licenses include a start date and an expiration date in addition to other information specified by the application's licensing model.

The ME licenses have the following categories:
Capacity licenses  

Control the number of licensed objects that can be active or used at the same time.
Feature licenses  

Control access to the optional features in an application.

A licensed feature or capacity can no longer be used or granted after the license key expiry. When the expiration date for a reserved license is reached, all affected application instances are notified that the license has expired. An expired license is retained by LM until it has been released by all application instances.

2.1 Modes of Operation

LM operates in the following modes:

2.1.1 Autonomous Mode

The License Manager automatically transitions from Normal mode to Autonomous mode when the connection between LM and NeLS is lost. The ME raises the alarm License Management, Autonomous Mode Activated to indicate this mode. During Autonomous mode, licenses that are already reserved by the client application continue to function normally. However, new licenses cannot be requested. Licenses that were not reserved before LM entered Autonomous mode remain unavailable until communication with NeLS is restored.

Applications can release licenses during Autonomous mode. When a license has been released by all application instances, that license becomes unavailable.

While in Autonomous mode, LM denies any application request for a license that is not already reserved. Application capacity can be restricted during Autonomous mode, as applications cannot increase or decrease the number of capacity tokens and must use what is currently available.

LM can operate in Autonomous mode for a maximum of 24 hours. If communication with NeLS cannot be re-established within this 24-hour window, LM enters Locked mode.

When the NeLS connection goes down, LM waits 3 to 5 minutes before attempting to reconnect for the first time. LM tries to reconnect to NeLS at regular intervals as specified by the NeLSConfiguration.retryInterval attribute. After reestablishing the NeLS connection, LM automatically reverts to Normal mode.

2.1.2 Emergency Unlock Mode

Emergency Unlock mode authorizes access to all licensed features and objects independent of valid licenses. Emergency Unlock is intended to provide or restore system functionality in extraordinary situations temporarily where an essential license cannot be renewed before it expires, or connectivity with NeLS is expected to remain unavailable for an extended period of time.

The Emergency Unlock mode window cannot exceed seven days. During this seven-day window, all application license requests are authorized. All licenses used during Emergency Unlock mode are set to expire at the end of the Emergency Unlock window.

When Emergency Unlock ends, LM automatically attempts to synchronize the granted licenses with NeLS. If synchronization is successful, LM begins operating in Integration Unlock Mode or Normal mode. If the synchronization fails, LM returns to the previous operating mode. These transitions are illustrated in Figure 2 and Figure 1.

2.1.3 Integration Unlock

LM runs in Integration Unlock mode after installation. While in this mode, LM can function without access to official licenses. This mode allows use of the system when access to valid licenses is unavailable.

LM can enter Emergency Unlock mode during the Integration Unlock window, as shown in Figure 1.
Figure 1   License Management State Transitions in Integration Unlock Mode

LM automatically transitions to Normal mode when the Integration Unlock window has expired, recorded by attribute expiration. Any license that was used during Integration Unlock mode for which no valid license key was found expires.

2.1.4 Locked Mode

The License Manager transitions from Autonomous mode to Locked mode if access to the NeLS license repository has not been restored by the end of the 24-hour Autonomous mode window. The ME raises the alarm License Management, Key File Fault to indicate this mode.

While in Locked mode, LM answers all application license requests with a failure. Reserved licenses remain unmodified, but cannot be accessed by the application. During Locked mode, LM tries to reconnect to NeLS at regular intervals. After reestablishing the NeLS connection, LM automatically reverts to Normal mode.

2.1.5 Normal Mode

Normal mode is the default operational state of the LM. During normal operation, the system authorizes only those feature sets and capacity levels that have a valid license in NeLS.

From Normal mode, LM can transition to other operational states, as shown in Figure 2.
Figure 2   License Management State Transitions

3 LM Managed Object Model

For general information about the MOM, MOCs, Managed Objects (MOs), cardinality, and related concepts, refer to Managed Object Model User Guide. The LM MOs are described in Table 1.

Table 1   License Management Managed Object Descriptions

MO

Description

Lm

The root of the LM model, supports activities and describes information related to LM.

AutonomousMode

Autonomous Mode state information.

CapacityKey

Key of a licensed capacity that is available for the Managed Element.The root of the LM model, supports activities and describes information related to LM.

EmergencyUnlock

Emergency Unlock state information.

FeatureKey

The root of the LM model, supports activities and describesKey of a licensed feature that is available for the Managed Element.

IntegrationUnlock

Integration Unlock state information.

NeLSConfiguration

NeLS configuration parameters.

4 Configuration Management

The following operations can be performed by the user and are described in Operating Instructions using the ECLI:

5 Fault Management

The LM-related alarms are described in Table 2.
Table 2   License Management Alarms

Alarm Name

Description

License Management, Autonomous Mode Activated

Raised in Autonomous mode after LM losing its connection to the license repository.

License Management, Emergency Unlock Reset Key Required

Raised in Emergency Unlock mode when counter activationsLeft is decremented. The severity increases as the counter is decremented. Cleared after a replenishment followed by a refresh of the license inventory.

License Management, Key File Fault

Raised in Locked mode when the license repository used by LM is unavailable. An unavailable license repository prevents the ME from using licensed features and functionality.

6 vMRF Licenses

This section contains information about the following licenses applicable for vMRF services:

  • Consumer Communication base package for basic vMRF functions

  • Enhanced Voice Services value package for the use of EVS

Table 3   vMRF Licenses

License

FAJ Number

Base or Value Package

Consumer Communication Base Package

FAJ 801 0891

Base

Enhanced Voice Services Value Package

FAJ 801 0893

Value

6.1 Consumer Communication Base Package

Table 4   Consumer Communication License

License Property

Description

FAJ Number

FAJ 801 0891

Version

R1

Type

Capacity license

License Aspect
The following basic vMRF functions are subject to the Consumer Communication license (along with connection to a NeLS server):

  • Tone sending

  • Announcements

  • DTMF detection

  • Multi-party audio calls (that is, audio conferencing)

If the license is absent or expired, the License Manager transitions to locked mode, and basic vMRF functions are disabled. In this case, the License Management, Key File Fault alarm is raised.

Activation

The capacity license is activated by installing license key files on NeLS.

Expiry

Licensed capacity can no longer be used or granted after the license key expiry. When the expiration date for a reserved license is reached, all affected application instances are notified that the license has expired. An expired license is retained by LM until it has been released by all application instances.

6.2 Enhanced Voice Services Value Package

Table 5   Enhanced Voice Services License

License Property

Description

FAJ Number

FAJ 801 0893

Version

R1

Type

Capacity license

License Aspect

The use of the EVS codec is subject to the Enhanced Voice Services license (along with connection to a NeLS server). If the license is absent or expired, the License Manager transitions to locked mode, and the use of EVS is disabled. In this case, the License Management, Key File Fault alarm is raised.

Activation

The capacity license is activated by installing license key files on NeLS.

Expiry

Licensed capacity can no longer be used or granted after the license key expiry. When the expiration date for a reserved license is reached, all affected application instances are notified that the license has expired. An expired license is retained by LM until it has been released by all application instances.
Legal |© Ericsson AB 2017–2019