In the Common Information Model (CIM) agent for the SAN Volume Controller,
the IBMTSSVC_StorageConfigurationService class provides all the methods
that are required for creating, modifying, and deleting an IBMTSSVC_StorageVolume
instance.
To create a new IBMTSSVC_StorageVolume instance, follow
these steps:
- Obtain the reference (CIMObjectPath) of the IBMTSSVC_StorageConfigurationService
instance that is associated with the IBMTSSVC_Cluster to which you
will assign the new volume.
- Invoke the IBMTSSVC_StorageConfigurationService. CreateOrModifyElementFromStoragePool()
method to create the new IBMTSSVC_StorageVolume with the following
parameter specifications:
- The Virtualization Type is set using the VirtualizationType parameter
(0,1,2 for striped, sequential or image).
- A Format flag can be used to specify that the volume is formatted
on creation or expansion.
- You can specify the BackendVolumes to place the extents for the
volume using the BackendVolume REF parameter.
- The PreferredNode parameter is used to set the preferred node
for the volume.
- The UnitDeviceID parameter can be used to set the Volume's Unit
Device ID on clusters that run software level 4.1.0 or higher.
- The ElementName parameter can be used to set the Volumes Name
at creation.
- The Autoexpand parameter
- Set ElementType to 2.
- Set Size to the desired volume size in bytes.
- Obtain the reference (CIMObjectPath) of the IBMTSSVC_ConcreteStoragePool
instance from which you will allocate an IBMTSSVC_StorageVolume.
- Set InPool to the reference (obtained in the previous
step) of the pool from which the volume will be allocated.
The following additional parameters are examples of those
that are available as part of the Virtual Disk (VDisk) Mirroring feature
or Space-Efficient Virtual Disk feature.
- Autoexpand
- Used to attempt to maintain a fixed amount of unused real capacity
on the virtual disk (VDisk), which is called the contingency capacity.
The capacity is initially set to the real capacity, which is
assigned when the VDisk is created. If you modify the real capacity,
the contingency capacity is reset to be the difference between the used
capacity and the real capacity.
- Copies
- Indicates the number of mirrored copies to create. Specify either
1 or 2.
- Grainsize
- Sets the grain size of a space-efficient VDisk. This
is valid only if RealSize is set. Valid options include 32, 64, 128,
or 256.
- Import
- Used to request the SAN Volume Controller to
import a space-efficient storage volume from the storage pool.
- IsSpaceEfficient
- Flag that is used to indicate that the created VDisks are space-efficient
VDisks. This does not apply to a modify operation.
- RealSizeBytes and RealSizePercent
- Indicates the real size of a space-efficient copy. These parameters
cannot be used together.
- WarningSizeBytes
- Indicates the set point of used capacity at which
point a warning is triggered. This parameter cannot be used with the WarningSizePercent parameter.
- WarningSizePercent
- Indicates the ratio of used capacity versus the VDisk virtual
capacity that triggers a warning. This parameter cannot be used with
the WarningSizeBytes parameter.