- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-License management commands | 62.58 KB |
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. The device supports only license installation through activation files, so this command always displays license information about activation files whether you specify this keyword or not.
Usage guidelines
The device supports license installation through only activation files in the current software version.
Examples
# Display detailed information about all licenses.
<Sysname> display license
flash:/license/StandardTemporary.ak
Feature: APMGR
Product Description: H3C vAC1000 License(Comware V7,32APs,1Year)
License SN: 213130A1QC0174000003
Registered at: 2019-03-25 07:16:54
License Type: Trial (days restricted)
Trial Time Left (days): 174
Current State: In use
Table 1 Command output
Field |
Description |
Feature |
Feature name. |
Product Description |
License description. |
License SN |
License serial number. |
Registered at |
Time when the license was installed. |
License Type |
License type by validity period: · NA—The system cannot obtain the license type. · Days restricted—Purchased license that is valid for a period of days, for example, 30 days. · Trial (days restricted)—Free trial license that is valid for a period of 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. |
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. When you uninstall an activation file, an Uninstall file that contains an Uninstall key is created. The Uninstall key is required for transferring the license. |
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
When you register a license for a device, 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.
The DID is contained in a .did file. Upload the file when you register the license with the license center.
Examples
# Display the device SN and DID.
<Sysname> display license device-id
SN: 525400b9b4170ff019032507
Device ID: flash:/license/525400b9b4170ff019032507.did
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: 128 Usage: 1
Feature Licensed State
APMGR 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. |
Licensed |
Licensing state of the feature: · N—Not licensed. · Y—Licensed. |
State |
License type by purchasing state: · Trial—Trial license. · Pre-licensed—Pre-installed license. If the feature is not licensed, this field displays a hyphen (-). To use the feature, you must install a valid license file. |
license activation-file install
Use license activation-file install to install an activation file.
Syntax
license activation-file install license-file
Views
System view
Predefined user roles
network-admin
Parameters
license-file: Specifies the path of an activation file, 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 20170810.ak.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20170810.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...Done.
# Install activation file package 20170101.tar to the specified slot.
<Sysname> system-view
[Sysname] license activation-file install flash:/license/20170101.tar 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...
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 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
license activation-file uninstall license-file
Views
System view
Predefined user roles
network-admin
Parameters
license-file: 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...Done.
Uninstall file: flash:/license/20130810.uak
display license activation-file
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
Use this command if the free license storage (see the display license feature command) is not sufficient.
This command clears expired licenses and uninstalled licensesthat are installed by using activation files.
If uninstalled licenses or expired licenses exist on the device, the compression operation will make the DID change. Before performing a compression, make sure all licenses registered with the old DID 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...Done.