- 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-ISSU commands
- 09-Emergency shell commands
- 10-Device management commands
- 11-Tcl commands
- 12-License management commands
- 13-Password recovery control command
- 14-Python commands
- Related Documents
-
Title | Size | Download |
---|---|---|
12-License management commands | 146.43 KB |
Device-locked license commands
license activation-file install
license activation-file uninstall
license activation-file install
license activation-file uninstall
Device-locked license commands
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. It is reserved for future support.
license-key: Displays information about license keys. This keyword is not supported in the current software version. It is reserved for future support.
chassis chassis-number: Specifies the member ID of an IRF member device. If no IRF member device is specified, this command displays license information for all members in the IRF fabric. (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/210235789456120011012013093010280123367.ak
Feature: CAMPUS
Product Description: H3C S12500 Advanced Campus License
Registered at: 2013-09-30 10:30:46
License Type: Permanent
Current State: Uninstalled
Uninstall Key: TAbx-ieC9-pZkL-HsjP-icuB-c$$%-G@$p-F2rM
Uninstall Date: 2013-09-30 10:36:12
flash:/license/210235789456120011012013093010421425475.ak
Feature: DATACENTER
Product Description: H3C S12500 Advanced Data Center License
Registered at: 2013-09-30 10:50:49
License Type: Trial (days restricted)
Trial Time Left (days): 53
Current State: In use
# (In IRF mode.) Display detailed license information for each device.
Chassis 1:
flash:/license/210235A96801060011222013092811165639811_c1_01.ak
Feature: CAMPUS
Product Description: H3C S12500 Advanced Campus License
Registered at: 2013-09-28 11:17:16
License Type: Permanent
Current State: In use
Chassis 2:
flash:/license/c2_campus_03.ak
Feature: CAMPUS
Product Description: H3C S12500 Advanced Campus License
Registered at: 2013-09-28 20:23:02
License Type: Trial (days restricted)
Time Left (days): 26
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/210235789456120011012013093010280123367.ak |
Activation file path. 210235789456120011012013093010280123367.ak is the activation file name. |
Feature |
Feature package name: · DATACENTER—Includes the EVI, FCoE, SPB, and MDC features. · CAMPUS—Includes the MDC feature. |
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. |
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: 1
Feature Licensed State
DATACENTER Y Formal
CAMPUS N -
# (In IRF mode.) Display brief feature license information.
<Sysname> display license feature
Chassis 1:
Total: 8 Usage: 2
Feature Licensed State
DATACENTER Y Trial
CAMPUS Y Formal
Chassis 2:
Total: 8 Usage: 2
Feature Licensed State
DATACENTER Y Trial
CAMPUS Y Formal
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. |
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 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 SN and DID of the device.
<Sysname> display license device-id
SN: 210231A968009A000026
Device ID: jb7-kpTq-HskV-NQ4r-jT5j-D5Yx-m:+B-SZYD
# (In IRF mode.) Display the SN and DID of the IRF member device 2.
<Sysname> display license device-id chassis 2
SN: 210231A9680093000003
Device ID: /B6i-5KF9-bCG+-V6xB-/+4f-5:JZ-u>ky-mbZc
Related commands
license compress
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 an MPU's flash memory or CF card.
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 registration match the current SN and DID of the specified device.
· No one else is installing an activation file on the device you are working with.
· Use the display power-supply command to verify that the power monitor module and the power supplies are operating correctly.
Activation files are device locked. A licensed feature can run on the device where its activation file is installed even after an MPU replacement.
Examples
# (In standalone mode.) Install the activation file 20130810.ak on the device.
<Sysname> system-view
[Sysname] license activation-file install flash:/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...
# (In IRF mode.) Install the activation file 20130812.ak to on IRF member device 2.
<Sysname> system-view
[Sysname] license activation-file install flash:/20130812.ak chassis 2
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 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.
|
NOTE: The uninstall action does not delete license data from the license storage area. To free storage space, you must compress the license storage (see the license compress command). |
Examples
# (In standalone mode.) Uninstall the activation file flash:\license\20130810.ak from the device.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:/license/20130810.ak
Uninstall file: flash:/license/20130810.uak
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...
# (In IRF mode.) Uninstall the activation file flash:\license\/20130812.ak from IRF member device 2.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:/license/20130812.ak chassis 2
Uninstall file: flash:/license/20130812.uak
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 activation-file
· license activation-file install
· license compress
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
|
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. |
Use this command if the free license storage (see the display license feature command) is not sufficient.
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.
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 on the device.
<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...
# (In IRF mode.) Compress the license storage on the IRF member device 2.
[Sysname] license compress chassis 2
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...
MPU-locked license commands
display license
Use display license to display detailed license information.
Syntax
In standalone mode:
display license [ activation-file | activation-key | license-key ] [ slot slot-number ]
In IRF mode:
display license [ activation-file | activation-key | license-key ] [ 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.
activation-key: Displays information about activation keys. This keyword is not supported in the current software version. It is reserved for future support.
license-key: Displays information about license keys. This keyword is not supported in the current software version. It is reserved for future support.
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. 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
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
Slot 0:
flash:/license/210231A2DG9137M111112013093014344857844.ak
Feature: DATACENTER
Product Description: H3C S12500 Advanced Data Center License
Registered at: 2013-09-30 14:34:21
License Type: Trial (days restricted)
Trial Time Left (days): 53
Current State: In use
# (In IRF mode.) Display detailed license information for each MPU.
<Sysname> display license chassis 2 slot 1
Chassis 1 Slot 0:
flash:/license/campus_002.ak
Feature: CAMPUS
Product Description: H3C S12500 Advanced Campus License
Registered at: 2013-10-09 10:00:46
License Type: Permanent
Current State: In use
Chassis 2 Slot 1:
flash:/license/campus_003.ak
Feature: CAMPUS
Product Description: H3C S12500 Advanced Campus License
Registered at: 2013-10-09 10:10:25
License Type: Trial (days restricted)
Time Left (days): 26
Current State: In use
Table 3 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. |
flash:/license/210231A2DG9137M111112013093014344857844.ak |
Activation file path. 210231A2DG9137M111112013093014344857844.ak is the activation file name. |
Feature |
Feature package name: · DATACENTER—Includes the EVI, FCoE, SPB, and MDC features. · CAMPUS—Includes the MDC feature. |
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. |
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 MPU supports.
· The number of installed licenses.
· Features that must be licensed to run on the MPU.
Examples
# (In standalone mode.) Display brief feature license information.
<Sysname> display license feature
Slot 0:
Total: 128 Usage: 1
Feature Licensed State
DATACENTER Y Formal
CAMPUS N -
Slot 1:
Total: 128 Usage: 1
Feature Licensed State
DATACENTER Y Formal
CAMPUS N -
# (In IRF mode.) Display brief feature license information.
<Sysname> display license feature
Chassis 1 Slot 0:
Total: 128 Usage: 2
Feature Licensed State
DATACENTER Y Formal
CAMPUS Y Formal
Chassis 2 Slot 1:
Total: 128 Usage: 2
Feature Licensed State
DATACENTER Y Formal
CAMPUS Y Formal
Table 4 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 (-). To use the feature, you must install a valid activation file. |
display license device-id
Use display license device-id to display MPU 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. 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 you register a license for an MPU, 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 SN and DID of the MPU in slot 1.
<Sysname> display license device-id slot 1
SN: 210231A968H134000109
Device ID: N%m8-$ZxH-FB7d-czBP-mG$d-U4M:-%A%g-$6VA
# (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: 210231A9680093000003
Device ID: /B6i-5KF9-bCG+-V6xB-/+4f-5:JZ-u>ky-mbZc
Related commands
license compress
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 slot slot-number
In IRF mode:
license activation-file install file-name chassis chassis-number slot slot-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 an MPU's flash memory or CF card.
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. The slot-number argument represents the slot number of the MPU on the 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 registration match the current SN and DID of the specified MPU.
· No one else is installing an activation file on the MPU you are working with.
· Use the display power-supply command to verify that the power monitor module and the power supplies are operating correctly.
Activation files are MPU 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 20130811.ak on the MPU in slot 1.
<Sysname> system-view
[Sysname] license activation-file install flash:\license\20130811.ak 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...
# (In IRF mode.) Install the activation file 20130814.ak to the MPU in slot 1 on IRF member device 2.
<Sysname> system-view
[Sysname] license activation-file install flash:\license\20130814.ak chassis 2 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 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 slot slot-number
In IRF mode:
license activation-file uninstall file-name chassis chassis-number slot slot-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.
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. The slot-number argument represents the slot number of the MPU on the device. (In IRF mode.)
Usage guidelines
A feature cannot run on the MPU after you uninstall all its activation files.
Use this command to revoke an unexpired license if you want to transfer the license from one MPU to another. For a successful uninstallation, make sure no one else is uninstalling an activation file on the MPU 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.
|
NOTE: The uninstall action does not delete license data from the license storage area. To free storage space, you must compress the license storage (see the license compress command). |
Examples
# (In standalone mode.) Uninstall the activation file flash:\license\20130811.ak from the MPU in slot 1.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:\license\20130811.ak slot 1
Uninstall file: flash:/license/20130811.uak
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...
# (In IRF mode.) Uninstall the activation file flash:\license\20130813.ak from the MPU in slot 1 on IRF member device 2.
<Sysname> system-view
[Sysname] license activation-file uninstall flash:\license\20130813.ak chassis 2 slot 1
Uninstall file: flash:\license\20130813.uak
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...
· display license activation-file
· license activation-file install
· license compress
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. 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. |
Use this command if the free license storage (see the display license feature command) is not sufficient. 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.
For a successful compression, make sure no one else is compressing the license storage on the MPU you are working with.
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 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...
# (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 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...