raidcom modify pool

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25

Sets the options of a pool for Thin Image, Copy-on-Write Snapshot, Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe. This option also changes the setting of the data direct mapping attribute of the pool for Dynamic Provisioning.

When the -status or -deduplication option is specified, the operation is executed asynchronously with the command input. Check the completion of this process by using the raidcom get command_status command.

Note: If a failure occurs in a processor on an MP blade or a controller, this command cannot be run even on an MP blade or a controller on which no failure occurs.

Syntax

raidcom modify pool -pool {<pool ID#> | <pool naming>} 
   {-status {nml|stop_shrinking} | -user_threshold <threshold_1> 
   [<threshold_2>] | -tier <Tier number> [<ratio>]
   [-tier_buffer_rate <%>] | -subscription <%> | 
   -pool_attribute <pool_attribute> | -monitor_mode <Monitor mode> | 
   -blocking_mode <IO blocking mode> | -data_direct_mapping {enable|disable}
   | -deduplication yes -ldev_id <ldev#>… [-ssids <ssid> …] |
   -deduplication no | -suspend_tipair {yes | no} |
   -delete dsd_volumes} | -auto_add_poolvol enable 
   [-password <One Time Password>] | -auto_add_poolvol disable [-password 
   <One Time Password>] 

Options and parameters

-pool {<pool ID#> | <pool naming>}

Specifies the Pool ID (0-127) or pool name for Thin Image, Copy-on-Write Snapshot, Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe.

When only a number is specified, it is recognized as a pool ID. Therefore, to specify a pool whose name is a number, use the pool ID instead of the pool name.

-status <status>
Supported storage systems:
  • VSP G200, G400, G600, G800 and VSP F400, F600, F800

Specifies the status of the pool. To restore the pool status, specify "nml".

-status {nml|stop_shrinking}
Supported storage systems:
  • VSP 5000 series
  • VSP G130, G/F350, G/F370, G/F700, G/F900
Specifies the status of the pool:
  • nml: Pool status is restored.
  • stop_shrinking: Stops shrinking the pool.
-user_threshold <threshold_1> [<threshold_2>]

Sets a user-defined threshold.

  • For Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, and active flash for mainframe, you may specify two user-defined thresholds, and their valid ranges are 1-100%, respectively. If you specify <threshold_1> and <threshold_2>:

    the value of <threshold_1> is set as the threshold for WARNING specified to a pool.

    the value of <threshold_2> is set as the threshold for High water mark specified to a pool.

    If you specify only <threshold_1>, your specified value and the system default value (80%) are applied.

    The setting in which you specify only <threshold_1> is supported to maintain backward compatibility with microcode before 70-02-0x-xx/xx. Once you specify two user-defined thresholds, you must continue to specify two user-defined thresholds thereafter.

  • The valid range for Thin Image or Copy-on-Write Snapshot is 20-95%. You may specify only <threshold_1>. Even if you specify the value for <threshold_2>, the value is ignored.
-tier <Tier number> [<ratio>]

Specifies the pool information for Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe. This is specified when changing the free space percentage for a new allocation by each tier. When this option is specified, pool attribute changes into manual relocation.

<Tier number>:Tier number (1-3)

<ratio>: Free space percentage for new allocation(0-50) [%]

[-tier_buffer_rate <%>]

Specifies the pool information for Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe. Specifies the amount of reallocation buffer (2-40) for each tier in percent (%).

-subscription <%>

For VSP G130, G/F350, G/F370, G/F700, G/F900, an error occurs if you specify this option.

Sets the percentage (0-65535) of the subscription limit of V-VOL and Thin Image pair to the pool capacity.
  • 0 to 65534: Specified percentage
  • 65535: Unlimited
-pool_attribute <pool_attribute>

Specifies when changing the pool from Dynamic Provisioning/Dynamic Provisioning for Mainframe to Dynamic Tiering/Dynamic Tiering for Mainframe, or from Dynamic Tiering/Dynamic Tiering for Mainframe to Dynamic Provisioning/Dynamic Provisioning for Mainframe.

Specifies the following value depend on the type of pool desired to be changed.

  • dt_manual: Changes the pool from Dynamic Provisioning/Dynamic Provisioning for Mainframe to Dynamic Tiering/Dynamic Tiering for Mainframe. It is changed to manual relocation.
  • dp: Changes the pool from Dynamic Tiering/Dynamic Tiering for Mainframe to Dynamic Provisioning/Dynamic Provisioning for Mainframe.
-monitor_mode <monitor mode>

Specifies the monitoring mode for a Dynamic Tiering/Dynamic Tiering for Mainframe pool. Or specifies the availability of active flash.

  • period: Performs monitoring periodically.
  • continuous: Performs monitoring continuously.
  • realtime_tiering: Enables active flash.
  • non_realtime_tiering: Disables active flash.
-blocking_mode <IO blocking mode>

Sets the I/O activity (availability for read/write access) when the pool for Dynamic Provisioning, Dynamic Tiering, or active flash is full and when the pool for Dynamic Provisioning, Dynamic Tiering, or active flash is blocked. This option is ignored when the microcode version does not support the option.

Note: If the microcode version does not support this option, "-" is displayed in the BM column when you execute the raidcom get dp_pool command.
  • pool_full: If the pool is full, read/write access for the target DP-VOL is disabled. If the pool is blocked, read/write access for the target DP-VOL is enabled.
  • pool_vol_blockade: If the pool-VOL is blocked, read/write access for the target DP-VOL is disabled. If the pool-VOL is full, read/write access for the target DP-VOL is enabled.
  • full_or_blockade: If the pool is full or blocked, read/write access for the target DP-VOL is disabled.
  • no_blocking: If the pool is full and/or blocked, read/write access for the target DP-VOL is enabled.
-data_direct_mapping {enable| disable}
For VSP 5000 series, VSP G1x00, VSP F1500, : Changes the setting of the data direct mapping attribute of the pool for Dynamic Provisioning.
  • enable or yes: Changes a pool for Dynamic Provisioning to a pool for Dynamic Provisioning that has the data direct mapping attribute.
  • disable or no: Changes a pool for Dynamic Provisioning that has the data direct mapping attribute to a pool for Dynamic Provisioning.

For this command, you can specify "y" as an alias of "yes" or "n" as an alias of "no".

-deduplication yes -ldev_id <ldev#> … [-ssids <ssid> …]

Enables deduplication of the pool. When this option is specified, a deduplication system data volume that has an LDEV number (0 to 65279) specified for “-ldev_id <ldev#> …” is created.

For VSP 5000 series,VSP G/F350, G/F370, G/F700, G/F900, an error occurs if you specify this option.

If you want to assign an SSID to the deduplication system data volume to be created, specify “-ssids <ssid> …” in hexadecimal. SSIDs specified by “-ssids <ssid> …” are assigned to deduplication system data volumes specified for “-ldev_id <ldev#> …” in the order they were specified. If you omit this option, or specify auto for <ssid>, SSIDs are assigned automatically to the corresponding deduplication system data volumes.

The -ssids option can be specified only for VSP G1x00, VSP F1500.

If you specify multiple LDEVs, an error occurs because the current microcode does not support this function. If this happens, deduplication of the pool is not enabled.

-deduplication no

Disables deduplication of the pool. When this option is specified, a deduplication system data volume in this pool is deleted.

For VSP 5000 series,VSP G/F350, G/F370, G/F700, G/F900, an error occurs if you specify this option.

[-suspend_tipair {yes | no} ]

Specifies or cancels the setting for suspending Thin Image pairs when the high water mark threshold is exceeded.

  • yes: Suspends Thin Image pairs.
  • no: Cancels the setting of suspending Thin Image pairs.

For this command, you can specify "y" as an alias of "yes" or "n" as an alias of "no".

-delete dsd_volumes
Supported storage systems:
  • VSP 5000 series
  • VSP G130, G/F350, G/F370, G/F700, G/F900

Deletes the deduplication system data volume.

-auto_add_poolvol enable [-password <One Time Password>]
Contact customer support if you want to specify this option in the following storage systems:
  • VSP 5000 series
  • VSP G130, G/F350, G/F370, G/F700, G/F900

For VSP G1x00 and VSP F1500, "-password" does not need to be specified.

Automatically adds pool volumes for which accelerated compression of the parity group is enabled according to the compression ratio of the parity group for which accelerated compression is enabled.

-auto_add_poolvol disable [-password <One Time Password>]
Contact customer support if you want to specify this option in the following storage systems:
  • VSP 5000 series
  • VSP G130, G/F350, G/F370, G/F700, G/F900

For VSP G1x00 and VSP F1500, "-password" does not need to be specified.

Pool volumes for which accelerated compression of the parity group is enabled are not added automatically.

Examples

Restoring the status of a pool ID: 6.

# raidcom modify pool -pool 6 -status nml

Restoring the status of a pool name: my_ss_pool.

# raidcom modify pool -pool my_ss_pool -status nml

Changing the user-defined thresholds of the pool ID:6 of the pool for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe, WARNING to 70% and High water mark to 80%.

# raidcom modify pool -pool 6 -user_threshold 70 80

Changing the user-defined threshold of the pool ID: 6 of the pool for Thin Image or Copy-on-Write Snapshot to 80%.

# raidcom modify pool -pool 6 -user_threshold 80

Changing the free space percentage for a new allocation to the tier number 1 of the pool ID:6 for Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe to 30%.

# raidcom modify pool -pool 6 -tier 1 30

Changing the amount of reallocation buffer to the tier number 1 of the pool ID:6 for Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe to 20%.

# raidcom modify pool -pool 6 -tier 1 -tier_buffer_rate 20

Changing a Dynamic Provisioning/Dynamic Provisioning for Mainframe pool of the pool ID:6 to a Dynamic Tiering/Dynamic Tiering for Mainframe pool.

# raidcom modify pool -pool 6 -pool_attribute dt_manual

Changing a Dynamic Tiering/Dynamic Tiering for Mainframe pool of the pool ID:6 to a Dynamic Provisioning/Dynamic Provisioning for Mainframe pool.

# raidcom modify pool -pool 6 -pool_attribute dp

Changing the automatic relocation of the pool (Pool name: my_pool) for Dynamic Provisioning to manual relocation.

# raidcom modify pool -pool my_pool -pool_attribute dt_manual

Changing the monitoring mode of Dynamic Tiering/Dynamic Tiering for Mainframe pool of the pool ID: 6 to continuous.

# raidcom modify pool -pool 6 -monitor_mode continuous

When the pool is full, changing read/write of Dynamic Provisioning pool ID: 6 to rejected.

# raidcom modify pool -pool 6 -blocking_mode pool_full

Enabling active flash of Dynamic Tiering pool ID: 6.

# raidcom modify pool -pool 6 -monitor_mode realtime_tiering

Changing a pool (pool ID: 6) for Dynamic Provisioning to a pool for Dynamic Provisioning that has the data direct mapping attribute.

# raidcom modify pool -pool 6 -data_direct_mapping enable

Enabling deduplication of the pool (pool ID: 6) for Dynamic Provisioning to create a deduplication system data volume of LDEV: 400. For VSP 5000 series,VSP G/F350, G/F370, G/F700, G/F900, an error occurs.

# raidcom modify pool -pool 6 -deduplication yes -ldev_id 400

Enabling deduplication of the pool (pool ID: 6) for Dynamic Provisioning to create a deduplication system data volume of LDEV: 400, and assigning SSID: 0x0004 to the deduplication system data volume. For VSP 5000 series,VSP G/F350, G/F370, G/F700, G/F900, an error occurs.

# raidcom modify pool -pool 6 -deduplication yes -ldev_id 400 -ssids 0x0004

Disabling deduplication of the pool (pool ID: 6) for Dynamic Provisioning to delete a deduplication system data volume. For VSP 5000 series,VSP G/F350, G/F370, G/F700, G/F900, an error occurs.

# raidcom modify pool -pool 6 -deduplication no

Deleting the deduplication system data volume of the pool (pool ID: 6) for Dynamic Provisioning.

# raidcom modify pool -pool 6 -delete dsd_volumes

Suspending Thin Image pairs when the high water mark threshold of the pool (pool ID: 6) for Dynamic Provisioning is exceeded.

# raidcom modify pool -pool 6 -suspend_tipair yes

Canceling the setting for suspending Thin Image pairs when the high water mark threshold of the pool (pool ID: 6) for Dynamic Provisioning is exceeded.

# raidcom modify pool -pool 6 -suspend_tipair no

Disabling the setting for automatically adding pool volumes for which accelerated compression is enabled in the pool (pool ID: 6).

# raidcom modify pool -pool 6 -auto_add_poolvol disable -password
<One Time Password>

Disabling the setting for automatically adding pool volumes for which accelerated compression is enabled in the pool (pool ID: 6).

# raidcom modify pool -pool 6 -auto_add_poolvol disable

Enabling the setting for automatically adding pool volumes for which accelerated compression is enabled in the pool (pool ID: 6).

# raidcom modify pool -pool 6 -auto_add_poolvol enable -password <One Time Password>

Enabling the setting for automatically adding pool volumes for which accelerated compression is enabled in the pool (pool ID: 6).

# raidcom modify pool -pool 6 -auto_add_poolvol enable