chlicense

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

Syntax

Read syntax diagramSkip visual syntax diagram chlicense -virtualizationcapacity_TB

Parameters

Important: All of the parameters are mutually exclusive. Only one licensing function can be changed at a time.
-virtualization capacity_TB
(Required) Changes system licensing for the Virtualization function. Specify a capacity 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 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 virtualization license capacity of 5 TB

chlicense -virtualization 5

The resulting output:

No feedback