3.12.2 Delete a virtual server (virtual disk)
Function
This service template disconnects volumes that are connected to instances in a KVM environment that is controlled by OpenStack.
The OpenStack-related terms used in this document are the names displayed in the OpenStack Dashboard. The OpenStack-related terms are:
- Identity
Displayed as "identity" or "KeyStone"
- Project
Displayed as "project" or "tenant"
- Volume
Displayed as "volume" or "block storage"
This service template requires the following servers:
- OpenStack server
A server on which OpenStack is installed
- KVM server
A server on which Kernel-based Virtual Machine is installed
- OpenStack control server
A server that executes the REST API on the OpenStack server
- Instance
An instance that is managed by the OpenStack server or by KVM. A general virtual server.
An overview of the processing is as follows:
(1) This service template disconnects volumes that are connected to instances.
This service template uses instance and volume names that have been specified by the user.
(2) The volumes can be deleted optionally.
This service template uses the volume names that have been specified by the user to delete the volumes.
Points to note concerning property settings:
(1) When volumes are disconnected, this service template waits the number of seconds that has been specified for the openstack.checkVolumeDetachmentInterval property, and then repeats the operation to check the status of the volumes the number of times that has been specified for the openstack.checkVolumeDetachmentCount property. Adjust the value of each property, according to the environment in use.
(2) When volumes are deleted, this service template waits the number of seconds that has been specified for the openstack.checkVolumeDeletionInterval property, and then repeats the operation to check the status of the volumes the number of times that has been specified for the openstack.checkVolumeDeletionCount property. Adjust the volume of each property, according to the environment in use.
Prerequisites
For the most recent information about the prerequisite products for the system, prerequisite products for the system executing the service templates, and the supported OSs for the prerequisite products for the system executing the service templates, see the release notes.
[Required product in the system]
JP1/Automatic Operation 11-10 or later
[Prerequisite products in the system executing the service template]
(1) Prerequisite products for an OpenStack server
- OpenStack
(2) Virtualization environment that manages instances
- Kernel-based Virtual Machine
- VMware vCenter Server
- VMware vSphere ESXi
(3) OpenStack control server
- Microsoft .Net Framework 3.5 or later
[Prerequisite product OS running in the system executing the service template]
(1) Prerequisite OSs for instances
- Red Hat Enterprise Linux Server 6 (32-bit x86), Red Hat Enterprise Linux Server 6 (64-bit x86_64)
- Red Hat Enterprise Linux Server 7 (64-bit x86_64)
(2) Prerequisite OSs for the OpenStack control server
- Windows Server 2008 R2 Standard/Enterprise/Datacenter
- Windows Server 2012 Standard/Datacenter
- Windows Server 2012 R2 Standard/Datacenter
Note that environments where Server Core is installed are excluded.
[Usage conditions of prerequisite products in the system executing the service template]
(1) Conditions related to instances
- Each instance name must be unique in a single project.
(2) Conditions related to volumes
- Each volume name must be unique in a single project.
Cautions
(1) When you disconnect volumes, make sure that they are unmounted. If volumes being mounted are disconnected, the file system might become corrupted.
(2) If specified instances and volumes exist together, the volumes are deleted even if no connection relation exists between the instances and volumes. Therefore, make sure that the specified volume names are correct.
Execution privilege
admin privileges
Version
02.00.00
Tags
Modify VM,OpenStack
Property list
The following shows the list of the property groups set in the property:
Property group |
Description |
Initial display |
---|---|---|
Cloud platform environment information |
Specify OpenStack information. |
Y |
Instance information |
Specify instance information. |
Y |
Volume information |
Specify information about volumes that are disconnected from instances. |
Y |
Runtime options |
Properties for a status check that is performed when instances are deleted. Change the properties as necessary. |
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 |
---|---|---|---|---|---|---|
openstack.targetHost |
Host name of the OpenStack control server |
Specify the host name or IP address of the OpenStack control server. Make sure that you do not specify an IPv6 address. |
Input |
Disabled |
R |
-- |
openstack.identityServerHostName |
Host name of the Identity server |
Specify the host name or IP address of the Identity server. Make sure that you do not specify an IPv6 address. |
Input |
Disabled |
R |
-- |
openstack.userName |
User name for logging in to the Identity server |
Specify the user name for logging in to the Identity server. |
Input |
Disabled |
R |
-- |
openstack.password |
Password for logging in to the Identity server |
Specify the password for logging in to the Identity server. |
Input |
Disabled |
R |
-- |
openstack.protocol |
Identity server connection protocol |
Specify the protocol that is used to connect to the Identity server. |
Input |
Disabled |
R |
-- |
openstack.portNumber |
Port number for connecting to the Identity server |
Specify the port number for logging in to the Identity server. |
Input |
Disabled |
R |
-- |
openstack.projectName |
Project name |
Specify a project name. |
Input |
Disabled |
R |
-- |
openstack.deleteVolumeEnabled |
Whether to delete volumes |
After disconnecting the volume, specify whether to delete the volume. If Yes is selected, the volume is deleted. |
Input |
Disabled |
R |
-- |
openstack.checkVolumeDetachmentCount |
Volume disconnection check count |
Specify the number of times to check whether a volume has been disconnected. This value and the volume disconnection check interval determine the maximum wait time. |
Input |
Disabled |
R |
-- |
openstack.checkVolumeDetachmentInterval |
Volume disconnection check interval |
Specify in seconds the interval at which to check whether a volume has been disconnected. |
Input |
Disabled |
R |
-- |
openstack.checkVolumeDeletionCount |
Volume deletion check count |
Specify the number of times to check whether a volume has been deleted. This value and the volume deletion check interval determine the maximum wait time. |
Input |
Disabled |
R |
-- |
openstack.checkVolumeDeletionInterval |
Volume deletion check interval |
Specify in seconds the interval at which to check whether a volume has been deleted. |
Input |
Disabled |
R |
-- |
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 |
---|---|---|---|---|---|---|
openstack.instanceName |
Instance name |
Specify the instance name. Note that the name you specify here is the display name of the instance in OpenStack, and is different from a host name in the OS. |
Input |
Disabled |
R |
-- |
openstack.volumeName |
Volume name |
Specify the name of a volume to be disconnected from an instance. |
Input |
Disabled |
R |
-- |
The following shows the restrictions on inputs to the properties displayed in the "Service Definition" window:
Property key |
Characters that can be input |
---|---|
openstack.targetHost |
-- |
openstack.identityServerHostName |
-- |
openstack.userName |
-- |
openstack.password |
-- |
openstack.protocol |
Select one of the following values: http,https |
openstack.portNumber |
-- |
openstack.projectName |
-- |
openstack.deleteVolumeEnabled |
Select one of the following values: yes,no |
openstack.checkVolumeDetachmentCount |
-- |
openstack.checkVolumeDetachmentInterval |
-- |
openstack.checkVolumeDeletionCount |
-- |
openstack.checkVolumeDeletionInterval |
-- |
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 |
---|---|
openstack.instanceName |
-- |
openstack.volumeName |
-- |
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 |
openstackDetachVolume |
Disconnect volumes |
Disconnects volumes from instances. |
Check the task log, remove the cause of the error, and then run this service again. |
2 |
JudgeValuePlugin |
Judge Value Plug-in |
Judges whether to delete a volume. |
-- |
3 |
openstackDeleteVolume |
Delete volumes |
Deletes volumes. |
Check the task log, and then remove the case of the error. If the volumes have not been deleted, delete the volume manually. |