The chlicense command changes license settings for cluster features.
Syntax
>>- svctask -- -- chlicense -- ---------------------------------> >--+- -flash capacity_TB ----------+-------------------------->< +- -remote capacity_TB ---------+ +- -virtualization capacity_TB -+ +- -physical_flash -+- on --+----+ | '- off -' | +- -physical_remote -+- on --+---+ | '- off -' | '- -physical_disks --- number ---'
Parameters
- -flash capacity_TB
- (Optional) Changes cluster licensing for the FlashCopy® feature. To change the licensed capacity for the FlashCopy feature, specify a capacity in terabytes (TB).
- -remote capacity_TB
- (Optional) Changes cluster licensing for the Metro Mirror and Global Mirror feature. To change the licensed capacity for the Metro Mirror and Global Mirror feature, specify a capacity in terabytes (TB).
- -virtualization capacity_TB
- (Optional) Changes cluster licensing for the Virtualization feature. To change the licensed capacity for the Virtualization feature, specify a capacity in terabytes (TB).
- -physical_flash on | off
- (Optional) For physical disk licensing, enables or disables the FlashCopy feature. The default value is off.
- -physical_remote on | off
- (Optional) For physical disk licensing, enables or disables the Metro Mirror and Global Mirror feature. The default value is off.
- -physical_disks number
- (Optional) Changes the licensed settings of the cluster for physical disk licensing. Enter the number of physical disks that your cluster is licensed to manage. The correct number is identified in your license.
- If the -physical_disks value is set to zero, the -physical_flash and -physical_remote values are turned off.
- If the -physical_disks value is nonzero, the -flash, -remote, and -virtualization values cannot be set.
- If the -flash, -remote, or -virtualization values are nonzero, the -physical_flash, -physical_remote, and -physical_disks values cannot be set.
- If the -physical_disks value is nonzero, only the FlashCopy and RemoteCopy usage is monitored and appropriate error messages are logged.
Description
The chlicense command changes license settings for the cluster. Any change that is made is logged as an event in the license setting log.
SAN Volume Controller version 4.3.1 provides two license options: physical disk licensing and capacity licensing. To select physical disk licensing, run the svctask chlicense command with the -physical_disks parameter. To select capacity licensing, run the svctask chlicense command with the -flash, -remote, or -virtualization parameter.
By default, the Copy Services functions are disabled, but this does not stop you from creating and using copy services. However, errors are placed in the license settings log that state that you are using an unlicensed feature. The command-line tool return code also notifies you that you are using an unlicensed feature.
The total virtualized capacity can also be modified with this command. This is the number of terabytes (TB) of virtual disk capacity that can be configured by the cluster.
When you reach 90% capacity, any attempt to create or extend Virtual Disks, Relationships, or Mappings results in a message from the command-line tool. This does not stop you from creating and expanding Virtual Disks, Relationships, or Mappings. When usage reaches or exceeds 100% capacity, errors are placed in the license settings log.
Any error that is placed in the license settings log results in a generic error being placed in the cluster error log. This occurs when you issue a command that violates the license agreement. The return code also notifies you that you are violating the license settings.
An invocation example
svctask chlicense -flash 5
The resulting output
No feedback