- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-License management commands | 75.79 KB |
License management commands
The WX1800H series, WX2500H series, MAK series, and WX3000H series access controllers do not support parameters or commands that are available only in IRF mode.
The following compatibility matrixes show the support of hardware platforms for licensing methods:
Hardware series |
Model |
Product code |
License management compatibility |
WX1800H series |
WX1804H |
EWP-WX1804H-PWR-CN |
No |
WX2500H series |
WX2508H-PWR-LTE WX2510H WX2510H-F WX2540H WX2540H-F WX2560H |
EWP-WX2508H-PWR-LTE EWP-WX2510H-PWR EWP-WX2510H-F-PWR EWP-WX2540H EWP-WX2540H-F EWP-WX2560H |
Yes: · WX2508H-PWR-LTE · WX2510H · WX2540H · WX2560H No: · WX2510H-F · WX2540H-F |
MAK series |
MAK204 MAK206 |
EWP-MAK204 EWP-MAK206 |
Yes |
WX3000H series |
WX3010H WX3010H-X WX3010H-L WX3024H WX3024H-L WX3024H-F |
EWP-WX3010H EWP-WX3010H-X-PWR EWP-WX3010H-L-PWR EWP-WX3024H EWP-WX3024H-L-PWR EWP-WX3024H-F |
Yes |
WX3500H series |
WX3508H WX3510H WX3520H WX3520H-F WX3540H |
EWP-WX3508H EWP-WX3510H EWP-WX3520H EWP-WX3520H-F EWP-WX3540H |
Yes |
WX5500E series |
WX5510E WX5540E |
EWP-WX5510E EWP-WX5540E |
Yes |
WX5500H series |
WX5540H WX5560H WX5580H |
EWP-WX5540H EWP-WX5560H EWP-WX5580H |
Yes |
Access controller modules |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
Yes |
Hardware series |
Model |
Product code |
License management compatibility |
WX1800H series |
WX1804H WX1810H WX1820H WX1840H |
EWP-WX1804H-PWR EWP-WX1810H-PWR EWP-WX1820H EWP-WX1840H-GL |
Yes: WX1840H No: · WX1804H · WX1810H · WX1820H |
WX3800H series |
WX3820H WX3840H |
EWP-WX3820H-GL EWP-WX3840H-GL |
Yes |
WX5800H series |
WX5860H |
EWP-WX5860H-GL |
Yes |
display license
Use display license to display detailed license information.
Syntax
In standalone mode:
display license [ activation-file ]
In IRF mode:
display license [ activation-file ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
activation-file: Displays license information about activation files.
slot slot-number: Specifies the member ID of an IRF member device. If no member device is specified, this command displays license information for all IRF member devices. (In IRF mode.)
Usage guidelines
If you do not specify any parameters, this command displays detailed information about all licenses.
Examples
# Display detailed information about all licenses.
<Sysname> display license
flash:/license/219801A0WL9166Q000042018122016485038123.ak
Feature: APMGR
Product Description: Enhanced Access Controller License,16 APs,for Verticals,for V7
Registered at: 2018-12-20 21:59:46
License Type: Trial (days restricted)
Trial Time Left (days): 180
Current State: In use
Table 1 Command output
Field |
Description |
Feature |
Feature name. |
Product Description |
License description. |
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 of days, for example, 30 days. · Trial (days restricted)—Free trial license that is valid for a period of days. |
Time Left (days) |
Remaining days of the license. This field is available for a purchased license. |
Trial Time Left (days) |
Remaining days of the trial period. This field is available for a trial 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. ¡ A date restricted license is in this state if its start date is not reached. · 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. |
Uninstall Date |
Date when the activation file was uninstalled. |
display license device-id
Use display license device-id to display SN and DID information.
Syntax
In standalone mode:
display license device-id
In IRF mode:
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. (In IRF mode.)
Usage guidelines
When you register a license for a device, you must provide its unique 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.
Examples
# (In standalone mode.) Display the device SN and DID.
<Sysname> display license device-id
SN: 219801A11XH133000015
SN CHECK_SUM: 157E907E
Device ID: flash:/license/219801A11XH133000015.did
# (In IRF mode.) Display the SN and DID for the specified slot.
<Sysname> display license device-id slot 1
SN: 210235A1JNC14B900031
SN CHECK_SUM: BBB9E675
Device ID: flash:/license/210235A1JNC14B900031.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
Examples
# (In standalone mode.) Display brief feature license information.
<Sysname> display license feature
Total: 360 Usage: 0
Feature Licensed State
APMGR N -
# (In IRF mode.) Display brief feature license information.
<Sysname> display license feature
Slot 1:
Total: 360 Usage: 0
Feature Licensed State
APMGR N -
Table 2 Command output
Field |
Description |
Total |
Total number of licenses that can be installed. |
Usage |
Number of licenses stored in the license storage. |
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. · Pre-licensed—Pre-installed 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 an activation file.
Syntax
In standalone mode:
license activation-file install license-file
In IRF mode:
license activation-file install license-file slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
license-file: Specifies the path of an activation file, 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. (In IRF mode.)
Usage guidelines
(In standalone mode.) License registration requires the device's hardware SN and DID.
In IRF mode:
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. A licensed feature can run on the IRF member device where its activation file is installed even after the member device is moved from one IRF fabric to another IRF fabric.
Examples
# (In standalone mode.) Install activation file 20170810.ak.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20170810.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...Done.
# (In IRF mode.) Install activation file 20170811.ak to the specified slot.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20170811.ak slot 1
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...Done.
Related commands
display license
display license device-id
license activation-file uninstall
license activation-file uninstall
Use license activation-file uninstall to uninstall an activation file.
Syntax
In standalone mode:
license activation-file uninstall license-file
In IRF mode:
license activation-file uninstall license-file slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
license-file: 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. (In IRF mode.)
Usage guidelines
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 file. Use this file together with the SN and DID of the transfer destination to register the license for the transfer destination.
A feature cannot run after you uninstall all of its activation files.
Trial licenses are not transferrable. When you uninstall the activation file of a trial license, no Uninstall file is created.
Examples
# (In standalone mode.) Uninstall activation file flash:/license/20130810.ak.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:/license/20130810.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...Done.
Uninstall file: flash:/license/20130810.uak
# (In IRF mode.) Uninstall activation file flash:/license/20130811.ak from the specified slot.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:/license/20130811.ak slot 1
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...Done.
Uninstall file: flash:/license/20130811.uak
display license
license activation-file install
license compress
Use license compress to compress the license storage.
Syntax
In standalone mode:
license compress
In IRF mode:
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. (In IRF mode.)
Usage guidelines
Use this command if the free license storage (see the display license feature command) is not sufficient.
This command clears expired licenses and uninstalled licenses from the license storage.
If uninstalled licenses or expired licenses exist on the device, the compression operation will make the DID change. You will be unable to install the activation file obtained by using the old DID on the device. As a best practice, install all activation files registered with the old DID before performing a compression.
Examples
# (In standalone mode.) Compress the license storage.
<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...Done.
# (In IRF mode.) Compress the license storage on the specified slot.
<Sysname> system-view
[Sysname] license compress slot 1
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...Done.