chlicense

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

Syntax

 chlicense    {  -remote  enclosures  |  -virtualization  number_of_enclosures  |  -easytier  enclosures  |  -flash  enclosures | [  -compression  enclosures  ] }

Parameters

 -remote  enclosures 
(Optional) Changes system licensing for the Metro Mirror, Global Mirror, or HyperSwap feature. 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  enclosures 
(Optional) Changes system licensing for the virtualization feature and specifies the number of enclosures of external storage that you have been authorized to use.
 -easytier  enclosures 
(Optional) Specifies the enclosures on which you can run Easy Tier.
 -flash  enclosures 
(Optional) Specifies the total number of internal and external enclosures for the FlashCopy feature.
 -compression  enclosures 
(Optional) Changes system licensing for the compression feature.

Only models that have installed additional memory module (16 GB DIMM) support compression.

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

chlicense -easytier 2

The resulting output:

No feedback

An invocation example for changing the license on a cloud account

chlicense -cloud 2

The resulting output:

No feedback