Mini-Link TN R4 Licenses Installation

Public
INSTRUCTION 1 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

For your Information Receiver

S/SDLDCA Gustavo Lugo S/SDLDCP Hermes Cermeño
S/SDLDCA Adrian Boully

Mini-Link Traffic Node Licenses Installation

 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 2 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

1 Introduction
This document provides instructions on how to perform license management operations together
with instructions on how to do them.

Licenses for optional features are distributed in the form of license keys in a License Key File (LKF),
which is stored on the Removable Memory Module (RMM) on the NPU.

Depending on which plug-in units are installed, all Network Elements (NEs) have a baseline of
features that are available without licenses. If the installed NPU has an RMM, the set of available
features can be expanded by installing licenses, that is, license keys that enable additional features
in the NE. Depending on how the equipment was ordered, licenses can either be preinstalled at
delivery or be installed later.

2 Workflow
Note:
MINI-LINK Craft is used to install licenses on a single NE. To be able to install on many NEs
at the same time, ServiceOn Microwave R8 is required. For more information regarding
ServiceOn Microwave, see the corresponding Customer Product Information.

The license management operations shown in Figure 1 are available in MINI-LINK Craft.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 3 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

2.1 Adding Optional Features to an NE

In order to add optional features to an NE, follow the process shown in Figure 2.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 4 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

Figure 2 Adding Optional Features to an NE

3 Viewing Available Optional Features

Based on the hardware and software, the system keeps a list of all optional features that can be
used. The NE also keeps track of how many licenses are installed for each feature and how many of
those licenses are used.

To view available optional features, license availability, and license usage, do the following:

1. In the Management Tree , right-click the NE.

2. Point to Tools and click Licenses to view the Licenses page.

The Installed column contains a summary of all installed licenses from all LKFs on the RMM.

The Used column shows how many licenses that are needed for the current configuration, that is,
how many optional features that are used. If the value in the Used column is greater than the
corresponding value in the Installed column, the NE is using optional features without licenses. If
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 5 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

the value in the Used column is less than the corresponding value in the Installed column, the NE
has licenses for unused features.

The Status column shows the status of the optional feature:

 OK — The feature is supported by the NE and there are no warnings or errors.

 Not Supported — The feature is not known by the NE.
 Warning — One or more licenses are missing for the feature.
 Newly Installed — One or more licenses for the feature have recently been installed. The
feature will remain in this status until it is used.

4 Viewing a List of Stored LKFs

An RMM may store several LKFs, provided they have different issuers.

To see a list of all stored license files, do the following:

1. In the Management Tree, right-click the NE.

2. Point to Tools, click Licenses.
3. On the Licences page, click License File Overview to view the License File Overview
page.

This page shows a list of features that are possible to activate with licenses. This list of features is
based on the current hardware configuration.

Note:
If you have installed licenses for features that cannot be used in the current hardware
configuration, those features will also be shown in the list. That is, they are shown, but
cannot be activated.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 6 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

Figure 146 The Licenses Page

 Fingerprint — The fingerprint of the RMM on the NPU.

 NE Name — The name of the NE.
 Feature List — A list of optional features that are possible to activate with
licenses.
o Number — The product number of the optional feature.
o Name — The description of the optional feature.
o Installed — The number of installed licenses for the optional feature.

If this value is greater than the corresponding value in the Used column,
the NE has licenses for unused features.

o Used — The number of used optional features.

If this number is greater than the corresponding number in the Installed

column, the NE is using optional features without licenses.

o Status — The status of the optional feature.

 OK . The feature is supported by the NE and there are no

warnings or errors.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 7 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

 Not Supported . The feature is not known by the NE.

 Warning . One or more licenses are missing for the feature.
 Newly Installed . One or more licenses for the feature have been
installed. The feature will remain in this status until it is used.

5 Viewing Optional Features with Installed Licenses

Licenses for optional features are contained within an LKF, which is provided from an issuer. There is
one LKF per issuer. The NE keeps track of which licenses are installed from which LKF.

If several LKFs contain licenses for the same feature, the list will contain one entry for each LKF. For
example, if two LKFs both contains a license key for a specific feature, that feature will appear twice
in the list.

To view a list of features with installed licenses, do the following:

1. In the Management Tree , right-click the NE.

2. Point to Tools , click Licenses .
3. On the Licences page, click License File Inventory to view the License File Inventory
page.

This page shows a list of all features with installed licenses.

Figure 149 The License File Inventory Page

 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 8 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

 Fingerprint — The fingerprint of the RMM on the NPU.

 Reload — Reloads the page.
 Filter — Applies the selected filter to the Feature List .
 Feature List — A list of features with installed licenses.

If several LKFs contains licenses for the same feature, the list will contain one entry for each
LKF. For example, if two LKFs both contains a license for a specific feature, that feature will
appear twice in the list.

6 Requesting Licenses
To create a license request file, do the following:

1. In the Management Tree , right-click the NE.

2. Point to Tools and click Licenses to view the Licenses page.
3. Click Create License Request .
4. In the Quantity column, specify how many licenses you need for each feature.

The default value in the Quantity column is the difference between the value in the
Installed column and the value in the Used column. This value cannot be negative.

5. Click Save License Request to save the license request to a file.

6. Send the license request to your local Ericsson representative.

The content of the license request file can also be viewed using Excel:

1. In the Windows File Manager , right-click the license request file.

2. Click Open With... .
3. In the list, click Microsoft Office Excel.

This page is used to create a license request file.

 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 9 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

Figure 147 The Create License Request Page

 Fingerprint — The fingerprint of the RMM on the NPU.

 NE Name — The name of the NE.
 Feature List — A list of optional features that are possible to activate with licenses.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 10 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

Clicking a feature in the list opens the License File Inventory page , filtered on that
feature.

o Number — The product number of the optional feature.

o Name — The description of the optional feature.
o Installed — The number of installed licenses for the optional feature.

If this value is greater than the corresponding value in the Used column, the NE has
licenses for unused features.

o Used — The number of used optional features.

If this number is greater than the corresponding number in the Installed column, the
NE is using optional features without licenses.

o Status — The status of the optional feature.

OK . The feature is supported by the NE and there are no warnings or errors.


Not Supported . The feature is not known by the NE.

Warning . One or more licenses are missing for the feature.

Newly Installed . One or more licenses for the feature have been installed. The

feature will remain in this status until it is used.
o Quantity — The number of additional licenses to order for this NE.
 Back — Navigates back to the Licenses page (see Section 2.127).
 Save License Request — Saves the license request to a file.

7 Installing Licenses
To install licenses for optional features, an LKF must be stored on the RMM. The LKF is provided by
your local Ericsson representative in response to a license request, and contains both the new license
keys and all license keys that was installed previously.

If a license key must be reinstalled, for example due to a faulty RMM, the installation is done in the
same way as installation of a new license key.

To install an LKF, do the following:

1. In the Management Tree , right-click the NE.

2. Point to Tools , click Licenses .
3. On the Licenses page, click Install Licenses to view the Install Licenses page.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 11 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

This page is used to install licenses from an LKF. The LKF is stored on the RMM on the NPU.

Figure 151 The Install Licenses Page

 Download License Key File — Specifies the LKF to download.

o File Name — The file name of the LKF.
o Browse –– Browse the name of the file.
 FTP — The FTP server from which the LKF should be downloaded.
o Remote server — A permanent FTP server in the network.
o Local server — The FTP server on the local PC.

 User Name — The user name used by the NE to log in to the FTP server. The
FTP server must be configured accordingly.
 Password — The password used by the NE to log in to the FTP server. The FTP
server must be configured accordingly.
 Reset — Resets all settings to their initial values.
 Apply — Applies all changes you have made without leaving the page.

Note:
If the fingerprint in the LKF does not match the RMM fingerprint, you will get a warning. It is
still possible to store the LKF on the RMM, but the licenses cannot be activated, and the LKF
cannot be removed from the RMM.

4.

Note:
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 12 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

Make sure the correct LKF is selected, that is, the LKF that matches the RMM fingerprint.

Under FTP , do one of the following:

 If the LKF resides on a remote FTP server, select Remote server .

 If the LKF resides on the PC, select Local server . Specify the IP
address, User Name and Password .

The LKF must be located in the tn_ftp_home\tn_licenses folder on the FTP

server.

2. In the File Name box, type the file name of the LKF or click Browse to search for the
file.
3. Click Apply .

Note:
If the fingerprint stated in the LKF does not match the RMM fingerprint, a license warning will
be shown. In that case, locate the correct LKF or request a new LKF that matches the RMM
fingerprint.

8 Viewing LKF Details

The LKF is an XML file containing license keys. To see the details of the LKF, view the XML source.

To view the license file details, do the following:

1. In the Management Tree, right-click the NE.

2. Point to Tools, click Licenses.
3. On the Licenses page, click License File Overview to view the License File Overview
page.
4. Click an LKF in the list to see its XML source.

The LKF is protected using a signature, and can therefore not be changed once it has been created.
Any attempt to change the file will make the signature corrupt, and the LKF cannot be used.
Changes can only be made by requesting a new LKF from Ericsson.

This page shows a list of all LKFs that are stored on the RMM.
 Mini-Link TN R4 Licenses Installation
Public
INSTRUCTION 13 (13)

Prepared (also subject responsible if other) No.

S/SDLDCA José G. Hernández

Approved Checked Date Rev Reference

2009-10-27 PA1

Figure 148 The License File Overview Page

 License Key File List — A list of the LKFs stored on the RMM.

Clicking an LKF opens the License File Content page, showing the XML source of the LKF.

o Issuer — The name of the issuer of the LKF, that is, the entity that generated the file.
o Fingerprint — The fingerprint of the RMM for which this LKF was generated.
o Seq.nr — The sequence number of the LKF. This number is incremented every time
an issuer generates an LKF for a specific fingerprint.
o Ver — The version of the LKF format.
o Generation Date — The date when the LKF was generated.
o Installation Date — The date when the LKF was downloaded to the LKF.
o SWLT — The software license target identity as defined by the issuer for
administrative purposes.
o Status — The status of the LKF.