| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE topic
|
|---|
| 3 | PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 4 | <topic xml:lang="en-us" id="solaris-zones">
|
|---|
| 5 | <title>Configuring a Non-Global Zone for Running <ph conkeyref="vbox-conkeyref-phrases/product-name"/></title>
|
|---|
| 6 |
|
|---|
| 7 | <body>
|
|---|
| 8 | <p>After installing <ph conkeyref="vbox-conkeyref-phrases/product-name"/> in the global zone (see
|
|---|
| 9 | <xref href="install-solaris-host.dita#install-solaris-host"/> for the installation instructions) the first step
|
|---|
| 10 | required to run <ph conkeyref="vbox-conkeyref-phrases/product-name"/> in a non-global zone is to modify the zone's
|
|---|
| 11 | configuration to be able to access the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> device nodes located
|
|---|
| 12 | in the global zone. This is done by performing the following steps as a zone administrator in the global zone. </p>
|
|---|
| 13 | <pre xml:space="preserve">global$ zonecfg -z <varname>vboxzone</varname>
|
|---|
| 14 | </pre>
|
|---|
| 15 | <p>Replace <varname>vboxzone</varname> with the name of the non-gloabl zone where you plan to run <ph
|
|---|
| 16 | conkeyref="vbox-conkeyref-phrases/product-name"/>. </p>
|
|---|
| 17 | <p>Use <userinput>zonecfg(8)</userinput> to add the <codeph>device</codeph> resource and the
|
|---|
| 18 | <codeph>match</codeph> property for each <ph conkeyref="vbox-conkeyref-phrases/product-name"/> device node in
|
|---|
| 19 | the global zone to the non-global zone as follows: </p>
|
|---|
| 20 | <pre xml:space="preserve">zonecfg:vboxzone> add device
|
|---|
| 21 | zonecfg:vboxzone:device> set match=/dev/vboxdrv
|
|---|
| 22 | zonecfg:vboxzone:device> end
|
|---|
| 23 | zonecfg:vboxzone> add device
|
|---|
| 24 | zonecfg:vboxzone:device> set match=/dev/vboxdrvu
|
|---|
| 25 | zonecfg:vboxzone:device> end
|
|---|
| 26 | zonecfg:vboxzone> exit</pre>
|
|---|
| 27 | <p>On Oracle Solaris 11 if you plan to use VMs configured to use a USB device, e.g. a USB pointing
|
|---|
| 28 | device or a USB pass-through device, you should also pass through the <filepath>/dev/vboxusbmon</filepath> device
|
|---|
| 29 | using the steps above. </p>
|
|---|
| 30 | <p>Oracle Solaris 11 does not support sparse root zones so you will need to loopback mount
|
|---|
| 31 | <filepath>/opt/VirtualBox</filepath> from the global zone into the non-global zone at the same path. This is
|
|---|
| 32 | done using <userinput>zonecfg(8)</userinput> to set the <codeph>dir</codeph> attribute and the
|
|---|
| 33 | <codeph>special</codeph> attribute for this directory. For example: </p>
|
|---|
| 34 | <pre xml:space="preserve">zonecfg:vboxzone> add fs
|
|---|
| 35 | zonecfg:vboxzone:fs> set dir=/opt/VirtualBox
|
|---|
| 36 | zonecfg:vboxzone:fs> set special=/opt/VirtualBox
|
|---|
| 37 | zonecfg:vboxzone:fs> set type=lofs
|
|---|
| 38 | zonecfg:vboxzone:fs> add options [readonly]
|
|---|
| 39 | zonecfg:vboxzone:fs> end
|
|---|
| 40 | zonecfg:vboxzone> exit</pre>
|
|---|
| 41 | <p>After making the above changes using <userinput>zonecfg(8)</userinput>, reboot the zone using
|
|---|
| 42 | <userinput>zoneadm(8)</userinput> as follows: </p>
|
|---|
| 43 | <pre xml:space="preserve">global$ zoneadm -z <varname>vboxzone</varname> reboot
|
|---|
| 44 | </pre>
|
|---|
| 45 | <p>for the changes to take effect. You will then be able to run <ph
|
|---|
| 46 | conkeyref="vbox-conkeyref-phrases/product-name"/> from /opt/VirtualBox within the configured non-global zone. </p>
|
|---|
| 47 | </body>
|
|---|
| 48 |
|
|---|
| 49 | </topic>
|
|---|
