chlicense

Use the chlicense command to change license settings for clustered system (system) features.

Syntax


>>- chlicense -- ----------------------------------------------->

>--+- -flash -- capacity_TB ----------------------------+------><
   +- -remote -- capacity_TB ---------------------------+   
   +- -virtualization -- virtualization_setting_in_scu -+   
   +- -compression -- compression_setting_in_scu -------+   
   '- -physical_flash --+- on --+-----------------------'   
                        '- off -'

Parameters

-flash capacity_TB: (Optional) Changes system licensing for the FlashCopy® feature. To change the licensed capacity for the FlashCopy feature, specify a capacity in terabytes (TB).
Note: Only use the optional flash parameter with the SAN Volume Controller .
-remote capacity_TB: (Optional) Changes system licensing for remote copy features such as Metro Mirror, Global Mirror, and HyperSwap®. To change the licensed capacity for one of these features, specify a capacity in terabytes (TB). You must have an enclosure license for all enclosures.
-virtualization virtualization_setting_in_scu: (Optional) Changes system licensing for the Virtualization feature. To change the licensed capacity for the Virtualization feature, specify a capacity in terabytes (TB).
-physical_flash on | off: (Optional) For physical disk licensing, enables or disables the FlashCopy feature. The default value is off.
-compression virtualization_setting_in_scu: (Optional) Changes system licensing for the compression feature.
To change the compression license capacity, specify a capacity value in terabytes (TB).

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 capacity for each licensed feature can be modified with this command. This is the number of terabytes (TB) of volume capacity or Storage Control Units (SCU) capacity that can be configured by the system.

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 feature.

When you reach 90% capacity, any attempt to create or extend volumes, relationships, or mappings generates an error message. You can still create and expand volumes, relationships, or mappings. When usage reaches or exceeds 100% capacity, errors are placed in the license settings log stating that you are using an unlicensed feature.

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