Professional Documents
Culture Documents
V800R011C00
GTL License Application
Instructions
Issue 01
Date 2018-10-30
and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The purchased products, services and features are stipulated by the contract made bet ween Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees or
representations of any kind, either express or implied.
The information in this document is subject to change without notice. E very effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Website: http://www.huawei.com
Email: support@huawei.com
Overview
This document describes the latest Huawei license standards (License Management
Regulations 2.0 (Preliminary), license operations in on-site delivery scenarios from the
Electronic Software Delivery Platform (ESDP) website (http://app.huawei.com/sdp/), and
deployment of carrier IP product licenses.
This document helps technical support engineers learn about license standards and service
scenarios, get familiar with carrier IP product license knowledge, and master common license
operations from the ESDP website.
This document focuses on describing router’s license operations.
Intended Audience
This document is intended for:
Technical support
Maintenance engineers
Symbol Conventions
The symbols that may be found in this document are defined as follows:
Symbol Description
Symbol Description
Change History
Changes between document issues are cumulative. The latest document issue contains all the
changes made in previous issues.
Contents
4 FAQ ................................................................................................................................................ 14
4.1 GTL License Usage .......................................................................................................................................................................14
4.2 Obtaining a Co mmercial GTL License ......................................................................................................................................14
4.3 Obtaining an ESN ..........................................................................................................................................................................14
4.4 Differences Between a GTL License File and a Tradit ional License.txt File ......................................................................15
4.5 Non-Co mmercial Licenses and Commercial Temporary Licenses .......................................................................................15
4.6 Checking Whether the License Is Running Properly ...............................................................................................................16
4.7 Display License Co mmand Output Description .......................................................................................................................19
4.8 Usage Scenarios of the license revoke Co mmand and Risks .................................................................................................23
4.9 Preloaded Licenses Before Delivery ..........................................................................................................................................24
4.10 Principles for License Consolidation on the ESDP Website ................................................................................................25
4.11 License Configuration in the Sales BOQ.................................................................................................................................26
4.12 Co mmon Problems During License Activation......................................................................................................................26
4.13 Causes for GTL License Activation Failures and Solutions ................................................................................................27
4.14 Is a New License Required During a Dev ice Upgrade? .............................................................. 错误!未定义书签。28
1 License Definition
1.1 License
Some features supported by the router product software version can be used only after a GTL
license is available.
1.4 ESDP
The ESDP (Electronic Software Delivery Platform) is a system used by Huawei to generate
and distribute license keys based on the order and application information and manage license
information.
ESDP Website: http://app.huawei.com/sdp/
1.5 ESN
An equipment serial number (ESN) is a character string that uniquely identifies a device, also
known as a "device fingerprint". It is used to deliver a license to a specified device.
1.6 LAC
LAC is short for license authorization code and also referred to as Entitlement ID.
An LAC is generated by ERP or ESDP and used to authenticate users. When users attempt to
log in to the ESDP website, they must input the LAC and ESN to activate the license file.
Huawei LACs are included in license authorization certificates.
1.7 Activation ID
An activation ID is obtained from the Contract Information column in the License
Certificate. Each license file corresponds to an activation ID. You can find a unique license
file by using an activation ID.
1.9 LSN
A License Serial Number (LSN), also called Fulfillment ID, is a license number obtained
from the ESDP. It can be used to search for a license file on the Manage License page of the
ESDP. The LSN of a license can be displayed by using the display license command.
CAUTION
1. Not all new deliver ies can have GTL licenses preloaded (such as the delivery of hardware
components). Therefore, it is necessary to visit http://app.huawei.com/sdp/ and run the
display license command on the device to check that a GTL license has been activated
and whether the license information is consistent with the contract.
2. Before you check whether a GTL license has been preloaded at the production phase, do
not apply for, load, and activate a GTL license at http://app.huawei.com/sdp/.
3. If the license needs to be adjusted after the device is delivered, perform the ESN change
or license adjustment operation.
For details about License Management Regulations 2.0 (Preliminary), visit the following
website:
http://w3.huawei.com/info/cn/doc/viewDoc.do?did=4175571&cata=334081
CAUTION
The temporary license application procedure has been closed, and service personnel can no
longer obtain temporary licenses.
Main Sub
Scenario Scenario
Upgrade
version with
temporarily
license to
solve critical
issues net
Issue cause by UniSTAR
CFG or quotation template
bug
Shift from Non license
control to first License
Control version or shift from
self platform to company
platform
Upgrade Feature Non
version compatibility
among
version
NA Upgrade Contract Modification PERMANENT iSales Product
Non version Manager
sales
Temporary License File Pre-sales in China PERMANENT Product
license delivered Region Manager
application according to
for PO Error Sales Loan Contract NA
commercial Outside China
use Experience Feature Trial 180 days Solution VP Product
new feature at the region Manager
before
purchasing
Software Test and Certification 360 days PDU director Product
license at the region Manager
borrowing
for
commercial
test
Main Sub
Scenario Scenario
Main Sub
Scenario Scenario
3. Fill in the basic information. Ensure that Group is set to Carrier GTS. After filling the
information, click Approve.
4. Wait for approval. After your application is approved, you have the GTS permission.
You can log in to the ESDP system again, and your role information is displayed. An
example is as follows.
2. The parent items and sub-items in the homepage of the ESDP system are described as
follows:
3. To download the required license, activate it first. To activate the license, choose
License Activation > Entitlement Activation in the menu on the left.
A license can be in the Ready, Pooled, or Actived status. Ready indicates that the
license has not been activated. Pooled indicates that the license belongs to the resource
pool. Actived indicates that the license has been activated.
On the Select Entitlement tab, you can set search criteria; otherwise, the search result
may contain a large number of items. After setting search criteria, click Search.
4. Select the desired license from the search result and click Next.
5. On the Bind ESN tab, enter the ESN of the specified device and then click Next.
6. On the Confirm Activation tab, click Confirm to activate the license after confirming
that the license information is correct. Note that this step is used to confirm the license
information only and no license file is generated.
If Success is displayed in the status bar, the license is normal and can be activated.
7. After the license is activated successfully, click Download to download the license file.
In the preceding scenario, if you roll back all license operations, both the license activation
and capacity expansion operations are canceled, and no license exists on the NE.
1. To apply for a fixed-term license, choose Fix-term License > Apply Fix-term License
in the menu on the left, and select a usage scenario.
2. Use the feature trial scenario for example. In the following UI, select the region,
representative office, product solution department, customer, country, and the
opportunity code.
Configuration Upload can be set to Import Unistar db File, Import Commercial
License Template, or Manually Configuration.
Import Unistar db File: The DB file exported from the CFG system is used to apply for
a fixed-term license.
Alternatively, you can fill in Part Number (license control item code) and Data
(application count) in the template provided by the system and then export the
configuration.
For cases in terms of the ESDP system usage, click the following link:
http://3ms.huawei.com/hi/group/2026441/blogs.html
If a port license is returned, the ESDP system obtains the return information, updates the
license, and delivers a W3 task to the service engineer who activated the license.
After receiving the task, the service engineer revokes the license on the related device and
then uses the license revocation code to close the task.
3. Enter the command line interface (CLI). The following message is displayed:
Info: Current license state is Trial. The trial days remains 60 day(s).
……
Master board license state: Trial. The trial days remains 60 day(s).
3.8.3 Service Engineer Uses the Revocation Code to Close the Return
E-flow
Log in to the W3, open the corresponding task, enter the revocation code, and then close the
return e-flow.
4 FAQ
In most cases, front line sales and marketing engineers sell software and licenses along with
devices. The supply chain contract manager records the contract, places a configuration order,
and generates a license file at http://app.huawei.com/sdp/.
The GTL license file is delivered in electronic format, rather than in hard copy.
The frontline engineers need to find and activate the license at ESDP website according to the
contract number and ESN.
The GTL license file downloaded from the http://app.huawei.com/sdp/ website must not be
modified using any text editor. Once the GTL license file is modified, it no longer can be used,
and a new license must be downloaded.
The ESN of a device is obtained by running the display esn command after the device is
powered on.
An ESN is a character string, for example, 0391091071000237. Each of the master and slave
MPUs on a device of the old model has a unique ESN. If a device is equipped with a slave
MPU, the ESN of the slave MPU must be applied for together with that of the master MPU.
The master and slave MPUs on an X3/X8/X16 of the new model have the same ESN, and
therefore, only one ESN is needed.
To obtain the ESN of a device, run the display esn command in the user view.
The PAF or license.txt file can be used to provide only required resources and features. A
Normal PAF or license.txt file is included in the software package. If a special PAF or
license.txt file is required due to a device specification or capac ity change, contact Huawei
R&D engineers.
Differences between a GTL license file and a traditional license.txt file are as follows:
If the PAF/license authorization value changes, the device must be restarted. If the GTL
license authorization value changes, the device does not need to be restarted.
The specification of a PAF or license.txt file can be modified because it is not encrypted.
The specification of a GTL license file cannot be modified because it carries a digital
signature.
A PAF or license.txt file controls service modules more strictly than a GTL license file
does. If a service module is no longer used, a PAF or license.txt file prevents all
commands from being run. With a GTL license file, some commands can still be run, but
they no longer take effect.
A GT L license file is verified at an interval, whereas a PAF or license.txt file is verified
only during starts.
A GT L license file is a .dat file and cannot be incorporated with a PAF or license.txt file.
Non-commercial licenses are used in non-R&D laboratories, R&D tests, software tests,
exhibition, and beta tests. Non-R&D laboratories refer to Huawei internal training, solution
verification, and on-device practice environments.
Note the license application for beta tests. In most cases, commercial (permanent) licenses are
used. If no such licenses are available, apply for fixed-period licenses (valid for 180 days).
Commercial temporary licenses are used in emergent deployment, trial before purchase, test
software loan, post-paid, and network problem handling/emergency recovery scenarios.
Except for network problem handling/emergency recovery scenarios, the marketing product
manager applies for the license, and contracts are required. On-site technical support
engineers can obtain the license from the marketing product manager. Alternatively, they c an
obtain the test and loan contract from the marketing product manager and obtain the license
from the ESDP website.
1. Check whether the ESN in the license file is the same as that on the device and whether
the device models are the same.
2. Check the compatibility between the license control items that are being used by the
device and those in the new license file. Ensure that the number of new license functions
and license control items is no less than the current number; otherwise, services may be
interrupted.
3. Check whether the master and slave main control boards save the same license file in
their CF cards.
After the license is activated, check its status. NE40E V800R011C00 is used as an example.
Display the license activation information.
<HUAWEI>display license
Active License : cfcard:/NE40E-X16AV800R011C00_20170922142353746.dat
License state : Demo
Revoke ticket : No ticket
LCR5S4IPSEC00 Resource 1 NetEngine40E IPSec Function License for VSU Series Units
LCR5BRAS0B Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUF-480
LCR5BRAS0C Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUI-480
Master board license state: Demo. The license for the current configuration will expire
in 26 day(s).
Apply for authentic license before the current license expires.
Check whether the Authorize type, Expired date, and the number of control items of the
GTL license are the same as those stated in the contract.
In most cases, the license status is Normal. In V600R002 or later, the license status of only the
master main control board is displayed, and the license of the slave main control board is
activated during master/slave main control board switchovers.
After the Expired date of a fixed-period license elapses or when a commercial permanent
license is revoked, the license status becomes Trial, and the license goes to a 60-day trial
period, and alarms and messages are generated. After a license is activated, but its ESN is
different from that of the device, the license also goes to a 60-day trial period.
Check all the service resources controlled by the GTL license and information about the
boards to which the GTL license is applied.
Check whether the number of used resources is the same as the actual number.
<HUAWEI>display license
Active License : cfcard:/NE40E-X16AV800R011C00_20170922142353746.dat
License state : Demo
Revoke ticket : No ticket
LCR54020G00 Resource 1 NetEngine40E&80E 20Gbps capacity License for VSU Series Units
LCR5CLCK04 Resource 1 NetEngine40E 1588v2 Function License for LPUI-21-L
LCR5BTOA07 Resource 1 NetEngine40E L3VPN Function License for LPUI-120-B
LCR5BTOA08 Resource 1 NetEngine40E L3VPN Function License for LPU F-120-B
LCR5BTOA05 Resource 1 NetEngine40E L3VPN Function License for LPUI-240-B
LCR5BTOA06 Resource 1 NetEngine40E L3VPN Function License for LPUF-240-B
LCR5CLCK05 Resource 1 NetEngine40E 1588v2 Function License for 120 Series Units
LCR5CLCK06 Resource 1 NetEngine40E 1588v2 Function License for 240 Series Units
LCR5BRAS05 Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUF-120
LCR5BRAS06 Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUF-240
LCR5BRAS09 Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUI-120
LCR5BRAS10 Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUI-240
LCR5S40CLCK06 Resource 1 NetEngine40E 1588v2 Function License for 480 Series Units
LCR5IPFPM01 Resource 1 NetEngine40E IP Performance Measure License(IP FPM) for LPUI-21-L
LCR5IPFPM02 Resource 1 NetEngine40E IP Performance Measure License(IP FPM) for 50G Series
Units
LCR5IPFPM03 Resource 1 NetEngine40E IP Performance Measure License(IP FPM) for 100G
Series Units
LCR5IPFPM04 Resource 1 NetEngine40E IP Performance Measure License(IP FPM) for 200G
Series Units
LCR5S400FPM05 Resource 1 NetEngine40E IP Performance Measure License(IP FPM) for 400G
Series Units
LCR5S40VA1C00 Resource 1 NetEngine40E Virtual Access Host License for 1 Client
LCR5S40VA5C00 Resource 1 NetEngine40E Virtual Access Host License for 5 Client
LCR5S40VAEC00 Resource 1 NetEngine40E Virtual Access Host License for 20 Client
LCR5EDSG01 Resource 2048 NetEngine40E OTT Service Boost Quantity License Annual Fee(per
1k OTT services)
LCR5S400FPM06 Resource 1 NetEngine40E IP Performance Measure License(IP FPM) for 1T
Series Units
LCR5S40CLCK07 Resource 1 NetEngine40E 1588v2 Function License for 1T Series Units
LCR5S40L3VN09 Resource 1 NetEngine40E L3VPN Function License for LPUI-1T-B
LCR5S40HT1000 Resource 1 NetEngine40E 10Gbps High Throughput License
LCR5S40L3VN0A Resource 1 NetEngine40E L3VPN Function License for LPUI-480-B
LCR5S40L3VN0B Resource 1 NetEngine40E L3VPN Function License for LPUF-480-B
LCR5S40IPTQ00 Resource 1 NetEngine40E IPSec Tunnels Quantity(500)
LCR5S00VCPE01 Resource 1 NetEngine40E vCPE Ending Device Quantity License (per 1k ending
devices)
LCR5S4IPSEC00 Resource 1 NetEngine40E IPSec Function License for VSU Series Units
LCR5BRAS0B Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUF-480
LCR5BRAS0C Resource 1 NetEngine40E PPPoE/IPoE Function License for LPUI-480
Master board license state: Demo. The license for the current configuration will expire
in 26 day(s).
Apply for authentic license before the current license expires.
After the display license command is run, the message displayed for each state is as follows:
Demo state:
Master board license state: Demo. The license for the current configuration will expire
in 70 days. Apply for authentic license before the current license expires.
Trial state:
Master board license state: Trial. The license for the current configuration will expire
in 50 days. Apply for authentic license before the current license expires.
Emergency state:
Master board license state: Emergency. The license for the current configuration will
expire in 6 days.
Normal state:
Product version V800R011C00 The version number of the current license file
can be different from the device version. If the
version number displayed is different from that
of the startup file of the device, check whether
there are unsupported license control items.
License Serial LIC201709227BMZ5 After applying for a license file, a unique LSN
No 0 is generated by default.
Creator Huawei Technologies Huawei is the creator of the license file.
Co., Ltd.
Created Time 2017-09-22 14:23:53 Created time for the license file, in
YYYY-MM-DD hh:mm:ss format.
Feature name CRFEA1 A feature is a collection of control items. The
control items within the same feature represent
an independent control item of the feature and
share the same expiry date. There are multiple
feature segments, and each of them has its own
name. CRFEA1 is a feature name.
Authorize type demo The Authorize type of license files includes
COMM and DEMO.
COMM: a commercial license file, mainly on
live networks.
DEMO: a fixed-period license file, mainly used
in R&D, test, and non-commercial scenarios.
Master board Demo The current four license states include Default,
license state Normal, Demo, Emergency, and Trial.
Default state: indicates that the license is
invalid. The state is not displayed, and only a
message is displayed, indicating that the license
has not been activated.
Normal: indicates that resource items and
control items can be used. Only COMM-type
license files have the Normal state.
Demo: indicates that resource items and control
items can be used. Only DEMO-type license
files have the Demo state.
Emergency: indicates that the system can run
with the maximum configurations of dynamic
resources for seven days. Each license file can
go into the 7-day emergency state for a
maximum of three times.
Trial: The Trial state lasts 60 days, and in such
state, resource items and control items can be
used, and an alarm is reported every day. When
the 60-day period expires, the license goes to
the Default state, indicating that the license is
invalid.
After the license revoke command is run, a revoke-ticket is generated, and users can use this
revoke-ticket to apply for a new GTL license on the ESDP website without providing the
contract number and ESN.
During the ESN change procedure, the revoke-ticket command speeds up license application.
The revoke-ticket command can be run when the license is in Normal state or in Trial state
due to ESN mismatch.
The characters marked in red in the preceding command output indicate the revoke-ticket.
You can also run the display license revoke-ticket command to obtain it.
Note: The currently used GTL license mechanism keeps only the current revoke-ticket. If a
new GTL license is activated, the previous revoke-ticket is deleted.
If the license fails to be preloaded because the on-site personnel have used it elsewhere before
delivery, the on-site personnel are responsible for obtaining a license after the device is
delivered and powered on.
Deploy the license based on the contract. Do not use it elsewhere before delivery.
Whether a license is preloaded is described as follows:
M8AM16A Yes No -
X1X2 Yes No -
X3/X3A Yes No -
M2E/M2F Yes No -
M2H Yes No -
M2K Yes No -
F1A Yes No -
X8/X8A Yes No -
X3/X3A Yes No -
M2E/M2F Yes No -
M2H Yes No -
M2K Yes No -
F1A Yes No -
NE9000-8 No Yes -
CX6608 No Yes -
The version of the consolidated license is the latest version of the licenses before the
consolidation.
The value of the function item in the consolidated license is calculated using the XOR
operation on the same function items of the licenses before the consolidation. The value
of the resource item in the consolidated license is calculated using the addition operation
on the same resource items of the licenses before the consolidation.
The LSN of the consolidated license is regenerated.
If the number of license files is different from the number of devices because the BOQ is
incorrectly configured, the licenses cannot be deployed or preloaded, complicating on-site
delivery.
If such a problem occurs, the on-site marketing personnel must change the contract.
3. If the version of a license is different from the version of the software package during
license activation, the license goes into Trial state.
4. After the Expired date of a fixed-period license elapses, the license goes into Trial state.
5. The Trial period lasts for 60 days. During the Trial period, the license is still valid, and
the revoke command can be run to obtain another 60-day trial period.
6. The system does not support two consecutive activation attempts for a GTL license with
an ESN or a version different from that of the device.
7. After the revoke command is run for license, the license can no longer be activated.
The GTL license file does The following message is Upload the GTL license to
not exist. displayed: the CF card or root directory
Error: The specified file of the flash and ensure that
does not exist. both the master and slave
MPUs have this file.
The format of the GTL The following message is Upload a GTL license file
license file is incorrect. displayed: with the correct format. The
Error: The filename is
GTL license file is a .dat file,
invalid, and the file name
generated on the ESDP
suffix must be "dat".
website.
The GTL license file is A file error is displayed or Apply for a new GTL license
invalid or an error occurs. the following message is or obtain the original license
displayed: file from the ESDP website.
Info: License file format
invalid.
The GTL license file The following message is Apply for a fixed-period
expires. displayed: GTL license.
Info: License is expired.
The GTL license file is The following message is Apply for a new GTL
invalid. displayed: license.
Info: License is already
revoked.
The GTL license file has The following message is The GTL license file cannot
been activated. displayed: be re-activated.
Info:File has been actived
before!
The product name in a GTL The following message is Choose a GTL license with
license file is inconsistent displayed: the correct product model.
with the product model. Info: Product mismatch.
The resources that a license Any of the following You do not need to activate
file applies for are not messages is displayed: the license file.
controlled. Info: System error
Info: Verify License
failed.
Info: No product features
present in License file.
The GTL license file is The following message is Check whether the ESN or
partially activated. displayed: version is consistent with
Error: Verify license
that of the device. If such
passed with minor errors:
inconsistency exists, apply
for a new license. In this
ESN is mismatched with node
situation, the license goes
esn.
into the Trial period.
Version is mismatched with
node Version.
A license file that does not Either of the following Use a license file that is
match the ESP or software message is displayed: mapped to the ESN and
version run on a device is Info: Verify license
software version.
activated repeatedly. failed.
Info: License with ESN or
Version mismatch activated
repetitively.
When a license of V600R002 is being activated, the product type, ESN, software version, and
license version consistency is checked. If the product type is inconsistent, the license cannot
be activated. If the ESN or version is inconsistent, the license goes into the trial period.
In the following versions, the software and license consistency is not checked (NE/CX/ME
product types included):
Usage of the original GTL license after an upgrade
V6R3C00SPCa00 (VRP
V500R009C01SPCa00) or later
All VRP V8 versions
Other versions (including V300R003, A new GTL license is A new GTL license is
V300R005, V600R001, V600R002, required. required.
V600R003C00SPC900 or earlier)
4.14.2 NE5000E
A device upgrade is a common maintenance operation. Whether a new license is required in
different upgrade scenarios is described as follows:
When a license of V800R009 is being activated, the product type, ESN, software version, and
license version consistency is checked. If a product type inconsistency is detected, the license
cannot be activated.
In the following versions, the software and license consistency is not checked (NE/CX/ME
product types included):
Usage of the original GTL license after an upgrade
Other versions (including V300R007, A new GTL license is A new GTL license is
V800R003, V800R005, V800R006 required. required.
or earlier)
License compatibility is supported. Specifically, the original license can still be used after an
upgrade if only the software is upgraded.
1. The original license can still be used after V800R002 or a later version is upgraded to
V800R009 or a later version. License control items in V5 are not license-controlled in
V8.
2. Because the license version consistency is not checked, a new license may be used on a
device running an old version.
3. Because the license policy may change after the upgrade, some features (only a few)
may no longer be supported or controlled by the license in the target version. The
features that are no longer supported in the target version must be verified in the upgrade
solution review phase. If some features are no longer be controlled by the license, the
functions of the features are contained in the base software package, and the amount of
the display license command output information decreases.
4. In the scenario that a VRP V5 version is upgraded to a VRP V8 version, some features
(only a few) may no longer be supported or controlled by the license in the target version.
The features that are no longer supported in the target version must be verified in the
upgrade solution review phase.