VirtualBox

source: vbox/trunk/doc/manual/en_US/dita/topics/iscsi-intnet.dita@ 105145

Last change on this file since 105145 was 99797, checked in by vboxsync, 21 months ago

Docs: bugref:10302. Merging changes from the docs team. Almost exclusively conkeyref related stuff.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 3.0 KB
Line 
1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
3<topic xml:lang="en-us" id="iscsi-intnet">
4 <title>Access iSCSI Targets Using Internal Networking</title>
5
6 <body>
7 <p>
8 As an experimental feature, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> enables access to an
9 iSCSI target running in a virtual machine which is configured to
10 use Internal Networking mode. See
11 <xref href="storage-iscsi.dita">iSCSI Servers</xref>,
12 <xref href="network_internal.dita">Internal Networking</xref>, and
13 <xref href="vboxmanage-storageattach.dita">VBoxManage storageattach</xref>.
14 </p>
15 <p>
16 The IP stack accessing Internal Networking must be configured in
17 the virtual machine which accesses the iSCSI target. A free
18 static IP and a MAC address not used by other virtual machines
19 must be chosen. In the example below, adapt the name of the
20 virtual machine, the MAC address, the IP configuration, and the
21 Internal Networking name (MyIntNet) according to your needs. The
22 following eight commands must first be issued:
23 </p>
24 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
25VBoxInternal/Devices/IntNetIP/0/Trusted 1
26$ VBoxManage setextradata <varname>VM-name</varname> \
27VBoxInternal/Devices/IntNetIP/0/Config/MAC 08:00:27:01:02:0f
28$ VBoxManage setextradata <varname>VM-name</varname> \
29VBoxInternal/Devices/IntNetIP/0/Config/IP 10.0.9.1
30$ VBoxManage setextradata <varname>VM-name</varname> \
31VBoxInternal/Devices/IntNetIP/0/Config/Netmask 255.255.255.0
32$ VBoxManage setextradata <varname>VM-name</varname> \
33VBoxInternal/Devices/IntNetIP/0/LUN#0/Driver IntNet
34$ VBoxManage setextradata <varname>VM-name</varname> \
35VBoxInternal/Devices/IntNetIP/0/LUN#0/Config/Network MyIntNet
36$ VBoxManage setextradata <varname>VM-name</varname> \
37VBoxInternal/Devices/IntNetIP/0/LUN#0/Config/TrunkType 2
38$ VBoxManage setextradata <varname>VM-name</varname> \
39VBoxInternal/Devices/IntNetIP/0/LUN#0/Config/IsService 1</pre>
40 <p>
41 Finally the iSCSI disk must be attached with the
42 <codeph>--intnet</codeph> option to tell the iSCSI initiator to
43 use internal networking, as follows:
44 </p>
45 <pre xml:space="preserve">$ VBoxManage storageattach ... --medium iscsi --server 10.0.9.30 \
46--target iqn.2008-12.com.sun:sampletarget --intnet</pre>
47 <p>
48 Compared to a regular iSCSI setup, the IP address of the target
49 <i>must</i> be specified as a numeric IP address,
50 as there is no DNS resolver for internal networking.
51 </p>
52 <p>
53 The virtual machine with the iSCSI target should be started
54 before the VM using it is powered on. If a virtual machine using
55 an iSCSI disk is started without having the iSCSI target powered
56 up, it can take up to 200 seconds to detect this situation. The
57 VM will fail to power up.
58 </p>
59 </body>
60
61</topic>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette