Contents

License management commands· 1

display license· 1

display license feature· 2

display license device-id· 4

license activation-file install 5

license activation-file uninstall 6

license compress· 7

 

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 Fundamentals 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 information about activation files.

activation-key: Displays information about activation keys. This keyword is not supported in the current software version.

license-key: Displays information about license keys. This keyword is not supported in the current software version.

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

Usage guidelines

The display license command displays detailed information about all licenses if it is used without any keywords.

Examples

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

<Sysname> display license

flash:/license/13.ak

Feature: mdc

Product Description: H3C S10500 Advanced Data Center License

Registered at: 2014-12-08 14:35:47

License Type: Permanent

Current State: In use

# (In IRF mode.) Display detailed license information for each IRF member device.

<Sysname> display license

Chassis 1:

flash:/license/13.ak

Feature: mdc

Product Description: H3C S10500 Advanced Data Center License

Registered at: 2014-12-08 14:35:47

License Type: Permanent

Current State: In use

Table 1 Command output

Field	Description
Chassis n	Member ID of the IRF member device. This field is available in IRF mode.
flash:/license/13.ak	Activation file path. 13.ak represents the activation file name.
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.
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. ·     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 file that contains an Uninstall key is created when you uninstall the activation file. The Uninstall file is required for transferring the license.
Uninstall Date	Date when the activation file was uninstalled.

 

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

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

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

<Sysname> display license feature

Total: 8  Usage: 0

Feature                         Licensed        State

LISP                            N               -

EVB                             N               -

evi                             N               -

mdc                             N               -

SPBM                            N               -

TRILL                           N               -

FCoE                            N               -

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

Chassis 1:

Total: 8  Usage: 0

Feature                         Licensed        State

LISP                            N               -

EVB                             N               -

evi                             N               -

mdc                             N               -

SPBM                            N               -

TRILL                           N               -

FCoE                            N               -

Table 2 Command output

Field	Description
Chassis n	Member ID of the IRF member device. This field is available in IRF mode.
Total	Total number of licenses that can be installed.
Usage	Number of installed licenses.
Feature	Feature that must be licensed before being used. The LISP, TRILL, and SPBM features are not supported in the current software version.
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.

 

display license device-id

Use display license device-id to display device 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 the 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 can be generated as a string or .id file.

·     If the DID is a string, enter the string when you register the license with the license center.

·     If the DID is contained in an .id 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: XXXXXXXXXXXXXXXXXXXX

Device ID: XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

# (In IRF mode.) Display the SN and DID of IRF member device 2.

<Sysname> display license device-id chassis 2

SN: XXXXXXXXXXXXXXXXXXXX

Device ID: XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

license activation-file install

Use license activation-file install to install a license 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

For a successful license activation file installation, make sure the following requirements are met:

·     The SN and DID used for registering the feature license match the current SN and DID of the device.

·     No one else is installing an activation file on the device you are working with.

You can install the activation files of multiple licenses for a feature. The feature can be used as long as one of the licenses is valid.

Activation files are device locked rather than MPU locked. A licensed feature can run on the entire system even after an MPU replacement.

The device in standalone mode will copy the activation file to other MPUs on the device during installation.

For a license-based feature package to run correctly on an IRF fabric:

·     Install one license for the feature package on each member in the fabric.

·     Make sure the licenses installed on the members are the same.

Examples

# (In standalone mode.) Install the activation file 20110810.ak.

<Sysname> system-view

[Sysname] license activation-file install flash:/license/20110810.ak

This operation might take some time. Do not perform any other operations until t

he operation is completed or a failure message is displayed. Please wait...    

The activation file has been installed.

# (In IRF mode.) Install the activation file 20110813.ak on IRF member device 2.

<Sysname> system-view

[Sysname] license activation-file install flash:/license/20110813.ak chassis 2

This operation might take some time. Do not perform any other operations until t

he operation is completed or a failure message is displayed. Please wait...    

The activation file has been installed.

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

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. For a successful uninstallation, make sure no one else is uninstalling an activation file on the device you are working with.

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.

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 the activation file flash:/license/20110810.ak.

<Sysname> system-view

[Sysname] license activation-file uninstall flash:/license/20110810.ak

This operation might take some time. Do not perform any other operations until t

he operation is completed or a failure message is displayed. Please wait...    

Uninstall file: flash:/license/20110810.uak

# (In IRF mode.) Uninstall the activation file flash:/license/20110813.ak from IRF member device 2.

<Sysname> system-view

[Sysname] license activation-file uninstall flash:/license/20110813.ak chassis 2

This operation might take some time. Do not perform any other operations until t

he operation is completed or a failure message is displayed. Please wait...    

Uninstall file: flash:/license/20110813.uak

Related commands

·     display license activation-file

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

This command clears invalid licenses (expired licenses and uninstalled licenses) and Uninstall files from the license storage area. Back up the Uninstall files before you compress the license storage.

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.

For a successful compression, make sure no one else is compressing the license storage on the device you are working with.

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

ses, including Uninstall keys, and create a new device ID for activation keys/fi

les. Make sure you have saved the Uninstall keys so you can apply for a new acti

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

he operation is completed or a failure message is displayed. Please wait...

# (In IRF mode.) Compress the license storage on IRF member device 2.

<Sysname> system-view

[Sysname] license compress chassis 2

This command will delete all data relevant to uninstalled and expired keys/licen

ses, including Uninstall keys, and create a new device ID for activation keys/fi

les. Make sure you have saved the Uninstall keys so you can apply for a new acti

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

he operation is completed or a failure message is displayed.Please wait...