Hitachi

JP1 Version 12 JP1/Automatic Operation Service Template Reference


5.4.12 Mount a virtual disk

Function

This component mounts a virtual disk on a Hyper-V server.

The following servers are required for this component:

- Hyper-V server (Execution target server)

This is the Windows server where Hyper-V is installed.

- Virtual server

This is a virtual server managed by Hyper-V.

Use situation

This component can be used to mount a virtual disk on the Hyper-V server.

Prerequisites

For the latest support information about [Required product in the 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 server]

(1)Prerequisite product of Hyper-V Server

- Windows Server 2008 R2 Hyper-V

(2)Prerequisite OS running in the virtual servers

- Windows Server 2008 R2 Standard/Enterprise/Datacenter

This does not apply to Server Core installation environments.

[Prerequisite product OS running in the execution target server]

- Windows Server 2008 R2 Standard/Enterprise/Datacenter

This does not apply to Server Core installation environments.

[Usage conditions for required products on the execution target server]

(1) The virtual server name must be unique within the Hyper-V server.

Cautions

(1) When a virtual disk of the virtual server is mounted on the Hyper-V server, an available drive letter on the Hyper-V server is temporarily assigned. If no drive letter is available on the Hyper-V server, this component terminates with an error. Before executing this component, make sure that drive letters are available on the Hyper-V server for the number of drives used by the virtual disk that is to be mounted.

Version

02.00.00

Plug-in tags

Modify VM,Hyper-V 2008

Plug-in name displayed in the task log

hypervMountVhd

Return code

0: Normal

12: Error (Mistake by user) A property is invalid.

23: Error (Invalid environment) The environment requirements are not met.

27: Error (Check the task log for error details.)

41: Error (An error was detected in the component.) A property was not entered. (An error was detected in the component script.)

Property list

The following table lists the properties:

Property key

Property name

Description

Default value

I/O type

Required

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

hyperv.vhdPath

Virtual disk file path (for first NIC)

Specifies the path of the virtual disk file (first NIC) as a full path.

--

Input

R

hyperv.vhdPath2

Virtual disk file path (for second NIC)

Specifies the path of the virtual disk file (second NIC) as a full path.

--

Input

O

hyperv.vhdPath3

Virtual disk file path (for third NIC)

Specifies the path of the virtual disk file (third NIC) as a full path.

--

Input

O

hyperv.vhdPath4

Virtual disk file path (for fourth NIC)

Specifies the path of the virtual disk file (fourth NIC) as a full path.

--

Input

O

hyperv.checkJobStateCountGetDriveList

Job monitoring count (Win32_LogicalDisk method)

This property adjusts the job monitoring count for monitoring requests to Hyper-V for processing (Win32_LogicalDisk method). You do not need to change the value of this property.

1440

Input

R

hyperv.checkJobStateIntervalGetDriveList

Job monitoring interval (Win32_LogicalDisk method)

This property adjusts the job monitoring interval for monitoring requests to Hyper-V for processing (Win32_LogicalDisk method). You do not need to change the value of this property.

5

Input

R

hyperv.returnDriveLetter

Drive letter

Stores the drive letter assigned to the virtual disk that was mounted by this component.

--

Output

O

common.returnValue

Return value for the plugin

The return value of this plugin stored.

--

Output

O

hyperv.returnVhdPath

Virtual disk file path

Stores the path of the virtual disk file as a full path.

--

Output

O