chlicense

Edit online

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

Syntax

Read syntax diagramSkip visual syntax diagram chlicense -flashcapacity_TB-remotecapacity_TB-virtualizationvirtualization_setting_in_scu-compressioncompression_setting_in_scu-physical_flashonoff

Parameters

Important: All of the parameters are mutually exclusive. Only one licensing function can be changed at a time.
-flash capacity_TB
(Required) Changes system licensing for the FlashCopy® function. Specify a capacity in terabytes (TB).
-remote capacity_TB
(Required) Changes system licensing for remote copy functions such as Metro Mirror, Global Mirror, and HyperSwap®. Specify a capacity in terabytes (TB).
-virtualization virtualization_setting_in_scu
(Required) Changes system licensing for the Virtualization function. Specify the total number of storage capacity units (SCUs) that you are licensed to virtualize across tiers of storage on your system.
-compression virtualization_setting_in_scu
(Required) Changes system licensing for the compression function. Specify the total number of storage capacity units (SCUs) that you are licensed to virtualize across tiers of storage on your system.
-physical_flash on | off
(Required) For physical disk licensing, this parameter enables or disables the FlashCopy function. The default value is off.

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 function can be modified with this command. This value 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 function.

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 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 modifying a compression license value

chlicense -compression 4

The resulting output:

No feedback