Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-License management commands | 137.79 KB |
license activation-file install
license activation-file uninstall
license activation-key install
license activation-key uninstall
license activation-file install
license activation-file uninstall
License management commands
display license
Use display license to display detailed license information.
Syntax
display license [ activation-file | activation-key | license-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.
license-key: Displays license information about license keys.
slot slot-number: Specifies the slot number of an MPU. If no slot number is specified, this command displays license information for all MPUs.
Usage guidelines
If you do not specify any parameters, this command displays detailed information about all licenses.
Examples
# Display detailed information about all licenses.
<Sysname> display license
Feature: opt
Feature Description: opt license.
Activation Key: QvkT-%gfS-Xz/4-jR@V-9g%3-79wv-NMFG-kmJ9
Registered at: 2013-02-23 11:36:09
License Type: Days restricted
Time Left (days): 249
Current State: In use
flash:/license/2014072009113494375.ak
Feature: LISP EVB evi mdc SPBM TRILL FCoE
Product Description: Advanced Data Center License
Registered at: 2014-05-07 15:07:39
License Type: Permanent
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. · Date restricted—Purchased license that is valid for an absolute date range, for example, 2015-05-01 to 2015-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 license is permanent, this field displays No limit. |
|
Trial Validity Period |
Start date and end state for a date restricted trial license. If the license is permanent, 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
display license device-id slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies the slot number of an MPU.
Usage guidelines
When you register a license for an MPU, 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.
Examples
# Display the SN and DID for the specified slot.
<Sysname> display license device-id slot 1
SN: 210235A1LFX176000002
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
Examples
# Display brief feature license information.
<Sysname> display license feature
Slot 0:
Total: 64 Usage: 1
Feature Licensed State
EVB Y Trial
FCoE Y Trial
SPBM Y Trial
TRILL Y Trial
evi Y Trial
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. The device does not support EVI in the current software version. |
|
Licensed |
Licensing state of the feature: · N—Not licensed. · Y—Licensed. |
|
State |
License type by purchasing state: · Pre-licensed—Preinstalled 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 for the feature. |
license activation-file install
Use license activation-file install to install an activation file.
Syntax
license activation-file install file-name slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
file-name: Specifies the path of an activation file or an activation file package, 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 slot number of an MPU.
Usage guidelines
Activation files can be released in either of the following forms:
· A single .ak file.
To obtain an .ak activation file, purchase a license key, access H3C License Management Platform, and provide the license key, SN and DID information.
· A .tar file package.
To obtain a .tar activation file package, purchase multiple license keys, access H3C License Management Platform, and provide the license keys, SN and DID information.
The activation file package is a set of .ak activation files corresponding to the license keys. Activation file packages are installed in the same way as single activation files are installed. The use of activation file packages simplifies the management of activation files by reducing the number of times you register and install activation files. However, to uninstall a license, you can uninstall .ak activation files one by one only.
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.
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
# Install activation file 20130811.ak to the specified slot.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20130811.ak slot 0
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...
# Install activation file package 20170101.tar to the specified slot.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20170101.tar slot 0
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...
Decompress......Done.
Begain to install test01.ak …Done.
Begain to install test02.ak …Done.
Begain to install test03.ak …Done.
Total Num:3
Success Num:3
Failed Num:0
Related commands
display license
display license device-id
license activation-file uninstall
license activation-file uninstall
Use license activation-file uninstall to uninstall an activation file.
Syntax
license activation-file uninstall file-name slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
file-name: Specifies the file path, a case-sensitive string of 1 to 127 characters.
slot slot-number: Specifies the slot number of an MPU.
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
# Uninstall activation file flash:/license/20130811.ak from the specified slot.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:/license/20130811.ak slot 0
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/20130811.uak
display license
license activation-file install
license activation-key install
Use license activation-key install to install an activation key.
Syntax
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. 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.
slot slot-number: Specifies the slot number of an MPU.
Usage guidelines
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 specified MPU.
Activation keys are MPU locked rather than device locked. A licensed feature can run on the MPU where its activation key is installed even after the MPU is moved between devices.
Examples
# Install an activation key 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...
Related commands
display license
display license device-id
license activation-key uninstall
license activation-key uninstall
Use license activation-key uninstall to uninstall an activation key.
Syntax
license activation-key uninstall activation-key-string slot slot-number
Views
System view
Predefined user roles
network-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. The activation key must not be expired.
slot slot-number: Specifies the slot number of an MPU.
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
# Uninstall an activation key from the specified slot.
<Sysname> system-view
[Sysname] license activation-key uninstall 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...
Uninstall key: YYYY-YYYY-YYYY-YYYY-YYYY-YYYY-YYYY-YYYY
display license
license activation-key install
license compress
Use license compress to compress the license storage.
Syntax
license compress slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies the slot number of an MPU.
Usage guidelines
The license storage is limited. You can execute this command to clear expired licenses and uninstalled licenses from the license storage.
If uninstalled licenses or expired licenses exist on the device, the compression operation will make the DID or DID file change. Before performing a compression, make sure all licenses registered with the old DID or DID file have been installed. You will be unable to install such licenses after the compression.
Examples
# Compress the license storage on the specified slot.
<Sysname> system-view
[Sysname] license compress slot 0
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.
Syntax
license license-key install license-key-string slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
license-key-string: Specifies a license key, a string of case-sensitive characters.
slot slot-number: Specifies the slot number of an MPU.
Usage guidelines
License keys are MPU locked rather than device locked. A licensed feature can run on the MPU where its license key is installed even after the MPU is moved between devices.
You can install a license key on multiple devices.
Examples
# Install a license key to the specified slot.
<Sysname> system-view
[Sysname] license license-key install XXXXXXXX-(XXXX-)XXXXXXXX-XXXXXXXX-XXXXXXXX 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...
Related commands
display license license-key
license license-key uninstall
license license-key uninstall
Use license license-key uninstall to uninstall a license key.
Syntax
license license-key uninstall license-key-string slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
license-key-string: Specifies a license key, a string of case-sensitive characters. The key must not be expired.
slot slot-number: Specifies the slot number of an MPU.
Usage guidelines
A feature cannot run correctly after you uninstall all of its license keys.
Examples
# Uninstall a license key from the specified slot.
<Sysname> system-view
[Sysname] license license-key uninstall 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...
Related commands
display license license-key
license license-key install
License management commands
display license
Use display license to display detailed license information.
Syntax
display license [ activation-file ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
activation-file: Displays license information about activation files.
Examples
# Display detailed information about all licenses.
<Sysname> display license
flash:/license/2014072009113494375.ak
Feature: LISP EVB evi mdc SPBM TRILL FCoE
Product Description: Advanced Data Center License
Registered at: 2014-05-07 15:07:39
License Type: Permanent
Current State: In use
Table 3 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. · 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 license is permanent, this field displays No limit. |
|
Trial Validity Period |
Start date and end state for a date restricted trial license. If the license is permanent, 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
display license device-id
Views
Any view
Predefined user roles
network-admin
network-operator
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
# Display the device SN and DID.
<Sysname> display license device-id
SN: 210235A1LFX176000002
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
Examples
# Display brief feature license information.
<Sysname> display license feature
Total: 80 Usage: 1
Feature Licensed State
ACG Y Formal
IPS Y Formal
SSLVPN Y Formal
WEB-CACHE Y Formal
Table 4 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. The device does not support EVB, LISP, 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. · Pre-licensed—Preinstalled 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 for the feature. |
license activation-file install
Use license activation-file install to install an activation file.
Syntax
license activation-file install file-name
Views
System view
Predefined user roles
network-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.
Usage guidelines
License registration requires the device's hardware SN and DID.
Examples
# 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
display license device-id
license activation-file uninstall
license activation-file uninstall
Use license activation-file uninstall to uninstall an activation file.
Syntax
license activation-file uninstall file-name
Views
System view
Predefined user roles
network-admin
Parameters
file-name: Specifies the file path, a case-sensitive string of 1 to 127 characters.
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
# 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
license activation-file install
license compress
Use license compress to compress the license storage.
Syntax
license compress
Views
System view
Predefined user roles
network-admin
Usage guidelines
The license storage is limited. You can execute this command to clear expired licenses and uninstalled licenses from the license storage.
If uninstalled licenses or expired licenses exist on the device, the compression operation will make the DID or DID file change. Before performing a compression, make sure all licenses registered with the old DID or DID file 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
# 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...
