From: Steve Sheppard Date: Mon, 20 Sep 2010 22:24:55 +0000 (-0400) Subject: updates to section 'Installing in Virtualized Linux Environment'; X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=1e37d199d5a1735d3c9a9b2e88b76597a4850ec5;p=Evergreen-DocBook.git updates to section 'Installing in Virtualized Linux Environment'; --- diff --git a/1.6/admin/ServersideInstallationVirtual.xml b/1.6/admin/ServersideInstallationVirtual.xml index 98167be..48f9d00 100644 --- a/1.6/admin/ServersideInstallationVirtual.xml +++ b/1.6/admin/ServersideInstallationVirtual.xml @@ -3,23 +3,23 @@ Installing In Virtualized Linux Environments
Overview - This section describes the installation of Evergreen software in so-called "virtualized" software environments. Evergreen software currently runs as a native application on any of several well-known x86 (32-bit) and x86-64 (64-bit) Linux distributions including Ubuntu and Debian, but it does not run as a native application on the Microsoft Windows operating system. However, it is possible to execute Evergreen on a Windows host system by running it within a virtual Linux-guest installation, which itself executes on the Windows system. The Linux environment is fully emulated and acts (with some limits) just as if it were executing on a real standalone system. + This section describes the installation of Evergreen software in so-called "virtualized" software environments. Evergreen software currently runs as a native application on any of several well-known x86 (32-bit) and x86-64 (64-bit) Linux distributions including Ubuntu and Debian, but it does not run as a native application on the Microsoft Windows operating system. However, it is possible to execute Evergreen on a Windows host system by running it within a virtual Linux-guest installation, which itself executes on the Windows system. The Linux environment is fully emulated and acts (within limits) just as if it were executing on a real standalone system. This technique of emulating a Linux environment on a Windows host is a practical way to install and run an Evergreen system if it is not possible to dedicate a physical machine solely as a Linux host for Evergreen. -There are some performance limitations to running Evergreen in a virtualized environment, so this architecture is not recommended for large scale systems. However, this is a reasonable architecture for simple experiments, as a proof of concept, or as a conference-room pilot. +There are some performance limitations to running Evergreen in a virtualized environment, so this architecture is not recommended for large scale systems. However, it is a reasonable architecture for simple experiments, as a proof of concept, or as a conference-room pilot.
Installing Virtualization Software - The Linux environment is controlled by one of several popular virtualization software applications 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. + 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). + This section reviews the procedure for installing the "VirtualBox" application on WindowsXP Professional (SP2). Follow these instructions: - Download VirtualBox from here: 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 first five figures until the software has been successfully installed: + 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 - +
@@ -27,7 +27,7 @@ There are some performance limitations to running Evergreen in a virtualized env Welcome to <application>VirtualBox</application> setup wizard - + @@ -35,7 +35,7 @@ There are some performance limitations to running Evergreen in a virtualized env Accept the license agreement - + @@ -43,7 +43,7 @@ There are some performance limitations to running Evergreen in a virtualized env Waiting for files to be copied - + @@ -51,64 +51,131 @@ There are some performance limitations to running Evergreen in a virtualized env Installation is complete - + - After successfully installating VirtualBox, 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: -
- Starting <application>VirtualBox</application> for the first time - - - - - -
-
- Setting VM name and OS type - - - - - -
-
- Setting memory size - - - - - -
-
- Setting disk type - - - - - -
-
- Setting disk size - - - - - -
-
- Finished defining the VM - - - - - -
+ 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 . - 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. +
+ Starting <application>VirtualBox</application> for the first time + + + + + +
+
+ Selecting the software image in "Virtual Media Manager" + + + + + +
+
+ New software image added to <application>VirtualBox</application> + + + + + +
+
+ Creating a new VM + + + + + +
+
+ Setting the VM name and OS type + + + + + +
+
+ Setting memory size + + + + + +
+
+ Setting up the Virtual Hard Disk + + + + + +
+
+ Finishing definiton of new VM + + + + + +
+
+ Summary of the new VM + + + + + +
+
+ Selecting VM from startup menu + + + + + +
+
+ Starting the new VM + + + + + +
+
+ Starting the new VM (continued) + + + + + +
+
+ Logging in to the new VM + + + + + +
Installing <application>"VMware"</application> Virtualization Software @@ -120,7 +187,7 @@ There are some performance limitations to running Evergreen in a virtualized env Starting the Windows installation file - + @@ -146,13 +213,13 @@ There are some performance limitations to running Evergreen in a virtualized env 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: + 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.