0% found this document useful (0 votes)
337 views71 pages

How To Activate A Router License - Huawei Router License Operation Guide

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
337 views71 pages

How To Activate A Router License - Huawei Router License Operation Guide

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 71

Huawei Router License Operation Guide

How to Activate a Router License

Issue 01
Date 2020-06-28

HUAWEI TECHNOLOGIES CO., LTD.


Copyright © Huawei Technologies Co., Ltd. 2020. All rights reserved.
No part of this document may be reproduced or transmitted in any form or by any means without prior
written consent of Huawei Technologies Co., Ltd.

Trademarks and Permissions

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 between 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. Every 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.

Huawei Technologies Co., Ltd.


Address: Huawei Industrial Base
Bantian, Longgang
Shenzhen 518129
People's Republic of China

Website: https://www.huawei.com
Email: [email protected]

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. i


How to Activate a Router License Contents

Contents

1 License, License Classification, and License Mechanism................................................1


2 Checking Whether a License Has Been Activated Before Delivery........................... 10
3 Applying for and Activating a License File for a Newly Delivered Device.............. 12
4 Activating Hardware RTUs and Service Licenses........................................................... 17
4.1 Activating Hardware RTUs................................................................................................................................................. 17
4.2 Activating Service Licenses................................................................................................................................................ 22

5 Activating a Trial License.................................................................................................... 27


6 Replacing a License with a Commercial License........................................................... 28
7 Revoking a License and Activating Another After the ESN Is Changed (Due to
Part Replacement for Example)............................................................................................ 32
8 Managing a License During Version Upgrade or Downgrade.................................... 35
9 Checking the Remaining Validity Period of a License..................................................41
10 Manually Enabling the Emergency Mode (When a Natural Disaster Occurs or
the Grace Period of the License Is About to Expire)........................................................ 42
11 Using the License Query Tool to View License Items................................................. 43
A Description of Parameters in the License File............................................................... 44
B Common License Commands..............................................................................................51
C Applying for the ESDP Website Permission.................................................................... 55
D Adjusting License Resources Among Multiple Devices (Splitting a License).........57
E Troubleshooting Common License Activation Problems............................................. 59
E.1 The File Does Not Exist (Error: The specified file does not exist)........................................................................ 59
E.2 The License File Format Is Invalid (Error: The format of the license file is invalid)...................................... 60
E.3 ESNs or Software Versions Do Not Match (Error: The ESN or version of the license file does not match
with the device)............................................................................................................................................................................ 60
E.4 Product Types Do Not Match (Error: The product type of the license file does not match with the
device).............................................................................................................................................................................................. 61
E.5 Some License Control Items Are Missing (Warning: No product feature is present in the license file)
............................................................................................................................................................................................................ 62

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. ii


How to Activate a Router License Contents

E.6 The License File Expires (Info: The license file has expired).................................................................................. 62
E.7 Verification Fails Consecutively (Error: Verify license failed).................................................................................62
E.8 How Do I Retrieve a License After It Is Revoked by Mistake?...............................................................................63
E.9 Hardware RTU Activation Fails........................................................................................................................................ 65
E.10 Service License Activation Fails......................................................................................................................................66

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. iii


1 License, License Classification, and License
How to Activate a Router License Mechanism

1 License, License Classification, and


License Mechanism

A license is an agreement in which the supplier authorizes the customer to use


certain functions of the purchased products within a validity period. The physical
form of a license is a license file, also called Global Trotter License (GTL). Some
router features can be used only after a license is obtained and activated.

License File
A license file is an authorization file that controls the capacity and functions of a
product. This file is generated on the Electronic Software Delivery Platform (ESDP)
website (https://app.huawei.com/sdp/) based on the project contract and device
information. In most cases, a license file is preinstalled on a device before device
shipment. Alternatively, Huawei technical support engineers can download the
license file from the ESDP website based on the project contract and the device's
electronic serial number (ESN).
A router license file can be in .xml or .dat format. Figure 1-1 shows an example of
a typical license file in .xml format. For details on versions that support license
files in .xml or .dat format, as well as parameters in license files, see A
Description of Parameters in the License File.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 1


1 License, License Classification, and License
How to Activate a Router License Mechanism

Figure 1-1 License file example

License Classification
Figure 1-2 shows license types.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 2


1 License, License Classification, and License
How to Activate a Router License Mechanism

Figure 1-2 License classification

Licenses are classified as either commercial or non-commercial licenses.


Commercial licenses can be used in scenarios, such as commercial projects, beta
tests, and testing and certification.
Licenses can also be classified as fixed-term or permanent licenses by the validity
period. Currently, the licenses used for commercial projects and purchased licenses
are permanent licenses (referred to as permanent commercial licenses in this
document).
Licenses can also be classified by the object to be activated. Table 1-1 describes
different types of licenses.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 3


1 License, License Classification, and License
How to Activate a Router License Mechanism

Table 1-1 License classification by object to be activated


License Description Activation Time Activation
Type Method

License The license file is preinstalled on The license file 3 Applying


file a device before device shipment has been pre- for and
or can be downloaded from the activated before Activating a
ESDP website based on the device shipment, License File
project contract and device ESN. or can be applied for a Newly
Commercial licenses and non- for and activated Delivered
commercial licenses (excluding by Huawei Device
trial licenses) are physically technical support
presented as license files. engineers.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 4


1 License, License Classification, and License
How to Activate a Router License Mechanism

License Description Activation Time Activation


Type Method

Hardwa Hardware RTUs control the valid During project 4.1


re Right ports of boards or box-shaped delivery or service Activating
to Use devices that are sold in usage, Huawei Hardware
(RTU) consumption model (CM). If technical support RTUs
hardware RTUs are not activated engineers or
for such ports as GE/10GE/25GE/ service
40GE/50GE/100GE/ configuration
400GE/POS/E1 on the boards or engineers
box-shaped devices sold in CM, activate hardware
the use of these ports is RTUs for specified
restricted. The restriction ports based on
includes, but is not limited to, the number of
the following: The bandwidth of purchased
the GE/10GE/25GE/40GE/50GE/ hardware RTUs.
100GE/400GE port is limited to
100 Mbit/s by default, or the
port cannot go up; by default,
the bandwidth of a POS
interface is limited to 5 Mbit/s;
serial ports cannot be created on
E1 ports.
Hardware RTUs' license item
descriptions contain Port Enable
RTU. Hardware RTUs control
resource allocation. That is,
purchased resources (such as 10
x 100G) are allocated to
specified ports based on the
hardware RTUs. To obtain the
slots of the CM boards housing
the ports (hereinafter referred to
as CM ports) for which hardware
RTUs are to be activated, run the
active port-basic slot ?
command in the license view.
NOTE
Boards with a silkscreen or
description containing CM are CM
boards. However, a small number of
boards whose silkscreen or
description does not contain CM
may also be CM boards.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 5


1 License, License Classification, and License
How to Activate a Router License Mechanism

License Description Activation Time Activation


Type Method

Service A software license control item During project 4.2


license that controls one or more delivery or service Activating
services. usage, Huawei Service
The display license command technical support Licenses
output shows that service engineers or
licenses are classified into the service
following types: configuration
engineers enable
● Function control service services for a
license: With Item type being specified board or
Function, this type of license port based on the
is valid for the entire system number of
and does not require separate purchased
activation as it is activated resource control
with the license file. service licenses.
● Resource control service
license: With Item type being
Resource, this type of license
takes effect on the board in a
specified slot or on a specified
port. For this type of license,
you need to run the activation
command provided in the
display license command
output for each resource
control service license to
enable services on specified
boards or ports.
For details about how to check
the description of each service
license, see 11 Using the
License Query Tool to View
License Items.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 6


1 License, License Classification, and License
How to Activate a Router License Mechanism

License Description Activation Time Activation


Type Method

Trial License control item that A trial license can 5 Activating


license supports trial use. A trial license be activated only a Trial
can be enabled twice for each R when no other License
version, and can be used for a activated license
maximum of 90 days each time file (including
it is enabled. When the trial commercial and
period ends, the controlled non-commercial
features become invalid licenses) exists on
immediately or after the device the device.
is restarted. These controlled
features can still be used only if
a commercial license is
purchased.
To view all trial license control
items and supported resources,
run the display license trial
command.

In the following example, LCR8S8KVBSLCP is a hardware RTU, and


LCR8S8KXMSCCP is a resource control service license.
<HUAWEI> display license
...
Item name Item type Value Description
-------------------------------------------------------------
CR8S8KXMSCCP -- 32 NetEngine 8000 10G MACsec Port Function License(per 10G)
LCR8S8KXMSCCP Resource 32 NetEngine 8000 10G MACsec Port Function License(per 10G)
LCR8S8KVBSLCP -- 64 NetEngine 8000 50G Port Enable RTU(per 50G/40G)
LCR8S8KVBSLCP Resource 64 NetEngine 8000 50G Port Enable RTU(per 50G/40G)
...

Item name (View)Resource License Command-line


-------------------------------------------------------------
LCR8S8KXMSCCP (License)active port-macsec slot <slot-id> card <card-id> port <port-list>
LCR8S8KVBSLCP (License)active port-basic slot <slot-id> card <card-id> port <port-list>
...

License Mechanism
Based on the license loading and running status, the license module has several
states, as listed in Table 1-2.

Table 1-2 States of the license module

State Description Handling


Suggestion

Default This state applies when no license file is Apply for and
activated after device shipment, or when activate a license.
the license file is not reactivated after the
grace period expires.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 7


1 License, License Classification, and License
How to Activate a Router License Mechanism

State Description Handling


Suggestion

Normal This state applies when a permanent None.


commercial license is running normally
after being activated.

Emergency This state applies when the device None.


operates with the maximum specifications
of existing dynamic resource items
(resource items that are not included in
the license are not controlled in some
earlier versions). This state can be
considered as a temporary state when
license control items are not under
restriction. The emergency mode can be
enabled a maximum of three times for
each version, and for a maximum of
seven days each time.

Demo This state applies when a fixed-term Apply for and


license is running normally after being activate a permanent
activated. commercial license
before the period
ends.

Trial This state applies when the license Apply for and
module is allowed to run based on the activate a new
authorization policy in the Normal or license.
Demo state.
After the state changes from Normal or
Demo to Trial, the Trial state lasts a grace
period of 60 days. If the license module
enters the Trial state from Demo state
and the license revoke command is run
before the grace period expires, the
license automatically enters another 60-
day grace period.

Figure 1-3 shows license state transitions.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 8


1 License, License Classification, and License
How to Activate a Router License Mechanism

Figure 1-3 License state machine

Table 1-3 describes all the events that trigger license state transitions.

Table 1-3 License state machine description


No. Trigger Event

0 A license file fails to be activated, and the license module is not


allowed to enter the grace period due to the cause of the
activation failure.

1 A permanent commercial license file is successfully activated.

2 A fixed-term license file is successfully activated.

3 A trial license is activated, or license file activation fails and the


license module is allowed to enter the grace period (for example,
ESNs or versions do not match for the first time).

4 A permanent commercial license becomes invalid. For example,


the license is manually revoked for license replacement.

5 The grace period expires.

6 A fixed-term license becomes invalid. For example, it expires


automatically or is manually revoked.

7 The emergency mode is manually enabled.

8 The emergency mode expires after running for seven days.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 9


2 Checking Whether a License Has Been Activated
How to Activate a Router License Before Delivery

2 Checking Whether a License Has Been


Activated Before Delivery

For most routers, a license is obtained, loaded, and activated according to the
contract order during the production phase. This topic lists the products that
support license pre-activation, and any products not included in the list do not
support license pre-activation. If hardware is delivered in separate parts, for
example, a device set is purchased through multiple orders or Bills of Quotation
(BOQs), license pre-activation may fail. In this case, check the device status.

Procedure
Step 1 Log in to the device.
Step 2 In the user view, check the state of the license module.
display license state
Info: No license is activated.

If No license is activated is displayed, the license module is in the Default state,


and the license is not pre-activated. In this case, go to 3 Applying for and
Activating a License File for a Newly Delivered Device. If Current license state
is Normal is displayed, the license has been pre-activated. In this case, go to the
next step.
Step 3 Check license items.
display license

Check the license items based on the project contract and service requirements. If
any exceptions are found, contact project sales personnel. If the license needs to
be replaced, go to 6 Replacing a License with a Commercial License.

----End

Products That Support License Pre-activation


Table 2-1 lists the products that support license pre-activation.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 10


2 Checking Whether a License Has Been Activated
How to Activate a Router License Before Delivery

Table 2-1 Products that support license pre-activation


Product Entire System or Series Support License Pre-
activation

NetEngine X4/X8 No
8000
M8/M14 Yes

M1/M6 Yes

F1A Yes

NE40E X16/X16A No

X3/X3A/X8/X8A Yes

M2H/M2K/M2K-B Yes

F1A Yes

ME60 X16/X16A No

X3/X8/X8A Yes

NE9000 NE9000-20 No

NE9000-8 No

NE5000E NE5000E No

NE20E S4/S8/S16/S8A/S16A Yes

S2E/S2F Yes

NE05E&NE08E NE05E-SQ/SR/S2, NE08E-S6E/S9 Yes

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 11


3 Applying for and Activating a License File for a
How to Activate a Router License Newly Delivered Device

3 Applying for and Activating a License


File for a Newly Delivered Device

For a device with no pre-activated license, Huawei technical support engineers


must download a license from the ESDP website based on the contract order,
upload the license to the device, and then activate the license.

Prerequisites
● The project contract order has been recorded in the enterprise resource
planning (ERP) system.
● The license certificate delivered with the device has been obtained.
● The task outlined in C Applying for the ESDP Website Permission has been
completed.

Context
Huawei sales engineers sell both software and licenses when selling devices. After
the contract administrator of the supply chain records the contract order in the
ERP system, the ESDP platform automatically generates a license file. Huawei
technical support engineers can then search for and download the license file
from the ESDP website based on the contract number.

Downloading a license file also requires the device's ESN, which is a character
string that uniquely identifies a device. The ESN is used to ensure that the license
is authorized for a specified device.

Procedure
Step 1 In the user view, check and record the device's ESN.
display license esn
MainBoard:
ESN: 2102352168P0B2333333

Record the last 20 or 16 characters of the ESN. If multiple devices are involved,
record all the involved ESNs.

For an NE5000E CCC-0 cluster, record the ESNs of the two CLCs. For an NE5000E
CCC-2 cluster, record the ESNs of the two CCCs.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 12


3 Applying for and Activating a License File for a
How to Activate a Router License Newly Delivered Device

If the device has been connected to NCE-IP or U2000, you can choose
Maintenance > NE Software Management > NE License Management > NE
License Maintenance on NCE-IP or choose Administration > NE License
Management > NE License Maintenance on U2000 to export NE information
(such as ESNs) in batches. In addition, you can load and activate license files on
the NMS page. For details about the operations on the NMS, see the NMS online
help.
Step 2 Download the license file.
1. Log in to the ESDP website (https://app.huawei.com/sdp/).

All operations on the ESDP website referred to in this document are performed by
Huawei technical support engineers. If you are not a Huawei technical support
engineer, contact the corresponding personnel. Note that the ESDP website is subject
to constant updates.
To obtain detailed operation guides and information relating to online support
personnel, click Help in the upper right corner of the ESDP website.
2. In the navigation tree, choose License Activation > Entitlement Activation,
as shown in Figure 3-1.

Figure 3-1 Entitlement activation

3. Enter Huawei Contract No. or other search criteria, click Search & Refresh,
select one or more entitlement records that meet the search criteria, and click
Next.
4. Enter ESN and Equipment (Node) Name, and click Next, as shown in Figure
3-2.
For an NE5000E CCC-0 cluster, enter the ESNs of two CLCs and separate them
with a comma (,). For an NE5000E CCC-2 cluster, enter the ESNs of two CCCs
and separate them with a comma (,).

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 13


3 Applying for and Activating a License File for a
How to Activate a Router License Newly Delivered Device

Figure 3-2 Binding ESNs

This operation will merge the new entitlement with any existing entitlement
already bound to the device.

If a fixed-term license has been bound to the device and you want to replace
it with a permanent commercial license, select No in Merge. However, if you
still need to use some items from the fixed-term license, select Merge in
Merge.

If the license resources in an entitlement need to be allocated to multiple


devices, adjust resource allocation after performing this step. For details, see
D Adjusting License Resources Among Multiple Devices (Splitting a
License).

The ESDP website allows you to merge only the entitlements with the same customer,
product, and ESN.
Permanent commercial entitlements of different versions can be merged directly, and
fixed-term entitlements of different versions can also be merged directly. After
entitlements of different versions are merged, the license version is the latest version
of the entitlements.
Permanent commercial and fixed-term entitlements of different versions cannot be
merged directly. To merge permanent commercial and fixed-term entitlements of
different versions, you must first ensure that they are of the same version through an
upgrade. Otherwise, all license items become fixed-term. For details about license
upgrade, see 8 Managing a License During Version Upgrade or Downgrade.
If multiple permanent commercial entitlements are merged for a function control
license item, the result is a set; that is, if any of the entitlements supports a function,
the function is supported after the entitlements are merged. If multiple permanent
commercial entitlements are merged for a resource control license item, the sum of
the resource values in all the entitlements is used as the value of this resource item.
5. After confirming that the information is correct, click Activate License and
then click Download to save the license file locally.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 14


3 Applying for and Activating a License File for a
How to Activate a Router License Newly Delivered Device

NOTICE

You can use the text editor to open the license file to view information such
as the license version, ESN, and license item information. For details about a
license file, see A Description of Parameters in the License File.
Do not modify the content of the license file, as it contains signature
verification information. If you modify the license file by mistake, it will
become invalid and cannot be activated. In this case, you need to download
the license file again.

Step 3 Upload the license file.


1. Upload the license file.
A license file can be in .xml or .dat format. In addition, a license file in the
format of a .zip package can be activated directly. As such, only an .xml, .dat,
or .zip file can be uploaded in this step.
For this example, assume that the IP address of the local PC is 10.10.10.10
and the SFTP server service is enabled. The license file
LICXXXX_VXXXRXXX_XXXX.xml has been stored in the root directory of the
SFTP server. In this case, log in to the device and perform the following
operations:
system-view
sftp 10.10.10.10
Trying 10.10.10.10 ...
Press CTRL+K to abort
Connected to 10.10.10.10 ...
Warning: The negotiated encryption, digest, key exchange or identity key algorithm is insecure. Using
a security algorithm (AES256-GCM, SHA2-256, SHA2-512, diffie-hellman-group-exchange-sha256) is
recommended.

Please input the username: user01


Enter password:**********
sftp-client>get LICXXXX_VXXXRXXX_XXXX.xml
...
sftp-client>quit
Bye
quit

2. (Optional, and applicable only to a device with two main control boards)
Copy the license file to the slave main control board.
copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml
Info: copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml to slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml? [Y/
N]:Y

Step 4 Verify the license file.


license verify LICXXXX_VXXXRXXX_XXXX.xml
Info: Verify license succeeded.

If Verify license succeeded is displayed, verification is successful. Otherwise,


verification has failed due to an invalid license file, or an ESN, version, or product
type mismatch. For details on how to solve these issues, see E Troubleshooting
Common License Activation Problems.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 15


3 Applying for and Activating a License File for a
How to Activate a Router License Newly Delivered Device

If an ESN or version mismatch occurs on the first occasion, you can still perform the next
step to activate the license file. If activation fails, the license module automatically enters
the Trial state. In this case, obtain and activate a valid license file within the 60-day validity
period.

Step 5 Activate the license file.


license active LICXXXX_VXXXRXXX_XXXX.xml
Now activing the license....done.
Info: Succeeded in activating the license file.

Step 6 Check the hardware RTU and service license items.


display license
Active License : LICXXXX_VXXXRXXX_XXXX.xml
License state : Normal
Revoke ticket : No ticket

RD of Huawei Technologies Co., Ltd.

Product name : XXXX


Product version : VXXXRXXX
License Serial No : LIC202004162VXXXX
Creator : Huawei Technologies Co., Ltd.
Created Time : 2020-04-16 19:30:41
-------------------------------------------------------------
...

Item name Item type Value Description


-------------------------------------------------------------
CR8S8KXMSCCP -- 32 NetEngine 8000 10G MACsec Port Function License(per 10G)
LCR8S8KXMSCCP Resource 32 NetEngine 8000 10G MACsec Port Function License(per 10G)
LCR8S8KVBSLCP -- 64 NetEngine 8000 50G Port Enable RTU(per 50G/40G)
LCR8S8KVBSLCP Resource 64 NetEngine 8000 50G Port Enable RTU(per 50G/40G)
...

Item name (View)Resource License Command-line


-------------------------------------------------------------
LCR8S8KXMSCCP (License)active port-macsec slot <slot-id> card <card-id> port <port-list>
LCR8S8KVBSLCP (License)active port-basic slot <slot-id> card <card-id> port <port-list>
...

Ensure that the license items displayed in the preceding command output meet
the project requirements, including the hardware RTU types, the number of
resources of each hardware RTU type, the function control service license types,
the resource control service license types, and the number of resources of each
service license type. If any exceptions are found, contact project sales personnel. If
the license needs to be replaced, go to 6 Replacing a License with a Commercial
License.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 16


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

4 Activating Hardware RTUs and Service


Licenses

After a license file is activated, hardware RTUs and service licenses must also be
activated to allocate license resources to specific boards and ports.
4.1 Activating Hardware RTUs
Hardware RTUs control the valid ports of boards or boxes that are sold based on
the CM. Some or all restrictions on such ports as GE/10GE/25GE/40GE/50GE/
100GE/400GE/POS/E1 on boards or box-shaped devices sold by CM can be
removed only after hardware RTUs are activated for these ports. If no hardware
RTUs have been purchased, skip this task.
4.2 Activating Service Licenses
A service license controls one or more software features. Resource control service
licenses need to be activated so that related resources are allocated to specified
ports. If no resource control service licenses have been purchased, skip this task.

4.1 Activating Hardware RTUs


Hardware RTUs control the valid ports of boards or boxes that are sold based on
the CM. Some or all restrictions on such ports as GE/10GE/25GE/40GE/50GE/
100GE/400GE/POS/E1 on boards or box-shaped devices sold by CM can be
removed only after hardware RTUs are activated for these ports. If no hardware
RTUs have been purchased, skip this task.

Prerequisites
The license file has been activated.

Context
If hardware RTUs are not activated for such ports as GE/10GE/25GE/40GE/50GE/
100GE/400GE/POS/E1 on the boards or box-shaped devices sold in CM, the use of
these ports is restricted. These restrictions include, but are not limited to, the
following: The bandwidth of the GE/10GE/25GE/40GE/50GE/100GE/400GE port is
limited to 100 Mbit/s by default, or the port cannot go up; by default, the
bandwidth of a POS interface is limited to 5 Mbit/s; serial ports cannot be created

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 17


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

on E1 ports. To obtain the slots of the CM boards housing CM ports, run the
active port-basic slot ? command in the license view.

Boards with a silkscreen or description containing CM are CM boards. However, a small


number of boards whose silkscreen or description does not contain CM may also be CM
boards. As such, running the active port-basic slot ? command to obtain the slots of the
CM boards housing CM ports is recommended.

The license item descriptions of hardware RTUs contain Port Enable RTU.
Hardware RTUs control resource allocation, whereby purchased resources (such as
10 x 100G) are allocated to specified ports based on the hardware RTUs.

Hardware RTUs are classified into enabling hardware RTUs and upgrade hardware
RTUs.

● Enabling hardware RTUs: enable the specified bandwidth for ports. For
example, 10G Port Enable RTU enables the 10 Gbit/s bandwidth for ports.
● Upgrade hardware RTUs: increase the port bandwidth from a specified value
to a larger value (under the condition that the physical port rate is the target
bandwidth). For example, 10G upgrade to 25G increases the port bandwidth
from 10 Gbit/s to 25 Gbit/s.

Generally, a GE/10GE/25GE/40GE/50GE/100GE/400GE/POS/E1 CM port requires a


corresponding GE/10GE/25GE/40GE/50GE/100GE/400GE/POS/E1 Port Enable RTU
for bandwidth restriction removal.

A high-bandwidth physical port can be manually configured to operate in a low-


rate mode using the port split command. For example, a 100GE interface can be
configured as one 50GE interface, one 40GE interface, four 25GE interfaces, four
10GE interfaces, or ten 10GE interfaces. According to the port support mode and
sales strategy, a small number of hardware RTUs with specific codes for routers
can be allocated to physical ports in combination mode. For example:

● A 100GE port is used as a 50GE port after one 50G Port Enable RTU is
allocated to the port (under the condition that the port rate has been
manually set to 50 Gbit/s), and the bandwidth restriction can be canceled
(meaning that the port is used as a 100GE port) if two 50G Port Enable RTUs
are allocated to the port.
● A 25GE port is used as a 10GE port after one 10G Port Enable RTU is
allocated to the port (under the condition that the port rate has been
manually set to 10 Gbit/s), and the bandwidth restriction can be canceled if
another 10G upgrade to 25G is allocated to the port.

You can use the license query tool to check whether an RTU can be allocated in
combination mode based on the RTU code (Item name displayed in the display
license command output). For details, see 11 Using the License Query Tool to
View License Items.

To activate hardware RTUs, you only need to specify the ports for which the
hardware RTUs are activated. The allocation result is automatically determined by
the device based on the port rate, RTU type, and number of RTUs. For example, if
five 10G Port Enable RTUs and three 10G upgrade to 25Gs have been purchased
for a 32x25GE CM subcard, ports 0 to 2 use the default mode, and ports 3 and 4
have been set to the 10G rate mode, after the RTUs are activated for ports 0 to 4,

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 18


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

bandwidth restrictions on ports 0 to 2 are removed, and ports 3 and 4 are used as
10GE ports, as shown in Figure 4-1.

Figure 4-1 Hardware RTU allocation example

Procedure
Step 1 Check the slots where CM boards reside and record all the ports for which
bandwidth restrictions are to be removed.
system-view
license
active port-basic slot ?
<1,2> The available slot
return
display interface brief
PHY: Physical
*down: administratively down
^down: standby
(l): loopback
(s): spoofing
(E): E-Trunk down
(b): BFD down
(B): Bit-error-detection down
(e): ETHOAM down
(d): Dampening Suppressed
(p): port alarm down
(ld): loop-detect trigger down
(mf): mac-flapping blocked
(c): CFM down
(sd): STP instance discarding
InUti/OutUti: input utility/output utility

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 19


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

Interface PHY Protocol InUti OutUti inErrors outErrors


100GE1/0/0(100M) down down 0% 0% 0 0
100GE1/0/1(100M) down down 0% 0% 0 0
...
25GE2/0/0(10G) down down 0% 0% 0 0
25GE2/0/1(100M) down down 0% 0% 0 0
...
100GE3/0/0 down down 0% 0% 0 0
100GE3/0/1 down down 0% 0% 0 0
...

For all products except the NE5000E, and for NE5000E V800R011C10 and earlier
versions, all ports with (100M) displayed in the display interface brief command
output are CM ports with the default bandwidth restriction, for example,
100GE1/0/0(100M). If the bandwidth restriction in the brackets is not 100M, but
is less than the rate of the physical port, for example, 25GE2/0/0(10G), at least
one enabling hardware RTU has been activated. You need to record both types of
ports.
For NE5000E V800R012C00 and later versions, all CM ports cannot go up by
default (the undo shutdown command cannot be run for the CM ports). That is,
all the ports in the down state in the slots where the CM boards reside have not
been activated with any RTU.
Step 2 Check the available (purchased) hardware RTUs.
display license resource usage port-basic all
FeatureName Descriptions:
====================================================================================
FeatureName Description
--------------------------------------------------------------------------------
LCR8S8KXBSLCQ NetEngine 8000 10G Port Enable RTU for Line Process Unit L(per 10G)
LCR8S8KVBSLCP NetEngine 8000 50G Port Enable RTU(per 50G/40G)
LCR8S8KXBSLCP NetEngine 8000 10G Port Enable RTU(per 10G)
LCR8S8KYBSLCP NetEngine 8000 10G upgrade to 25G Port Enable RTU(per 25G)
LCR8S8KVBSLCQ NetEngine 8000 50G Port Enable RTU for Line Process Unit L(per 50G/40G)
LCR8S8KYBSLCQ NetEngine 8000 10G upgrade to 25G Port Enable RTU for Line Process Unit L(per
25G)

Global license information:


====================================================================================
FeatureName Offline Allocated Activated Available Total
--------------------------------------------------------------------------------
LCR8S8KXBSLCQ 0 0 0 76 76
LCR8S8KYBSLCQ 0 0 0 76 76
LCR8S8KYBSLCP 0 0 0 176 176
LCR8S8KXBSLCP 0 0 0 76 76
LCR8S8KVBSLCQ 0 0 0 40 40
LCR8S8KVBSLCP 0 0 0 140 140
...

The value in the Available column indicates the number of each license item's
remaining resources. You are advised to refer to Table 4-1 when collecting
statistics on the number of available RTUs.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 20


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

Table 4-1 Statistics on the number of available hardware RTUs

Categ Description Number of Remarks (When


ory Ports for Applicable Boards Are
Which the Limited)
RTU Can Be
Activated

Enabli 10G Port Enable RTU ____ ____________________


ng
hard 25G Port Enable RTU ____ ____________________
ware 50G Port Enable RTU ____ ____________________
RTUs
100G Port Enable RTU ____ ____________________

400G Port Enable RTU ____ ____________________

_____ Port Enable RTU ____ ____________________

Upgra ____ upgrade to ____ Port ____ ____________________


de Enable RTU
hard
ware ____ upgrade to ____ Port ____ ____________________
RTUs Enable RTU

____ upgrade to ____ Port ____ ____________________


Enable RTU

Step 3 Plan the range of ports for which RTUs are to be activated based on the list of
ports for which bandwidth restrictions are to be removed, the number of available
RTUs, and service requirements.

Plan the range of ports as required. If the number of ports for which RTUs are to be
activated exceeds the number of purchased license resources, RTU activation will fail for
some ports. The device reports an alarm in such cases.

Step 4 Activate RTUs for the ports as planned.


system-view
license
active port-basic slot slot-id card card-id port port-list
commit

To check the detailed activation command of each license item on the current
device, run the display license command. For some product models (including the
NE8000-M1, and NE8000-M6), the activation command is active port-basic slot
slot-id port port-list (card card-id is not included).
If a port requires multiple RTUs in combination mode during the activation, you
need to run the activation command only once for the port.

Step 5 Check hardware RTU resource usage statistics.


display license resource usage port-basic all
FeatureName Descriptions:
====================================================================================
FeatureName Description
--------------------------------------------------------------------------------

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 21


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

LCR8S8KXBSLCQ NetEngine 8000 10G Port Enable RTU for Line Process Unit L(per 10G)
LCR8S8KVBSLCP NetEngine 8000 50G Port Enable RTU(per 50G/40G)
LCR8S8KXBSLCP NetEngine 8000 10G Port Enable RTU(per 10G)
LCR8S8KYBSLCP NetEngine 8000 10G upgrade to 25G Port Enable RTU(per 25G)
LCR8S8KVBSLCQ NetEngine 8000 50G Port Enable RTU for Line Process Unit L(per 50G/40G)
LCR8S8KYBSLCQ NetEngine 8000 10G upgrade to 25G Port Enable RTU for Line Process Unit L(per
25G)

Global license information:


====================================================================================
FeatureName Offline Allocated Activated Available Total
--------------------------------------------------------------------------------
LCR8S8KXBSLCQ 0 0 76 0 76
LCR8S8KYBSLCQ 0 0 70 6 76
LCR8S8KYBSLCP 0 0 170 6 176
LCR8S8KXBSLCP 0 0 72 4 76
LCR8S8KVBSLCQ 0 0 40 0 40
LCR8S8KVBSLCP 0 0 140 0 140

License detailed information:


====================================================================================
Physical Position FeatureName Needed Count Used Count Active Status
--------------------------------------------------------------------------------
3/0/0 LCR8S8KVBSLCP 2 2 Activated
3/0/1 LCR8S8KVBSLCP 2 2 Activated
3/0/2 LCR8S8KVBSLCP 2 2 Activated
...

Fields in Global license information in the preceding command output are


described as follows:

● Offline: indicates the number of resources used by offline ports (for example,
the boards where the ports reside are powered off or removed).
● Allocated: indicates the number of ports that fail RTU activation due to
insufficient available RTUs, despite the active port-basic command being run.
In this case, the device reports an alarm, and you need to replan the range of
ports for which RTUs are to be activated based on the number of available
RTUs or have the license capacity expanded.
● Activated: indicates the number of ports for which RTUs are successfully
activated.
● Available: indicates the number of remaining license item resources.

Check whether RTUs are activated for ports as planned. If any port in the planned
port range fails to have an RTU activated, return to the previous step for
adjustment.

----End

Troubleshooting
If the activation fails, see E.9 Hardware RTU Activation Fails.

4.2 Activating Service Licenses


A service license controls one or more software features. Resource control service
licenses need to be activated so that related resources are allocated to specified
ports. If no resource control service licenses have been purchased, skip this task.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 22


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

Prerequisites
The license file has been activated. Before allocating service license resources to
CM ports, ensure that hardware RTUs have been activated.

Context
Function control service licenses are valid for the entire system (including CM
boards unless otherwise specified in the license item description) and are
automatically activated with the license file. As such, additional activation is not
required.
Resource control service licenses need to be activated so that related resources are
allocated to specified ports. Some service licenses are used only on CM boards or a
specific board and cannot be allocated to ports on other boards. For details about
license items, contact sales engineers or see 11 Using the License Query Tool to
View License Items.
If the service item corresponding to a sales code contains an initial service
configuration (generally referred to as Initial Bundle) and the initial configuration
contains a default resource authorization (for example, enabling L3VPN&EVPN for
10x10GE and all GE ports), one or more resource control service license items is
displayed for the service item. In this case, the resource control service license
items contain the resource authorization for 10GE and higher-speed ports. For
ports with speeds lower than 10 Gbit/s, the resource control service license items
are automatically activated with the license file and no additional activation is
required.

Procedure
Step 1 Check currently available (purchased) resource control service licenses.
Run the display license command in the user view and record all resource control
service licenses (Item type is Resource, and Description does not contain Port
Enable RTU) and the corresponding activation commands. You are advised to
refer to Table 4-2 when collecting statistics on the number of available resources.
display license
...

Item name Item type Value Description


-------------------------------------------------------------
CR8P00TSYFC0 -- 1 NetEngine 8000 Timing Synchronization Function Package License
LCR8P00TSYFC0 Function YES NetEngine 8000 Timing Synchronization Function Package
License
CR8P00OAMFC0 -- 1 NetEngine 8000 OAM Function Package License
LCR8P002544C0 Function YES NetEngine 8000 OAM Function Package License
CR8S8KXMSCCP -- 152 NetEngine 8000 10G MACsec Port Function License(per 10G)
LCR8S8KXMSCCP Resource 152 NetEngine 8000 10G MACsec Port Function License(per 10G)
CR8S0VCAGGC0 -- 40 NetEngine 8000 50G Core&Aggregation Scenario License(per 50G/
40G)
LCR8S0VCAGGC0 Resource 40 NetEngine 8000 50G Core&Aggregation Scenario License(per
50G/40G)
CR8S0XCAGGC0 -- 152 NetEngine 8000 10G Core&Aggregation Scenario License(per 10G)
LCR8S0XCAGGC0 Resource 152 NetEngine 8000 10G Core&Aggregation Scenario License(per
10G)
...

Item name (View)Resource License Command-line


-------------------------------------------------------------

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 23


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

LCR8S0VCAGGC0 (License)active port-core-aggregation slot <slot-id> card <card-id> port <port-list>


LCR8S0XCAGGC0 (License)active port-core-aggregation slot <slot-id> card <card-id> port <port-list>
LCR8S8KXMSCCP (License)active port-macsec slot <slot-id> card <card-id> port <port-list>
...

Table 4-2 Service license resource statistics

Service Number Activation Command


Name of
Resources

______________ ________ active ____________________ slot slot-id card card-


___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ active ____________________ slot slot-id card card-
___ id port port-list
______________ ________ __________________________________________________
___ _____________________________

______________ ________ __________________________________________________


___ _____________________________

For some product models (including the NE8000-M1, and NE8000-M6), the activation
command is active XXXX slot slot-id port port-list (card card-id is not included). Similar
details will be omitted in the rest of the document.
If the slot ID of a board that does not support the current service license is entered, an error
message will be displayed. To check the slots of the boards that need a service license, run
the active XXXX slot ? command.
For example, to check the slots of the boards that need the MACsec service license, run the
active port-macsec slot ? command in the license view.

Step 2 Plan the ranges of boards and ports for which each service license needs to be
activated based on the available service license resources and service
requirements.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 24


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

Plan the ranges of boards and ports as required. If the number of boards or ports for which
service licenses are to be activated exceeds the number of purchased license resources,
service license activation will fail for some boards or ports. The device reports an alarm in
such cases.

Step 3 Allocate license resources based on the planned ranges.


system-view
license
active XXXX slot slot-id card card-id port port-list
commit

Some service license resources need to be activated by board, and the


corresponding activation command may vary from other activation commands. As
such, run the corresponding activation command according to Table 4-2.
Step 4 Check service license resource statistics.
1. Check the overall service license resource statistics.
display license resource usage
...
--------------------------------------------------------------------------------
FeatureName ConfigureItemName ResourceUsage
--------------------------------------------------------------------------------
CRFEA1 LCR8S0VCAGGC0 40/40
CRFEA1 LCR8S0XCAGGC0 150/152
CRFEA1 LCR8S8KXMSCCP 140/152
...
2. Check service license resource statistics by service.
The following example shows MACsec service license resource statistics.
display license resource usage ?
...
display license resource usage port-macsec all
FeatureName Descriptions:
=================================================================================
===
FeatureName Description
--------------------------------------------------------------------------------
LCR8S8KXMSCCP NetEngine 8000 10G MACsec Port Function License(per 10G)

Global license information:


=================================================================================
===
FeatureName Offline Allocated Activated Available Total
--------------------------------------------------------------------------------
LCR8S8KXMSCCP 0 0 140 12 152

License detailed information:


=================================================================================
===
Physical Position FeatureName Needed Count Used Count Active Status
--------------------------------------------------------------------------------
1/0/0 LCR8S8KXMSCCP 1 1 Activated
1/0/1 LCR8S8KXMSCCP 1 0 No allocated
...

Fields in Global license information in the preceding command output are


described as follows:
– Offline: indicates the number of resources used by offline ports (for
example, the boards where the ports reside are powered off).
– Allocated: indicates the number of ports that fail service license
activation due to insufficient available resources, despite the activation

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 25


How to Activate a Router License 4 Activating Hardware RTUs and Service Licenses

command being run. In this case, the device reports an alarm, and you
need to replan the range of ports for which the service license is to be
activated based on the number of available resources or have the license
capacity expanded.
– Activated: indicates the number of ports for which the service license is
successfully activated.
– Available: indicates the number of remaining license item resources.
Check whether the service license is activated for ports as planned. If any port
in the planned port range fails to have the service license activated, return to
the previous step for adjustment.

----End

Troubleshooting
If the activation fails, see E.10 Service License Activation Fails.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 26


How to Activate a Router License 5 Activating a Trial License

5 Activating a Trial License

After a trial license is activated, you can use some functions provided by the
device free of charge for a short period. To continue using these functions, you are
recommended to purchase and activate a permanent commercial license before
the trial license expires.

Prerequisites
No license file has been activated on the device.

Context
A trial license can be enabled twice for each R version, and can be used for a
maximum of 90 days each time it is enabled. When the trial period ends, the
controlled features become invalid immediately or after the device is restarted.

Procedure
Step 1 Run the license trial enable command in the user view to activate the trial
license.
license trial enable
Warning: This operation will enable the license-controlled feature and can be used only after authorization.
Please apply for a license before the feature expires. Continue? [Y/N]:y
Info: Operating, please wait for a moment...........done.
Info: Succeeded to perform this operation.

Step 2 Check activated trial license items.


display license trial
License trial status : Enable
Remain times :1
Remain days : 89

Feature-name Value Description


------------------------------------------------------------
LCR8SX0SRV6C1 1 NetEngine 8000 SRv6 Function License
LCR8SX0L3VPC1 1 NetEngine 8000 L3VPN Function License
...

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 27


How to Activate a Router License 6 Replacing a License with a Commercial License

6 Replacing a License with a Commercial


License

Scenarios where a license may need to be replaced with a commercial license


include but are not limited to adding hardware RTUs and service licenses or
having their capacities expanded, replacing a non-commercial license with a
commercial license before the non-commercial license enters the grace period,
and replacing a non-commercial license with a commercial license after the non-
commercial license enters the grace period.

Prerequisites
The project contract order corresponding to the target commercial license has
been recorded in the ERP system.

If you only need to adjust license resources among multiple devices with no new contract
involved, see D Adjusting License Resources Among Multiple Devices (Splitting a
License).

Procedure
Step 1 Obtain the target license file.
1. Log in to the ESDP website (https://app.huawei.com/sdp/).
2. In the navigation tree, choose License Activation > Entitlement Activation,
as shown in Figure 6-1.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 28


How to Activate a Router License 6 Replacing a License with a Commercial License

Figure 6-1 Entitlement activation

3. Enter Huawei Contract No. or other search criteria, click Search & Refresh,
select one or more entitlement records that meet the search criteria, and click
Next.
4. Click the button in the ESN column. In the dialog box that is displayed, enter
the ESN, select the target device, and confirm it, as shown in Figure 6-2.

For an NE5000E CCC-0 cluster, enter the ESNs of two CLCs and separate them
with a comma (,). For an NE5000E CCC-2 cluster, enter the ESNs of two CCCs
and separate them with a comma (,).

Figure 6-2 Binding ESNs

This operation will merge the new entitlement with any existing entitlement
already bound to the device.

If a non-commercial license has been bound to the device and you want to
replace it with a commercial license, select No in Merge. However, if you still
need to use some license items in the non-commercial license, select Merge
in Merge.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 29


How to Activate a Router License 6 Replacing a License with a Commercial License

The ESDP website allows you to merge only the entitlements with the same customer,
product, and ESN.
Commercial entitlements of different versions can be merged directly, and non-
commercial entitlements of different versions can also be merged directly. After
entitlements of different versions are merged, the license version is the latest version
of the entitlements.
Commercial and non-commercial entitlements of different versions cannot be merged
directly. To merge commercial and non-commercial entitlements of different versions,
you must first ensure that they are of the same version through an upgrade.
Otherwise, all license items become fixed-term. For details about license upgrade, see
8 Managing a License During Version Upgrade or Downgrade.
If multiple permanent commercial entitlements are merged for a function control
license item, the result is a set; that is, if any of the entitlements supports a function,
the function is supported after the entitlements are merged. If multiple permanent
commercial entitlements are merged for a resource control license item, the sum of
the resource values in all the entitlements is used as the value of this resource item.
5. Click Next.
6. After confirming that the information is correct, click Activate License and
then click Download to save the license file locally.
Step 2 Upload the license file.
1. Upload the license file.
A license file can be in .xml or .dat format. In addition, a license file in the
format of a .zip package can be activated directly. As such, only an .xml, .dat,
or .zip file can be uploaded in this step.
For this example, assume that the IP address of the local PC is 10.10.10.10
and the SFTP server service is enabled. The license file
LICXXXX_VXXXRXXX_XXXX.xml has been stored in the root directory of the
SFTP server. In this case, log in to the device and perform the following
operations:
system-view
sftp 10.10.10.10
Trying 10.10.10.10 ...
Press CTRL+K to abort
Connected to 10.10.10.10 ...
Warning: The negotiated encryption, digest, key exchange or identity key algorithm is insecure. Using
a security algorithm (AES256-GCM, SHA2-256, SHA2-512, diffie-hellman-group-exchange-sha256) is
recommended.

Please input the username: user01


Enter password:**********
sftp-client>get LICXXXX_VXXXRXXX_XXXX.xml
...
sftp-client>quit
Bye
quit
2. (Optional, and applicable only to a device with two main control boards)
Copy the license file to the slave main control board.
copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml
Info: copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml to slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml? [Y/
N]:Y

Step 3 Verify the license file.


license verify LICXXXX_VXXXRXXX_XXXX.xml
Info: Verify license succeeded.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 30


How to Activate a Router License 6 Replacing a License with a Commercial License

If Verify license succeeded is displayed, verification is successful. Otherwise,


verification has failed due to an invalid license file, or an ESN, version, or product
type mismatch. For details on how to solve this issue, see E Troubleshooting
Common License Activation Problems.
Step 4 Activate the license file.
The license file that has been activated does not need to be revoked before you
run the following command to activate the target license file:
license active LICXXXX_VXXXRXXX_XXXX.xml
Now activing the license....done.
Info: Succeeded in activating the license file.

Step 5 (Optional) Delete the original license file.


For example, to delete the XXXX.xml file from a device with two main control
boards, run the following commands in the user view:
delete cfcard:/XXXX.xml
delete salve#cfcard:/XXXX.xml

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 31


7 Revoking a License and Activating Another After
the ESN Is Changed (Due to Part Replacement for
How to Activate a Router License Example)

7
Revoking a License and Activating
Another After the ESN Is Changed (Due to
Part Replacement for Example)

The license file is bound to the device ESN. If the ESN is changed, the license
module automatically enters the grace period. In such cases, you need to obtain
and activate a new license file as soon as possible.

Prerequisites
None

Context
Each ESN uniquely identifies a device and is key to authorizing a license for the
device.

The ESN is associated with the backplane of the device. Generally, the ESN is not
changed unless the subrack is replaced. In abnormal scenarios, if a device fails to
read backplane information, it automatically uses the barcode in main control
board information as its ESN; if the main control board is replaced, the ESN
changes accordingly. To check whether the ESN of the current device is associated
with the backplane or the main control board, run the display elabel backplane
command to view the barcode of the backplane. If the barcode is the same as the
ESN, the ESN is associated with the backplane. Otherwise, the ESN is associated
with the main control board.

Procedure
Step 1 In the user view, check and record the device's new ESN.
display license esn
MainBoard:
ESN: 2102352168P0B2333333

Step 2 Revoke the current license and record the revocation code.

If the revocation code cannot be obtained due to such circumstances as a device


startup failure, go to the next step.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 32


7 Revoking a License and Activating Another After
the ESN Is Changed (Due to Part Replacement for
How to Activate a Router License Example)

license revoke
Warning: The license will enter the Trial state and will not be activated again. Continue? [Y/N]:y
Now revoking the license...................done.
Info: Succeeded in revoking the license. The revoke ticket is LIC20201120YBXXXX:
0E47B21121D40C4BBBBB8E8255A437E6D532XXXX.

Record the revocation code in the preceding command output. You can also run
the following command to view the revocation code:
display License revoke-ticket
Info: The revoke ticket is LIC20201120YBXXXX:0E47B21121D40C4BBBBB8E8255A437E6D532XXXX.

Step 3 Download a new license file.


1. Log in to the ESDP website (https://app.huawei.com/sdp/).
2. In the navigation tree on the left, choose License Commissioning and
Maintenance > ESN Change > Product Hardware Change, as shown in
Figure 7-1.

Figure 7-1 ESN change

3. Enter the recorded revocation code in the Revocation Code text box and click
Verify.
If you have not obtained the revocation code, select ESN Change Without
Revocation Code in ESN Change Type, and enter related information for
approval.
4. After the verification succeeds, enter the new ESN, click Submit, and confirm
the operation.
5. In the navigation tree on the left, choose My Task > Operation Record. After
the task status changes to Success, click Download to obtain the license file.
Step 4 Upload the license file.
1. Upload the license file.
A license file can be in .xml or .dat format. In addition, a license file in the
format of a .zip package can be activated directly. As such, only an .xml, .dat,
or .zip file can be uploaded in this step.
For this example, assume that the IP address of the local PC is 10.10.10.10
and the SFTP server service is enabled. The license file
LICXXXX_VXXXRXXX_XXXX.xml has been stored in the root directory of the
SFTP server. In this case, log in to the device and perform the following
operations:
system-view
sftp 10.10.10.10

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 33


7 Revoking a License and Activating Another After
the ESN Is Changed (Due to Part Replacement for
How to Activate a Router License Example)

Trying 10.10.10.10 ...


Press CTRL+K to abort
Connected to 10.10.10.10 ...
Warning: The negotiated encryption, digest, key exchange or identity key algorithm is insecure. Using
a security algorithm (AES256-GCM, SHA2-256, SHA2-512, diffie-hellman-group-exchange-sha256) is
recommended.

Please input the username: user01


Enter password:**********
sftp-client>get LICXXXX_VXXXRXXX_XXXX.xml
...
sftp-client>quit
Bye
quit

2. (Optional, and applicable only to a device with two main control boards)
Copy the license file to the slave main control board.
copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml
Info: copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml to slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml? [Y/
N]:Y

Step 5 Verify the license file.


license verify LICXXXX_VXXXRXXX_XXXX.xml
Info: Verify license succeeded.

If Verify license succeeded is displayed, verification is successful. Otherwise,


verification has failed due to an invalid license file, or an ESN, version, or product
type mismatch. For details on how to solve this issue, see E Troubleshooting
Common License Activation Problems.
Step 6 Activate the license file.
license active LICXXXX_VXXXRXXX_XXXX.xml
Now activing the license....done.
Info: Succeeded in activating the license file.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 34


8 Managing a License During Version Upgrade or
How to Activate a Router License Downgrade

8 Managing a License During Version


Upgrade or Downgrade

During a version upgrade or downgrade, the license must be processed according


to requirements to prevent service failures or new service provisioning failures.

Prerequisites
The license file has been activated. If the license capacity needs to be expanded,
the expansion order must have been recorded in the ERP system.

Context
After a version upgrade, the license can be automatically inherited, and you do
not need to apply for or activate the license again in such cases. However, to use
license-controlled new services in the target version, you must apply for a new
license file for license capacity expansion.

After a version downgrade, if the license version is the target version or earlier, the
license does not need to be processed. Otherwise, you need to apply for a new
license file on the ESDP website and activate it. If the order version is later than
the software version, the license also needs to be downgraded.

NOTICE

The sales strategies before and after the upgrade may be different. Example
scenarios include those where a service control is removed (a service is no longer
under license control) or where a service is tailored (no longer supported) in the
target version. In the case of the former, the number of license items decreases in
the target version without compromising the service. In the case of the latter, the
service immediately becomes invalid (without a grace period) after the upgrade. In
the pre-upgrade evaluation phase, check whether services are tailored. If such
services exist and have been enabled, carefully follow the upgrade process for
approval.
The versions described in this document are all VRP V8 versions. If a VRP V5
version is involved, contact Huawei engineers for assistance.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 35


8 Managing a License During Version Upgrade or
How to Activate a Router License Downgrade

Procedure
Step 1 Save the license information before the upgrade.
display license
...
Item name Item type Value Description
-------------------------------------------------------------
CR8P00TSYFC0 -- 1 NetEngine 8000 Timing Synchronization Function Package License
LCR8P00TSYFC0 Function YES NetEngine 8000 Timing Synchronization Function Package
License
CR8P00OAMFC0 -- 1 NetEngine 8000 OAM Function Package License
LCR8P002544C0 Function YES NetEngine 8000 OAM Function Package License
CR8S8KXMSCCP -- 152 NetEngine 8000 10G MACsec Port Function License(per 10G)
LCR8S8KXMSCCP Resource 152 NetEngine 8000 10G MACsec Port Function License(per 10G)
CR8S0VCAGGC0 -- 40 NetEngine 8000 50G Core&Aggregation Scenario License(per 50G/
40G)
LCR8S0VCAGGC0 Resource 40 NetEngine 8000 50G Core&Aggregation Scenario License(per
50G/40G)
CR8S0XCAGGC0 -- 152 NetEngine 8000 10G Core&Aggregation Scenario License(per 10G)
LCR8S0XCAGGC0 Resource 152 NetEngine 8000 10G Core&Aggregation Scenario License(per
10G)
...

Step 2 (Optional, and applicable only in license capacity expansion scenarios) Obtain and
activate a new license file.
1. Log in to the ESDP website (https://app.huawei.com/sdp/).
2. In the navigation tree, choose License Activation > Entitlement Activation,
as shown in Figure 8-1.

Figure 8-1 Entitlement activation

3. Enter Huawei Contract No. or other search criteria, click Search & Refresh,
select one or more entitlement records that meet the search criteria, and click
Next.
4. Click the button in the ESN column. In the dialog box that is displayed, enter
the ESN, select the target device, confirm it, and click Next, as shown in
Figure 8-2.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 36


8 Managing a License During Version Upgrade or
How to Activate a Router License Downgrade

Figure 8-2 Binding ESNs

For a device that has been bound to an entitlement, this operation will merge
the new entitlement to the device.

The ESDP website allows you to merge only the entitlements with the same customer,
product, and ESN.
Permanent commercial entitlements of different versions can be merged directly, and
fixed-term entitlements of different versions can also be merged directly. After
entitlements of different versions are merged, the license version is the latest version
of the entitlements.
Permanent commercial and fixed-term entitlements of different versions cannot be
merged directly. To merge permanent commercial and fixed-term entitlements of
different versions, you must first ensure that they are of the same version through an
upgrade. Otherwise, all license items become fixed-term.
If multiple permanent commercial entitlements are merged for a function control
license item, the result is a set; that is, if any of the entitlements supports a function,
the function is supported after the entitlements are merged. If multiple permanent
commercial entitlements are merged for a resource control license item, the sum of
the resource values in all the entitlements is used as the value of this resource item.
5. After confirming that the information is correct, click Activate License and
then click Download to save the license file locally.
6. Upload the license file.
A license file can be in .xml or .dat format. In addition, a license file in the
format of a .zip package can be directly activated. As such, only an .xml, .dat,
or .zip file can be uploaded in this step.
For this example, assume that the IP address of the local PC is 10.10.10.10
and the SFTP server service is enabled. The license file
LICXXXX_VXXXRXXX_XXXX.xml has been stored in the root directory of the
SFTP server. In this case, log in to the device and perform the following
operations:
system-view
sftp 10.10.10.10

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 37


8 Managing a License During Version Upgrade or
How to Activate a Router License Downgrade

Trying 10.10.10.10 ...


Press CTRL+K to abort
Connected to 10.10.10.10 ...
Warning: The negotiated encryption, digest, key exchange or identity key algorithm is insecure. Using
a security algorithm (AES256-GCM, SHA2-256, SHA2-512, diffie-hellman-group-exchange-sha256) is
recommended.

Please input the username: user01


Enter password:**********
sftp-client>get LICXXXX_VXXXRXXX_XXXX.xml
...
sftp-client>quit
Bye
quit

7. (Optional, and applicable only to a device with two main control boards)
Copy the license file to the slave main control board.
copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml
Info: copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml to slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml? [Y/
N]:Y

8. Verify the license file.


license verify LICXXXX_VXXXRXXX_XXXX.xml
Info: Verify license succeeded.

If Verify license succeeded is displayed, verification is successful. Otherwise,


verification has failed due to an invalid license file, or an ESN, version, or
product type mismatch. For details on how to solve this issue, see E
Troubleshooting Common License Activation Problems.
9. Activate the license file.
If the license file version is later than the source version, this operation must
be performed after the upgrade is complete.
license active LICXXXX_VXXXRXXX_XXXX.xml
Now activing the license....done.
Info: Succeeded in activating the license file.

Step 3 (Optional, and applicable only in license version downgrade scenarios) Obtain and
activate the new license file.
1. In the navigation tree, choose License Commissioning and Maintenance >
Version Change.
2. Select I have read and agree to the above and click Next.
3. Click Select. In the dialog box that is displayed, enter the ESN, select the
target device, confirm it, and enter Target Product Name and Target
Product Version, as shown in Figure 8-3.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 38


8 Managing a License During Version Upgrade or
How to Activate a Router License Downgrade

Figure 8-3 Selecting the target version

4. Click Activate License and save the license locally.


5. Upload the license file.
A license file can be in .xml or .dat format. In addition, a license file in the
format of a .zip package can be activated directly. As such, only an .xml, .dat,
or .zip file can be uploaded in this step.
For this example, assume that the IP address of the local PC is 10.10.10.10
and the SFTP server service is enabled. The license file
LICXXXX_VXXXRXXX_XXXX.xml has been stored in the root directory of the
SFTP server. In this case, log in to the device and perform the following
operations:
system-view
sftp 10.10.10.10
Trying 10.10.10.10 ...
Press CTRL+K to abort
Connected to 10.10.10.10 ...
Warning: The negotiated encryption, digest, key exchange or identity key algorithm is insecure. Using
a security algorithm (AES256-GCM, SHA2-256, SHA2-512, diffie-hellman-group-exchange-sha256) is
recommended.

Please input the username: user01


Enter password:**********
sftp-client>get LICXXXX_VXXXRXXX_XXXX.xml
...
sftp-client>quit
Bye
quit
6. (Optional, and applicable only to a device with two main control boards)
Copy the license file to the slave main control board.
copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml
Info: copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml to slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml? [Y/
N]:Y
7. Verify the license file.
license verify LICXXXX_VXXXRXXX_XXXX.xml
Info: Verify license succeeded.

If Verify license succeeded is displayed, verification is successful. Otherwise,


verification has failed due to an invalid license file, or an ESN, version, or
product type mismatch. For details on how to solve this issue, see E
Troubleshooting Common License Activation Problems.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 39


8 Managing a License During Version Upgrade or
How to Activate a Router License Downgrade

8. Activate the license file.


This operation must be performed after the version downgrade is complete.
license active LICXXXX_VXXXRXXX_XXXX.xml
Now activing the license....done.
Info: Succeeded in activating the license file.

Step 4 Check the license information after the upgrade.


display license

Compare the license items before and after the upgrade. If the result is not as
expected, contact Huawei technical support personnel.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 40


9 Checking the Remaining Validity Period of a
How to Activate a Router License License

9 Checking the Remaining Validity Period


of a License

Non-permanent-commercial licenses have a fixed validity period, and must be


replaced with permanent commercial licenses before the validity period expires.
Otherwise, features under license control will become invalid.

Prerequisites
None

Procedure
● If a non-permanent-commercial license file has been activated, run the
following command:
display license state
Info: Current license state is Demo. The license for the current configuration will expire in 7 day(s).

● If a trial license has been activated, run the following command:


display license trial
License trial status : Enable
Remain times :1
Remain days :7
...

● If a non-permanent-commercial license is in the grace period, run the


following command:
display license state trial
Info: Current license state is Trial. The trial days remains 59 days.The license for the current
configuration will expire at 02:00 on the next day of the last trial day.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 41


10 Manually Enabling the Emergency Mode (When
a Natural Disaster Occurs or the Grace Period of the
How to Activate a Router License License Is About to Expire)

10 Manually Enabling the Emergency


Mode (When a Natural Disaster Occurs or
the Grace Period of the License Is About to
Expire)

After the emergency mode is enabled, the device operates with the maximum
specifications of existing dynamic resource items (resource items that are not
included in the license are not controlled in some earlier versions). This state can
be considered as a temporary state when license control items are not under
restriction. The emergency mode can be enabled a maximum of three times for
each version, and for a maximum of seven days each time.

Prerequisites
The license module is in the Normal, Demo, or Trial state, and the emergency
mode has been enabled no more than twice.

Procedure
Step 1 Run the following command in the user view:
license emergency
Warning: This operation will cause LCS into the EMERGENCY state. Continue? [Y/N]:y
Info: The emergency has been started. You can stop it only by activating a new license file.

Step 2 Check license items in the emergency mode.


display license emergency
License emergency status : Enable
Remain times :2
Remain days :6

Feature-name Value Description


------------------------------------------------------------
LCR8SX0SRV6C1 1 NetEngine 8000 SRv6 Function License
LCR8SX0L3VPC1 1 NetEngine 8000 L3VPN Function License
...

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 42


11 Using the License Query Tool to View License
How to Activate a Router License Items

11 Using the License Query Tool to


View License Items

The license query tool helps you query the description of a specified license item
by code and can be used only by Huawei engineers.

Prerequisites
You have obtained the code of the license item to be queried (Item name
displayed in the display license command output).

Procedure
Step 1 Click the following link to access the tool page.

Enterprise network

Step 2 Set the search criteria and click Search, as shown in Figure 11-1.

Figure 11-1 License query

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 43


How to Activate a Router License A Description of Parameters in the License File

A Description of Parameters in the


License File

Router license files have two file name extensions: .xml and .dat. The XML license
files are used in V800R011 (released in 2019) or later versions. Figure A-1 shows
an example of an XML license file.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 44


How to Activate a Router License A Description of Parameters in the License File

Figure A-1 Example of an XML license file

Table A-1 describes the parameters in an XML license file.

Table A-1 Parameters in an XML license file


Module Parameter Manda Description
tory

LicFile formatVersion Yes Version of the license file format.


The format version of each XML
license file is 3.00 or later.

GeneralInfo CopyRight Yes Copyright information.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 45


How to Activate a Router License A Description of Parameters in the License File

Module Parameter Manda Description


tory

LSN Yes The license serial number is also


known as the Fulfillment ID, and is
the unique identifier of a license file.
You can search for a license file on
license management pages of the
ESDP website. To check the LSN, run
the display license command.

LicType Yes COMM indicates a permanent


commercial license that has been
purchased. DEMO indicates a non-
permanent-commercial license.

GraceDay Yes Number of days in the grace period


after the license file expires. The
value is fixed at 60.

Creator Yes Publisher information. This


parameter has a fixed value of
Huawei Technologies Co., Ltd..

Issuer Yes Name of the user who generated the


license file in the license distribution
system. For a commercial license file,
the value is fixed at License
Distribution Center. For a non-
commercial license file, the value is
the applicant information.

CreateTime Yes Time when the license file was


created, and is the local system time
of the license distribution system,
rather than the system time of the
NE that uses the license.

CustomerInf Customer No Customer name.


o
Country No Country name.

Office No City name.

NodeInfo Node Yes Device ID.

Des No Device description.

LockModel No Lock mode. NODELOCK indicates


single node lock mode, and
DUALLOCK indicates dual node lock
mode. By default, the single node
lock mode is used.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 46


How to Activate a Router License A Description of Parameters in the License File

Module Parameter Manda Description


tory

ESN Yes Electronic serial number of a device,


also called device fingerprint. It is a
string of characters that uniquely
identifies a device and ensures that a
license is authorized to the device.

SaleInfo OfferingProduc Yes Product name and version.


t

SaleItem Yes Sales item code.

Value Yes Sales volume.

DesChs No Description of the sales item, in


Chinese.

DesEng No Description of the sales item, in


English.

CapacityKey No Resource control service license item.


Value indicates the number of
authorized resources. validDate
indicates the authorization
expiration date. If the date is
PERMANENT or left blank, the
authorization is permanent.

FeatureKey No Function control service license item.


The Value is fixed at 1. validDate
indicates the authorization
expiration date. If the date is
PERMANENT or left blank, the
authorization is permanent.

KeyInfo productName Yes Product name and version.

CapacityKey No Resource control service license item.


name indicates the sales item name;
group indicates the sales item type;
Value indicates the number of
authorized resources; validDate
indicates the authorization
expiration date. If the date is
PERMANENT or left blank, the
authorization is permanent.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 47


How to Activate a Router License A Description of Parameters in the License File

Module Parameter Manda Description


tory

FeatureKey No Function control service license item.


name indicates the sales item name.
group indicates the sales item type.
The Value is fixed at 1. validDate
indicates the authorization
expiration date. If the date is
PERMANENT or left blank, the
authorization is permanent.

Footer CommonSign Yes Signature.

ProductSign Yes method indicates the encryption


algorithm. Currently, the 1-RSA1024,
2-RSA2048, 3-ECC163, and 4-ECC233
encryption algorithms are supported.

The DAT license files are used in versions earlier than V800R011 (released in 2018
or earlier). Figure A-2 shows an example of a DAT license file.

Figure A-2 Example of a DAT license file

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 48


How to Activate a Router License A Description of Parameters in the License File

Table A-2 describes the parameters in a DAT license file.

Table A-2 Parameters in a DAT license file


Parameter Manda Description
tory

LicenseSeri Yes The license serial number is also known as the


alNo Fulfillment ID, and is the unique identifier of a license
file. You can search for a license file on license
management pages of the ESDP website. To check the
LSN, run the display license command.

Creator Yes Publisher information. This parameter has a fixed value


of Huawei Technologies Co., Ltd..

CreatedTim Yes Time when the license file was created. The time is the
e local system time of the license distribution system,
rather than the system time of the NE that uses the
license.

Country Yes Country name.

Custom Yes Customer name.

Office Yes Region name or user ID in a contract.

Sign Yes Signature.

Product Yes Product name.

Feature Yes License item type.

Esn Yes Electronic serial number of a device, also called device


fingerprint. The ESN is a string of characters that
uniquely identifies a device and ensures that a license is
authorized to the device.
If there are multiple ESNs, the license file can be
allocated to multiple devices.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 49


How to Activate a Router License A Description of Parameters in the License File

Parameter Manda Description


tory

Attrib Yes Six fields separated by commas from left to right:


● In the first field, COMM indicates a permanent
commercial license that has been purchased. DEMO
indicates a non-permanent-commercial license.
● The second field indicates the authorization
expiration date. PERMANENT indicates that the
authorization is permanent. NULL indicates that the
parameter is invalid.
● The third field indicates the number of days in the
grace period after the license file expires. NULL
indicates that the parameter is invalid.
● The fourth field indicates the software maintenance
expiration date. NULL indicates that the parameter is
invalid.
● The fifth field indicates the hardware maintenance
expiration date. NULL indicates that the parameter is
invalid.
● The sixth field indicates the expiration date of free
software upgrades. NULL indicates that the
parameter is invalid.

Version Yes Product version.

Libver No Version of the license file format.

Resource No Resource control service license item. The value


following the equal sign (=) in each license item
indicates the number of authorized resources.

Function No Function control service license item. The value


following the equal sign (=) in each license item is fixed
at 1.

Comment No Comment information, such as the project name, order,


and contract.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 50


How to Activate a Router License B Common License Commands

B Common License Commands

Function Command

Displaying detailed display license


license information display license verbose

Displaying the ESN of display license esn


the current device

Checking whether a license verify


license file is valid

Activating a license file license active file-name

Activating/Displaying active port-basic slot slotid card cardid port port-


Hardware RTUs list
display license resource usage port-basic { all | slot
slotid } [ active | deactive ]
Activa SRv6 active port-srv6 slot slotid card cardid port port-list
ting/ display license resource usage port-srv6 { all | slot
Displa slotid } [ active | deactive ]
ying
servic L3VPN active port-l3vpn slot slot-id card card-id port port-
e list
licens display license resource usage port-l3vpn { all |
es slot slotid } [ active | deactive ]

EVPN active port-evpn slot slotid card cardid port portlist


display license resource usage port-evpn { all | slot
slotid } [ active | deactive ]
VXLAN active port-vxlan slot slotid card cardid port portlist
display license resource usage port-vxlan { all |
slot slotid } [ active | deactive ]

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 51


How to Activate a Router License B Common License Commands

Function Command

MACsec active port-macsec slot slotid card cardid port port-


list
display license resource usage port-macsec { all |
slotslotid } [ active | deactive ]

FlexE active port-flexe slot slotid card cardid port port-list


display license resource usage port-flexe { all | slot
slotid } [ active | deactive ]
HQoS active port-hqos slot slotid card cardid port port-list
display license resource usage port-hqos { all | slot
slotid } [ active | deactive ] [ slave ]
Channelized active port-mode-channel slot slotid card cardid
sub-interfaces port port-list
display license resource usage port-mode-channel
{ all | slot slotid } [ active | deactive ]

BRAS access active port-bras slot slotid card cardid port port-list
display license resource usage port-bras { all | slot
slotid } [ active | deactive ] [ slave ]
Port slicing active port-slicing slot slot-id card card-id port
port-list
display license resource usage port-slicing

Service active port-service-enhance slot slot-id card cardid


enhancement port port-list
scenarios display license resource usage port-service-
(Segment enhance { all | slot slotid } [ active | deactive ]
Routing,
VXLAN, EVPN,
HQoS, and
L3VPN)

Aggregation active port-aggregation slot slot-id card cardid port


scenarios port-list
(Segment display license resource usage port-aggregation
Routing, { all | slot slotid } [ active | deactive ]
Telemetry, NG
MVPN, and
IPv6)

Core&aggregati active port-core-aggregation slot slot-id card


on scenarios cardid port port-list
(Segment display license resource usage port-core-
Routing, RSVP- aggregation { all | slot slotid } [ active | deactive ]
TE, MPLS TE,
VXLAN, and
HQoS)

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 52


How to Activate a Router License B Common License Commands

Function Command

Peering active port-peering slot slot-id card card-id port


gateway- port-list
specific license display license resource usage port-peering { all |
scenarios slot slotid } [ active | deactive ]
(NE8000-X: BGP
RPD, BGP
Flowspec, BMP,
and RPKI; M2:
Segment
Routing,
Telemetry, and
IPv6)

Trial Enabling/ license trial enable


licens Disabling a trial license trial disable
e license

Displaying display license trial


detailed trial
license
information

Enabling/Displaying the license emergency


emergency mode of a display license emergency
license

Displaying the license display license state


state

Displaying the usage of display license resource usage


active license resource
items

Displaying the display license state trial


remaining days of the
grace period

Configuring/Displaying set license license-item threshold threshold-value


the license resource display license threshold
alarm threshold

Revoking the current license revoke


license

Displaying the display license revoke-ticket


revocation code of the
current invalid license

Saving a license file license export file-name

Deleting a license file delete cfcard:/XXXX.xml


delete salve#cfcard:/XXXX.xml

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 53


How to Activate a Router License B Common License Commands

For some product models (including the NE8000-M1, and NE8000-M6), the activation
command is active XXXX slot slot-id port port-list (card card-id is not included).
Some service license activation commands may activate a license for a specified service on
a specific board. When running the commands, ensure that they are the same as those in
the display license command output.
The list of the preceding commands may vary according to products and versions. When
running the commands, refer to the display license command output or Command
Reference of the involved product and version.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 54


How to Activate a Router License C Applying for the ESDP Website Permission

C Applying for the ESDP Website


Permission

Prerequisites
Only Huawei engineers can apply for the ESDP website permission.

Procedure
Step 1 Log in to https://w3.huawei.com/iauth/#/searchRolePage?
keepData=1&isDraft=.

Step 2 Enter Carrier GTS or Enterprise GTS in the text box on the right and click Search.

Step 3 Select the check box in the search result and click Next, as shown in Figure C-1.

Figure C-1 Applying for the ESDP website permission

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 55


How to Activate a Router License C Applying for the ESDP Website Permission

Step 4 Enter basic personal information and click Submit.


After the application is approved, you obtain the ESDP website permission.
Step 5 Log in to the ESDP website (https://app.huawei.com/sdp/).
Check whether Current Role in the upper right corner is either Carrier GTS or
Enterprise GTS. If so, the application is successful. Otherwise, trace the approval
process.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 56


D Adjusting License Resources Among Multiple
How to Activate a Router License Devices (Splitting a License)

D Adjusting License Resources Among


Multiple Devices (Splitting a License)

If hardware RTU or service license resources are insufficient and license capacity
cannot be expanded, you can adjust license resources among multiple devices. For
example, if device A has 20 SRv6 Function Licenses (per 100GE), all of which are
in use, and device B also has 20 SRv6 Function Licenses (per 100GE), but with only
10 in use, you can allocate the 10 available resources on device B to device A.

Prerequisites
● You have obtained the ESDP website permission.
● You have obtained the ESNs of the devices involved.
● (Optional) You have obtained the revocation code. If no revocation code is
obtained, approval is required.

Context
The ESDP website allows you to adjust only resources of licenses with the same
customer, product, and version. The total number of license resources before and
after the adjustment must be the same.

Procedure
Step 1 Log in to the ESDP website (https://app.huawei.com/sdp/).
Step 2 In the navigation tree on the left, choose License Commissioning and
Maintenance > Network Adjustment > Adjust License, as shown in D Adjusting
License Resources Among Multiple Devices (Splitting a License).

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 57


D Adjusting License Resources Among Multiple
How to Activate a Router License Devices (Splitting a License)

Figure D-1 Adjusting a license

Step 3 Select Application Stage and Source Equipment based on the actual project
information.

If Application Stage is set to After PAC (Preliminary Acceptance Certificate) or


Source Equipment is set to Without revocation code (approval required), enter
the application reason and other information as prompted.

Step 4 Click Add. In the dialog box that is displayed, enter search criteria, select multiple
target devices, and click Confirm.

Step 5 Select the devices whose license resources are to be adjusted, and enter the
number of resources to be adjusted in Changed Value, as shown in Figure D-2.

Figure D-2 Adjusting license resources

Step 6 Click Submit and confirm the operation.

Step 7 Click Download to save the adjusted license file of each device locally.

Step 8 Upload and activate the adjusted license files.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 58


E Troubleshooting Common License Activation
How to Activate a Router License Problems

E Troubleshooting Common License


Activation Problems

E.1 The File Does Not Exist (Error: The specified file
does not exist)
Symptom
During license activation, Error: The specified file does not exist is displayed.

Possible Causes
● The license file name in the activation command is incorrect.
● The license file fails to be uploaded.
● The license file is not copied to the slave main control board.

Procedure
Step 1 Check the license file.
dir
Directory of cfcard:/

Idx Attr Size(Byte) Date Time FileName


...
8 -rw- 13,012 Apr 07 2020 23:10:47 LICXXXX_VXXXRXXX_XXXX.xml
...

For a device with two main control boards, check whether the involved license file
also exists on the slave main control board.
dir slave#cfcard:

If the license file name in the activation command is different from the actual file
name, run the activation command again based on the actual file name.
If the license file to be activated is not found, go to the next step.
If the license file fails to be activated on the slave main control board, run the
following command and then run the activation command again:

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 59


E Troubleshooting Common License Activation
How to Activate a Router License Problems

copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml

Step 2 Upload and activate the license file.

----End

E.2 The License File Format Is Invalid (Error: The


format of the license file is invalid)
Symptom
During license activation, Error: The format of the license file is invalid is
displayed.

Possible Causes
● The license file name in the activation command is incorrect.
● The file name extension of the uploaded license file is not .xml or .dat.

Procedure
Step 1 Check that the file name in the activation command is correct.

If the file name is incorrect, run the command again with the correct file name.

Step 2 Check that an XML or DAT license file is uploaded to the device.

If a correct license file is available locally, go to the next step. Otherwise, apply for
and download a new license file.

Step 3 Upload and activate the license file.

----End

E.3 ESNs or Software Versions Do Not Match (Error:


The ESN or version of the license file does not match
with the device)
Symptom
During license activation, Error: The ESN or version of the license file does not
match with the device is displayed.

Possible Causes
● The ESN bound to the license does not match the ESN of the device.
● The software version in the license does not match that of the device.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 60


E Troubleshooting Common License Activation
How to Activate a Router License Problems

Procedure
Step 1 Check and record the new ESN of the device.
display license esn

Use the text editor to open the copy of the license file and compare the recorded
ESN with that in the license file. If they are different, the ESN bound to the license
is incorrect. If you attempt to activate multiple license files for different devices,
ensure that the license files are correctly uploaded.
Step 2 Check the software version.
display version

Compare the displayed software version with the software version in the license
file. If they are inconsistent, the software version in the license is incorrect.
Step 3 Apply for and download a new license file.
Step 4 Upload and activate the license file.

----End

E.4 Product Types Do Not Match (Error: The product


type of the license file does not match with the device)
Symptom
During license activation, Error: The product type of the license file does not
match with the device is displayed.

Possible Causes
The type of the product bound to the license does not match that of the device.

Procedure
Step 1 Check the type of the device.
display version

Use the text editor to open the copy of the license file and compare the displayed
device type with the product type in the license file. If they are different, the type
of the product bound to the license is incorrect.
Step 2 Apply for and download a new license file.
Step 3 Upload and activate the license file.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 61


E Troubleshooting Common License Activation
How to Activate a Router License Problems

E.5 Some License Control Items Are Missing (Warning:


No product feature is present in the license file)
Symptom
During license activation, Warning: No product feature is present in the license
file is displayed.

Possible Causes
The license file of an earlier version contains the features that are no longer under
license control of a later version.

Procedure
Step 1 No action is required.

----End

E.6 The License File Expires (Info: The license file has
expired)
Symptom
During license activation, Info: The license file has expired is displayed.

Possible Causes
The license file has expired.

Procedure
Step 1 Apply for a new license file.

----End

E.7 Verification Fails Consecutively (Error: Verify


license failed)
Symptom
During license activation, Error: Verify license failed is displayed.

Possible Causes
License activation is performed multiple times when ESNs or versions do not
match.

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 62


E Troubleshooting Common License Activation
How to Activate a Router License Problems

If activation is performed on a license file with an incorrect ESN or software version for the
first time, Error: The ESN or version of the license file does not match with the device is
displayed. In this case, the license module automatically enters the grace period.
If activation is performed on a license file with an incorrect ESN or software version for
multiple times, the license module cannot enter the grace period.

Procedure
Step 1 Check and record the new ESN of the device.
display license esn

Use the text editor to open the copy of the license file and compare the recorded
ESN with that in the license file. If they are different, the ESN bound to the license
is incorrect. If you attempt to activate multiple license files for different devices,
ensure that the license files are correctly uploaded.
Step 2 Check the software version.
display version

Compare the displayed software version with the software version in the license
file. If they are inconsistent, the software version in the license is incorrect.
Step 3 Apply for and download a new license file.
Step 4 Upload and activate the license file.

----End

E.8 How Do I Retrieve a License After It Is Revoked by


Mistake?
Symptom
The license module enters the grace period. The output of the display license
revoke-ticket command shows a revocation code.

Possible Causes
The license file is revoked by mistake.

Procedure
Step 1 Check and record the revocation code.
Record the displayed revocation code. You can also run the following command to
view the revocation code:
display License revoke-ticket
Info: The revoke ticket is LIC20201120YBXXXX:0E47B21121D40C4BBBBB8E8255A437E6D532XXXX.

Step 2 Download a new license file.


1. Log in to the ESDP website (https://app.huawei.com/sdp/).

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 63


E Troubleshooting Common License Activation
How to Activate a Router License Problems

2. In the navigation tree on the left, choose License Commissioning and


Maintenance > Revoked License Recovery, as shown in Figure E-1.

Figure E-1 Retrieving a revoked license

3. Enter the recorded revocation code in the Revocation Code text box and click
Verify.
4. After the verification succeeds, enter the new ESN, click Submit, and confirm
the operation.
5. In the navigation tree on the left, choose My Task > Operation Record. After
the task status changes to Success, click Download to obtain the license file.

Step 3 Upload the license file.


1. Upload the license file.

A license file can be in .xml or .dat format. In addition, a license file in the
format of a .zip package can be activated directly. As such, only an .xml, .dat,
or .zip file can be uploaded in this step.

For this example, assume that the IP address of the local PC is 10.10.10.10
and the SFTP server service is enabled. The license file
LICXXXX_VXXXRXXX_XXXX.xml has been stored in the root directory of the
SFTP server. In this case, log in to the device and perform the following
operations:
system-view
sftp 10.10.10.10
Trying 10.10.10.10 ...
Press CTRL+K to abort
Connected to 10.10.10.10 ...
Warning: The negotiated encryption, digest, key exchange or identity key algorithm is insecure. Using
a security algorithm (AES256-GCM, SHA2-256, SHA2-512, diffie-hellman-group-exchange-sha256) is
recommended.

Please input the username: user01


Enter password:**********
sftp-client>get LICXXXX_VXXXRXXX_XXXX.xml
...
sftp-client>quit
Bye
quit

2. (Optional, and applicable only to a device with two main control boards)
Copy the license file to the slave main control board.
copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml
Info: copy cfcard:/LICXXXX_VXXXRXXX_XXXX.xml to slave#cfcard:/LICXXXX_VXXXRXXX_XXXX.xml? [Y/
N]:Y

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 64


E Troubleshooting Common License Activation
How to Activate a Router License Problems

Step 4 Verify the license file.


license verify LICXXXX_VXXXRXXX_XXXX.xml
Info: Verify license succeeded.

If Verify license succeeded is displayed, verification is successful. Otherwise,


verification has failed due to an invalid license file, or an ESN, version, or product
type mismatch. For details on how to solve these issues, see E Troubleshooting
Common License Activation Problems.
Step 5 Activate the license file.
license active LICXXXX_VXXXRXXX_XXXX.xml
Now activing the license....done.
Info: Succeeded in activating the license file.

----End

E.9 Hardware RTU Activation Fails


Symptom
During hardware RTU activation, Error: Wrong parameter found at '^' position is
displayed.

Possible Causes
The ports for which hardware RTUs fail to be activated are not controlled by the
hardware RTUs. The possible causes are as follows:
● The ports for which hardware RTUs fail to be activated are not CM ports.
● The ports for which hardware RTUs fail to be activated are CM ports, but
bandwidth restrictions are not imposed on them due to software
implementation and hardware production batch issues. This issue occurs only
in rare cases, and does not consume license resources or compromise services.

Procedure
Step 1 Check the slots of CM boards.
system-view
license
active port-basic slot ?
<3,5> The available slot
return

If the slots of the boards housing the ports for which hardware RTUs fail to be
activated are not in the list of the slots obtained in the previous step, the boards
are not CM boards. In this case, no action is required. Otherwise, go to the next
step.
Step 2 Check that bandwidth restrictions are imposed on the ports.
display interface brief
...
InUti/OutUti: input utility/output utility
Interface PHY Protocol InUti OutUti inErrors outErrors
100GE1/0/0(100M) down down 0% 0% 0 0
100GE1/0/1(100M) down down 0% 0% 0 0
...
25GE2/0/0(10G) down down 0% 0% 0 0

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 65


E Troubleshooting Common License Activation
How to Activate a Router License Problems

25GE2/0/1(100M) down down 0% 0% 0 0


...
100GE3/0/0 down down 0% 0% 0 0
100GE3/0/1 down down 0% 0% 0 0
...

All ports with (100M) displayed in the display interface brief command output
are CM ports with the default bandwidth restriction, for example,
100GE1/0/0(100M). If the bandwidth restriction in the brackets is not 100M, but is
less than the rate of the physical port, for example, 25GE2/0/0(10G), at least one
enabling hardware RTU has been activated.

If the ports for which hardware RTUs fail to be activated do not have the (100M)
bandwidth restriction flag, no bandwidth restrictions are imposed on the ports. In
this case, no action is required. Otherwise, go to the next step.

Step 3 Collect fault information, and contact Huawei technical support engineers.

----End

E.10 Service License Activation Fails


Symptom
During service license activation, Error: Wrong parameter found at '^' position is
displayed.

Possible Causes
● The service license is a function control service license that is automatically
activated with the license file. Therefore, no action is required.
● The service license is used only for a specified board and cannot be allocated
to ports on other boards.

Procedure
Step 1 Check whether a function control service license of the involved service exists.

SRv6 service licenses are used as an example. If an SRv6 Function License exists,
SRv6 has been enabled globally on the device. Otherwise, go to the next step.
display license
...
CR8SX0SRV6C1 -- 1 NetEngine 8000 SRv6 Function License
LCR8SX0SRV6C1 Function YES NetEngine 8000 SRv6 Function License
...

Step 2 Check the slots of the boards for which service licenses of the involved service can
be allocated.

SRv6 service licenses are used as an example.


system-view
license
active port-srv6 slot ?
<3,5> The available slot
return

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 66


E Troubleshooting Common License Activation
How to Activate a Router License Problems

If the slots of the boards for which the service licenses of the involved service fail
to be activated are not in the list of the slots obtained in the previous step, the
service licenses cannot be allocated to the ports on these boards.
Step 3 Configure the involved service on the ports for which the service licenses of the
involved service fail to be activated.
If the configuration succeeds, no other actions are required. Otherwise, go to the
next step.
Step 4 Collect fault information, and contact Huawei technical support engineers.

----End

Issue 01 (2020-06-28) Copyright © Huawei Technologies Co., Ltd. 67

You might also like