Login
- Table of Contents
-
- 01-Fundamentals
- 00-Preface
- 01-CLI commands
- 02-RBAC commands
- 03-Login management commands
- 04-FTP and TFTP commands
- 05-File system management commands
- 06-Configuration file management commands
- 07-Software upgrade commands
- 08-Device management commands
- 09-Tcl commands
- 10-Python commands
- 11-License management commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 11-License management commands | 59.14 KB |
License management commands
The following matrix shows the keywords activation-file and activation-key and hardware compatibility:
|
Hardware series |
Model |
activation-file compatibility |
activation-key compatibility |
|
WX1800H series |
WX1804H WX1810H WX1820H |
No |
No |
|
WX2500H series |
WX2510H WX2540H WX2560H |
Yes |
No |
|
WX3000H series |
WX3010H WX3010H-L WX3010H-X WX3024H WX3024H-L |
Yes |
No |
|
WX3500H series |
WX3508H WX3510H WX3520H WX3540H |
Yes |
No |
|
WX5500E series |
WX5510E WX5540E |
Yes |
Yes |
|
WX5500H series |
WX5540H WX5560H WX5580H |
Yes |
No |
|
Access controller modules |
EWPXM1MAC0F |
Yes |
No |
|
EWPXM1WCME0 |
Yes |
Yes |
|
|
EWPXM2WCMD0F |
Yes |
No |
|
|
LSQM1WCMX20 |
Yes |
No |
|
|
LSQM1WCMX40 |
Yes |
No |
|
|
LSUM1WCME0 |
Yes |
Yes |
|
|
LSUM1WCMX20RT |
Yes |
No |
|
|
LSUM1WCMX40RT |
Yes |
No |
The WX2500H series and WX3000H series access controllers do not support the slot keyword or the slot-number argument.
display license
Use display license to display detailed license information.
Syntax
display license [ activation-file | activation-key ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
activation-file: Displays information about activation files.
activation-key: Displays information about activation keys.
slot slot-number: Specifies the member ID of an IRF member device. If you do not specify a member device, this command displays license information for all IRF member devices.
Usage guidelines
The display license command displays detailed information about all licenses if it is used without any keywords.
After you execute this command, it takes certain time for the device to output detailed license information depending on the device load.
Examples
# Display detailed license information for each IRF member device.
<Sysname> display license
cfa0:/license/210235A1AMB1450000272015052317092592481.ak
Feature: APMGR
Product Description: Enhanced Access Controller License,128 APs,for Verticals,for V7 Registered at: 2015-05-28 16:54:24
License Type: Trial (days restricted)
Trial Time Left (days): 30
Current State: In use
Table 1 Command output
|
Field |
Description |
|
Feature |
Feature name. |
|
Registered at |
Time when the license was installed. |
|
License Type |
License type by validity period: · NA—The system cannot obtain the license type. · Permanent—Purchased license that never expires and is always valid. · Days restricted—Purchased license that is valid for a period in days, for example, 30 days. · Trial (days restricted)—Free trial license that is valid for a period in days. |
|
Trial Time Left (days) |
Remaining days of the trial period. This field is available for a trial license. |
|
Time Left (days) |
Remaining days of the license. This field is available for a purchased license. |
|
Current State |
State of the license: · In use—The license is being used. · Usable—The license is available for use. If multiple days-restricted licenses for one feature are installed, only one license is in In use state and the rest licenses are in Usable state. · Expired—The license has expired. · Uninstalled—The license has been uninstalled. · Unusable—The license cannot be used. · Invalid—The license is invalid and cannot be used. |
|
Uninstall Key |
This field is available for licenses that have been uninstalled. An Uninstall key is created after the uninstallation. The Uninstall key is required for transferring the license. |
|
Uninstall Date |
Date when the license was uninstalled. This field is available for licenses that have been uninstalled. |
display license device-id
Use display license device-id to display device SN, checksum, and DID information.
Syntax
display license device-id slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies the member ID of an IRF member device.
Usage guidelines
Each device has a unique SN and DID. When you register a license for a device, you must provide its SN and DID.
The DID changes each time you use the license compress command to compress the license storage. Use the display license device-id command to identify the up-to-date DID each time you register licenses.
The DID is generated as an .id file. Upload the file when you register the license with the license center.
Examples
# Display the device SN and DID.
<Sysname> display license device-id
SN: 210235A0VSB011000029
SN CHECK_SUM: FFFFFFEA
Device ID: cfa0:/license/210235A0VSB011000029.did
display license feature
Use display license feature to display brief license information for features.
Syntax
display license feature
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
Feature license information includes the following information:
· The total number of licenses that the device supports.
· The number of installed licenses.
· Features that must be licensed to run on the device.
Examples
# Display brief feature license information.
<Sysname> display license feature
Total: 128 Usage: 2
Feature Licensed State
APMGR Y Trial
Table 2 Command output
|
Field |
Description |
|
Total |
Total number of licenses that can be installed. |
|
Usage |
Number of installed licenses. |
|
Feature |
Feature that must be licensed before being used. |
|
Licensed |
Licensing state of the feature: · N—Not licensed. · Y—Licensed. |
|
State |
License type by purchasing state: · Trial—Trial license. · Formal—Purchased license. If the feature is not licensed, this field displays a hyphen (-). To use the feature, you must install a valid license file. |
license activation-file install
Use license activation-file install to install a license activation file.
Syntax
license activation-file install file-name slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
file-name: Specifies the file path, a case-sensitive string of 1 to 127 characters. The activation file must be valid and stored on the device.
slot slot-number: Specifies the member ID of an IRF member device.
Usage guidelines
To install a license activation file successfully, make sure the SN and DID used for registering the feature license matches the current SN and DID of the device.
Activation files are device locked rather than MPU locked. A licensed feature can run on the entire system even after an MPU replacement.
Examples
# Install the activation file 20130812.ak on the device.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20130812.ak
This operation might take some time. Do not perform any other operations until the operation is completed or a failure message is displayed. Please wait...
Related commands
· display license activation-file
· display license device-id
· license activation-file uninstall
license activation-file uninstall
Use license activation-file uninstall to uninstall an activation file.
Syntax
license activation-file uninstall file-name slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
file-name: Specifies the file path, a case-sensitive string of 1 to 127 characters.
slot slot-number: Specifies the member ID of an IRF member device.
Usage guidelines
A feature cannot run on the device after you uninstall all its activation files.
Use this command to revoke an unexpired license if you want to transfer the license from one device to another.
When an activation file is uninstalled, the system creates an Uninstall key. Use this key together with the SN and DID of the transfer destination to register the license for the transfer destination.
Trial licenses are not transferrable. When you uninstall the activation file of a trial license, no Uninstall file is created.
Examples
# Uninstall the activation file flash:/license/20130812.ak from the device.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:/license/20130812.ak
This operation might take some time. Do not perform any other operations until the operation is completed or a failure message is displayed. Please wait...
Uninstall file: flash:/license/20130812.uak
· display license activation-file
· license activation-file install
license activation-key install
Use license activation-key install to install an activation key.
Syntax
license activation-key install activation-key-string slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
activation-key-string: Specifies the activation key in the XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX format. The string is case sensitive and must be valid.
slot slot-number: Specifies the member ID of an IRF member device.
Usage guidelines
To install a license activation key successfully, make sure the SN and DID used for registering the feature license matches the current SN and DID of the device.
Activation keys are device locked rather than MPU locked. A licensed feature can run on the entire system even after an MPU replacement.
Examples
# Install the activation key XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX.
<Sysname> system-view
[Sysname] license activation-key install XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
This operation might take some time. Do not perform any other operations until the operation is completed or a failure message is displayed. Please wait...
Related commands
· display license activation-key
· display license device-id
· license activation-key uninstall
license compress
Use license compress to compress the license storage.
Syntax
license compress slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies the member ID of an IRF member device.
Usage guidelines
|
|
CAUTION: The DID changes each time the license storage is compressed. Before performing a compression, make sure all activation files generated based on the old DID have been installed. They cannot be installed after the compression. |
Use this command if the free license storage (see the display license feature command) is not sufficient.
This command clears invalid licenses (expired licenses and uninstalled licenses) and Uninstall keys from the license storage area. Back up the Uninstall keys before you compress the license storage.
Examples
# Compress the license storage on the device.
<Sysname> system-view
[Sysname] license compress
This command will delete all data relevant to uninstalled and expired keys/licenses, including Uninstall keys, and create a new device ID for activation keys/files. Make sure you have saved the Uninstall keys so you can apply for a new activation key/file for the unexpired licenses that were covered by the uninstalled activation keys/files.
Are you sure you want to continue? [Y/N]: Y
This operation might take some time. Do not perform any other operations until the operation is completed or a failure message is displayed. Please wait...
