chlicense

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

Syntax

chlicense { -flashnumber_of_enclosures | -remotenumber_of_enclosures | -virtualizationnumber_of_enclosures | -compressionnumber_of_enclosures | -easy_tiernumber_of_enclosures }

Parameters

Important: All of the parameters are mutually exclusive. Only one licensing function can be changed at a time.
-flashnumber_of_enclosures
(Required) Changes system licensing for the FlashCopy function. Specify the total number of internal and external enclosures for the FlashCopy function.
-remotenumber_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.
-virtualizationnumber_of_enclosures
(Required) Changes system licensing for the Virtualization function. Specify the number of enclosures of external storage that you are authorized to use.
-compressionnumber_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.
-easytiernumber_of_enclosures
(Required) Specifies the number of enclosures on which you can run Easy Tier.

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 enabling Easy Tier settings

chlicense -easytier 2

The resulting output:

No feedback