From c5cf9343b51d656246b894dbf82289e3979cb0af Mon Sep 17 00:00:00 2001 From: Steve Sheppard Date: Thu, 20 Jan 2011 14:59:24 -0500 Subject: [PATCH] extend the section 'Installing In Virtualized Linux Environments'; --- 1.6/admin/serversideinstallation.xml | 348 ++++++++++++++++++--------- 1 file changed, 234 insertions(+), 114 deletions(-) diff --git a/1.6/admin/serversideinstallation.xml b/1.6/admin/serversideinstallation.xml index 918cb19a1f..03c9357246 100644 --- a/1.6/admin/serversideinstallation.xml +++ b/1.6/admin/serversideinstallation.xml @@ -1949,14 +1949,6 @@ Linux and Evergreen software in the new virtualized environment: - - Download and install a prebuilt software image that - contains a working - Linux / Evergreen - system (see - for - details) - Manually install a Linux guest system, @@ -1964,8 +1956,34 @@ for details) + + Download and install a prebuilt software image. The following + example shows installation of a working Debian "Lenny" (5.0) + Linux / Evergreen 1.6.1.4 system + (see for + details) + We review each method in the following sections. +
+ Manually install <systemitem class="osname">Linux</systemitem> and Evergreen + Instead of installing a pre-built, pre-configured virtual image + of Linux containing the + Evergreen software, you could just install a bare virtual + Linux guest system, then install + Evergreen from scratch on that system. + We recommend this approach if you need to specially configure + either the Linux system or + Evergreen itself. 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 on a Windows + system. See for + information on a normal Evergreen installation. +
Download and install a prebuilt software image You can download a prebuilt software image that, when installed @@ -2065,82 +2083,240 @@ - For the following example, we have already installed the - VirtualBox application (see - for details). - Continue with the steps as shown; refer to the accompanying figures for further - information: + In the following example you will install a prebuilt Debian + "Lenny" (5.0) / Evergreen 1.6.1.4 system. We assume you have already + installed the VirtualBox application (see + for + details). Continue with the following steps; refer to the accompanying + figures for more information: - Start VirtualBox for the first time and select + Download software + Download the prebuilt software image for Debian + "Lenny" (5.0) / Evergreen 1.6.1.4 contained in the + file Evergreen_1_6_1_4_Lenny.zip . + Create a temporary directory + C:\temp, then extract the contents + of the .ZIP file there. + + + Add new virtual disk + You must configure VirtualBox to recognized the new disk + image before you can create a new virtual machine to use it. + Start VirtualBox and select File VirtualBox Media Manager Add - - 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 + , + then choose the disk image Lenny_1614_disk1.vmdk + that you just extracted to the temporary directory. Review + , + and - for details). + for details. + Start virtual machine wizard Click New to start the "Virtual - Machine Wizard", then Next to continue - and create a new virtual machine (VM) + Machine Wizard", then click Next to + create a new virtual machine (VM) ). - Create a new name for the VM and set the operating + Define new virtual machine + Define a name for the new virtual machine, set the operating system type, then click Next (see ). - Set the memory size (we chose the default value of - 512Mb), then click Next (see + Set memory size + Set the memory size (we chose a default value of 512Mb), + 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 - ). + Attach virtual disk + Attach the virtual hard disk image by setting the radio boxes + Boot Hard Disk and Use existing hard + disk. Ensure that the proper disk name is selected. + Click Finish to finish the setup. Review + , + and + and + for details. + + + Start new virtual machine + Click Start to boot the new VM. + + + Manually start Evergreen + After the new virtual machine boots up for the first time, + you must manually start Evergreen. Start it as follows, starting + as the root user (see + for more + information): + + + su - # become the root user - enter "evergreen" for the password + su - opensrf # as the opensrf user + osrf_ctl.sh -l -a start_all # start all Evergreen services + exit # become the root user again + /etc/init.d/apache2 restart # restart the Apache server + + The following table lists the default accounts already set + up in the virtual machine: + + + Default Accounts + + + + + + + Account + Password + Type + + + + + root + evergreen + Linux account + + + + + evergreen + evergreen + Linux account + + + + + opensrf + evergreen + Linux account + + + + + evergreen + evergreen + Database account + + + + + admin + open-ils + Evergreen account + + + +
+ At this point you have a running + Linux / Evergreen system. If + you need to modify the Evergreen configuration in any way, review + + in the standard Evergreen installation instructions. + + + Start staff client + The virtual machine just installed has been configured + to include an optional graphical desktop environment. If you + configure the virtual machine for 1.0 GB RAM, you should be + able to run the desktop at the same time as Evergreen. To + start the desktop, log in as the + opensrf user and + enter the command startx. + The desktop in this virtual machine includes the web + browser IceWeasel (the + Debian version of + Firefox) and XULRunner 1.9. Once you + start the desktop and Evergreen, you can connect to Evergreen + using the built-in staff client with the following + commands: + + + # as the opensrf user + cd /home/opensrf/Evergreen-ILS-1.6.1.4/Open-ILS + xulrunner-1.9 xul/staff_client/build/application.ini + + Connect to + localhost using the + username and password + admin / + open-ils and begin populating the + data in your image. + + + (OPTIONAL) Modify network connections + This machine was configured with a NAT connection on the + first Ethernet adapter + (eth0). As the virtual machines + tend to map virtual devices to real MAC addresses on their host, + you might need to clear that mapping before making a connection. + As root, run: + + + # as the root user: + rm /etc/udev/rules.d/70-persistent-net.rules + reboot + + To create a network connection, as root run: + dhclient eth0 to set up a NAT + connection. + + + Add another host connection + To add another host connection, you must add a second + Ethernet adapter (eth1) network + configuration interface and configure it as a host-based + connection. After you add the second Ethernet adapter for the + host connection, to create the host network connection, as root + run: dhclient eth1. + To connect to your virtual machine from your host + machine, create the host connection and check the IP address + of device eth1 using the + ifconfig command: + /sbin/ifconfig eth1. The IP address + will be listed in the inet_addr stanza as something like: inet addr: 192.168.56.101. - Install the VirtualBox Guest - Additions (really a required upgrade to - VirtualBox). + Network connections for external staff clients + While you can use the IP address to access the OPAC, the + staff client needs a hostname to connect to Evergreen. For the + built-in staff client in the Linux graphical desktop, you can + just use "localhost". But for external staff + clients, if your network does not assign a real hostname to the + IP address for the virtual image, you may need to alter the + hosts file on your client workstations to provide an alias for + the IP address. + On Linux, the hosts file can be found in the file + /etc/hosts. On + Windows, the hosts file + can be found in + C:\WINDOWS\System32\drivers\etc\hosts. - Return to VirtualBox and see the summary of the VM just created - (see - and ). - Click Start to boot the new VM, then - log in with username root and - password evergreen to continue. + External staff clients + You can connect a staff client to the virtual Evergreen system + by getting your host-based connection running (see + ). + Once you have a host-based connection, you can install and use the + Windows 1.6.1.4 staff + client available from + + http://evergreen-ils.org/downloads/evergreen-setup-rel_1_6_1_4.exe + to connect to the virtual Evergreen system from another + Windows machine. - At this point you have a running - Linux / Evergreen system. - If you need to modify the Evergreen configuration in any way, review - the sectons of the standard Evergreen installation instructions in - that deal with - configuration.
Starting <application>VirtualBox</application> for the first time @@ -2205,7 +2381,6 @@
-
Summary of the new VM @@ -2215,61 +2390,6 @@
-
- Manually install <systemitem class="osname">Linux</systemitem> and Evergreen - Instead of installing a pre-built, pre-configured virtual image - of Linux containing the - Evergreen software, you could also manually install a - Linux guest system, then install - Evergreen from scratch on that system. - We recommend this approach if you need to specially configure - either the Linux system or - Evergreen itself. 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 on a Windows - system. See for - information on the normal Evergreen installation, then continue with this - section. - For the following example, we have already installed the - VirtualBox application (see - for details). - Continue with the steps as shown; refer to the accompanying figures - for further information: - - - Download and install an appropriate version of the - standard Ubuntu software - distribution on "VirtualBox". - - - Start (boot) Ubuntu. - - - Install Evergreen on the - Ubuntu system. - - -
-
- Summary - Whether you install a pre-built, pre-configured virtual image of - Linux already containing the - Evergreen software (see ), - or you install a plain virtual - image Linux and then install - Evergreen from scratch (see ), - your Windows system is now 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 should - behave as if it were executing on a standalone - Ubuntu system. -
-- 2.43.2