raidcom add dp_pool

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25
Create a pool for Dynamic Provisioning or Dynamic Provisioning for Mainframe by the specified resource. Or, add pool volumes to the pools for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe. A parity group, an LDEV, and a device group can be specified as a resource.
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.

If a cache memory, HIE, or a logical path inside the storage is blocked, the operation cannot be performed.

Tip: For VSP G130, G/F350, G/F370, G/F700, G/F900, specifying a parity group is recommended. When a parity group is specified, an LDEV is created and a pool volume is added. It is not necessary to create an LDEV in advance. In addition, you cannot add an existing LDEV as a pool volume.

When specifying a pool that is already created for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe, the specified LDEV is added as a pool volume.

Specify either one of Pool ID or Pool Name certainly. If both the Pool ID and Pool Name options are omitted, this command is rejected with EX_REQARG.

This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.

Syntax

raidcom add dp_pool {-pool_id <pool ID#> | -pool_name <pool 
    naming> | -pool_id <pool ID#> 
    -pool_name <pool naming>} 
   {-parity_grp_id <gnosgno> [-resource_id <resource group id >]
   | -ldev_id <ldev#> …[-cnt <count>] | -grp_opt <group option> 
   -device_grp_name <device group name> [<device name>]}
   [ -user_threshold <threshold_1>[<threshold_2>] ]
   [-suspend_tipair {yes | no}] 
   [-auto_add_poolvol {enable|disable}]

Options and parameters

-pool_id <pool ID#>

Specifies the Pool ID (0-127) for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe. When the specification of Pool ID is omitted, a Pool Name must be specified.

If a -pool_id option is non-numeric, the specified value is recognized as a pool name to identify the pool ID.

When you omit specifying -pool_id option, you need to specify -pool_name option.

When specifying the -pool_name option without a -pool_id option, the specified pool is searched first. If the pool exists, the pool volume is added to the corresponding pool. If the pool does not exist, a new pool is created and is assigned a pool ID. However, if the pool does not exist and multiple commands without the -pool_id option are executed simultaneously, the same pool ID might be assigned to multiple newly created pools.

To avoid this behavior, use the raidcom lock resource command in advance to lock all resource groups. If all the resource groups are locked, commands executed by other users cannot take out unused pool IDs from all the resource groups. If you create multiple pools, execute the next raidcom add snap_pool command after the execution of the current raidcom add snap_pool command is complete.

After the execution of all the raidcom add snap_pool commands are complete, use the raidcom unlock resource command to unlock all the resource groups.

-pool_name <pool naming>

Specifies a pool name of a pool for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe. Up to 32 characters can be specified.

When specifying a pool ID or a pool name, if the pool name exists in the specified pool ID, the pool name is overwritten. If the pool volume is added by specifying only a pool ID for already existing pool, the pool name is not changed. When the specification of Pool Name is omitted, a Pool ID must be specified. When the Pool ID is specified and the Pool Name and -device_grp_name option are omitted, a pool name is allocated automatically in the form of "New Pool<number>".

The -pool_name option cannot be specified by configuring only in numeric because numeric values are preferentially identified as a pool ID. Specifies a pool ID with the '-pool_id<pool ID#>' option.

-ldev_id <ldev#> …

Specifies the LDEV number (0 to 65279). Up to 64 of LDEVs can be specified at a time. For example:

  • -ldev_id 100
  • -ldev_id 100 - 110
  • -ldev_id 100 -cnt 10
[-cnt <count> ]

Specifies the count (2 to 64).

If this specificaion is omitted, "1" is used.

Up to 64 of LDEVs can be specified at a time.

-grp_opt <group option>

Specifies the device information extracted from the LDEV belonging to the device group. Specify "ldev" (fixed). The information of LDEV belonging to the device group is used.

-device_grp_name <device group name> [<device name>]

Specifies the name of device group (maximum 32 characters) to be operated.

To operate an LDEV in the device group, specify the device name of LDEV (maximum 32 characters) within the device group.

If the device name is omitted, all the LDEVs belonging in the device group are operated.

When the -pool_name option is omitted, the device group name changes into the pool name.

[-user_threshold <threshold_1> [<threshold_2>] ]

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. If you omit to specify the value, 70% and 80% are applied, automatically.

When you add a pool volume, this option is ignored even if it is specified. If you want to change the user defined threshold value of the additional pool volume, execute the raidcom modify pool command.

[-suspend_tipair {yes | no}]

Specifies whether to suspend Thin Image pairs when the threshold for high water mark is exceeded. This option is valid only for creating pairs.

  • yes: Thin Image pairs are suspended.
  • no: Thin Image pairs are not suspended.

If this option is omitted , "yes" is set.

[-auto_add_poolvol {enable|disable}]

Specifies whether to automatically add pool volumes for which accelerated compression is enabled. This option is valid only for creating pools. This option can be specified for VSP G1x00 or VSP F1500.

  • enable: Automatically adds pool volumes for which accelerated compression is enabled according to the compression ratio of a parity group for which accelerated compression is enabled.
  • disable: The pool volumes for which accelerated compression is enabled are not added automatically.
When these options are not specified, the default values will be applied as follows:
  • enable: When the storage system is VSP 5000 series or VSP G/F350, G/F370, G/F700, G/F900.
  • disable: When the storage system is VSP G1x00 or VSP F1500.

Examples

By using LDEVs:400, 401, and 402, creating a pool of Pool ID:1, Pool Name: my_pool for Dynamic Provisioning/Dynamic Provisioning for Mainframe.

# raidcom add dp_pool -pool_id 1 -pool_name my_pool -ldev_id 400 401 402

By using LDEVs:500, 501, and 502, creating a pool of Pool ID: Allocated automatically, Pool Name: my_pool for Dynamic Provisioning/Dynamic Provisioning for Mainframe.

# raidcom add dp_pool -pool_name my_pool -ldev_id 500 501 502

By using LDEVs:600, 601, and 602, creating a pool of Pool ID: 2, Pool Name: Allocated automatically for Dynamic Provisioning/Dynamic Provisioning for Mainframe.

# raidcom add dp_pool -pool_id 2 -ldev_id 600 601 602

By using LDEVs: 700, 701, and 702, creating a pool of Pool ID: 3, Pool Name: my_pool for Dynamic Provisioning, Dynamic Provisioning for Mainframe, with the user-defined thresholds WARNING specified to 70% and High water mark to 80%.

# raidcom add dp_pool -pool_id 3 -pool_name my_pool 
-ldev_id 700 701 702 -user_threshold 70 80

Add LDEV: 368 to the pool ID: 10 for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe.

# raidcom add dp_pool -pool_id 10 -ldev_id 368

By using LDEV belonging to the device group: grp1, creating a pool of Pool ID:1, pool name: Allocated automatically for Dynamic Provisioning/Dynamic Provisioning for Mainframe.

# raidcom add dp_pool -pool_id 1 -grp_opt ldev -device_grp_name grp1

By using LDEVs: 800, 801, and 802, creating a pool of Pool ID: 4, Pool Name: my_pool for Dynamic Provisioning, with the user-defined thresholds WARNING specified to 70% and High water mark to 80%, and Thin Image pairs are suspended when the high water mark threshold is exceeded.

# raidcom add dp_pool -pool_id 4 -pool_name my_pool -ldev_id 800 801 802 -user_threshold 70 80 -suspend_tipair yes

Using an LDEV ID of resource group ID: 0, creating an LDEV for parity group: 1-1, and then creating a pool of Pool ID: 1, Pool Name: Allocated automatically for Dynamic Provisioning or Dynamic Provisioning for Mainframe.

# raidcom add dp_pool -pool_id 1 -parity_grp_id 1-1 -resource_id 0

Using LDEVs: 500, 501, and 502, creating a pool of Pool ID: Allocated automatically and Pool Name: my_pool for Dynamic Provisioning for which automatic addition settings of pool volumes whose accelerated compression is enabled: enabled.

# raidcom add dp_pool -pool_name my_pool -ldev_id 500 501 502 -auto_add_poolvol enable