chlicense

Use the chlicense command to change license settings for system functions.

Syntax

Read syntax diagramSkip visual syntax diagram chlicense -remotenumber_of_enclosures-virtualizationnumber_of_enclosures-compressionnumber_of_enclosures-cloudnumber_of_enclosures

Parameters

Important: All of the parameters are mutually exclusive. Only one licensing function can be changed at a time.
-remote capacity_TB number_of_enclosures
(Required) Changes system licensing for remote copy functions such as Metro Mirror, Global Mirror, and HyperSwap®. Specify the total number of internal and external enclosures that you have licensed on your system. You must have an enclosure license for all enclosures.
-virtualization number_of_enclosures
(Required) Changes system licensing for the Virtualization function. Specify the number of enclosures of external storage that you are authorized to use.
-compression number_of_enclosures
(Required) Changes system licensing for the compression function. Specify the total number of internal and external enclosures that you have licensed on your system. Only models that have installed extra memory module (16-GB DIMM) support compression.
-cloud number_of_enclosures
(Required) Specifies number of enclosures for the transparent cloud tiering function. The value must be a number.

Description

The chlicense command changes license settings for the system. Any change that is made is logged as an event in the license setting log.

The enclosure license already includes virtualization of internal drives on your system. You can use this command to set any additional options. The total number of enclosures in your system must not exceed the total number of licensed enclosures that you have. The total virtualized capacity (number of external enclosures that can be configured by the system) can also be modified with this command. The default is to have no function that is licensed, but it does not stop you from using related functions.

Any error that is placed in the license settings log results in a generic error being placed in the system error log. The command-line tool return code also notifies you that you are using an unlicensed function.

An invocation example for adding a remote copy license capacity of 5 TB

chlicense -remote 5

The resulting output:

No feedback

An invocation example for modifying a compression license value

chlicense -compression 4

The resulting output:

No feedback

An invocation example for changing the license on a cloud account

chlicense -cloud 2

The resulting output:

No feedback