01-License Management Command Reference

HomeSupportResource CenterH3C Access Controllers Command References(R5426P02)-6W10301-License Management Command Reference
03-License client commands
Title Size Download
03-License client commands 53.44 KB

License client commands

The following compatibility matrixes show the support of hardware platforms for license client:

 

Hardware series

Model

Product code

License client compatibility

WX1800H series

WX1804H

EWP-WX1804H-PWR-CN

Yes

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

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

WX1800H series

WX1804H

WX1810H

WX1820H

WX1840H

EWP-WX1804H-PWR

EWP-WX1810H-PWR

EWP-WX1820H

EWP-WX1840H-GL

No

WX3800H series

WX3820H

WX3840H

EWP-WX3820H-GL

EWP-WX3840H-GL

No

WX5800H series

WX5860H

EWP-WX5860H-GL

No

display license client

Use display license client to display the license client configuration and the obtained license information on the license client.

Syntax

display license client

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the license client configuration and the obtained license information on the license client.

<Sysname> display license client

Username: user      

Ciphertext password: ******

License server's IPv4 address: 192.168.3.124, port: 5555

License server's IPv6 address: 2001::1, port: 6000

License client: Enabled, Registering, Miss sync count 0

Cache Size:

  License name: APMGR, cache size: 64

License Count: 1

 

ID: 34153395526cf65b09000000

License Name: APMGR

Licensed Count:32

License Description: H3C WLAN AP Management, 32 licenses

Current State: In use

Get Time: 2018-11-22 16:55:01

Table 1 Command output

Field

Description

Username

Username for login to the license server.

This field displays Not configured if no username is specified.

Ciphertext password

Password in encrypted form for login to the license server.

This field displays Not configured if no password is specified.

License server's IPv4 address: 192.168.3.124, port: 5555

IPv4 address and port number of the license server.

License server's IPv6 address: 2001::1, port: 6000

IPv6 address and port number of the license server.

License server's IPv4/IPv6 address: Not configured, port: Not configured

IP address and port number of the license server.

This field displays Not configured if no IP address or port number of the license server is specified.

License client

Status of the license client:

·          Enabled.

·          Disabled.

·          Registering.

·          Registered.

Miss sync count

Number of packets for synchronization that are dropped by the license client.

Cache Size:

  License name: APMGR, cache size: 64

Name and size of the license cached on the license client.

License Count

Number of licenses cached on the license client.

ID

Identification of the license allocated by the license server. The license server assigns an ID for each license request.

Licensed Count

Maximum number of licensed nodes in the license. For example, this field displays 32 for the license H3C WLAN AP Management, 32 licenses. The value 32 indicates that the license allows a maximum of 32 concurrent online APs.

For a feature license, this field always displays 1.

License description

Description of the license.

Current State

Current status of the license:

·          In use—The license is in use.

·          Unusable—The license is not in use.

·          Expired (will be reclaimed in n days)—The license is expired and will be reclaimed in n days.

Get Time

Time when the license was obtained from the license server.

display license client statistics

Use display license client statistics to display license statistics on the license client.

Syntax

display license client statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display license statistics on the license client.

<Sysname> display license client statistics

Name    Type       Total

APMGR   UINT32     64

Table 2 Command output

Field

Description

Name

License name.

Type

License data type:

·          UINT32—Quantity type.

·          BOOL—Boolean type. It defines whether the license client can use the feature.

·          STRING—String type. It defines whether the license client can use the feature with specific settings.

Total

For a quantity type, this field displays total number of licenses.

For a Boolean or string type, this field displays total number of licensed users.

Related commands

display license client

license client config cache

Use license client config cache to configure license cache on the license client.

Use undo license client config cache to disable license cache.

Syntax

license client config cache license-name license-name size cache-size

undo license client config cache license-name license-name

Default

License cache is not configured. No license can be cached on the license client.

Views

System view

Predefined user roles

network-admin

Parameters

license-name: Specifies a license by its license name. Only APMGR is supported.

cache-size: Specifies the maximum number of licenses that can be cached.

Examples

# Configure the license client to accommodate a maximum of 64 APMGR licenses.

<Sysname> system-view

[Sysname] license client config cache license-name APMGR size 64

license client enable

Use license client enable to enable the license client.

Use undo license client enable to disable the license client.

Syntax

license client enable

undo license client enable

Default

License client is disabled, and it cannot get licenses from the license server.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Specify the IP address, username, and password of the license server before enabling license client. Otherwise, the configuration fails.

After you enable the license client, the device automatically initiates a connection to the license server. The license server verifies the device identity through the username and password. If they are consistent with those specified on the license server, the device passes authentication. Then the device can apply for licenses from the license server and use the licensed features.

Examples

# Enable the license client.

<Sysname> system-view

[Sysname] license client enable

Related commands

license client username

license server

license client username

Use license client username to specify the username and password on the license client for logging in to the license server.

Use undo license client username to delete the username and password settings.

Syntax

license client username username password { cipher | simple } password

undo license client username

Default

No username or password is specified on the license client.

Views

System view

Predefined user roles

network-admin

Parameters

username: Specify the username, a case-sensitive string of 1 to 31 characters.

cipher: Specify a password in encrypted form.

simple: Specifies a password in plaintext form.

password: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 31 characters. Its encrypted form is a case-sensitive string of 33 to 73 characters.

Usage guidelines

You can specify only one username and one password on the license client for login to the license server.

If you execute the command multiple times before enabling the license client, the most recent configuration takes effect.

After the license client is enabled, you cannot modify the username or password. To modify the settings, disable the license client first.

Examples

# Specify test and 123456 as the username and password on the license client.

<Sysname> system-view

[Sysname] license client username test password simple 123456

Related commands

license client enable

license server

Use license server to specify the IP address and port number of the license server.

Use undo license server to delete the license server settings on the license client.

Syntax

license server { ipv4 ipv4-address | ipv6 ipv6-address } port port-number [ vpn-instance vpn-instance-name ]

undo license server { ipv4 ipv4-address | ipv6 ipv6-address }

Default

No IP address or port number of the license server is specified.

Views

System view

Predefined user roles

network-admin

Parameters

ipv4 ipv4-address: Specifies the IPv4 address of the license server.

ipv6 ipv6-address: Specifies the IPv6 address of the license server.

port-number: Specifies the port number of the license server, in the range of 1 to 65535.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the license server belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the license server is on the public network, do not specify this option.

Usage guidelines

You can specify a maximum of four license servers on the license client. Each license server is uniquely identified by the combination of an IPv4 address and a port number.

When the upper limit is reached, you cannot specify new license servers unless you delete existing license server settings.

As a best practice, make sure only one license server is reachable. If multiple license servers are reachable, the license client selects the first license server with which the client establishes a connection.

After the license client is enabled, you cannot modify the license server settings on the client. To modify the settings, disable the license client first.

Examples

# Specify 192.168.100.1 and 5555 as the IPv4 address and port number of the license server, respectively.

<Sysname> system-view

[Sysname] license server ipv4 192.168.100.1 port 5555

# Specify 3001::1 and 5555 as the IPv6 address and port number of the license server, respectively.

<Sysname> system-view

[Sysname] license server ipv6 3001::1 port 5555

Related commands

license client enable