From f66a3d1c04edca0cf63932dc99ff3fe6f9b533ce Mon Sep 17 00:00:00 2001 From: Steve Sheppard Date: Mon, 20 Sep 2010 18:51:59 -0400 Subject: [PATCH] further updates to section 'Installing in Virtualized Linux Environments'; --- 1.6/admin/ServersideInstallationVirtual.xml | 285 ++++++++++---------- 1 file changed, 140 insertions(+), 145 deletions(-) diff --git a/1.6/admin/ServersideInstallationVirtual.xml b/1.6/admin/ServersideInstallationVirtual.xml index 48f9d003f4..ee111d95d8 100644 --- a/1.6/admin/ServersideInstallationVirtual.xml +++ b/1.6/admin/ServersideInstallationVirtual.xml @@ -9,69 +9,160 @@ There are some performance limitations to running Evergreen in a virtualized env
Installing Virtualization Software 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 "VirtualBox", "VMware" or "VirtualPC" which must first be installed on the Windows system. This section contains step-by-step examples of installing each of the popular virtualization applications on a Windows 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. -
+
Installing <application>"VirtualBox"</application> Virtualization Software This section reviews the procedure for installing the "VirtualBox" application on WindowsXP Professional (SP2). Follow these instructions: + Download VirtualBox from their official website: http://download.virtualbox.org/virtualbox/3.2.8/VirtualBox-3.2.8-64453-Win.exe, then run the executable file. Continue with the steps shown in the next five figures until the software has been successfully installed: +
+ Starting the Windows installation file + + + + + +
+
+ Welcome to <application>VirtualBox</application> setup wizard + + + + + +
+
+ Accept the license agreement + + + + + +
+
+ Waiting for files to be copied + + + + + +
+
+ Installation is complete + + + + + +
+
+
+ Installing <application>"VMware"</application> Virtualization Software + This section reviews the procedure for installing the "VMware" application on WindowsXP Professional (SP2). - Download VirtualBox from their official website: http://download.virtualbox.org/virtualbox/3.2.8/VirtualBox-3.2.8-64453-Win.exe, then run the executable file. Continue with the steps shown in the next five figures until the software has been successfully installed: + Download VMware from here: link, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed:
Starting the Windows installation file - - - -
-
- Welcome to <application>VirtualBox</application> setup wizard - - - - - -
-
- Accept the license agreement - - - - - -
-
- Waiting for files to be copied - - - +
+ + + After successfully installating VMware, start it for the first time and click "New" 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 Debian Lenny. 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 VirtualBox and defining the new VM: + + + At this point, VirtualBox 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 with the installation of the Linux / Evergreen distribution. + + ZZZ-REVIEW + ADD INFO ON VMWARE + + ADD INFO ON VMWARE +
+
+ Installing <application>"VirtualPC"</application> Virtualization Software + This section reviews the procedure for installing the "VirtualPC" application on WindowsXP Professional (SP2). + + + Download VMware from here: link, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed:
- Installation is complete + Starting the Windows installation file - +
- After successfully installating VirtualBox, do the following: - - Start it for the first time and select FileVirtualBox Media ManagerAdd to locate the prebuilt software image just downloaded (the example shows it was extracted from the original .ZIP file into a temporary directory C:\temp). See for details. - After selecting the file, click Open to import it (see for details). - Then click OK to save the selection and return to the VirtualBox Media Manager (see for details). - Click New to start the "Virtual Machine Wizard", then Next to continue and create a new virtual machine (VM) ). - Create a new name for the VM and set the operating system type, then click Next (see ). - Set the memory size (we chose the default value of 384Mb), then click Next (see ). - 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 Finish to finish the setup (see ). - Return to VirtualBox and see the summary of the VM just created. Click Start to boot the new VM (see ). - See the start of the Linux boot sequence. Choose "Debian Gnu/Linux, kernel 2.6.26-2-686" from the startup menu and type Enter to start Linux and Evergreen (see ). After some delay you should see the command line prompt: debian-lenny login: . Log in with username root and password evergreen to continue (see ). - - 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 . + After successfully installating VMware, start it for the first time and click "New" 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 Debian Lenny. 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 VirtualBox and defining the new VM: + At this point, VirtualBox 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 with the installation of the Linux / Evergreen distribution. + + ZZZ-REVIEW + ADD INFO ON VIRTUALPC + + ADD INFO ON VIRTUALPC +
+
+
+ Installing Linux / Evergreen on Virtualization Software + 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: + + + Download a prebuilt software image file containing a working Linux / Evergreen system (see for details) + + + Manually install a Linux guest system, then manually install Evergreen on it (see for details) + + + See the following two sections for a review of each method. +
+ Download and install a prebuilt software image + You can download a prebuilt software image that, when installed in "VirtualBox", "VMware" or "VirtualPC", 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. + 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 for a list of prebuilt software images that are currently available to download and execute: + + Linux / Evergreen Virtual Images + + + + Linux Version + Evergreen Version + OpenSRF Version + VirtualBox Image + + + + + Debin lenny (5.0) + 1.6.0.1 + 1.4.x + + download + + + + +
+ + ZZZ-REVIEW + ADD LIST OF OTHER PREBUILS IMAGES + + After successfully installing VirtualBox (see for details), continue with the following procedure. Refer to the accompanying figures for further information: + + Start VirtualBox for the first time and select FileVirtualBox Media ManagerAdd to locate the prebuilt software image just downloaded (the example shows it was extracted from the original .ZIP file into a temporary directory C:\temp). See for details. + After selecting the file, click Open to import it (see for details). + Then click OK to save the selection and return to the VirtualBox Media Manager (see for details). + Click New to start the "Virtual Machine Wizard", then Next to continue and create a new virtual machine (VM) ). + Create a new name for the VM and set the operating system type, then click Next (see ). + Set the memory size (we chose the default value of 384Mb), then click Next (see ). + 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 Finish to finish the setup (see ). + Return to VirtualBox and see the summary of the VM just created. Click Start to boot the new VM (see ). + See the start of the Linux boot sequence. Choose "Debian Gnu/Linux, kernel 2.6.26-2-686" from the startup menu and type Enter to start Linux and Evergreen (see ). After some delay you should see the command line prompt: debian-lenny login: . Log in with username root and password evergreen to continue (see ). + + 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 .
Starting <application>VirtualBox</application> for the first time @@ -177,114 +268,18 @@ There are some performance limitations to running Evergreen in a virtualized env
-
- Installing <application>"VMware"</application> Virtualization Software - This section reviews the procedure for installing the "VMware" application on WindowsXP Professional (SP2). - - - Download VMware from here: link, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed: -
- Starting the Windows installation file - - - - - -
- - - After successfully installating VMware, start it for the first time and click "New" 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 Debian Lenny. 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 VirtualBox and defining the new VM: - - - At this point, VirtualBox 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 with the installation of the Linux / Evergreen distribution. - - ZZZ-REVIEW - ADD INFO ON VMWARE - - ADD INFO ON VMWARE -
-
- Installing <application>"VirtualPC"</application> Virtualization Software - This section reviews the procedure for installing the "VirtualPC" application on WindowsXP Professional (SP2). - - - Download VMware from here: link, then run the executable file. Continue with the steps shown in the first ??? figures until the software has been successfully installed: -
- Starting the Windows installation file - - - - - -
- - - After successfully installating VMware, start it for the first time and click "New" 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 Debian Lenny. 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 VirtualBox and defining the new VM: - - - At this point, VirtualBox 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 with the installation of the Linux / Evergreen distribution. - - ZZZ-REVIEW - ADD INFO ON VIRTUALPC - - ADD INFO ON VIRTUALPC -
-
-
- Installing Linux / Evergreen on Virtualization Software - 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: - - - Download a prebuilt software image file containing a working Linux / Evergreen system. - - - Manually install a Linux guest system, then manually install Evergreen on it. - - - See the following two sections for a review of each method. -
- Download a prebuilt software image file - Download a prebuilt software image that, when installed in "VirtualBox", "VMware" or "VirtualPC", 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. - 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 for a list of prebuilt software images that are currently available to download and execute: - - Linux / Evergreen Virtual Images - - - - Linux Version - Evergreen Version - OpenSRF Version - VirtualBox Image - - - - - Debin lenny (5.0) - 1.6.0.1 - 1.4.x - - download - - - - -
- In the remainder of this section, we assume that the application "VirtualBox" has already been installed and started. - - Download the prebuilt Linux/Evergreen system - Start the system - Configure the system - -
-
+
Manually install Linux and Evergreen Manually install a Linux guest system, then manually install Evergreen. 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 for information on the normal Evergreen installation, then continue with this section. In this example, we assume that the application "VirtualBox" has already been installed and started: - A standard Ubuntu distribution, the so-called "Guest" operating system, is installed in the running "VirtualBox" environment. - The Ubuntu distribution is started ("booted") just as if it existed on a real, physical system. - Evergreen is installed on the running Ubuntu distribution, just as if installing on a standalone system. + A standard Ubuntu distribution, the so-called "Guest" operating system, is installed in the running "VirtualBox" environment. + ZZZ-REVIEWADD DETAILS ON MANUAL INSTALLATION OF LINUX + The Ubuntu distribution is started ("booted") just as if it existed on a real, physical system. + ZZZ-REVIEWADD DETAILS ON MANUAL INSTALLATION OF VM LINUX BOOT SEQUENCE + Evergreen is installed on the running Ubuntu distribution, just as if installing on a standalone system. + ZZZ-REVIEWADD DETAILS ON MANUAL INSTALLATION OF EVERGREEN At this point, the Windows system is hosting an Ubuntu system, which itself is hosting the Evergreen distribution. So far as Evergreen is concerned, it is happily executing in a standard Ubuntu environment and behaves exactly as if it were executing on a standalone Ubuntu system. Of course, there are limitations to how well a virtualized Ubuntu system emulates a real one. The "VirtualBox" application itself consumes memory, and it contributes to the CPU load on the Windows host system. The emulated Ubuntu 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. -- 2.43.2