This 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 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Source device information. |
|
|
|
|
|
|
Not used here. |
|
|
|
The device information. Use |
|
|
|
|
|
|
|
|
Target device information. |
|
|
|
|
|
|
Target server ID. |
|
|
|
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>