os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

This is a minor content fixup as much work is needed in this chapter.

Browse source 
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)
This commit is contained in:
Dru Lavigne 2013-02-28 15:40:57 +00:00
parent f0da12bdad
commit 5c7559f8ae
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=41062
1 changed files with 233 additions and 249 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

482
en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
View file

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