chlicense

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

Syntax

Read syntax diagramSkip visual syntax diagram
>>- chlicense -- ----------------------------------------------->

>--+- -remote -- number_of_enclosures ---------+---------------><
   +- -virtualization -- number_of_enclosures -+   
   '- -compression -- number_of_enclosures ----'   

Parameters

-remote  number_of_enclosures 
(Optional) Changes system licensing for remote copy features such as Metro Mirror and Global Mirror. Specify the total number of internal and external enclosures that you have licensed on your system. You must have a Metro Mirror and Global Mirror enclosure license for all enclosures.
-virtualization  number_of_enclosures 
(Optional) Changes system licensing for the Virtualization feature. Specify the number of enclosures of external storage that you have been authorized to use.
 -compression  number_of_enclosures 
(Optional) Changes system licensing for the compression feature.

Specifies the total number of internal and external enclosures that you have licensed on your system.

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 licensed, but this 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 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