Changing pool settings for snapshots

Use the pool_config_snapshots command to change the storage pool snapshot settings.

pool_config_snapshots pool=PoolName [ protected_snapshot_priority=<0|1|2|3|4> ]

Parameters

Name Type Description Mandatory Default
pool Object name Name of the storage pool. Y N/A
protected_
snapshot_
priority
 Integer Specifies a snapshot delete priority between 0 and 4; snapshots with a lower delete priority (i.e., higher number) than the specified value might be deleted by the system automatically to free space, before pausing mirroring, thus protecting snapshots with a priority equal or higher than the value. If for example the value is set to 3, the system will deactivate mirroring if not enough space can be freed even after the deletion of snapshots with delete priority 4. Snapshots with priority level 1, 2 and 3 will not be deleted. If the value is set to 4, the system will deactivate mirroring before deleting any snapshots. If the value is set to 0, the system can delete any snapshot regardless of deletion priority. N unchanged

This command changes the storage pool snapshot limitation policy.

The create_last_consistent_snapshot attribute (used for systems which have no space):
  • If the value of the attribute is "no", no last consistent snapshot is generated.
  • If value is changed while synchronizing, the existing snapshot is not deleted.
The protected_snapshot_priority attribute:
  • Snapshots with a lower delete priority (i.e., higher number) than the specified value might be deleted by the system automatically, in order to free space, before pausing the mirroring, thus protecting snapshots with a priority equal or higher than the value.
  • If, for example, the value is set to 3:
    • The system will deactivate mirroring if not enough space can be freed even after the deletion of snapshots with deletion priority of 4.
    • Snapshots with priority level 1, 2 and 3 will not be deleted.
  • If the value is set to 4, the system will deactivate mirroring before deleting any of the snapshots.
  • If the value is set to 0, the system can delete any snapshot regardless of deletion priority.

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

Warnings

  • ARE_YOU_SURE_YOU_WANT_TO_CHANGE_THE_PROTECTED_LEVEL_OF_SNAPSHOTS

    Are you sure you want to change the protected level of snapshot in storage pool Pool? Note that in case of pool space depletion the system will delete protected snapshots only after deleting unprotected snapshots and internal asynchronous mirror snapshots.

  • ARE_YOU_SURE_YOU_WANT_TO_INCREASE_THE_PROTECTED_LEVEL_OF_
    EXISTING_SNAPSHOTS

    Are you sure you want to increase the protected level of snapshot in storage pool Pool? Note that the pool contains unprotected snapshots that will become protected after issuing this command. In case of pool space depletion the system will delete protected snapshots only after deleting unprotected snapshots and internal asynchronous mirror snapshots.

  • ARE_YOU_SURE_YOU_WANT_TO_DECREASE_THE_PROTECTED_LEVEL_OF_
    EXISTING_SNAPSHOTS

    Are you sure you want to decrease the protected level of snapshot in storage pool Pool? Note that the pool contains protected snapshots that will become unprotected after issuing this command.In case of pool space depletion the system will delete internal asynchronous mirror snapshots only after deleting unprotected snapshots.

Return codes

  • POOL_DOES_NOT_EXIST

    Storage pool does not exist.

  • SNAPSHOT_ILLEGAL_PRIORITY

    Illegal snapshot priority; must be an integer between 1 and 4.

  • 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.