5.3.1 Create DP volume
Function
Creates a specified virtual volume (DP volume) by using Hitachi Device Manager Software (hereafter called Device Manager).
This plugin assumes the following servers:
• HDvM server
Server on which Device Manager is installed.
• HDvM CLI server (Execution target server)
Server on which Device Manager CLI is installed. The plugin is sent to this server by JP1/AO and then is executed.
The property to be used for specifying the family name of storage system varies depending on the type of storage system to be operated. For the following storage systems, specify the family name of the storage system for the family name of the storage system (custom option) (the property HDvM.familyText):
- For Hitachi Virtual Storage Platform G1500, specify VSP G1500.
- For Hitachi Virtual Storage Platform F1500, specify VSP F1500.
- For Hitachi Virtual Storage Platform G200/G400/G600/G800, specify VSP Gx00.
- For Hitachi Virtual Storage Platform F400/F600/F800, specify VSP Fx00.
For storage systems other than the above, specify the family name of the storage system for the family name of the storage system (the property HDvM.family).
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 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]
JP1/Automatic Operation 11-00 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 2100/2300/2500/2010
• Hitachi Unified Storage 110/130/150
• Hitachi Unified Storage VM
• Hitachi Universal Storage Platform V/VM
• Hitachi Virtual Storage Platform
• Hitachi Virtual Storage Platform G1000/G1500/F1500
• Hitachi Virtual Storage Platform G200/G400/G600/G800
• Hitachi Virtual Storage Platform F400/F600/F800
[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 2008 R2 Standard/Enterprise/Datacenter
• Windows Server 2012 Standard/Datacenter, Windows Server 2012 R2 Standard/Datacenter
Cautions
(1) Do not specify an unsupported storage system for the HDvM.familyText property.
(2) If the user ID set in the authentication information of Connection Destination definitions setting is not the built-in Administrator, one of the following conditions must be satisfied.
- The UAC feature in Windows is completely disabled.
- An RDP session has been established for the user ID set in the authentication information of the Connection Destination definitions setting on the target of connection destinations.
Execution privilege
(1) Administrators permissions
(2) The user who will be connecting to Device Manager must have the following permissions:
User with All Resources assigned as the resource group, and Modify permission granted
Version
02.00.00
Plug-in tags
Add New Storage,Device Manager
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 |
|
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 |
|
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 |
|
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |