further updates to section 'Installing in Virtualized Linux Environments';
authorSteve Sheppard <ssheps@gmail.com>
Mon, 20 Sep 2010 22:51:59 +0000 (18:51 -0400)
committerSteve Sheppard <ssheps@gmail.com>
Mon, 20 Sep 2010 22:51:59 +0000 (18:51 -0400)
1.6/admin/ServersideInstallationVirtual.xml

index 48f9d00..ee111d9 100644 (file)
@@ -9,69 +9,160 @@ There are some performance limitations to running Evergreen in a virtualized env
                <section>
                        <title>Installing Virtualization Software</title>
                        <para>As described above, Evergreen is installed on top of an emulated Linux environment. The Linux environment, in turn, is installed on top of a software application such as <application>"VirtualBox"</application>, <application>"VMware"</application> or <application>"VirtualPC"</application> which must first be installed on the <systemitem class="osname">Windows</systemitem> system. This section contains step-by-step examples of installing each of the popular virtualization applications on a <systemitem class="osname">Windows</systemitem> host system. Following this section are further descriptions of installing Linux systems on the virtualization software, then of installing and running Evergreen within those Linux systems.</para>
-                       <section>
+                       <section xml:id="serversideinstallation-virtual-vbox-install">
                                <title>Installing <application>"VirtualBox"</application> Virtualization Software</title>
                                <para>This section reviews the procedure for installing the <application>"VirtualBox"</application> application on <systemitem class="osname">WindowsXP Professional (SP2)</systemitem>. Follow these instructions:</para>
+                               <para>Download <application>VirtualBox</application> from their official website: <ulink url="http://download.virtualbox.org/virtualbox/3.2.8/VirtualBox-3.2.8-64453-Win.exe">http://download.virtualbox.org/virtualbox/3.2.8/VirtualBox-3.2.8-64453-Win.exe</ulink>, then run the executable file. Continue with the steps shown in the next five figures until the software has been successfully installed:</para>
+                               <figure>
+                                       <title>Starting the Windows installation file</title>
+                                       <mediaobject>
+                                               <imageobject>
+                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-1.png" scalefit="1" width="70%"/>
+                                               </imageobject>
+                                       </mediaobject>
+                               </figure>
+                               <figure>
+                                       <title>Welcome to <application>VirtualBox</application> setup wizard</title>
+                                       <mediaobject>
+                                               <imageobject>
+                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-2.png" scalefit="1" width="70%"/>
+                                               </imageobject>
+                                       </mediaobject>
+                               </figure>
+                               <figure>
+                                       <title>Accept the license agreement</title>
+                                       <mediaobject>
+                                               <imageobject>
+                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-3.png" scalefit="1" width="70%"/>
+                                               </imageobject>
+                                       </mediaobject>
+                               </figure>
+                               <figure>
+                                       <title>Waiting for files to be copied</title>
+                                       <mediaobject>
+                                               <imageobject>
+                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-4.png" scalefit="1" width="70%"/>
+                                               </imageobject>
+                                       </mediaobject>
+                               </figure>
+                               <figure>
+                                       <title>Installation is complete</title>
+                                       <mediaobject>
+                                               <imageobject>
+                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-5.png" scalefit="1" width="70%"/>
+                                               </imageobject>
+                                       </mediaobject>
+                               </figure>
+                       </section>
+                       <section>
+                               <title>Installing <application>"VMware"</application> Virtualization Software</title>
+                               <para>This section reviews the procedure for installing the <application>"VMware"</application> application on <systemitem class="osname">WindowsXP Professional (SP2)</systemitem>.</para>
                                <procedure>
                                        <step>
-                                               <para>Download <application>VirtualBox</application> from their official website: <ulink url="http://download.virtualbox.org/virtualbox/3.2.8/VirtualBox-3.2.8-64453-Win.exe">http://download.virtualbox.org/virtualbox/3.2.8/VirtualBox-3.2.8-64453-Win.exe</ulink>, then run the executable file. Continue with the steps shown in the next five figures until the software has been successfully installed:</para>
+                                               <para>Download <application>VMware</application> from here: <ulink url="">link</ulink>, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed:</para>
                                                <figure>
                                                        <title>Starting the Windows installation file</title>
                                                        <mediaobject>
                                                                <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-1.png" scalefit="1" width="70%"/>
-                                                               </imageobject>
-                                                       </mediaobject>
-                                               </figure>
-                                               <figure>
-                                                       <title>Welcome to <application>VirtualBox</application> setup wizard</title>
-                                                       <mediaobject>
-                                                               <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-2.png" scalefit="1" width="70%"/>
-                                                               </imageobject>
-                                                       </mediaobject>
-                                               </figure>
-                                               <figure>
-                                                       <title>Accept the license agreement</title>
-                                                       <mediaobject>
-                                                               <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-3.png" scalefit="1" width="70%"/>
-                                                               </imageobject>
-                                                       </mediaobject>
-                                               </figure>
-                                               <figure>
-                                                       <title>Waiting for files to be copied</title>
-                                                       <mediaobject>
-                                                               <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-4.png" scalefit="1" width="70%"/>
+                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-1.png" scalefit="1" width="75%"/>
                                                                </imageobject>
                                                        </mediaobject>
                                                </figure>
+                                       </step>
+                                       <step>
+                                               <para>After successfully installating <application>VMware</application>, start it for the first time and click <guibutton>"New"</guibutton> to begin defining a new virtual machine (VM). You must specify a name and operating system type for the new VM; in this example we decided to install <systemitem class="osname">Debian Lenny</systemitem>. You must set a reasonable memory size (we chose the default value of 384Mb). You must define a name and size for a virtual hard disk (we chose a name, and set the size to 4.0Gb). The next six figures illlustrate the steps in starting <application>VirtualBox</application> and defining the new VM:</para>
+                                       </step>
+                               </procedure>
+                               <para>At this point, <application>VirtualBox</application> has been installed, started for the first time, and a new virtual machine (VM) has been created. This VM is the environment in which the Linux / Evergreen installation will execute. Please continue in <xref linkend="serversideinstallation-virtual-install-linux-ev"/> with the installation of the Linux / Evergreen distribution.</para>
+                               <indexterm>
+                                       <primary>ZZZ-REVIEW</primary>
+                                       <secondary>ADD INFO ON VMWARE</secondary>
+                               </indexterm>
+                               <caution>ADD INFO ON VMWARE</caution>
+                       </section>
+                       <section>
+                               <title>Installing <application>"VirtualPC"</application> Virtualization Software</title>
+                               <para>This section reviews the procedure for installing the <application>"VirtualPC"</application> application on <systemitem class="osname">WindowsXP Professional (SP2)</systemitem>.</para>
+                               <procedure>
+                                       <step>
+                                               <para>Download <application>VMware</application> from here: <ulink url="">link</ulink>, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed:</para>
                                                <figure>
-                                                       <title>Installation is complete</title>
+                                                       <title>Starting the Windows installation file</title>
                                                        <mediaobject>
                                                                <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-5.png" scalefit="1" width="70%"/>
+                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-1.png" scalefit="1" width="75%"/>
                                                                </imageobject>
                                                        </mediaobject>
                                                </figure>
                                        </step>
                                        <step>
-                                               <para>After successfully installating <application>VirtualBox</application>, do the following:</para>
-                                               <itemizedlist>
-                                                       <listitem>Start it for the first time and select <menuchoice><guimenu>File</guimenu><guimenuitem>VirtualBox Media Manager</guimenuitem><guimenuitem>Add</guimenuitem></menuchoice> to locate the prebuilt software image just downloaded (the example shows it was extracted from the original <literal>.ZIP</literal> file into a temporary directory <literal>C:\temp</literal>). See <xref linkend="serversideinstallation-virtual-vm-install-2"/> for details.</listitem>
-                                                       <listitem>After selecting the file, click <guibutton>Open</guibutton> to import it (see <xref linkend="serversideinstallation-virtual-vm-install-3"/> for details).</listitem>
-                                                       <listitem>Then click <guibutton>OK</guibutton> to save the selection and return to the VirtualBox Media Manager (see <xref linkend="serversideinstallation-virtual-vm-install-4"/> for details).</listitem>
-                                                       <listitem>Click <guibutton>New</guibutton> to start the "Virtual Machine Wizard", then <guibutton>Next</guibutton> to continue and create a new virtual machine (VM) <xref linkend="serversideinstallation-virtual-vm-install-5"/>).</listitem>
-                                                       <listitem>Create a new name for the VM and set the operating system type, then click <guibutton>Next</guibutton> (see <xref linkend="serversideinstallation-virtual-vm-install-6"/>).</listitem>
-                                                       <listitem>Set the memory size (we chose the default value of 384Mb), then click <guibutton>Next</guibutton> (see <xref linkend="serversideinstallation-virtual-vm-install-7"/>).</listitem>
-                                                       <listitem>Edit the Virtual Hard Disk configuration settings; click the radio boxes "Boot Hard Disk" and "Use existing hard disk" and ensure that the disk name "Evergreen1601_DebianLenny.vmdk" is selected. Click <guibutton>Finish</guibutton> to finish the setup (see <xref linkend="serversideinstallation-virtual-vm-install-8"/>).</listitem>
-                                                       <listitem>Return to VirtualBox and see the summary of the VM just created. Click <guibutton>Start</guibutton> to boot the new VM (see <xref linkend="serversideinstallation-virtual-vm-install-9"/>).</listitem>
-                                                       <listitem>See the start of the Linux boot sequence. Choose "Debian Gnu/Linux, kernel 2.6.26-2-686" from the startup menu and type <guibutton>Enter</guibutton> to start Linux and Evergreen (see <xref linkend="serversideinstallation-virtual-vm-install-11"/>). After some delay you should see the command line prompt: <literal>debian-lenny login:</literal>  .  Log in with username <literal>root</literal> and password <literal>evergreen</literal> to continue (see <xref linkend="serversideinstallation-virtual-vm-install-14"/>).</listitem>
-                                               </itemizedlist>
-                                               <para>At this point, you have a running Linux / Evergreen system. If you need to modify the Evergren configuration in any way, first review the standard Evergreen installation instructions in <xref linkend="serversideinstallation-ubuntudebian"/>.</para>
+                                               <para>After successfully installating <application>VMware</application>, start it for the first time and click <guibutton>"New"</guibutton> to begin defining a new virtual machine (VM). You must specify a name and operating system type for the new VM; in this example we decided to install <systemitem class="osname">Debian Lenny</systemitem>. You must set a reasonable memory size (we chose the default value of 512Mb). You must define a name and size for a virtual hard disk (we chose a name, and set the size to 4.0Gb). The next six figures illlustrate the steps in starting <application>VirtualBox</application> and defining the new VM:</para>
                                        </step>
                                </procedure>
+                               <para>At this point, <application>VirtualBox</application> has been installed, started for the first time, and a new virtual machine (VM) has been created. This VM is the environment in which the Linux / Evergreen installation will execute. Please continue in <xref linkend="serversideinstallation-virtual-install-linux-ev"/> with the installation of the Linux / Evergreen distribution.</para>
+                               <indexterm>
+                                       <primary>ZZZ-REVIEW</primary>
+                                       <secondary>ADD INFO ON VIRTUALPC</secondary>
+                               </indexterm>
+                               <caution>ADD INFO ON VIRTUALPC</caution>
+                       </section>
+               </section>
+               <section xml:id="serversideinstallation-virtual-install-linux-ev">
+                       <title>Installing Linux / Evergreen on Virtualization Software</title>
+                       <para>After the virtualization software is installed and running and a new virtual machine (VM) has been created, there are two ways to continue with installing software in this virtualized environment:</para>
+                       <orderedlist>
+                               <listitem>
+                                       <para>Download a prebuilt software image file containing a working Linux / Evergreen system (see <xref linkend="serversideinstall-virtual-prebuilt"/> for details)</para>
+                               </listitem>
+                               <listitem>
+                                       <para>Manually install a Linux guest system, then manually install Evergreen on it (see <xref linkend="serversideinstall-virtual-manual"/> for details)</para>
+                               </listitem>
+                       </orderedlist>
+                       <para>See the following two sections for a review of each method.</para>
+                       <section xml:id="serversideinstall-virtual-prebuilt">
+                               <title>Download and install a prebuilt software image</title>
+                               <para>You can download a prebuilt software image that, when installed in <application>"VirtualBox"</application>, <application>"VMware"</application> or <application>"VirtualPC"</application>, will emulate a Linux guest system containing a running Evergreen distribution. The image is essentially a snapshot of a hard disk from a fully configured, functional Linux system with Evergreen already installed.</para>
+                               <para>We recommend this approach if you wish to get Evergreen running quickly with minimal attention to configuration. After reviewing only a few configuration details you can have a working Evergreen system that integrates smoothly with the rest of your network. See <xref linkend="serversideinstall-virtual-versions"/> for a list of prebuilt software images that are currently available to download and execute:</para>
+                               <table xml:id="serversideinstall-virtual-versions">
+                                       <title>Linux / Evergreen Virtual Images</title>
+                                       <tgroup align="left" cols="4" colsep="1" rowsep="1">
+                                               <thead>
+                                                       <row>
+                                                               <entry>Linux Version</entry>
+                                                               <entry>Evergreen Version</entry>
+                                                               <entry>OpenSRF Version</entry>
+                                                               <entry>VirtualBox Image</entry>
+                                                       </row>
+                                               </thead>
+                                               <tbody>
+                                                       <row>
+                                                               <entry>Debin lenny (5.0)</entry>
+                                                               <entry>1.6.0.1</entry>
+                                                               <entry>1.4.x</entry>
+                                                               <entry>
+                                                                       <ulink url="http://www.open-ils.org/~denials/Evergreen1601_DebianLenny.zip"> download </ulink>
+                                                               </entry>
+                                                       </row>
+                                               </tbody>
+                                       </tgroup>
+                               </table>
+                               <indexterm>
+                                       <primary>ZZZ-REVIEW</primary>
+                                       <secondary>ADD LIST OF OTHER PREBUILS IMAGES</secondary>
+                               </indexterm>
+                               <para>After successfully installing <application>VirtualBox</application> (see <xref linkend="serversideinstallation-virtual-vbox-install"/> for details), continue with the following procedure. Refer to the accompanying figures for further information:</para>
+                               <procedure>
+                                       <step>Start VirtualBox for the first time and select <menuchoice><guimenu>File</guimenu><guimenuitem>VirtualBox Media Manager</guimenuitem><guimenuitem>Add</guimenuitem></menuchoice> to locate the prebuilt software image just downloaded (the example shows it was extracted from the original <literal>.ZIP</literal> file into a temporary directory <literal>C:\temp</literal>). See <xref linkend="serversideinstallation-virtual-vm-install-2"/> for details.</step>
+                                       <step>After selecting the file, click <guibutton>Open</guibutton> to import it (see <xref linkend="serversideinstallation-virtual-vm-install-3"/> for details).</step>
+                                       <step>Then click <guibutton>OK</guibutton> to save the selection and return to the VirtualBox Media Manager (see <xref linkend="serversideinstallation-virtual-vm-install-4"/> for details).</step>
+                                       <step>Click <guibutton>New</guibutton> to start the "Virtual Machine Wizard", then <guibutton>Next</guibutton> to continue and create a new virtual machine (VM) <xref linkend="serversideinstallation-virtual-vm-install-5"/>).</step>
+                                       <step>Create a new name for the VM and set the operating system type, then click <guibutton>Next</guibutton> (see <xref linkend="serversideinstallation-virtual-vm-install-6"/>).</step>
+                                       <step>Set the memory size (we chose the default value of 384Mb), then click <guibutton>Next</guibutton> (see <xref linkend="serversideinstallation-virtual-vm-install-7"/>).</step>
+                                       <step>Edit the Virtual Hard Disk configuration settings; click the radio boxes "Boot Hard Disk" and "Use existing hard disk" and ensure that the disk name "Evergreen1601_DebianLenny.vmdk" is selected. Click <guibutton>Finish</guibutton> to finish the setup (see <xref linkend="serversideinstallation-virtual-vm-install-8"/>).</step>
+                                       <step>Return to VirtualBox and see the summary of the VM just created. Click <guibutton>Start</guibutton> to boot the new VM (see <xref linkend="serversideinstallation-virtual-vm-install-9"/>).</step>
+                                       <step>See the start of the Linux boot sequence. Choose "Debian Gnu/Linux, kernel 2.6.26-2-686" from the startup menu and type <guibutton>Enter</guibutton> to start Linux and Evergreen (see <xref linkend="serversideinstallation-virtual-vm-install-11"/>). After some delay you should see the command line prompt: <literal>debian-lenny login:</literal>  .  Log in with username <literal>root</literal> and password <literal>evergreen</literal> to continue (see <xref linkend="serversideinstallation-virtual-vm-install-14"/>).</step>
+                               </procedure>
+                               <para>At this point, you have a running Linux / Evergreen system. If you need to modify the Evergren configuration in any way, first review the standard Evergreen installation instructions in <xref linkend="serversideinstallation-ubuntudebian"/>.</para>
                                <figure xml:id="serversideinstallation-virtual-vm-install-2">
                                        <title>Starting <application>VirtualBox</application> for the first time</title>
                                        <mediaobject>
@@ -177,114 +268,18 @@ There are some performance limitations to running Evergreen in a virtualized env
                                        </mediaobject>
                                </figure>
                        </section>
-                       <section>
-                               <title>Installing <application>"VMware"</application> Virtualization Software</title>
-                               <para>This section reviews the procedure for installing the <application>"VMware"</application> application on <systemitem class="osname">WindowsXP Professional (SP2)</systemitem>.</para>
-                               <procedure>
-                                       <step>
-                                               <para>Download <application>VMware</application> from here: <ulink url="">link</ulink>, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed:</para>
-                                               <figure>
-                                                       <title>Starting the Windows installation file</title>
-                                                       <mediaobject>
-                                                               <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-1.png" scalefit="1" width="75%"/>
-                                                               </imageobject>
-                                                       </mediaobject>
-                                               </figure>
-                                       </step>
-                                       <step>
-                                               <para>After successfully installating <application>VMware</application>, start it for the first time and click <guibutton>"New"</guibutton> to begin defining a new virtual machine (VM). You must specify a name and operating system type for the new VM; in this example we decided to install <systemitem class="osname">Debian Lenny</systemitem>. You must set a reasonable memory size (we chose the default value of 384Mb). You must define a name and size for a virtual hard disk (we chose a name, and set the size to 4.0Gb). The next six figures illlustrate the steps in starting <application>VirtualBox</application> and defining the new VM:</para>
-                                       </step>
-                               </procedure>
-                               <para>At this point, <application>VirtualBox</application> has been installed, started for the first time, and a new virtual machine (VM) has been created. This VM is the environment in which the Linux / Evergreen installation will execute. Please continue in <xref linkend="serversideinstallation-virtual-install-linux-ev"/> with the installation of the Linux / Evergreen distribution.</para>
-                               <indexterm>
-                                       <primary>ZZZ-REVIEW</primary>
-                                       <secondary>ADD INFO ON VMWARE</secondary>
-                               </indexterm>
-                               <caution>ADD INFO ON VMWARE</caution>
-                       </section>
-                       <section>
-                               <title>Installing <application>"VirtualPC"</application> Virtualization Software</title>
-                               <para>This section reviews the procedure for installing the <application>"VirtualPC"</application> application on <systemitem class="osname">WindowsXP Professional (SP2)</systemitem>.</para>
-                               <procedure>
-                                       <step>
-                                               <para>Download <application>VMware</application> from here: <ulink url="">link</ulink>, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed:</para>
-                                               <figure>
-                                                       <title>Starting the Windows installation file</title>
-                                                       <mediaobject>
-                                                               <imageobject>
-                                                                       <imagedata fileref="../media/serversideinstallation-virtual-vbox-install-1.png" scalefit="1" width="75%"/>
-                                                               </imageobject>
-                                                       </mediaobject>
-                                               </figure>
-                                       </step>
-                                       <step>
-                                               <para>After successfully installating <application>VMware</application>, start it for the first time and click <guibutton>"New"</guibutton> to begin defining a new virtual machine (VM). You must specify a name and operating system type for the new VM; in this example we decided to install <systemitem class="osname">Debian Lenny</systemitem>. You must set a reasonable memory size (we chose the default value of 512Mb). You must define a name and size for a virtual hard disk (we chose a name, and set the size to 4.0Gb). The next six figures illlustrate the steps in starting <application>VirtualBox</application> and defining the new VM:</para>
-                                       </step>
-                               </procedure>
-                               <para>At this point, <application>VirtualBox</application> has been installed, started for the first time, and a new virtual machine (VM) has been created. This VM is the environment in which the Linux / Evergreen installation will execute. Please continue in <xref linkend="serversideinstallation-virtual-install-linux-ev"/> with the installation of the Linux / Evergreen distribution.</para>
-                               <indexterm>
-                                       <primary>ZZZ-REVIEW</primary>
-                                       <secondary>ADD INFO ON VIRTUALPC</secondary>
-                               </indexterm>
-                               <caution>ADD INFO ON VIRTUALPC</caution>
-                       </section>
-               </section>
-               <section xml:id="serversideinstallation-virtual-install-linux-ev">
-                       <title>Installing Linux / Evergreen on Virtualization Software</title>
-                       <para>After the virtualization software is installed and running and a new virtual machine (VM) has been created, there are two ways to continue with installing software in this virtualized environment:</para>
-                       <orderedlist>
-                               <listitem>
-                                       <para>Download a prebuilt software image file containing a working Linux / Evergreen system.</para>
-                               </listitem>
-                               <listitem>
-                                       <para>Manually install a Linux guest system, then manually install Evergreen on it.</para>
-                               </listitem>
-                       </orderedlist>
-                       <para>See the following two sections for a review of each method.</para>
-                       <section>
-                               <title>Download a prebuilt software image file</title>
-                               <para>Download a prebuilt software image that, when installed in <application>"VirtualBox"</application>, <application>"VMware"</application> or <application>"VirtualPC"</application>, will emulate a Linux guest system containing a running Evergreen distribution. The image is essentially a snapshot of a hard disk from a fully configured, functional Linux system with Evergreen already installed.</para>
-                               <para>We recommend this approach if you wish to get Evergreen running quickly with minimal attention to configuration. After reviewing only a few configuration details you can have a working Evergreen system that integrates smoothly with the rest of your network. See <xref linkend="serversideinstall-virtual-versions"/> for a list of prebuilt software images that are currently available to download and execute:</para>
-                               <table xml:id="serversideinstall-virtual-versions">
-                                       <title>Linux / Evergreen Virtual Images</title>
-                                       <tgroup align="left" cols="4" colsep="1" rowsep="1">
-                                               <thead>
-                                                       <row>
-                                                               <entry>Linux Version</entry>
-                                                               <entry>Evergreen Version</entry>
-                                                               <entry>OpenSRF Version</entry>
-                                                               <entry>VirtualBox Image</entry>
-                                                       </row>
-                                               </thead>
-                                               <tbody>
-                                                       <row>
-                                                               <entry>Debin lenny (5.0)</entry>
-                                                               <entry>1.6.0.1</entry>
-                                                               <entry>1.4.x</entry>
-                                                               <entry>
-                                                                       <ulink url="http://www.open-ils.org/~denials/Evergreen1601_DebianLenny.zip"> download </ulink>
-                                                               </entry>
-                                                       </row>
-                                               </tbody>
-                                       </tgroup>
-                               </table>
-                               <para>In the remainder of this section, we assume that the application <application>"VirtualBox"</application> has already been installed and started.</para>
-                               <procedure>
-                                       <step>Download the prebuilt Linux/Evergreen system</step>
-                                       <step>Start the system</step>
-                                       <step>Configure the system</step>
-                               </procedure>
-                       </section>
-                       <section>
+                       <section xml:id="serversideinstall-virtual-manual">
                                <title>Manually install Linux and Evergreen</title>
                                <para>Manually install a Linux guest system, then manually install Evergreen.</para>
                                <para>We recommend this approach if you need to configure the Linux system in any special way, or if you require Evergreen to target some specific chores. This will require a detailed review of both Linux and Evergreen configuration details. You are essentially doing a normal Evergreen installation on a Linux system; it just happens that Linux is running within a virtualized environment. Refer to <xref linkend="serversideinstallation-ubuntudebian"/> for information on the normal Evergreen installation, then continue with this section.</para>
                                <para>In this example, we assume that the application <application>"VirtualBox"</application> has already been installed and started:</para>
                                <procedure>
-                                       <step>A standard <systemitem class="osname">Ubuntu</systemitem> distribution, the so-called "Guest" operating system, is installed in the running <application>"VirtualBox"</application> environment.</step>
-                                       <step>The <systemitem class="osname">Ubuntu</systemitem> distribution is started ("booted") just as if it existed on a real, physical system.</step>
-                                       <step>Evergreen is installed on the running <systemitem class="osname">Ubuntu</systemitem> distribution, just as if installing on a standalone system.</step>
+                                       <step>A standard <systemitem class="osname">Ubuntu</systemitem> distribution, the so-called "Guest" operating system, is installed in the running <application>"VirtualBox"</application> environment.
+                               <indexterm><primary>ZZZ-REVIEW</primary><secondary>ADD DETAILS ON MANUAL INSTALLATION OF LINUX</secondary></indexterm></step>
+                                       <step>The <systemitem class="osname">Ubuntu</systemitem> distribution is started ("booted") just as if it existed on a real, physical system.
+                               <indexterm><primary>ZZZ-REVIEW</primary><secondary>ADD DETAILS ON MANUAL INSTALLATION OF VM LINUX BOOT SEQUENCE</secondary></indexterm></step>
+                                       <step>Evergreen is installed on the running <systemitem class="osname">Ubuntu</systemitem> distribution, just as if installing on a standalone system.
+                               <indexterm><primary>ZZZ-REVIEW</primary><secondary>ADD DETAILS ON MANUAL INSTALLATION OF EVERGREEN</secondary></indexterm></step>
                                </procedure>
                                <para>At this point, the <systemitem class="osname">Windows</systemitem> system is hosting an <systemitem class="osname">Ubuntu</systemitem> system, which itself is hosting the Evergreen distribution. So far as Evergreen is concerned, it is happily executing in a standard <systemitem class="osname">Ubuntu</systemitem> environment and behaves exactly as if it were executing on a standalone <systemitem class="osname">Ubuntu</systemitem> system.</para>
                                <para>Of course, there are limitations to how well a virtualized <systemitem class="osname">Ubuntu</systemitem> system emulates a real one. The <application>"VirtualBox"</application> application itself consumes memory, and it contributes to the CPU load on the <systemitem class="osname">Windows</systemitem> host system. The emulated <systemitem class="osname">Ubuntu</systemitem> system will have less available memory and will execute more slowly than if it were a standalone system, therefore Evergreen itself will inherit some limitations from this overall environment.</para>