01-License Management Command Reference

HomeSupportResource CenterH3C Access Controllers Command References(R5426P02)-6W10301-License Management Command Reference
02-License management commands
Title Size Download
02-License management commands 61.61 KB

License management commands

The WX1800H series, WX2500H 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

Activation file

Activation key

WX1800H series

WX1804H

EWP-WX1804H-PWR-CN

Yes

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

No

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

No

WX3500H series

WX3508H

WX3510H

WX3520H

WX3520H-F

WX3540H

EWP-WX3508H

EWP-WX3510H

EWP-WX3520H

EWP-WX3520H-F

EWP-WX3540H

Yes

No

WX5500E series

WX5510E

WX5540E

EWP-WX5510E

EWP-WX5540E

Yes

Yes

WX5500H series

WX5540H

WX5560H

WX5580H

EWP-WX5540H

EWP-WX5560H

EWP-WX5580H

Yes

No

Access controller modules

LSUM1WCME0

EWPXM1WCME0

LSQM1WCMX20

LSUM1WCMX20RT

LSQM1WCMX40

LSUM1WCMX40RT

EWPXM2WCMD0F

EWPXM1MAC0F

LSUM1WCME0

EWPXM1WCME0

LSQM1WCMX20

LSUM1WCMX20RT

LSQM1WCMX40

LSUM1WCMX40RT

EWPXM2WCMD0F

EWPXM1MAC0F

Yes

Yes:

·          LSUM1WCME0

·          EWPXM1WCME0

No:

·          LSQM1WCMX20

·          LSUM1WCMX20RT

·          LSQM1WCMX40

·          LSUM1WCMX40RT

·          EWPXM2WCMD0F

·          EWPXM1MAC0F

 ‌

Hardware series

Model

Product code

Activation file

Activation key

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

EWP-WX1804H-PWR

EWP-WX1810H-PWR

EWP-WX1820H

EWP-WX1840H-GL

Yes: WX1840H

No:

·          WX1804H

·          WX1810H

·          WX1820H

No

WX3800H series

WX3820H

WX3840H

EWP-WX3820H-GL

EWP-WX3840H-GL

Yes

No

WX5800H series

WX5860H

EWP-WX5860H-GL

Yes

No

display license

Use display license to display detailed license information.

Syntax

In standalone mode:

display license [ activation-file | activation-key ]

In IRF mode:

display license [ activation-file | activation-key ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

activation-file: Displays license information about activation files.

activation-key: Displays license information about activation keys.

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.)

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.

When you uninstall an activation file, an Uninstall file that contains an Uninstall key is created. The Uninstall key is required for transferring the license.

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.

The DID is contained in a .did file. Upload the file when you register the license with the license center.

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:

·          Formal—Purchased license.

·          Trial—Trial 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 rather than MPU locked. A licensed feature can run on the entire system even after an MPU replacement.

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 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

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

Related commands

display license activation-file

license activation-file install

license activation-key install

Use license activation-key install to install an activation key.

Syntax

In standalone mode:

license activation-key install activation-key-string

In IRF mode:

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. (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 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

# (In standalone mode.) Install activation key XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX.

<Sysname> system-view

[Sysname] license activation-key install XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

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 key XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX on the specified slot.

<Sysname> system-view

[Sysname] license activation-key install XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX 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 activation-key

display license device-id

license activation-key uninstall

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 that are installed by using activation files or activation keys.

If uninstalled licenses or expired licenses exist on the device, the compression operation will make the DID change. Before performing a compression, make sure all licenses registered with the old DID have been installed. You will be unable to install such licenses after the compression.

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

# (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.