From: Steve Sheppard Date: Sun, 19 Sep 2010 23:24:20 +0000 (-0400) Subject: expand section 'Installing in Virtualized Linux Environments'; X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=ffb5cf33a61cca649db9375a6e0c5c8a02c67388;p=Evergreen-DocBook.git expand section 'Installing in Virtualized Linux Environments'; --- diff --git a/1.6/admin/ServersideInstallationVirtual.xml b/1.6/admin/ServersideInstallationVirtual.xml index e4c93ae..90e3998 100644 --- a/1.6/admin/ServersideInstallationVirtual.xml +++ b/1.6/admin/ServersideInstallationVirtual.xml @@ -1,10 +1,205 @@ - - - Server-side Installation in Virtualized Unix Environments - - placeholder - - -
+ + 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 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. +
+ 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. +
+ Installing <application>"VirtualBox"</application> Virtualization Software + This section reviews the procedure for installing the "VirtualBox" application on WindowsXP Professional (SP2). + + + 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: +
+ 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 + + + + + +
+ + + 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 + + + + + +
+ + + 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. +
+
+ 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 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 VIRTUALPC + + ADD INFO ON VIRTUALPC +
+
+
+ Installing Linux and Evergreen on the Virtualization Software + After the virtualization software is installed and running, there are two ways to continue: + + + Download a sample Linux guest system containing a pre-installed Evergreen distribution. + We recommend this approach if you wish to get Evergreen running quickly, with minimal attention to configuration. + + + Manually install a Linux guest system, then manually install Evergreen. + We recommend this approach if you need to configure Evergreen in any special way. + + +
+ Download a pre-installed Evergreen distribution + In this section, we assume that the application "VirtualBox" has already been installed and started. + 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. + + Download the pre-installed Linux/Evergreen system + Start the system + Configure the system + +
+
+ Manually install Linux and Evergreen + If you need to configure Evergreen in any special way, continue as follows. + 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. + + 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. + However, this technique of using a Windows host to emulate a Linux environment is a practical way to install and run an Evergreen system even if it isn't possible to dedicate a real machine solely as a Linux host for testing. This is a reasonable architecture for simple experiments, or as a proof of concept, or as a conference-room pilot. +
+
+
+