From e6ede471b476bc1d69f27d6eed8257bbefa62198 Mon Sep 17 00:00:00 2001 From: Steve Sheppard <ssheps@gmail.com> Date: Sun, 19 Sep 2010 22:56:10 -0400 Subject: [PATCH] expand section 'Installing in Virtualized Linux Environments'; --- 1.6/admin/ServersideInstallationVirtual.xml | 50 +++++++++++++++++++++-------- 1 file changed, 37 insertions(+), 13 deletions(-) diff --git a/1.6/admin/ServersideInstallationVirtual.xml b/1.6/admin/ServersideInstallationVirtual.xml index 90e3998284..98167be296 100644 --- a/1.6/admin/ServersideInstallationVirtual.xml +++ b/1.6/admin/ServersideInstallationVirtual.xml @@ -164,31 +164,55 @@ There are some performance limitations to running Evergreen in a virtualized env </section> </section> <section xml:id="serversideinstallation-virtual-install-linux-ev"> - <title>Installing Linux and Evergreen on the Virtualization Software</title> - <para>After the virtualization software is installed and running, there are two ways to continue:</para> - <itemizedlist> + <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 sample Linux guest system containing a pre-installed Evergreen distribution.</para> - <para>We recommend this approach if you wish to get Evergreen running quickly, with minimal attention to configuration.</para> + <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.</para> - <para>We recommend this approach if you need to configure Evergreen in any special way.</para> + <para>Manually install a Linux guest system, then manually install Evergreen on it.</para> </listitem> - </itemizedlist> + </orderedlist> + <para>See the following two sections for a review of each method.</para> <section> - <title>Download a pre-installed Evergreen distribution</title> - <para>In this section, we assume that the application <application>"VirtualBox"</application> has already been installed and started.</para> - <para>To get Evergreen running quickly it is simplest to just download a pre-installed Linux and Evergreen installation. The software is in the form of a compressed ISO file which can be quickly imported into VirtualBox, then started. Only a few simple configuration tasks are required.</para> + <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 pre-installed Linux/Evergreen system</step> + <step>Download the prebuilt Linux/Evergreen system</step> <step>Start the system</step> <step>Configure the system</step> </procedure> </section> <section> <title>Manually install Linux and Evergreen</title> - <para>If you need to configure Evergreen in any special way, continue as follows.</para> + <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> -- 2.11.0