5.3.4 Check LU creation
Function
Verifies that a specified LU can be created by using Hitachi Device Manager Software (hereafter called Device Manager).
This module assumes the following servers:
• HDvM server
This is the server on which Device Manager is installed.
• HDvM CLI server (Execution target server)
This is the server on which Device Manager CLI is installed. The module is transferred from JP1/AO to this server and then is executed.
Checks the following:
• Whether a storage system with a specified serial number and family name has been registered in HDvM
If the storage system is not registered in HDvM, the result is false.
• Whether the device number of a specified DP volume is in use in the storage system
If the device number is already in use in the storage system, the result is false.
• Whether a DP pool with the ID of a specified DP pool and the ID of a specified host group has already been registered in the storage system
The module checks if a specified LU number is already in use in the storage system.
If either the DP pool ID or the host group ID does not exist or the LU number is already in use, the result is false.
• Whether a DP pool in a specified storage system has enough free space to create the DP volume
If the size of the DP volume is greater than the free space available in the DP pool, the result is false.
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 intend to add an LU, you first use this module to check whether the LU can be created in the data storage DP pool.
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 on 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 on the execution target server]
(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 on 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 the Storage system family name (custom option) (the property HDvM.familyText).
(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 belong to a user group with the following permissions:
User group to which All Resources is assigned as the resource group and that has Admin or Modify permissions
Version
02.00.00
Plug-in tags
Gather Storage information,Device Manager
Plug-in name displayed in the task log
hdvmCheckStorageSpec
Return code
0: Normal
12: Error (user error) Invalid property
21: Error (invalid environment) Command cannot be found (error detected in the module script)
27: Error (check task logs for the nature of error)
41: Error (error detected in module) Missing property (error detected in module script)
42: Error (error detected in module) Internal error (error detected in the module 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 which protocol, http or https, to use to connect to the HDvM server. |
http |
Input |
R |
HDvM.hostName |
Host name of the HDvM server |
Specify the host name or IP address of the HDvM server. An IPv6 address cannot be specified. |
-- |
Input |
R |
HDvM.portNumber |
Port number for connecting to HDvM |
Specify the port number for connecting to the HDvM server. |
2001 |
Input |
R |
HDvM.userName |
ID of the user who is connecting to HDvM |
Specify the ID of the user who is connecting to the HDvM server. |
System |
Input |
R |
HDvM.password |
Password for connecting to HDvM |
Specify the password for connecting to the HDvM server. |
manager |
Input |
R |
HDvM.serialNumber |
Serial number of the storage system |
Specify the serial number of the storage system to be checked. |
-- |
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.devNumber |
Device number of the DP volume (LU) |
Specify the device number in decimal of the DP volume before determining whether it can be used. |
-- |
Input |
R |
HDvM.pathPortName |
Port name of the path |
Specify the port name of the path to the DP volume (LU). |
-- |
Input |
R |
HDvM.lun |
LU Number (LUN) |
Specify the LU Number (LUN). |
-- |
Input |
R |
HDvM.poolId |
DP pool ID |
Specify the pool ID of the DP pool before determining whether the DP volume (LU) can be created there. |
-- |
Input |
R |
HDvM.capacity |
Space on the DP volume (LU) (GB) |
Specify the space in gigabytes of the DP volume (LU) before determining whether it can be created. |
1 |
Input |
R |
HDvM.numOfLUs |
Number of LUs |
Specify the number of LUs to be created. |
1 |
Input |
O |
HDvM.domainId |
Host group ID |
Specify the ID of the host group in decimal or hexadecimal before determining whether the DP volume (LU) can be added there. In the case of hexadecimal, the prefix "0x" must be used. |
-- |
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 |
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 |
common.checkStorageSpecResult |
LU creation check result |
Stores the result of determining whether the DP volume (LU) can be created. |
-- |
Output |
O |