Operation: create-storage-pool

The create-storage-pool operation sends a request to the EMC SMI-S Provider to create a new storage pool (RAID Group or Thin Pool) in a specified storage system.

The create-storage-pool operation creates a pool whose RAID type is "Unbound", which means that it can be chosen later when the first LUN is created.

In general, it is recommended that storage pools are manually created and configured by the SAN administrators because it is not a repetitive operation.

Adapter Request Elements for 'create-storage-pool' Operation

Definition

Required

operation-name

Specifies the name of the operation you want to perform.

•	Valid value: create-storage-pool.

Yes

arguments

Parent element for <argument> element.

Yes

argument

Specifies a list of arguments that is required for this operation

Yes

target

Specifies the connection information for an EMC SMI-S Provider.

•

Valid value: The value specified for <target> element must be the same as the value that has been specified for the name attribute of <config> element in the adapter configuration. You can skip this element. In this case the request will be executed on the first defined adapter configuration. You can leave this element empty. In this case the request will be executed on the first defined adapter configuration.

•	Default value: The first defined adapter configuration.

timeout-secs

Specifies the time in seconds after which the attempt to connect to the EMC SMI-S Provider times out. The "timeout-secs" specified in adapter request overrides the value specified in adapter configuration.

•	Valid value: A numeric value which specifies the time in seconds.

•	Default Value: 180, if no "timeout-secs" is provided in adapter configuration.

You can specify one or more of the following elements to retrieve specific information. If none of the elements is specified, then all the details are fetched.

storage-system-name

Specifies the user defined storage system name.

•	Valid value: Please refer to the get-storage-system operation to list the valid values of this field.

•	Default value: None.

Yes

pool-type

Specifies the type of the pool to be created.

•	Valid value: RG, or TP

•	Default value: On Symmetrix systems, TP will be considered as the default pool type, while on CLARiiON systems, RG will be considered as the default pool type.

disk-type

Specifies the type of the disks that must be used to create the storage pool.

•	Valid value: None.

•	Default value: None.

thin-pool-name

Specifies the name of the thin pool that must be created. This element is applicable only if the 'pool-type' is TP. There is a constrain in the length of the pool name. By default, only the first 12 characters will be considered.

•	Valid value: Any valid string

•	Default value: None.

synchronous

Wait until the job completes.

•	Valid value: yes \| no

•	Default value: yes

job-completion-timeout-secs

Specifies the time in seconds after which the attempt to complete the job times out.

•	Valid value: A numeric value which specifies the time in seconds.

•	Default value: 180 seconds

raid-level

number-of-disks

disk-name

lun-name

For CLARiiON Storage Systems Only

Specifies the RAID level of the storage pool to be created, or the number of disks for the storage pool, or the disk names/LUN name(s) to use to create the storage pool.

•	Valid value: Any value. Please refer to the get-raid-level operation to retrieve a list of available RAID levels, or the get-disk operation to retrieve a list of available disks, or to the get-lun operation to retrieve the available LUN

•	Default value: None

If no value is specified, the storage pool is created with an "Unbound" RAID level. This means that the RAID level of the storage pool will be definitely assigned upon the first LUN creation.

Important Information

1.	When the number of disks is user-specified (manually), the RAID level is automatically selected and the disk name are automatically selected according to the information provided in the following table:

Number of Disks	RAID Level
2	RAID 1
3 or greater	RAID 5

2.	When the RAID level is user-specified (manually, the number of disk and the disk name is automatically selected according to the information provided in the following table.

RAID Level	Number of Disks
RAID 0	3
RAID 1	2
RAID 1/0	2
RAID 3	5
RAID 5	3
RAID 6	4

3.	When the disk name is user-specified (manually), the RAID level must also be manually specified. If the RAID level is not provided, then the create-storage-pool operation creates a pool whose RAID level type is "Unbound", which means that it can be chosen later when the first LUN is created.

Yes

raid-level

lun-name

size-bytes

For SYMMETRIX Storage Systems Only

Specifies the RAID level, or the LUN name(s), or the size-bytes used to create the storage pool.

Valid value: Any value. Please refer to the get-raid-level operation to retrieve the list of available RAID levels, or to the get-lun operation to retrieve the available LUN(s) of type Data Device.

Default value: None

Important Information

1.	When the RAID level is user-specified (manually), the element size-bytes must be specified, in order to create a new data device with the requested RAID level.

2.	When the size-bytes is user-specified (manually) and the RAID level is not specified then the default RAID level of the primordial pool is considered.

3.	When the LUN name is user-specified (manually), the specified LUNs are used to create the pool.

Note: make sure the specified LUN(s) is(are) of type data device and created from the same type of disk group.

Yes

Sample Adapter Request for 'create-storage-pool' Operation

Adapter Response Elements for 'create-storage-pool' Operation

Sample Adapter Response for 'create-storage-pool' Operation

<job-status-description>Completed – Storage pool Create</job-status-description>