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

 

display license

Use display license to display detailed license information.

Syntax

In standalone mode:

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

In IRF mode:

display license [ activation-file ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

activation-file: Displays information about activation files.

slot slot-number: Specifies the slot number of an MPU. If no slot number is specified, this command displays license information for all MPUs. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies an MPU in an IRF member device. The chassis-number argument represents the IRF member ID of the device, and the slot-number argument represents the slot number of the MPU on the device. If no IRF member device and slot number are specified, this command displays license information for all MPUs in the IRF fabric. (In IRF mode.)

Usage guidelines

If executed without any keyword specified, the command displays detailed information about all licenses.

Examples

# In standalone mode, display detailed information about all licenses.

<Sysname> display license

Slot 0:

slot0#flash:/license/210231A968010B0001212012092820310797599.ak

Feature: mdc

Product Description: mdc license

Registered at: 2012-09-28 20:26:15

License Type: Permanent

Current State: In use

# In IRF mode, display detailed license information for each IRF member device.

<Sysname> display license chassis 2 slot 1

Chassis 2 Slot 1:

chassis2slot1#flash:/license/210231A968010B0001212012092820310797599.ak

Feature: mdc

Product Description: mdc license

Registered at: 2012-09-28 20:26:15

License Type: Permanent

Current State: In use

Table 1 Command output

Field	Description
Slot n	Slot number of the MPU. This field is available in standalone mode.
Chassis n slot m	Slot number of the MPU and member ID of the IRF member device that hosts the MPU. This field is available in IRF mode.
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. ·       Date restricted—Purchased license that is valid for an absolute date range, for example, 2012-05-01 to 2012-05-30. ·       Trial (days restricted)—Free trial license that is valid for a period in days. ·       Trial (date restricted)—Free trial license that is valid for an absolute date range.
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.

 

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 total number of licenses that the device supports, the number of installed licenses, and features that must be licensed to run on the device.

Examples

# In standalone mode, display brief feature license information.

<Sysname> display license feature

Slot 0:

Total: 128  Usage: 0

Feature         Licensed        State

mdc             N               -

evi             N               -

# In IRF mode, display brief feature license information.

<Sysname> display license feature

Chassis 1 Slot 0:

Total: 128  Usage: 0

Feature         Licensed        State

mdc             N               -

evi             N               -

Chassis 2 Slot 0:

Total: 128  Usage: 0

Feature         Licensed        State

mdc             N               -

evi             N               -

Table 2 Command output

Field	Description
Slot n	Slot number of the MPU. This field is available in standalone mode.
Chassis n slot m	Slot number of the MPU and member ID of the IRF member device that hosts the MPU. 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.
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 (-).

 

display license device-id

Use display license device-id to display device SN and DID information.

Syntax

In standalone mode:

display license device-id slot slot-number

In IRF mode:

display license device-id chassis chassis-number slot slot-number

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

slot slot-number: Specifies the slot number of an MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies an MPU in an IRF member device. The chassis-number argument represents the IRF member ID of the device, and the slot-number argument represents the slot number of the MPU on the device. (In IRF mode.)

Usage guidelines

Each MPU has a unique SN and DID. When registering a license for an MPU, you must provide its SN and DID.

The DID changes each time the license compress command is executed 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 SN and DID of the MPU in slot 1.

<Sysname> display license device-id slot 1

SN: XXXXXXXXXXXXXXXXXXXX

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

# In IRF mode, display the SN and DID of the MPU in slot 1 on IRF member device 2.

<Sysname> display license device-id chassis 2 slot 1

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-path slot slot-number

In IRF mode:

license activation-file install file-path chassis chassis-number slot slot-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

file-path: Specifies the file path, a case-sensitive string of 1 to 127 characters. The activation file must be valid and stored on the MPU.

slot slot-number: Specifies the slot number of an MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies an MPU in an IRF member device. The chassis-number argument represents the IRF member ID of the device, and the slot-number argument represents the slot number of the MPU on the device. (In IRF mode.)

Usage guidelines

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

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 MPU locked rather than device locked. A licensed feature can run on the MPU where its activation file is installed even after the MPU is moved between devices.

Examples

# In standalone mode, install the activation file 20110811.ak to the MPU in slot 1.

<Sysname> system-view

[Sysname] license activation-file install flash:\license\20110811.ak slot 1

# In IRF mode, install the activation file 20110814.ak to the MPU in slot 1 on IRF member device 2.

<Sysname> system-view

[Sysname] license activation-file install flash:\license\20110814.ak chassis 2 slot 1

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-path slot slot-number

In IRF mode:

license activation-file uninstall file-path chassis chassis-number slot slot-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

file-path: Specifies the file path, a case-sensitive string of 1 to 127 characters. The activation file must be one that has not expired.

slot slot-number: Specifies the slot number of an MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies an MPU in an IRF member device. The chassis-number argument represents the IRF member ID of the device, and the slot-number argument represents the slot number of the MPU on the device. (In IRF mode.)

Usage guidelines

If the activation files of all licenses for a feature are uninstalled or expired, the feature is unavailable.

Use this command to revoke an unexpired license if you want to transfer the license from one MPU to another.

If 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 key is created.

Examples

# In standalone mode, uninstall the activation file flash:\license\20110811.ak from the MPU in slot 1.

<Sysname> system-view

[Sysname] license activation-file uninstall flash:\license\20110811.ak slot 1

# In IRF mode, uninstall the activation file flash:\license\20110814.ak from the MPU in slot 1 on IRF member device 2.

<Sysname> system-view

[Sysname] license activation-file uninstall flash:\license\20110814.ak chassis 2 slot 1

Uninstall file: flash:\license\20110814.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 slot slot-number

In IRF mode:

license compress chassis chassis-number slot slot-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

slot slot-number: Specifies the slot number of an MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies an MPU in an IRF member device. The chassis-number argument represents the IRF member ID of the device, and the slot-number argument represents the slot number of the MPU on the device. (In IRF mode.)

Usage guidelines

 

CAUTION: The DID changes each time the license storage is compressed. Before performing a compression, make sure all activation files generated based on the old DID have been installed. They cannot be installed after the compression.

 

This command clears invalid licenses (expired licenses and uninstalled licenses) from the license storage area. Use this command if the idle license storage entries (see the display license feature command) are not enough.

Examples

# In standalone mode, compress the license storage on the MPU in slot 1.

<Sysname> system-view

[Sysname] license compress slot 1

This command will delete all data relevant to unistalled 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 unistalled activation keys/files.

Are you sure you want to continue? [Y/N]: Y

# In IRF mode, compress the license storage on the MPU in slot 1 of IRF member device 2.

<Sysname> system-view

[Sysname] license compress chassis 2 slot 1

This command will delete all data relevant to unistalled 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 unistalled activation keys/files.

Are you sure you want to continue? [Y/N]: Y