Expand the Virtualization section by adding a section on VMWare Fusion.

svn path=/head/; revision=31591

en_US.ISO8859-1/books/handbook/virtualization/chapter.sgml

@@ -768,12 +768,195 @@ xenbr1          8000.feffffffffff   no                  vif0.1
     </sect2>
 
     <sect2 id="virtualization-guest-vmware">
-      <title>VMware on &windows;/&mac;/&linux;</title>
+      <title>VMWare on MacOS</title>
 
-      <para>This section has yet to be written.</para>
+      <para><application>FMWare Fusion</application> for &mac; is a
+	commercial software product available for &intel; based &apple;
+	&mac; computers running &macos; 10.4.9 or higher.  FreeBSD is a
+	fully supported guest operating system.  Once
+	<application>VMWare Fusion</application> has been installed on
+	&macos; X, the user must configure a virtual machine and then
+	install the desired guest operating system.</para>
 
+	<sect3 id="virtualization-guest-vmware-install">
+	  <title>Installing FreeBSD on VMWare/&macos; X</title>
+
+	  <para>The first step is to start VMWare Fusion, the Virtual
+	    Machine Library will load.  Click "New" to create the VM:</para>
+
+	  <mediaobject>
+            <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd01">
+            </imageobject>
+          </mediaobject>
+
+	  <para>This will load the New Virtual Machine Assistant to help
+	    you create the VM, click Continue to proceed:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd02">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Select <guimenuitem>Other</guimenuitem> as the
+	    <guimenuitem>Operating System</guimenuitem> and
+	    <guimenuitem>FreeBSD</guimenuitem> or
+	    <guimenuitem>FreeBSD 64-bit</guimenuitem>, depending on if
+	    you want 64-bit support, as the <guimenu>Version</guimenu>
+	    when prompted:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd03">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Choose the Name of the VM Image and the Directory where
+	    you would like it saved:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd04">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Choose the size of the Virtual Hard Disk for the VM:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd05">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Choose the method you would like to install the VM,
+	    either from an ISO image or from a CD:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd06">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Once you click Finish, the VM will boot:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd07">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Install &os; like you normally would, or by following the
+	    directions in <xref linkend="install">:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd08">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>Once the install is complete you can modify the settings
+	    of the VM, such as Memory Usage:</para>
+
+          <note>
+	    <para>The System Hardware settings of the VM cannot be modified
+	      while the VM is running.</para>
+          </note>
+
+	  <mediaobject>
+            <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd09">
+            </imageobject>
+          </mediaobject>
+
+	  <para>The number of CPUs the VM will have access to:</para>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd10">
+	    </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>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd11">
+	    </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
+	    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>
+
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="virtualization/vmware-freebsd12">
+	    </imageobject>
+	  </mediaobject>
+
+	  <para>After you have finished modifing the settings, boot the
+	    newly installed FreeBSD virtual machine.</para>
+
+	<sect3 id="virtualization-guest-vmware-configure">
+	  <title>Configuring FreeBSD on &macos; X/VMWare</title>
+
+	  <para>After FreeBSD 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>
+
+          <procedure>
+	    <step>
+	      <title>Set boot loader variables</title>
+
+	      <para>The most important step is to reduce the
+	        <option>kern.hz</option> tunable to reduce the CPU utilization
+		of FreeBSD under the <application>VMWare</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 FreeBSD
+	        <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>
+	    </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
+		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>
+	    </step>
+
+	    <step>
+	      <title>Setup 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
+	        <literal>ifconfig_em0="DHCP"</literal> to
+	        <filename>/etc/rc.conf</filename>.  More advanced
+		networking setups are described in <xref
+		linkend="advanced-networking">.</para>
+	    </step>
+          </procedure>
+
+      </sect3>
     </sect2>
-
   </sect1>
 
   <sect1 id="virtualization-host">