5.2.1 Create DP volume
Function
Creates a specified virtual volume (DP volume) by using Hitachi Device Manager Software (hereafter called HDvM).
This plugin assumes the following servers:
• HDvM server
Server on which HDvM is installed.
• HDvM CLI server (Execution target server)
Server on which HDvM CLI is installed. The plugin is sent to this server by JP1/AO and then is executed.
Use situation
When you add a virtual server and virtual disk, you use this plugin to create a DP volume at the data storage destination.
You can achieve this processing by combining this plugin with the following plugins:
• storageAddHostgroupLU
• vsphereRecognizeLU
• vsphereGetCanonicalName
• vsphereCreateDatastore
Prerequisites
For the latest support information about [Required product in the System]/[Required products on the execution target server]/[Prerequisite product OS running in the execution target server], see the release notes.
[Required product in the System]
Job Management Partner 1/Automatic Operation 10-50 or later
[Required products on the execution target system]
(1) The following product has been set up on the HDvM server.
• Hitachi Device Manager Software 07-00 or later
(2) As the storage system within the system, either of the following has been set up.
• Hitachi Adaptable Modular Storage 2000
• Hitachi Universal Storage Platform
• Hitachi Virtual Storage Platform
• Hitachi Unified Storage 100
• Hitachi Unified Storage VM
• Hitachi Virtual Storage Platform G1000
[Usage conditions for required products in the execution target system]
(1) The storage system is managed by Hitachi Device Manager Software.
(2) A DP pool has already been created in the storage system.
[Required products on the execution target server]
• Hitachi Device Manager Software CLI 07-00 or later
[Prerequisite product OS running in the execution target server]
• Windows Server 2003, Standard Edition/Enterprise Edition (x86/x64) SP1 or later,Windows Server 2003 R2, Standard Edition/Enterprise Edition (x86/x64)
• Windows Server 2008 Standard/Enterprise (x86/x64),Windows Server 2008 R2 Standard/Enterprise/Datacenter
• Windows Server 2012 Standard/Datacenter,Windows Server 2012 R2 Standard/Datacenter
Execution privilege
(1) The user who will be connecting to HDvM must have the following permissions:
User with All Resources assigned as the resource group, and Modify permission granted
Version
01.13.00
Category
HCS/HDvM
Plug-in name displayed in the task log
storageCreateLU2
Return code
0: Normal
12: Error (user error) Invalid property
21: Error (invalid environment) Command cannot be found (error detected in the plugin script)
27: Error (check task logs for the nature of error)
41: Error (error detected in plugin) Missing property (error detected in plugin script)
42: Error (error detected in plugin) Internal error (error detected in the plugin script)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
HDvM.cliInstallPath |
HDvM CLI installation path |
Specify the HDvM CLI installation path. |
-- |
Input |
R |
HDvM.httpType |
Protocol for communication with HDvM |
Specify either HTTP or HTTPS as the protocol to be used for communication with HDvM. |
http |
Input |
R |
HDvM.hostName |
Host name of the HDvM server |
Specify the host name or IP address of the HDvM server. IPv6 addresses are not supported. |
-- |
Input |
R |
HDvM.portNumber |
Port number for connecting to HDvM |
Specify the port number for connecting to HDvM. |
2001 |
Input |
R |
HDvM.userName |
User name for connecting to HDvM |
Specify the user name for connecting to HDvM. |
System |
Input |
R |
HDvM.password |
Password for connecting to HDvM |
Specify the password for connecting to HDvM. |
manager |
Input |
R |
HDvM.serialNumber |
Serial number of the storage system |
Specify the serial number of the target storage system. |
-- |
Input |
R |
HDvM.family |
Storage system's family name |
Specify the family name of the storage system. You can specify AMS, USP_V, USP_VM, VSP, HUS, HUS VM or VSP G1000. |
-- |
Input |
R |
HDvM.creationOption |
Forcible option (for AMS and HUS) |
Specify "force" if you want a DP volume to be created even when the DP pool usage exceeds the warning-level threshold. |
-- |
Input |
O |
HDvM.groupOption |
Parity group option (for USP only) |
Specify "exist" if you add a DP volume to an existing parity group. Note that if you specify this property, you must also specify the HDvM.arrayGroupName property. |
-- |
Input |
O |
HDvM.arrayGroupName |
Virtual parity group name (for USP only) |
Specify the virtual parity group name in Xn-1 format (n: number). |
-- |
Input |
O |
HDvM.capacity |
Size of a DP volume to be created |
Specify (in GB) the capacity of the DP volume to be created. |
-- |
Input |
R |
HDvM.numOfLUs |
Number of LUs |
Specify the number of LUs to be created. |
1 |
Input |
O |
HDvM.devNumber |
Device number for the DP volume |
Specify a decimal number as the device number of the DP volume. |
-- |
Input |
O |
HDvM.clprNumber |
CLPR number of the LDEV (for USP, AMS and HUS) |
Specify the CLPR number of the LDEV. The default is 0, but if a value has been set for the HDvM.poolId property, the CLPR number of the DP pool is used as the default. |
-- |
Input |
O |
HDvM.poolId |
DP pool ID |
Specify the pool ID of the DP pool to be associated with the DP volume to be created. This specification is required for VSP, AMS, HUS, HUS VM or VSP G1000. |
-- |
Input |
O |
HDvM.threshold |
DP volume usage threshold (for USP only) |
Specify a multiple of 5 (in the range from 5 to 300) as the DP volume usage warning threshold (%). |
-- |
Input |
O |
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
HDvM.familyText |
Storage system family name (custom option) |
Specifies the family name of the storage system that is not on the selection list of the HDvM.family property. If you specify this property, the value specified in the HDvM.family property is ignored. |
-- |
Input |
O |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |