diff options
Diffstat (limited to 'doc/manual/en_US/user_Installation.xml')
| -rw-r--r-- | doc/manual/en_US/user_Installation.xml | 72 |
1 files changed, 42 insertions, 30 deletions
diff --git a/doc/manual/en_US/user_Installation.xml b/doc/manual/en_US/user_Installation.xml index 12a83841..2661b259 100644 --- a/doc/manual/en_US/user_Installation.xml +++ b/doc/manual/en_US/user_Installation.xml @@ -1363,60 +1363,72 @@ virtualbox virtualbox/delete-old-modules boolean true</screen> <sect2 id="solaris-zones"> - <title>Configuring a Zone for Running &product-name;</title> + <title>Configuring a Non-Global Zone for Running &product-name;</title> <para> - Assuming that &product-name; has already been installed into - your zone, you need to give the zone access to &product-name;'s - device node. This is done by performing the following steps. - Start a root terminal and run the following command: + After installing &product-name; in the global zone + (see <xref linkend="install-solaris-host"/> for the installation instructions) + the first step required to run &product-name; in a + non-global zone is to modify the zone's configuration to be able to access the + &product-name; device nodes located in the global zone. + This is done by performing the following steps as a zone administrator in the global zone. </para> -<screen>zonecfg -z <replaceable>vboxzone</replaceable></screen> +<screen>global$ zonecfg -z <replaceable>vboxzone</replaceable></screen> <para> Replace <replaceable>vboxzone</replaceable> with the name of the - zone where you intend to run &product-name;. + non-global zone where you plan to run &product-name;. </para> <para> - Use <command>zonecfg</command> to add the - <literal>device</literal> resource and <literal>match</literal> - properties to the zone, as follows: + Use <command>zonecfg(8)</command> to add the + <literal>device</literal> resource and the <literal>match</literal> + property for each &product-name; device node in the global zone to + the non-global zone as follows: </para> -<screen>zonecfg:vboxzone>add device -zonecfg:vboxzone:device>set match=/dev/vboxdrv -zonecfg:vboxzone:device>end -zonecfg:vboxzone>add device -zonecfg:vboxzone:device>set match=/dev/vboxdrvu -zonecfg:vboxzone:device>end -zonecfg:vboxzone>exit</screen> +<screen>zonecfg:vboxzone> add device +zonecfg:vboxzone:device> set match=/dev/vboxdrv +zonecfg:vboxzone:device> end +zonecfg:vboxzone> add device +zonecfg:vboxzone:device> set match=/dev/vboxdrvu +zonecfg:vboxzone:device> end +zonecfg:vboxzone> exit</screen> <para> - On Oracle Solaris 11 or later, you may also add a device for - <filename>/dev/vboxusbmon</filename>, similar to that shown - above. + On Oracle Solaris 11 if you plan to use VMs configured to use a USB device, e.g. a USB + pointing device or a USB pass-through device, you should also pass through the + <filename>/dev/vboxusbmon</filename> device using the steps above. </para> <para> - If you are not using sparse root zones, you will need to + Oracle Solaris 11 doesn't support sparse root zones so you will need to loopback mount <filename>/opt/VirtualBox</filename> from the global zone into the non-global zone at the same path. This is - specified below using the <literal>dir</literal> attribute and - the <literal>special</literal> attribute. For example: + done using <command>zonecfg(8)</command> to set the <literal>dir</literal> + attribute and the <literal>special</literal> attribute for this directory. + For example: </para> -<screen>zonecfg:vboxzone>add fs -zonecfg:vboxzone:device>set dir=/opt/VirtualBox -zonecfg:vboxzone:device>set special=/opt/VirtualBox -zonecfg:vboxzone:device>set type=lofs -zonecfg:vboxzone:device>end +<screen>zonecfg:vboxzone> add fs +zonecfg:vboxzone:fs> set dir=/opt/VirtualBox +zonecfg:vboxzone:fs> set special=/opt/VirtualBox +zonecfg:vboxzone:fs> set type=lofs +zonecfg:vboxzone:fs> add options [readonly] +zonecfg:vboxzone:fs> end zonecfg:vboxzone>exit</screen> <para> - Reboot the zone using <command>zoneadm</command> and you should - be able to run &product-name; from within the configured zone. + After making the above changes using <command>zonecfg(8)</command>, reboot the zone + using <command>zoneadm(8)</command> as follows: + </para> + +<screen>global$ zoneadm -z <replaceable>vboxzone</replaceable> reboot</screen> + + <para> + for the changes to take effect. You will then be able to run + &product-name; from /opt/VirtualBox within the configured non-global zone. </para> </sect2> |