- Table of Contents
-
- 01-Fundamentals Command Reference
- 00-Preface
- 01-CLI commands
- 02-RBAC commands
- 03-Login management commands
- 04-FTP and TFTP commands
- 05-File system management commands
- 06-Configuration file management commands
- 07-Software upgrade commands
- 08-Device management commands
- 09-Tcl commands
- 10-Python commands
- 11-License management commands
- 12-MAC learning through a Layer 3 device commands
- 13-Cloud connection commands
- Related Documents
-
Title | Size | Download |
---|---|---|
11-License management commands | 79.07 KB |
License management commands
All commands in this chapter are supported only on the default context. Features licensed to the default context are also licensed to non-default contexts. For information about contexts, see Virtual Technologies Configuration Guide.
display license
Use display license to display detailed license information.
Syntax
In standalone mode:
display license [ activation-file ]
In IRF mode:
display license [ activation-file ] [ chassis chassis-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Parameters
activation-file: Displays license information about activation files.
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.)
Examples
# (In standalone mode.) Display detailed information about all licenses.
<Sysname> display license
flash:/license/M90002015090711271930813.ak
Feature: AV
Product Description: H3C SecPath M9000,AV Anti-Virus Security License
Registered at: 2017-05-07 11:21:42
License Type: Trial (days restricted)
Trial Time Left (days): 29
Current State: In use
flash:/license/M90002015090711261999412.ak
Feature: SSLVPN
Product Description: H3C SecPath M9000,SSL VPN for 200 Users
Registered at: 2017-05-07 11:21:23
License Type: Trial (days restricted)
Trial Time Left (days): 29
Current State: In use
flash:/license/M90002015090711253150850.ak
Feature: SLB
Product Description: H3C SecPath M9000,LB License
Registered at: 2017-05-07 11:20:58
License Type: Trial (days restricted)
Trial Time Left (days): 29
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. · 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. |
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. · Unusable—The license cannot be used. · Invalid—The license is invalid and cannot be used. |
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
context-admin
context-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:flash:/license/210231S12500XSUPSUPC.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
context-admin
context-operator
Examples
# (In standalone mode.) Display brief feature license information.
<Sysname> display license feature
Total: 5 Usage: 1
Feature Licensed State
ACG N -
AV N -
IPS N -
SLB N -
SSLVPN N -
UFLT N -
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: · 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 file. |
license activation-file install
Use license activation-file install to install an activation file.
Syntax
In standalone mode:
license activation-file install license-file
In IRF mode:
license activation-file install license-file chassis chassis-number
Views
System view
Predefined user roles
network-admin
context-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.
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...Done.
Related commands
display license
display license device-id
license activation-file uninstall
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
context-admin
Parameters
chassis chassis-number: Specifies the member ID of an IRF member device. (In IRF mode.)
Usage guidelines
The license storage is limited. You can execute this command to clear expired licenses from the license storage.
The compression operation might 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
# (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...Done.