5.3.7 Register LU in host group
Function
Registers a specified LU into a specified host group 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, you use this plugin to register into a host group an LU created for storing the virtual server data.
The related plugins are as follows:
• storageCreateLU2
• 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) Operation target LUs and host groups have 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.
Execution privilege
(1) The user who will be connecting to Device Manager must have the following permissions:
User with the Modify or Admin role assigned
Version
02.00.00
Plug-in tags
Add New Storage,Device Manager
Plug-in name displayed in the task log
storageAddHostgroupLU
Return code
0: Normal
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)
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.pathName |
Path name of the DP volume |
Specify the path name of the DP volume. |
-- |
Input |
O |
|
HDvM.pathPortNumber |
Number of the port for connecting to the DP volume |
Specify the number of the port for connecting to the DP volume. Note that if you specify this parameter, you must specify either the HDvM.pathPortNumber or HDvM.pathPortName parameter. |
-- |
Input |
O |
|
HDvM.pathPortName |
Name of the port for connecting to the DP volume |
Specify the name of the port for connecting to the DP volume. Note that if you specify this parameter, you must specify either the HDvM.pathPortNumber or HDvM.pathPortName parameter. |
-- |
Input |
O |
|
HDvM.domainId |
ID of the host group to add DP volumes to |
Specify a decimal or hexadecimal number as the ID of the host group to which you want to add a DP volume. If you specify a hexadecimal number, prefix "0x" to the number. Note that you cannot specify both this parameter and the HDvM.domainNickname. |
-- |
Input |
O |
|
HDvM.domainNickname |
Nickname of the domain to add DP volumes to |
Specify the nickname of the host group to which you want to add a DP volume. Note that you cannot specify both this parameter and the HDvM.domainId parameter. |
-- |
Input |
O |
|
HDvM.scsiId |
SCSI ID |
Specify 15 for a fibre channel. |
-- |
Input |
O |
|
HDvM.lun |
LU number (LUN) |
Specify the LU number (LUN). |
-- |
Input |
R |
|
HDvM.devNumber |
Device number for the DP volume |
Specify the device number of the DP volume in decimal. Either HDvM.devNumber or HDvM.luseDevNums must be specified. |
-- |
Input |
O |
|
HDvM.luseDevNums |
List of LUSE device numbers |
Specify a list of LDEV numbers in decimal to create LUSE volumes at those paths. If there is more than one, separate them with commas. Either HDvM.devNumber or HDvM.luseDevNums must be specified. |
-- |
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 |