Hitachi

JP1 Version 12 JP1/Automatic Operation Service Template Reference


3.15.5 Delete Datastore on VMware vSphere

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).

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).

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]

JP1/Automatic Operation 12-00 or later

[Required products for the service template execution system]

(1) Required product for the vCenter server

• VMware vCenter Server 7.0, 6.7, 6.5, 6.0, 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 7.0, 6.7, 6.5, 6.0, 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 6.3 Release1, 6.0 Release3, 6.0 Release1, 5.8 Release1, 5.5 Release2, 5.5 Release1, 5.1 Release2, 5.0

• VMware PowerCLI 6.5 Release1

• VMware PowerCLI 6.5.1, 6.5.4

· VMware PowerCLI 10.1.0, 10.1.1, 11.3.0, 12.0.0, 12.1.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 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

[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, Windows Server 2012 R2 Standard/Datacenter

• Windows Server 2016 Standard/Datacenter

• Windows Server 2019 Standard/Datacenter

(2) Required OS for the HDvM CLI server

• 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.

(2) Do not specify an unsupported storage system for the hdvm.hdvmArrayFamilyText property.

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

02.11.00

Tags

Delete VM,VMware 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 associated with the DP volume to be deleted.

Y

Virtual environment information

Specify the virtual environment information associated 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" window:

(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" window and the "Submit Service" window:

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" window:

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" window and the "Submit Service" window:

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

Description

Error recovery method

1

vsphereDeleteDatastore

Delete data store

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

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

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.