01-Fundamentals Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C S12500X-AF & S12500-X & S9800 Switch Series Command References(R27xx)-6W10501-Fundamentals Command Reference
12-License management commands
Title Size Download
12-License management commands 89.79 KB

License management commands

All commands in this chapter are supported only on the default MDC. Features licensed to the default MDC are also licensed to non-default MDCs. For information about MDCs, see Virtual Technologies Configuration Guide.

display license

Use display license to display detailed license information.

Syntax

In standalone mode:

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

In IRF mode:

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

activation-file: Displays license information about activation files.

activation-key: Displays license information about activation keys.

license-key: Displays license information about license keys.

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

 

 

NOTE:

The activation-key and license-key keywords are supported only in R2719 and later.

 

Usage guidelines

If you do not specify any parameters, this command displays detailed information about all licenses.

Examples

# (In standalone mode.) Display detailed information about all licenses.

<Sysname> display license

flash:/license/210231S12500XSUPSUPC2015010415352158495.ak                      

Feature: LISP EVB evi mdc SPBM TRILL FCoE                                      

Product Description: H3C S12500-X Advanced Data Center License                 

Registered at: 2015-01-04 14:49:17                                              

License Type: Permanent                                                        

Current State: In use

Table 1 Command output

Field

Description

Feature

Feature name.

The device does not support the LISP, EVB, EVI, SPBM, or TRILL feature in the current software version.

Product Description

License description

License Key

Installed license key.

Activation Key

Installed activation key.

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.

·     Date restricted—Purchased license that is valid for an absolute date range, for example, 2013-05-01 to 2013-05-30.

·     Trial (days restricted)—Free trial license that is valid for a period of days.

·     Trial (date restricted)—Free trial license that is valid for an absolute date range.

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.

Validity Period

Start date and end state for a date restricted purchased license. If the start or end date is not limited, this field displays No limit.

Trial Validity Period

Start date and end state for a date restricted trial license. If the start or end date is not limited, this field displays No limit.

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

chassis chassis-number: Specifies the member ID of an IRF member device. (In IRF mode.)

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.

Examples

# (In standalone mode.) Display the device SN and DID.

<Sysname> display license device-id

SN: 210231S12500XSUPSUPC

Device ID:jFvq-zRGA-DpJy-VK@d-$Zz+-QjA7-$pLP-xvzR

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

mdc-admin

mdc-operator

Examples

# (In standalone mode.) Display brief feature license information.

<Sysname> display license feature

Total: 5  Usage: 5                                                             

Feature                         Licensed        State                          

EVB                             Y               Formal                         

FCoE                            Y               Formal                         

LISP                            Y               Formal                         

SPBM                            Y               Formal                         

TRILL                           Y               Formal                         

evi                             Y               Formal                         

mdc                             Y               Formal

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.

The device does not support EVB, LISP, SPBM, TRILL, or EVI in the current software version.

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.

 

license activation-file install

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

Syntax

In standalone mode:

license activation-file install file-name

In IRF mode:

license activation-file install file-name chassis chassis-number

Views

System view

Predefined user roles

network-admin

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

chassis chassis-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 IRF member device.

A licensed feature can run on the IRF member device where its activation file is installed even after the IRF member device joins another IRF fabric.

Examples

# (In standalone mode.) Install activation file 20130810.ak.

<Sysname> system-view

[Sysname] license activation-file install 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...

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

In IRF mode:

license activation-file uninstall file-name chassis chassis-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

file-name: Specifies the file path, a case-sensitive string of 1 to 127 characters.

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

Uninstall file: flash:/license/20130810.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.

 

 

NOTE:

This command is supported only in R2719 and later.

 

Syntax

In standalone mode:

license activation-key install activation-key-string

In IRF mode:

license activation-key install activation-key-string chassis chassis-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

activation-key-string: Specifies the activation key. The key must be in the format of XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX. The string is case sensitive and must be valid.

chassis chassis-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 IRF member device.

A licensed feature can run on the IRF member device where its activation key is installed even after the IRF member device joins another IRF fabric.

Examples

# (In standalone mode.) Install an activation key.

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

Related commands

display license activation-key

display license device-id

license activation-key uninstall

license activation-key uninstall

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

 

 

NOTE:

This command is supported only in R2719 and later.

 

Syntax

In standalone mode:

license activation-key uninstall activation-key-string

In IRF mode:

license activation-key uninstall activation-key-string chassis chassis-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

activation-key-string: Specifies the activation key. The key must be in the format of XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX. The string is case sensitive. Make sure the activation key has not expired.

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

If an activation key 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.

A feature cannot run after you uninstall all of its activation keys.

Trial licenses are not transferrable. When you uninstall the activation key of a trial license, no Uninstall key is created.

Examples

# (In standalone mode.) Uninstall an activation key.

<Sysname> system-view

[Sysname] license activation-key uninstall 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...

Uninstall key: YYYY-YYYY-YYYY-YYYY-YYYY-YYYY-YYYY-YYYY

Related commands

display license activation-key

license activation-key install

license compress

Use license compress to compress the license storage.

Syntax

In standalone mode:

license compress

In IRF mode:

license compress chassis chassis-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

The DID changes each time the license storage is compressed. Before performing a compression, make sure all licenses registered with the old DID have been installed. They cannot be installed 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...

license license-key install

Use license license-key install to install a license key.

 

 

NOTE:

This command is supported only in R2719 and later.

 

Syntax

In standalone mode:

license license-key install license-key-string

In IRF mode:

license license-key install license-key-string chassis chassis-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

license-key-string: Specifies a valid license key, a string of case-sensitive characters.

chassis chassis-number: Specifies the member ID of an IRF member device. (In IRF mode.)

Usage guidelines

License keys are purchased for activating licenses.

(In IRF mode.) A licensed feature can run on the IRF member device where its license key is installed even after the IRF member device joins another IRF fabric.

You can install a license key on multiple devices.

Examples

# (In standalone mode.) Install a license key.

<Sysname> system-view

[Sysname] license license-key install XXXXXXXX-(XXXX-)XXXXXXXX-XXXXXXXX-XXXXXXXX

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

license license-key uninstall

license license-key uninstall

Use license license-key uninstall to uninstall a license key.

 

 

NOTE:

This command is supported only in R2719 and later.

 

Syntax

In standalone mode:

license license-key uninstall license-key-string

In IRF mode:

license license-key uninstall license-key-string chassis chassis-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

license-key-string: Specifies a valid license key, a string of case-sensitive characters. Make sure the key has not expired.

chassis chassis-number: Specifies the member ID of an IRF member device. (In IRF mode.)

Usage guidelines

A feature cannot run correctly after you uninstall all of its license keys.

Examples

# (In standalone mode.) Uninstall a license key.

<Sysname> system-view

[Sysname] license license-key uninstall XXXXXXXX-XXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX

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

license license-key install

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网