chlicense

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

Syntax

chlicense { -remoteenclosures | [ -virtualizationenclosures ] | [ -compressionenclosures ] }

Parameters

-remoteenclosures: (Optional) Changes system licensing for remote copy features 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.
-virtualizationenclosures: (Optional) Changes system licensing for the Virtualization feature. Specify the number of enclosures of external storage that you have been authorized to use.
-compression: (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