How To Activate A Router License - Huawei Router License Operation Guide
How To Activate A Router License - Huawei Router License Operation Guide
Issue 01
Date 2020-06-28
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.
Website: https://www.huawei.com
Email: [email protected]
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
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.
License Classification
Figure 1-2 shows license types.
License Mechanism
Based on the license loading and running status, the license module has several
states, as listed in Table 1-2.
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.
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.
Table 1-3 describes all the events that trigger license state transitions.
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.
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
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
S2E/S2F Yes
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.
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.
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 (,).
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.
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.
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.
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
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.
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
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.
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
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.
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.
● 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,
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.
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
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)
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.
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.
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.
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)
● 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.
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
...
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.
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.
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.
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.
----End
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.
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 (,).
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.
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.
----End
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.
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.
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
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
----End
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.
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.
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.
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
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
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.
Compare the license items before and after the upgrade. If the result is not as
expected, contact Huawei technical support personnel.
----End
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).
----End
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.
----End
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.
----End
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.
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.
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.
Function Command
Function Command
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
Function Command
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.
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.
----End
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).
Step 3 Select Application Stage and Source Equipment based on the actual project
information.
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.
Step 7 Click Download to save the adjusted license file of each device locally.
----End
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:/
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:
----End
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.
----End
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.
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
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
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
Possible Causes
License activation is performed multiple times when ESNs or versions do not
match.
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
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.
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.
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.
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
----End
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
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
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.
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