Previous page

Next page

Locate page in Contents

Print this page

forward_device

WindowsThis call is currently available on Windows only.

Summary:

Makes a SCSI device on the Hardware Node accessible from within a Virtuozzo Container.

Request specification:

Name

Min/Max

Type

Description

forward_device

 

 

 

{

 

 

 

forward

1..1

 

 

{

 

 

 

source

1..1

 

Source device information.

{

 

 

 

eid

0..1

eid_type

Not used here.

device

1..1

common_deviceType

The device information.

Use scsi_deviceType type -- the the subtype of common_deviceType -- when populating this structure.

}

 

 

 

destination

1..1

 

Target device information.

{

 

 

 

eid

0..1

eid_type

Target server ID.

device

1..1

common_deviceType

The device info as you want to be displayed in the target server.

}

 

 

 

}

 

 

 

}

 

 

 

Returns:

OK/Error

Description:

This functionality exists for the purpose of setting up SAN (Storage Area Networks) based Container clustering. One of the requirements for setting up SAN based clustering is the ability to access remote storage devices (shared SCSI, fiberchannel, etc.) from within a Container by mounting such a device inside the Container. The forward_device call allows to accomplish this task. The source device information must include the name and the ID of the device (the ID is contained in the physical_name element). To retrieve the list of SCSI devices available on the Hardware Node, use the list_device call and select the entries from the result set that are contained in the device element of type scsi_deviceType. The following is an example of such an entry:

<ns2:device xsi:type="ns2:scsi_deviceType">

<ns2:name>S SCSI Disk Device</ns2:name>

<ns2:description>Disk drive</ns2:description>

<ns2:physical_name>

U0NTSVxESVNLJlZFTl9WTVdBUkVfJlBST0Rf

Vk1XQVJFX1ZJUlRVQUxfUyZSRVZfMS4wXDQm

M0E3Mzk1MjkmMCYwMDA=

</ns2:physical_name>

</ns2:device>

The target device information must include the ID of the server where you would like to mount the drive, and the device info (name, description) as you want it to be displayed in the target server.

Example:

Input

<packet xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/devm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4.0.0">

<target>vzadevm</target>

<data>

<vzadevm>

<forward_device>

<forward>

<source>

<ns2:device xsi:type="ns2:scsi_deviceType">

<ns2:name>S SCSI Disk Device</ns2:name>

<ns2:description>Disk drive</ns2:description>

<ns2:physical_name>U0NTSVxESVNLJlZFTl9WTVdBUkVfJlBST0RfVk1XQVJFX1ZJUlRVQUxfUyZSRVZfMS4wXDQmM0E3Mzk1MjkmMCYwMDA=</ns2:physical_name>

</ns2:device>

</source>

<destination>

<eid>7f29d970-3e31-46f3-9b59-2654329e3e55</eid>

<ns2:device xsi:type="ns2:scsi_deviceType">

<ns2:name>My SCSI Disk Device</ns2:name>

<ns2:description>Disk drive</ns2:description>

</ns2:device>

</destination>

</forward>

</forward_device>

</vzadevm>

</data>

</packet>

Please send us your feedback on this help page