svn commit: r41062 - head/en_US.ISO8859-1/books/handbook/virtualization
Dru Lavigne
dru at FreeBSD.org
Thu Feb 28 15:40:57 UTC 2013
Author: dru
Date: Thu Feb 28 15:40:57 2013
New Revision: 41062
URL: http://svnweb.freebsd.org/changeset/doc/41062
Log:
This is a minor content fixup as much work is needed in this chapter.
This patch addresses the following:
- minor rewording for "you"
- fix xref and guimenuitem tags (need to review ulinks)
- enforce consistency in app names
- note on vbox 4.0.0 removed as this port hasn't been less than this version for 22 months
Approved by: gjb (mentor)
Modified:
head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml Thu Feb 28 13:17:34 2013 (r41061)
+++ head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml Thu Feb 28 15:40:57 2013 (r41062)
@@ -66,23 +66,23 @@
<itemizedlist>
<listitem>
- <para>Understand the basics of &unix; and &os; (<xref
- linkend="basics"/>).</para>
+ <para>Understand the <link linkend="basics">basics of &unix;
+ and &os;</link>.</para>
</listitem>
<listitem>
- <para>Know how to install &os; (<xref
- linkend="install"/>).</para>
+ <para>Know how to <link linkend="install">install
+ &os;</link>.</para>
</listitem>
<listitem>
- <para>Know how to set up your network connection (<xref
- linkend="advanced-networking"/>).</para>
+ <para>Know how to <link linkend="advanced-networking">set up a
+ network connection</link>.</para>
</listitem>
<listitem>
- <para>Know how to install additional third-party
- software (<xref linkend="ports"/>).</para>
+ <para>Know how to <link linkend="ports">install additional
+ third-party software</link>.</para>
</listitem>
</itemizedlist>
</sect1>
@@ -91,7 +91,7 @@
<title>&os; as a Guest OS</title>
<sect2 id="virtualization-guest-parallels">
- <title>Parallels on MacOS</title>
+ <title><application>Parallels</application> on &macos; X</title>
<para><application>Parallels Desktop</application> for &mac; is
a commercial software product available for &intel; based
@@ -104,8 +104,8 @@
<sect3 id="virtualization-guest-parallels-install">
<title>Installing &os; on Parallels/&macos; X</title>
- <para>The first step in installing &os; on &macos;
- X/<application>Parallels</application> is to create a new
+ <para>The first step in installing &os; on
+ <application>Parallels</application> is to create a new
virtual machine for installing &os;. Select
<guimenuitem>&os;</guimenuitem> as the <guimenu>Guest OS
Type</guimenu> when prompted:</para>
@@ -116,8 +116,8 @@
</imageobject>
</mediaobject>
- <para>And choose a reasonable amount of disk and memory
- depending on your plans for this virtual &os; instance.
+ <para>Choose a reasonable amount of disk and memory
+ depending on the plans for this virtual &os; instance.
4GB of disk space and 512MB of RAM work well for most uses
of &os; under <application>Parallels</application>:</para>
@@ -174,16 +174,16 @@
</imageobject>
</mediaobject>
- <para>After your &os; virtual machine has been created, you
- will need to install &os; on it. This is best done with an
- official &os; CDROM or with an ISO image downloaded from an
- official FTP site. When you have the appropriate ISO image
- on your local &mac; filesystem or a CDROM in your &mac;'s CD
- drive, click on the disc icon in the bottom right corner of
- your &os; <application>Parallels</application> window. This
- will bring up a window that allows you to associate the
- CDROM drive in your virtual machine with an ISO file on disk
- or with your real CDROM drive.</para>
+ <para>After the &os; virtual machine has been created, &os;
+ can be installed on it. This is best done with an
+ official &os; CD/DVD or with an ISO image downloaded from an
+ official FTP site. Copy the appropriate ISO image to the
+ local &mac; filesystem or insert a CD/DVD in the &mac;'s CD
+ drive. Click on the disc icon in the bottom right corner of
+ the &os; <application>Parallels</application> window. This
+ will bring up a window that can be used to associate the
+ CDROM drive in the virtual machine with the ISO file on disk
+ or with the real CDROM drive.</para>
<mediaobject>
<imageobject>
@@ -191,12 +191,10 @@
</imageobject>
</mediaobject>
- <para>Once you have made this association with your CDROM
- source, reboot your &os; virtual machine as normal by
- clicking the reboot icon.
- <application>Parallels</application> will reboot with a
- special BIOS that first checks if you have a CDROM just as a
- normal BIOS would do.</para>
+ <para>Once this association with the CDROM source has been
+ made, reboot the &os; virtual machine by clicking the reboot
+ icon. <application>Parallels</application> will reboot with
+ a special BIOS that first checks if there is a CDROM.</para>
<mediaobject>
<imageobject>
@@ -205,10 +203,9 @@
</mediaobject>
<para>In this case it will find the &os; installation media
- and begin a normal <application>sysinstall</application>
- based installation as described in <xref
- linkend="install"/>. You may install, but do not attempt
- to configure X11 at this time.</para>
+ and begin a normal &os; installation. Perform the
+ installation, but do not attempt to configure
+ <application>&xorg;</application> at this time.</para>
<mediaobject>
<imageobject>
@@ -216,8 +213,8 @@
</imageobject>
</mediaobject>
- <para>When you have finished the installation, reboot into
- your newly installed &os; virtual machine.</para>
+ <para>When the installation is finished, reboot into the
+ newly installed &os; virtual machine.</para>
<mediaobject>
<imageobject>
@@ -227,7 +224,8 @@
</sect3>
<sect3 id="virtualization-guest-parallels-configure">
- <title>Configuring &os; on &macos; X/Parallels</title>
+ <title>Configuring &os; on
+ <application>Parallels</application> </title>
<para>After &os; has been successfully installed on &macos;
X with <application>Parallels</application>, there are a
@@ -248,35 +246,32 @@
<programlisting>kern.hz=100</programlisting>
<para>Without this setting, an idle &os;
- <application>Parallels</application> guest
- OS will use roughly 15% of the CPU of a single
- processor &imac;. After this change the usage will be
- closer to a mere 5%.</para>
+ <application>Parallels</application> guest will use
+ roughly 15% of the CPU of a single process &imac;.
+ After this change the usage will be closer to 5%.</para>
</step>
<step>
<title>Create a New Kernel Configuration File</title>
- <para>You can remove all of the SCSI, FireWire, and USB
- device drivers. <application>Parallels</application>
- provides a virtual network
- adapter used by the &man.ed.4; driver, so
- all other network devices except for
- &man.ed.4; and &man.miibus.4; can be
- removed from the kernel.</para>
+ <para>All of the SCSI, FireWire, and USB device drivers
+ can be removed from a custom kernel configuration file.
+ <application>Parallels</application> provides a virtual
+ network adapter used by the &man.ed.4; driver, so all
+ network devices except for &man.ed.4; and &man.miibus.4;
+ can be removed from the kernel.</para>
</step>
<step>
<title>Configure Networking</title>
- <para>The most basic networking setup involves simply
- using DHCP to connect your virtual machine to the same
- local area network as your host &mac;. This can be
- accomplished by adding
+ <para>The most basic networking setup uses DHCP to connect
+ the virtual machine to the same local area network as
+ the host &mac;. This can be accomplished by adding
<literal>ifconfig_ed0="DHCP"</literal> to
<filename>/etc/rc.conf</filename>. More advanced
- networking setups are described in
- <xref linkend="advanced-networking"/>.</para>
+ networking setups are described in <link
+ linkend="advanced-networking"></link>.</para>
</step>
</procedure>
</sect3>
@@ -592,26 +587,27 @@ xenbr1 8000.feffffffffff no
</sect2>
-->
<sect2 id="virtualization-guest-virtualpc">
- <title>Virtual PC on &windows;</title>
+ <title><application>Virtual PC</application> on
+ &windows;</title>
<para><application>Virtual PC</application> for &windows; is a
µsoft; software product available for free download.
- See <ulink
+ See this website for the <ulink
url="http://www.microsoft.com/windows/downloads/virtualpc/sysreq.mspx">
system requirements</ulink>. Once <application> Virtual PC
</application> has been installed on µsoft.windows;,
- the user must configure a virtual machine and then install
+ the user can configure a virtual machine and then install
the desired guest operating system.</para>
<sect3 id="virtualization-guest-virtualpc-install">
- <title>Installing &os; on Virtual
- PC/µsoft.windows;</title>
+ <title>Installing &os; on <application>Virtual
+ PC</application></title>
<para>The first step in installing &os; on
- µsoft.windows; /<application>Virtual PC
- </application> is to create a new virtual machine for
- installing &os;. Select <guimenuitem>Create a virtual
- machine</guimenuitem> when prompted:</para>
+ <application>Virtual PC </application> is to create a new
+ virtual machine for installing &os;. Select
+ <guimenuitem>Create a virtual machine</guimenuitem> when
+ prompted:</para>
<mediaobject>
<imageobject>
@@ -625,7 +621,7 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>And select <guimenuitem>Other</guimenuitem> as the
+ <para>Select <guimenuitem>Other</guimenuitem> as the
<guimenuitem>Operating system</guimenuitem> when
prompted:</para>
@@ -636,10 +632,9 @@ xenbr1 8000.feffffffffff no
</mediaobject>
<para>Then, choose a reasonable amount of disk and memory
- depending on your plans for this virtual &os;
- instance. 4GB of disk space and 512MB of RAM work well
- for most uses of &os; under
- <application>Virtual PC</application>:</para>
+ depending on the plans for this virtual &os; instance.
+ 4GB of disk space and 512MB of RAM work well for most uses
+ of &os; under <application>Virtual PC</application>:</para>
<mediaobject>
<imageobject>
@@ -661,7 +656,7 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Select your &os; virtual machine and click
+ <para>Select the &os; virtual machine and click
<guimenu>Settings</guimenu>, then set the type of networking
and a network interface:</para>
@@ -677,18 +672,18 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>After your &os; virtual machine has been created, you
- will need to install &os; on it. This is best done with an
- official &os; CDROM or with an ISO image downloaded from an
- official FTP site. When you have the appropriate ISO image
- on your local &windows; filesystem or a CDROM in your CD
- drive, double click on your &os; virtual machine to boot.
- Then, click <guimenu>CD</guimenu> and choose
- <guimenu>Capture ISO Image...</guimenu> on
+ <para>After the &os; virtual machine has been created, &os;
+ can be installed on it. This is best done with an
+ official &os; CD/DVD or with an ISO image downloaded from an
+ official FTP site. Copy the appropriate ISO image to the
+ local &windows; filesystem or insert a CD/DVD in the CD
+ drive, then double click on the &os; virtual machine to
+ boot. Then, click <guimenu>CD</guimenu> and choose
+ <guimenu>Capture ISO Image...</guimenu> on the
<application>Virtual PC</application> window. This will
- bring up a window that allows you to associate the CDROM
- drive in your virtual machine with an ISO file on disk or
- with your real CDROM drive.</para>
+ bring up a window where the CDROM drive in the virtual
+ machine can be associated with an ISO file on disk or
+ with the real CDROM drive.</para>
<mediaobject>
<imageobject>
@@ -702,13 +697,11 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Once you have made this association with your CDROM
- source, reboot your &os; virtual machine as normal by
- clicking the <guimenu>Action</guimenu> and
- <guimenu>Reset</guimenu>.
+ <para>Once this association with the CDROM source has been
+ made, reboot the &os; virtual machine by clicking
+ <guimenu>Action</guimenu> and <guimenu>Reset</guimenu>.
<application>Virtual PC</application> will reboot with a
- special BIOS that first checks if you have a CDROM just as a
- normal BIOS would do.</para>
+ special BIOS that first checks for a CDROM.</para>
<mediaobject>
<imageobject>
@@ -717,10 +710,9 @@ xenbr1 8000.feffffffffff no
</mediaobject>
<para>In this case it will find the &os; installation media
- and begin a normal <application>sysinstall</application>
- based installation as described in
- <xref linkend="install"/>. You may install, but do not
- attempt to configure X11 at this time.</para>
+ and begin a normal &os; installation. Continue with the
+ installation, but do not attempt to configure
+ <application>&xorg;</application> at this time.</para>
<mediaobject>
<imageobject>
@@ -728,9 +720,9 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>When you have finished the installation, remember to
- eject CDROM or release ISO image. Finally, reboot into your
- newly installed &os; virtual machine.</para>
+ <para>When the installation is finished, remember to eject
+ the CD/DVD or release the ISO image. Finally, reboot into
+ the newly installed &os; virtual machine.</para>
<mediaobject>
<imageobject>
@@ -740,8 +732,8 @@ xenbr1 8000.feffffffffff no
</sect3>
<sect3 id="virtualization-guest-virtualpc-configure">
- <title>Configuring &os; on µsoft.windows;/Virtual
- PC</title>
+ <title>Configuring &os; on <application>Virtual
+ PC</application></title>
<para>After &os; has been successfully installed on
µsoft.windows; with <application>Virtual PC
@@ -755,9 +747,9 @@ xenbr1 8000.feffffffffff no
<para>The most important step is to reduce the
<option>kern.hz</option> tunable to reduce the CPU
- utilization of &os; under the
- <application>Virtual PC</application> environment.
- This is accomplished by adding the following line to
+ utilization of &os; under the <application>Virtual
+ PC</application> environment. This is accomplished
+ by adding the following line to
<filename> /boot/loader.conf</filename>:</para>
<programlisting>kern.hz=100</programlisting>
@@ -765,55 +757,57 @@ xenbr1 8000.feffffffffff no
<para>Without this setting, an idle &os;
<application>Virtual PC</application> guest OS will
use roughly 40% of the CPU of a single processor
- computer. After this change the usage will be
- closer to a mere 3%.</para>
+ computer. After this change, the usage will be
+ closer to 3%.</para>
</step>
<step>
<title>Create a New Kernel Configuration File</title>
- <para>You can remove all of the SCSI, FireWire, and USB
- device drivers. <application>Virtual PC</application>
- provides a virtual network adapter used by the
- &man.de.4; driver, so all other network devices except
- for &man.de.4; and &man.miibus.4; can be removed from
- the kernel.</para>
+ <para>All of the SCSI, FireWire, and USB device drivers
+ can be removed from a custom kernel configuration file.
+ <application>Virtual PC</application> provides a virtual
+ network adapter used by the &man.de.4; driver, so all
+ network devices except for &man.de.4; and &man.miibus.4;
+ can be removed from the kernel.</para>
</step>
<step>
<title>Configure Networking</title>
- <para>The most basic networking setup involves simply
- using DHCP to connect your virtual machine to the same
- local area network as your host µsoft.windows;.
- This can be accomplished by adding
- <literal>ifconfig_de0="DHCP"</literal> to
+ <para>The most basic networking setup uses DHCP to connect
+ the virtual machine to the same local area network as
+ the µsoft.windows; host. This can be accomplished
+ by adding <literal>ifconfig_de0="DHCP"</literal> to
<filename>/etc/rc.conf</filename>. More advanced
- networking setups are described in
- <xref linkend="advanced-networking"/>.</para>
+ networking setups are described in <link
+ linkend="advanced-networking"></link>.</para>
</step>
</procedure>
</sect3>
</sect2>
<sect2 id="virtualization-guest-vmware">
- <title>VMware on MacOS</title>
+ <title><application>VMware Fusion</application> on
+ &macos;</title>
<para><application>VMware Fusion</application> for &mac; is a
commercial software product available for &intel; based
&apple; &mac; computers running &macos; 10.4.9 or higher.
&os; is a fully supported guest operating system. Once
<application>VMware Fusion</application> has been
- installed on &macos; X, the user must configure a virtual
+ installed on &macos; X, the user can configure a virtual
machine and then install the desired guest operating
system.</para>
<sect3 id="virtualization-guest-vmware-install">
- <title>Installing &os; on VMware/&macos; X</title>
+ <title>Installing &os; on <application>VMware
+ Fusion</application></title>
- <para>The first step is to start VMware Fusion, the Virtual
- Machine Library will load. Click "New" to create the
- VM:</para>
+ <para>The first step is to start <application>VMware
+ Fusion</application> which will load the Virtual
+ Machine Library. Click <guimenuitem>New</guimenuitem> to
+ create the virtual machine:</para>
<mediaobject>
<imageobject>
@@ -821,8 +815,8 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>This will load the New Virtual Machine Assistant to help
- you create the VM, click Continue to proceed:</para>
+ <para>This will load the New Virtual Machine Assistant. Click
+ <guimenuitem>Continue</guimenuitem> to proceed:</para>
<mediaobject>
<imageobject>
@@ -831,11 +825,10 @@ xenbr1 8000.feffffffffff no
</mediaobject>
<para>Select <guimenuitem>Other</guimenuitem> as the
- <guimenuitem>Operating System</guimenuitem> and
+ <guimenuitem>Operating System</guimenuitem> and either
<guimenuitem>&os;</guimenuitem> or
- <guimenuitem>&os; 64-bit</guimenuitem>, depending on if
- you want 64-bit support, as the <guimenu>Version</guimenu>
- when prompted:</para>
+ <guimenuitem>&os; 64-bit</guimenuitem>, as the
+ <guimenu>Version</guimenu> when prompted:</para>
<mediaobject>
<imageobject>
@@ -843,8 +836,8 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Choose the Name of the VM Image and the Directory where
- you would like it saved:</para>
+ <para>Choose the name of the virtual machine and the directory
+ where it should be saved:</para>
<mediaobject>
<imageobject>
@@ -852,8 +845,8 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Choose the size of the Virtual Hard Disk for the
- VM:</para>
+ <para>Choose the size of the Virtual Hard Disk for the virtual
+ machine:</para>
<mediaobject>
<imageobject>
@@ -861,8 +854,8 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Choose the method you would like to install the VM,
- either from an ISO image or from a CD:</para>
+ <para>Choose the method to install the virtual machine,
+ either from an ISO image or from a CD/DVD:</para>
<mediaobject>
<imageobject>
@@ -870,7 +863,8 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Once you click Finish, the VM will boot:</para>
+ <para>Click <guimenuitem>Finish</guimenuitem> and the virtual
+ machine will boot:</para>
<mediaobject>
<imageobject>
@@ -878,8 +872,7 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Install &os; like you normally would, or by following
- the directions in <xref linkend="install"/>:</para>
+ <para>Install &os; as usual:</para>
<mediaobject>
<imageobject>
@@ -887,12 +880,14 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>Once the install is complete you can modify the settings
- of the VM, such as Memory Usage:</para>
+ <para>Once the install is complete, the settings
+ of the virtual machine can be modified, such as memory
+ usage:</para>
<note>
- <para>The System Hardware settings of the VM cannot be
- modified while the VM is running.</para>
+ <para>The System Hardware settings of the virtual machine
+ cannot be modified while the virtual machine is
+ running.</para>
</note>
<mediaobject>
@@ -901,7 +896,8 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>The number of CPUs the VM will have access to:</para>
+ <para>The number of CPUs the virtual machine will have access
+ to:</para>
<mediaobject>
<imageobject>
@@ -909,9 +905,9 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>The status of the CD-Rom Device. Normally you can
- disconnect the CD-Rom/ISO from the VM if you will not be
- needing it anymore.</para>
+ <para>The status of the CDROM device. Normally the
+ CD/DVD/ISO is disconnected from the virtual machine when it
+ is no longer needed.</para>
<mediaobject>
<imageobject>
@@ -919,14 +915,15 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>The last thing to change is how the VM will connect to
- the Network. If you want to allow connections to the VM
- from other machines besides the Host, make sure you choose
- the <guimenuitem>Connect directly to the physical network
- (Bridged)</guimenuitem>. Otherwise <guimenuitem>Share the
+ <para>The last thing to change is how the virtual machine will
+ connect to the network. To allow connections to the virtual
+ machine from other machines besides the host, choose
+ <guimenuitem>Connect directly to the physical network
+ (Bridged)</guimenuitem>. Otherwise, <guimenuitem>Share the
host's internet connection (NAT)</guimenuitem> is
- preferred so that the VM can have access to the Internet,
- but the network cannot access the VM.</para>
+ preferred so that the virtual machine can have access to the
+ Internet, but the network cannot access the virtual
+ machine.</para>
<mediaobject>
<imageobject>
@@ -934,17 +931,18 @@ xenbr1 8000.feffffffffff no
</imageobject>
</mediaobject>
- <para>After you have finished modifying the settings, boot the
- newly installed &os; virtual machine.</para>
+ <para>After modifying the settings, boot the newly installed
+ &os; virtual machine.</para>
</sect3>
<sect3 id="virtualization-guest-vmware-configure">
- <title>Configuring &os; on &macos; X/VMware</title>
+ <title>Configuring &os; on <application>VMware
+ Fusion</application></title>
<para>After &os; has been successfully installed on &macos; X
- with <application>VMware</application>, there are a number
- of configuration steps that can be taken to optimize the
- system for virtualized operation.</para>
+ with <application>VMware Fusion</application>, there are a
+ number of configuration steps that can be taken to optimize
+ the system for virtualized operation.</para>
<procedure>
<step>
@@ -953,40 +951,40 @@ xenbr1 8000.feffffffffff no
<para>The most important step is to reduce the
<option>kern.hz</option> tunable to reduce the CPU
utilization of &os; under the
- <application>VMware</application> environment. This is
- accomplished by adding the following line to
+ <application>VMware Fusion</application> environment.
+ This is accomplished by adding the following line to
<filename>/boot/loader.conf</filename>:</para>
<programlisting>kern.hz=100</programlisting>
<para>Without this setting, an idle &os;
- <application>VMware</application> guest
- OS will use roughly 15% of the CPU of a single
- processor &imac;. After this change the usage will be
- closer to a mere 5%.</para>
+ <application>VMware Fusion</application> guest will use
+ roughly 15% of the CPU of a single processor &imac;.
+ After this change, the usage will be closer to
+ 5%.</para>
</step>
<step>
<title>Create a New Kernel Configuration File</title>
- <para>You can remove all of the FireWire, and USB device
- drivers. <application>VMware</application> provides a
+ <para>All of the FireWire, and USB device drivers can be
+ removed from a custom kernel configuration file.
+ <application>VMware Fusion</application> provides a
virtual network adapter used by the &man.em.4; driver,
- so all other network devices except for &man.em.4; can
- be removed from the kernel.</para>
+ so all network devices except for &man.em.4; can be
+ removed from the kernel.</para>
</step>
<step>
<title>Configure Networking</title>
- <para>The most basic networking setup involves simply
- using DHCP to connect your virtual machine to the
- same local area network as your host &mac;. This
- can be accomplished by adding
+ <para>The most basic networking setup uses DHCP to connect
+ the virtual machine to the same local area network as
+ the host &mac;. This can be accomplished by adding
<literal>ifconfig_em0="DHCP"</literal> to
<filename>/etc/rc.conf</filename>. More advanced
- networking setups are described in
- <xref linkend="advanced-networking"/>.</para>
+ networking setups are described in <link
+ linkend="advanced-networking"></link>.</para>
</step>
</procedure>
</sect3>
@@ -1000,23 +998,23 @@ xenbr1 8000.feffffffffff no
<itemizedlist>
<listitem>
- <para>Clipboard sharing</para>
+ <para>Clipboard sharing.</para>
</listitem>
<listitem>
- <para>Mouse pointer integration</para>
+ <para>Mouse pointer integration.</para>
</listitem>
<listitem>
- <para>Host time synchronization</para>
+ <para>Host time synchronization.</para>
</listitem>
<listitem>
- <para>Window scaling</para>
+ <para>Window scaling.</para>
</listitem>
<listitem>
- <para>Seamless mode</para>
+ <para>Seamless mode.</para>
</listitem>
</itemizedlist>
@@ -1026,7 +1024,8 @@ xenbr1 8000.feffffffffff no
<para>First, install the <filename
role="package">emulators/virtualbox-ose-additions</filename>
- package in the &os; guest.</para>
+ package or port in the &os; guest. This will install
+ the port:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose-additions && make install clean</userinput></screen>
@@ -1036,14 +1035,15 @@ xenbr1 8000.feffffffffff no
<programlisting>vboxguest_enable="YES"
vboxservice_enable="YES"</programlisting>
- <para>If &man.ntpd.8; or &man.ntpdate.8; will be used, host time
+ <para>If &man.ntpd.8; or &man.ntpdate.8; is used, host time
synchronization should be disabled:</para>
<programlisting>vboxservice_flags="--disable-timesync"</programlisting>
- <para>The <literal>vboxvideo_drv</literal> should be recognized
- by <command>Xorg -configure</command>. If not, modify
- <filename>xorg.conf</filename> for the
+ <para>The <literal>vboxvideo</literal> driver should be
+ automatically recognized by <command>Xorg
+ -configure</command>. If not, modify
+ <filename>/etc/X11/xorg.conf</filename> for the
<application>&virtualbox;</application> video card:</para>
<programlisting>Section "Device"
@@ -1058,15 +1058,16 @@ vboxservice_enable="YES"</programlisting
BusID "PCI:0:2:0"
EndSection</programlisting>
- <para>To use <literal>vboxmouse_drv</literal>, adjust the mouse
- section in your <filename>xorg.conf</filename>:</para>
+ <para>To use the <literal>vboxmouse</literal> driver, adjust the
+ mouse section in
+ <filename>/etc/X11/xorg.conf</filename>:</para>
<programlisting>Section "InputDevice"
Identifier "Mouse0"
Driver "vboxmouse"
EndSection</programlisting>
- <para><acronym>HAL</acronym> users should create this file at
+ <para><acronym>HAL</acronym> users should create the following
<filename>/usr/local/etc/hal/fdi/policy/90-vboxguest.fdi</filename>
or copy it from
<filename>/usr/local/share/hal/fdi/policy/10osvendor/90-vboxguest.fdi</filename>:</para>
@@ -1107,45 +1108,39 @@ EndSection</programlisting>
</sect1>
<sect1 id="virtualization-host">
- <title>&os; as a Host OS</title>
+ <title>&os; as a Host</title>
<para>For a number of years, &os; was not officially supported as
- a host OS by any of the available virtualization solutions.
- Some people were using older and mostly obsolete versions of
- <application>VMware</application> (like
- <filename role="package">emulators/vmware3</filename>), which
- utilized the &linux; binary compatibility layer. Shortly after
- the release of &os; 7.2, Sun's
+ a host operating system by any of the available virtualization
+ solutions. Shortly after the release of &os; 7.2, &oracle;
<application>&virtualbox;</application> appeared in the
Ports Collection as a native &os; program.</para>
<para><application>&virtualbox;</application> is an actively
developed, complete virtualization package, that is available
for most operating systems including &windows;, &macos;, &linux;
- and &os;. It is equally capable at running &windows; or &unix;
- like guests. It is released as open source software, but with
- closed-source components available in a separate extension pack.
- These components include support for USB 2.0 devices, among
- others. More information may be found on the
- <quote>Downloads</quote> page of the
- <application>&virtualbox;</application> wiki, at <ulink
- url="http://www.virtualbox.org/wiki/Downloads"></ulink>.
+ and &os;. It is equally capable of running &windows; or
+ &unix;-like guests. It is released as open source software, but
+ with closed-source components available in a separate extension
+ pack. These components include support for USB 2.0 devices.
+ More information may be found on the <ulink
+ url="http://www.virtualbox.org/wiki/Downloads">
+ <quote>Downloads</quote> page of the
+ <application>&virtualbox;</application> wiki</ulink>.
Currently, these extensions are not available for &os;.</para>
<sect2 id="virtualization-virtualbox-install">
<title>Installing &virtualbox;</title>
<para><application>&virtualbox;</application> is available as a
- &os; port in
- <filename role="package">emulators/virtualbox-ose</filename>.
- As &virtualbox; is very actively developed, make sure your
- ports tree is up to date before installing. Install using
- these commands:</para>
+ &os; package or port in <filename
+ role="package">emulators/virtualbox-ose</filename>. The
+ port can be installed using these commands:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
- <para>One useful option in the configuration dialog is the
+ <para>One useful option in the port's configuration menu is the
<literal>GuestAdditions</literal> suite of programs. These
provide a number of useful features in guest operating
systems, like mouse pointer integration (allowing the mouse to
@@ -1153,8 +1148,7 @@ EndSection</programlisting>
special keyboard shortcut to switch) and faster video
rendering, especially in &windows; guests. The guest
additions are available in the <guimenu>Devices</guimenu>
- menu, after the installation of the guest OS is
- finished.</para>
+ menu, after the installation of the guest is finished.</para>
<para>A few configuration changes are needed before
<application>&virtualbox;</application> is started for the
@@ -1181,59 +1175,51 @@ EndSection</programlisting>
during installation of
<application>&virtualbox;</application>. All users that need
access to <application>&virtualbox;</application> will have to
- be added as members of this group. The <command>pw</command>
- command may be used to add new members:</para>
+ be added as members of this group. <command>pw</command>
+ can be used to add new members:</para>
<screen>&prompt.root; <userinput>pw groupmod vboxusers -m <replaceable>yourusername</replaceable></userinput></screen>
- <para>The default permissions for
- <filename class="devicefile">/dev/vboxnetctl</filename> are
+ <para>The default permissions for <filename
+ class="devicefile">/dev/vboxnetctl</filename> are
restrictive and need to be changed for bridged
- networking.</para>
-
- <para>To test it temporarily:</para>
+ networking:</para>
<screen>&prompt.root; <userinput>chown root:vboxusers /dev/vboxnetctl</userinput>
&prompt.root; <userinput>chmod 0660 /dev/vboxnetctl</userinput></screen>
- <para>To make the permissions change permanent, add these
+ <para>To make this permissions change permanent, add these
lines to <filename>/etc/devfs.conf</filename>:</para>
<programlisting>own vboxnetctl root:vboxusers
perm vboxnetctl 0660</programlisting>
- <para>To launch <application>&virtualbox;</application>, either
- select the <guimenuitem>Sun VirtualBox</guimenuitem> item from
- the graphic environment's menu, or type the following in a
- terminal:</para>
+ <para>To launch <application>&virtualbox;</application>,
+ type from a <application>&xorg;</application> session:</para>
<screen>&prompt.user; <userinput>VirtualBox</userinput></screen>
<para>For more information on configuring and using
- <application>&virtualbox;</application>, please visit the
- official website at
- <ulink url="http://www.virtualbox.org"></ulink>. As the &os;
- port is very recent, it is under heavy development. For the
- latest information and troubleshooting instructions, please
- visit the relevant page in the &os; wiki, at <ulink
- url="http://wiki.FreeBSD.org/VirtualBox"></ulink>.</para>
+ <application>&virtualbox;</application>, refer to the
+ <ulink url="http://www.virtualbox.org">official
+ website</ulink>. For &os;-specific information and
+ troubleshooting instructions, refer to the <ulink
+ url="http://wiki.FreeBSD.org/VirtualBox">relevant page in
+ the &os; wiki</ulink>.</para>
</sect2>
<sect2 id="virtualization-virtualbox-usb-support">
<title>&virtualbox; USB Support</title>
- <note>
- <para>These steps require VirtualBox 4.0.0 or later.</para>
- </note>
-
<para>In order to be able to read and write to USB devices,
- users need to be members of the operator group:</para>
+ users need to be members of
+ <groupname>operator</groupname>:</para>
<screen>&prompt.root; <userinput>pw groupmod operator -m <replaceable>jerry</replaceable></userinput></screen>
<para>Then, add the following to
- <filename>/etc/devfs.rules</filename> (create it if it does
- not exist yet):</para>
+ <filename>/etc/devfs.rules</filename>, or create this file if
+ it does not exist yet:</para>
<programlisting>[system=10]
add path 'usb/*' mode 0660 group operator</programlisting>
@@ -1256,20 +1242,20 @@ add path 'usb/*' mode 0660 group operato
<title>&virtualbox; Host DVD/CD Access</title>
<para>Access to the host DVD/CD drives from guests is achieved
- through the sharing of the physical drives. In GUI this is
- set up from the Storage window in the Settings of the virtual
- machine. Create an empty IDE CD/DVD device first.
- Then choose the Host Drive from the popup menu for the virtual
- CD/DVD drive selection. A checkbox labeled
- <literal>Passthrough</literal> check box will appear.
- This allows the virtual machine to use the hardware directly.
- For example, audio CDs or the burner only function if
- this option is selected.</para>
+ through the sharing of the physical drives. Within
+ &virtualbox;, this is set up from the Storage window in the
+ Settings of the virtual machine. If needed, create an empty
+ IDE CD/DVD device first. Then choose the Host Drive from the
+ popup menu for the virtual CD/DVD drive selection. A checkbox
+ labeled <literal>Passthrough</literal> will appear. This
+ allows the virtual machine to use the hardware directly. For
+ example, audio CDs or the burner will only function if this
+ option is selected.</para>
<para><acronym>HAL</acronym> needs to run for
<application>&virtualbox;</application> DVD/CD functions to
work, so enable it in <filename>/etc/rc.conf</filename> and
- start it (if it is not already running):</para>
+ start it if it is not already running:</para>
<programlisting>hald_enable="YES"</programlisting>
@@ -1277,16 +1263,14 @@ add path 'usb/*' mode 0660 group operato
<para>In order for users to be able to use
<application>&virtualbox;</application> DVD/CD functions, they
- need access to
- <filename class="devicefile">/dev/xpt0</filename>, <filename
+ need access to <filename
+ class="devicefile">/dev/xpt0</filename>, <filename
class="devicefile">/dev/cd<replaceable>N</replaceable></filename>,
and <filename
class="devicefile">/dev/pass<replaceable>N</replaceable></filename>.
- This is usually achieved by making the user of
- <application>&virtualbox;</application>
- a member of the operator group, which is also the default
- group of the above mentioned devices. Permissions of these
- devices have to be corrected by adding the following lines to
+ This is usually achieved by making the user a member of
+ <groupname>operator</groupname>. Permissions to these devices
+ have to be corrected by adding the following lines to
<filename>/etc/devfs.conf</filename>:</para>
<programlisting>perm cd* 0600
More information about the svn-doc-all
mailing list