3.8.7 Delete virtual server (delete data store and LU)
Function
Deletes a data store from VMware vSphere ESXi (or VMware ESX Server; hereafter referred to collectively as ESX) and deletes the LU from the storage system.
This service template assumes the following servers:
• vCenter server
This is a server on which VMware vCenter Server is installed.
• vCenter control server
This is a server on which VMware vSphere PowerCLI is installed.
• ESX server
This is a server on which ESX is installed.
• HDvM server
This is a server on which Hitachi Device Manager Software is installed.
• HDvM CLI server
This is a server on which Hitachi Device Manager Software CLI is installed.
The service template performs the following processing:
(1) From the vCenter control server, performs data store deletion processing on an ESX server.
(2) From the HDvM CLI server, deletes the LU from the host group.
(3) From the HDvM CLI server, formats and deletes the specified virtual volume (DP volume).
Prerequisites
For the latest support information about [Required product for the system]/[Required products for the service template execution system]/[Prerequisite product OS running in the system executing the service template], see the release notes.
[Required product for the system]
Job Management Partner 1/Automatic Operation 10-50 or later
[Required products for the service template execution system]
(1) Required product for the vCenter server
• VMware vCenter Server 5.5, 5.1, 5.0, 4.1, or 4.0
(2) VMware vSphere ESXi (or VMware ESX Server) that manages virtual servers
• VMware vSphere ESXi 5.5, 5.1 or 5.0 or VMware ESX Server 4.1 or 4.0
(3) Required product for the vCenter control server
• VMware vSphere PowerCLI 5.5 Release1, 5.1 Release2, 5.0
(4) The product listed below must have already been set up on the servers in the system. Also, Hitachi Device Manager Software CLI must have already been set up on the HDvM CLI server.
• Hitachi Device Manager Software 07-00 or later
(5) One of the products listed below must have already been set up as the system's storage system (it must be an FC-SAN storage):
• 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
[Prerequisite product OS running in the system executing the service template]
(1) Required OS for the vCenter control server
• Windows Server 2008 R2 Standard/Enterprise/Datacenter
• Windows Server 2012 Standard/Datacenter
(2) Required OS for the HDvM CLI server
• Windows Server 2003, Standard Edition/Enterprise Edition (x86/x64) SP1 or later, Windows Server 2003 R2, or Standard Edition/Enterprise Edition (x86/x64)
• Windows Server 2008 Standard/Enterprise (x86/x64) or Windows Server 2008 R2 Standard/Enterprise/Datacenter
• Windows Server 2012 Standard/Datacenter,Windows Server 2012 R2 Standard/Datacenter
[Usage conditions of prerequisite products in the system executing the service template]
(1) VMware vSphere ESXi (or VMware ESX Server) is managed by vCenter.
(2) The storage system is managed by Hitachi Device Manager Software.
(3) If the VMware ESX Server version is 4.x, the following problem has been resolved:
• Unpresenting a LUN containing a datastore from ESX 4.x and ESXi 4.x
http://kb.vmware.com/kb/1015084
Cautions
(1) Make sure that no virtual server that is being used is stored in the data store that is to be deleted.
Execution privilege
(1) The user who will be connecting to VMware vCenter Server must have the following permissions:
System administrator role
(2) The user who will be connecting to Hitachi Device Manager Software must have the following permissions:
All Resources assigned as the resource group
Admin or Modify role
Version
01.50.01
Category
VM_Operations/Configuration/vSphere
Property list
The following shows the list of the property groups set in the property:
Property group |
Description |
Initial display |
---|---|---|
Virtual system environment information |
Specify the information for HDvM and VMware vCenter Server. |
Y |
Storage information |
Specify the storage information asociated with the DP volume to be deleted. |
Y |
Virtual environment information |
Specify the virtual environment information asociated with the data store to be deleted. |
Y |
Custom option |
Specify the information of storage system that cannot be specified as the select list of hdvm.hdvmArrayFamily property. |
N |
The following shows the list of the properties to be displayed in the "Service Definition" dialog box:
- (Legend)
-
R: The property must be specified.
O: The property can be omitted. However, the property might be mandatory depending on what is specified for other properties. See the Description of each property.
Property key |
Property name |
Description |
I/O type |
Shared |
Required |
Property group |
---|---|---|---|---|---|---|
hdvm.targetHost |
Host name of Device Manager CLI server |
Specify the host name or IP address of the server where Device Manager CLI is installed. You cannot specify an IPv6 address. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.cliInstallPath |
Installation path of Device Manager CLI |
Specify the installation path of Device Manager CLI. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.hdvmProtocol |
Protocol for HDvM communication |
Specify the protocol (http or https) to use when connecting to Device Manager server. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.hdvmHostName |
HDvM server host name |
Specify the host name or IP address of the Device Manager server. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.hdvmPortNumber |
Port number for HDvM connection |
Specify the port number used to connect to the Device Manager server. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.hdvmUserName |
User name for HDvM connection |
Specify the user ID to use when connecting to Device Manager server. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.hdvmPassword |
Password for HDvM connection |
Specify the password to use when connecting to Device Manager server. |
Input |
Disabled |
R |
Virtual system environment information |
vmware.targetHost |
Host name of VMware vCenter control server |
Specify the host name or IP address of the server (a server with vSphere PowerCLI installed) that will be used to control VMware vCenter. You cannot specify an IPv6 address. |
Input |
Disabled |
R |
Virtual system environment information |
vmware.vCenterServerName |
VMware vCenter server name |
Specify the host name or IP address of the VMware vCenter server. You cannot specify an IPv6 address. |
Input |
Disabled |
R |
Virtual system environment information |
vmware.userName |
User name for VMware vCenter Server connection |
Specify the user name to use when connecting to the VMware vCenter server. |
Input |
Disabled |
R |
Virtual system environment information |
vmware.password |
Password for VMware vCenter Server connection |
Specify the password to use when connecting to the VMware vCenter server. |
Input |
Disabled |
R |
Virtual system environment information |
vmware.portNumber |
Port number for VMware vCenter Server connection |
Specify the port number to use when connecting to the VMware vCenter server (specifically, the port number of the VMware vCenter server's Web service). If you omit this property, the default value of the VMware vCenter server applies. |
Input |
Disabled |
O |
Virtual system environment information |
vmware.protocol |
Protocol for VMware vCenter Server connection |
Specify the protocol to use when connecting to the VMware vCenter server. |
Input |
Disabled |
R |
Virtual system environment information |
hdvm.hdvmSerialNumber |
Storage system serial number |
Specify the serial number of the target storage system. |
Input |
Disabled |
R |
Storage information |
hdvm.hdvmArrayFamily |
Storage system family |
Specify the family name of the storage system. You can specify AMS, USP_V, USP_VM, VSP, HUS, HUS VM or VSP G1000. |
Input |
Disabled |
R |
Storage information |
hdvm.hdvmArrayFamilyText |
Storage system family name (custom option) |
Use this property to specify a storage system family name that is not included in the selection list for the hdvm.hdvmArrayFamily property. This property takes precedence over the hdvm.hdvmArrayFamily property. |
Input |
Disabled |
O |
Custom option |
hdvm.luFormatOption |
Whether to format the LU (custom option) |
Specify "yes" to format the LU before deleting it, or specify "no" to not format it. This property takes effect only if the value of the hdvm.hdvmArrayFamilyText property is not included in the selection list for the hdvm.hdvmArrayFamily property. |
Input |
Disabled |
R |
Custom option |
The following shows the list of the properties to be displayed on the "Service Definition" dialog box and the "Submit Service" dialog box:
Property key |
Property name |
Description |
I/O type |
Shared |
Required |
Property group |
---|---|---|---|---|---|---|
hdvm.hdvmPathPortName |
Path port name |
Specify the port name of the path to the DP volume (LU). |
Input |
Disabled |
R |
Storage information |
hdvm.hdvmDomainId |
Host group ID |
Specify the ID of the host group whose DP volume (LU) is to be deleted, as a decimal or hexadecimal number. Prefix hexadecimal numbers with "0x". |
Input |
Disabled |
R |
Storage information |
hdvm.hdvmDevNumber |
DP volume (LU) device number |
Specify the device number of the DP volume (LU) as a decimal. |
Input |
Disabled |
R |
Storage information |
vmware.vmHostName |
ESX server name |
Specify the ESX server name to be displayed in the Hosts and Clusters inventory view managed by VMware vCenter server. |
Input |
Disabled |
R |
Virtual environment information |
vmware.dataStoreName |
Datastore name |
Specify the datastore name. |
Input |
Disabled |
R |
Virtual environment information |
The following shows the restrictions on inputs to the properties displayed in the "Service Definition" dialog box:
Property key |
Characters that can be input |
---|---|
hdvm.targetHost |
A maximum of 255 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -. |
hdvm.cliInstallPath |
A character string of no more than 1024 characters can be entered. It cannot include <, >, |, ;, &, ^. |
hdvm.hdvmProtocol |
Select one of the following values: http,https |
hdvm.hdvmHostName |
A maximum of 255 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -. |
hdvm.hdvmPortNumber |
Integer between 1 and 65553 can be entered. |
hdvm.hdvmUserName |
A character string of between 1 and 256 characters can be entered. Characters that can be used include alphanumeric characters, as well as !, #, $, %, ', (, ), *, +, -, ., =, @, \, ^ and _. It cannot include a trailing \. |
hdvm.hdvmPassword |
A character string of between 4 and 256 characters can be entered. Characters that can be used include alphanumeric characters, as well as !, #, $, %, ', (, ), *, +, -, ., =, @, \, ^ and _. It cannot include a trailing \. |
vmware.targetHost |
A maximum of 256 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -. |
vmware.vCenterServerName |
A maximum of 256 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -. |
vmware.userName |
A maximum of 512 characters can be entered. Characters that can be used include alphanumeric characters and symbols. It cannot include <, >, |, ;, &, ', ", *, ?, [, ], `, /, :, =, , , +, %. |
vmware.password |
A maximum of 127 characters can be entered. Characters that can be used include alphanumeric characters and symbols. It cannot include <, >, |, ;, &, ', ", *, ?, [, ], `, %. |
vmware.portNumber |
Integer between 1 and 65535 can be entered. |
vmware.protocol |
Select one of the following values: http,https |
hdvm.hdvmSerialNumber |
Alphanumeric between 1 and 20 characters. |
hdvm.hdvmArrayFamily |
Select one of the following values: AMS,USP_V,USP_VM,VSP,HUS,HUS VM,VSP G1000 |
hdvm.hdvmArrayFamilyText |
A string that has 255 or fewer single-byte alphanumeric characters and symbols. The following symbols cannot be used: < > | ; & ' " * ? [ ] ` % |
hdvm.luFormatOption |
Select one of the following values: yes,no |
The following shows the restrictions on inputs to the property displayed on the "Service Definition" dialog box and the "Submit Service" dialog box:
Property key |
Characters that can be input |
---|---|
hdvm.hdvmPathPortName |
A character string of no less than 1 characters can be entered. It cannot include <, >, |, ;, &, or a trailing \. |
hdvm.hdvmDomainId |
Alphanumeric characters more than 1 characters can be entered. Followin characters can be entered. 0-9, a-f, A-F, and x. |
hdvm.hdvmDevNumber |
Integer between 0 and 524287 can be entered. |
vmware.vmHostName |
A maximum of 256 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -. |
vmware.dataStoreName |
A maximum of 42 characters can be entered. Characters that can be used include alphanumeric characters and symbols. It cannot include <, >, |, ;, &, ', ", *, ?, [, ], `, %. |
Flow specification details
The following table shows the detailed specification of the flow:
Hierarchy |
Display name |
Plug-in |
|||
---|---|---|---|---|---|
Plug-in name |
Version |
Description |
Error recovery method |
||
1 |
vsphereDeleteDatastore |
Delete data store |
01.00.04 |
Deletes a data store from VMware vSphere ESXi (or VMware ESX Server). |
Eliminate the cause of the error, and then re-execute the service. |
2 |
storageDeleteHostgroupLU |
Delete LU from host group |
01.13.00 |
Deletes the specified LU from the host group in a storage system managed by Device Manager. |
Eliminate the cause of the error, and then delete the LU manually. |
3 |
storageDeleteLU |
Delete DP volume |
01.13.00 |
Deletes the specified DP volume in the storage system managed by Device Manager. |
Eliminate the cause of the error, and then delete the LU manually. |