Changing pool limitations, performance class, or pool threshold parameters

Use the pool_change_config command to change storage pool configuration.

pool_change_config pool=PoolName [ lock_behavior=<read_only|no_io> ] [ perf_class=perfClassName ]
        [ restore_thresholds=<yes|no> | hysteresis=HysteresisValue | < code=EventCode 
		severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL|NONE> threshold=<ThresholdValue|NONE> > ]

Parameters

Name Type Description Mandatory Default
pool Object name Name of the storage pool. Y N/A
lock_
behavior
 Enumeration Sets whether and how the pool is locked upon space depletion. N read_only
perf_class Object name Name of the performance class pool. N No performance class
code N/A Event code. N No code
severity Enumeration Severity. N No severity
threshold Integer Threshold value, or NONE to indicate that an event with this severity is not created. N No threshold
restore_
thresholds
 Boolean Restore thresholds to default values. N no
hysteresis Integer Hysteresis value, indicate the hysteresis of the event throwing. N "3"

This command changes the pool behavior when running out of thin provisioning space.

For thin provisioned storage pools, the lock_behavior parameter sets how the pool is locked upon space depletion. The pool can be locked for write, or for both read and write.

Example: 

 pool_change_config pool=VOL_BREED_None_0 lock_behavior=read_only

This command changes the performance class of the pool.

Example: 

 pool_change_config pool=VOL_BREED_None_1 perf_class=valid_perf_class_name

This command changes the thresholds parameters of the pool or resets it to the default thresholds value.

Example: 

 pool_change_config pool=VOL_BREED_None_1 code=STORAGE_POOL_VOLUME_USAGE_INCREASED severity=INFORMATIONAL threshold=40
		  pool_change_config pool=VOL_BREED_None_1 code=STORAGE_POOL_SNAPSHOT_USAGE_INCREASED severity=INFORMATIONAL threshold=50
		  pool_change_config pool=VOL_BREED_None_1 restore_thresholds=yes

Output: 

Command executed successfully.

Access control

User Category Permission
Storage administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Operations administrator Disallowed
Host side accelerator client Disallowed

Return codes

  • POOL_DOES_NOT_EXIST

    Storage pool does not exist.

  • PERF_CLASS_BAD_NAME

    Performance class does not exist.

  • POOL_ALREADY_IN_PERF_CLASS

    Pool pool name already in performance class Performance Class.

  • OPERATION_DENIED_OBJECT_MANAGED

    This is a managed object. Only the managing software and xiv_maintenance / xiv_development may complete this operation on this object.

  • UNRECOGNIZED_EVENT_CODE

    'String' is not a recognized event code.

    Troubleshooting: Consult the manual for the list of event codes.

  • EVENT_DOES_NOT_HAVE_THRESHOLDS

    Event does not have thresholds.

  • EVENT_THRESHOLD_IS_ILLEGAL

    Illegal value for event threshold.

    Troubleshooting: Event threshold values must be monotonic.

  • PERF_CLASS_ASSOCIATED_WITH_HOSTS

    Performance class Performance Class is already in use by host.