VirtualBox

Changeset 103593 in vbox for trunk/doc


Ignore:
Timestamp:
Feb 27, 2024 6:12:40 PM (9 months ago)
Author:
vboxsync
Message:

doc/manual: Update the User Manual to correct and clarify the
instructions detailing the required configuration steps to be able to
run VirtualBox within non-global zones on Solaris hosts.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/dita/topics/solaris-zones.dita

    r99797 r103593  
    33  PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
    44<topic xml:lang="en-us" id="solaris-zones">
    5                <title>Configuring a Zone for Running <ph conkeyref="vbox-conkeyref-phrases/product-name"/></title>
    6                
     5               <title>Configuring a Non-Global Zone for Running <ph conkeyref="vbox-conkeyref-phrases/product-name"/></title>
     6
    77               <body>
    88                  <p>
    9         Assuming that <ph conkeyref="vbox-conkeyref-phrases/product-name"/> has already been installed into
    10         your zone, you need to give the zone access to <ph conkeyref="vbox-conkeyref-phrases/product-name"/>'s
    11         device node. This is done by performing the following steps.
    12         Start a root terminal and run the following command:
     9        After installing <ph conkeyref="vbox-conkeyref-phrases/product-name"/> in the global zone
     10        (see <xref href="install-solaris-host.dita#install-solaris-host"/> for the installation instructions)
     11        the first step required to run <ph conkeyref="vbox-conkeyref-phrases/product-name"/> in a
     12        non-global zone is to modify the zone's configuration to be able to access the
     13        <ph conkeyref="vbox-conkeyref-phrases/product-name"/> device nodes located in the global zone.
     14        This is done by performing the following steps as a zone administrator in the global zone. 
    1315      </p>
    14                   <pre xml:space="preserve">zonecfg -z <varname>vboxzone</varname>
     16                  <pre xml:space="preserve">global$ zonecfg -z <varname>vboxzone</varname>
    1517                  </pre>
    1618                  <p>
    1719        Replace <varname>vboxzone</varname> with the name of the
    18         zone where you intend to run <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
     20        non-gloabl zone where you plan to run <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
    1921      </p>
    2022                  <p>
    21         Use <userinput>zonecfg</userinput> to add the
    22         <codeph>device</codeph> resource and <codeph>match</codeph>
    23         properties to the zone, as follows:
     23        Use <userinput>zonecfg(8)</userinput> to add the <codeph>device</codeph> resource
     24        and the <codeph>match</codeph> property for each
     25        <ph conkeyref="vbox-conkeyref-phrases/product-name"/> device node in the global
     26        zone to the non-global zone as follows:
    2427      </p>
    25                   <pre xml:space="preserve">zonecfg:vboxzone&gt;add device
    26 zonecfg:vboxzone:device&gt;set match=/dev/vboxdrv
    27 zonecfg:vboxzone:device&gt;end
    28 zonecfg:vboxzone&gt;add device
    29 zonecfg:vboxzone:device&gt;set match=/dev/vboxdrvu
    30 zonecfg:vboxzone:device&gt;end
    31 zonecfg:vboxzone&gt;exit</pre>
     28                  <pre xml:space="preserve">zonecfg:vboxzone&gt; add device
     29zonecfg:vboxzone:device&gt; set match=/dev/vboxdrv
     30zonecfg:vboxzone:device&gt; end
     31zonecfg:vboxzone&gt; add device
     32zonecfg:vboxzone:device&gt; set match=/dev/vboxdrvu
     33zonecfg:vboxzone:device&gt; end
     34zonecfg:vboxzone&gt; exit</pre>
    3235                  <p>
    33         On Oracle Solaris 11 or later, you may also add a device for
    34         <filepath>/dev/vboxusbmon</filepath>, similar to that shown
    35         above.
     36        On Oracle Solaris 11 if you plan to use VMs configured to use a USB device, e.g. a USB
     37        pointing device or a USB pass-through device, you should also pass through the
     38        <filepath>/dev/vboxusbmon</filepath> device using the steps above.
    3639      </p>
    3740                  <p>
    38         If you are not using sparse root zones, you will need to
     41        Oracle Solaris 11 doesn't support sparse root zones so you will need to
    3942        loopback mount <filepath>/opt/VirtualBox</filepath> from the
    40         global zone into the non-global zone at the same path. This is
    41         specified below using the <codeph>dir</codeph> attribute and
    42         the <codeph>special</codeph> attribute. For example:
     43        global zone into the non-global zone at the same path.  This is
     44        done using <userinput>zonecfg(8)</userinput> to set the <codeph>dir</codeph>
     45        attribute and the <codeph>special</codeph> attribute for this directory.
     46        For example:
    4347      </p>
    44                   <pre xml:space="preserve">zonecfg:vboxzone&gt;add fs
    45 zonecfg:vboxzone:device&gt;set dir=/opt/VirtualBox
    46 zonecfg:vboxzone:device&gt;set special=/opt/VirtualBox
    47 zonecfg:vboxzone:device&gt;set type=lofs
    48 zonecfg:vboxzone:device&gt;end
    49 zonecfg:vboxzone&gt;exit</pre>
     48                  <pre xml:space="preserve">zonecfg:vboxzone&gt; add fs
     49zonecfg:vboxzone:fs&gt; set dir=/opt/VirtualBox
     50zonecfg:vboxzone:fs&gt; set special=/opt/VirtualBox
     51zonecfg:vboxzone:fs&gt; set type=lofs
     52zonecfg:vboxzone:fs&gt; add options [readonly]
     53zonecfg:vboxzone:fs&gt; end
     54zonecfg:vboxzone&gt; exit</pre>
    5055                  <p>
    51         Reboot the zone using <userinput>zoneadm</userinput> and you should
    52         be able to run <ph conkeyref="vbox-conkeyref-phrases/product-name"/> from within the configured zone.
     56        After making the above changes using <userinput>zonecfg(8)</userinput>, reboot the zone
     57        using <userinput>zoneadm(8)</userinput> as follows:
     58        </p>
     59                  <pre xml:space="preserve">global$ zoneadm -z <varname>vboxzone</varname> reboot
     60                  </pre>
     61                  <p>
     62        for the changes to take effect.  You will then be able to run
     63        <ph conkeyref="vbox-conkeyref-phrases/product-name"/> from /opt/VirtualBox within the
     64        configured non-global zone.
    5365      </p>
    5466               </body>
    55                
     67
    5668            </topic>
Note: See TracChangeset for help on using the changeset viewer.

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