Open Source Integrated Library System
About Us FAQs Documentation Blog Chat Mailing Lists Evergreen Blogs Download
 

Evergreen 1.4.0.4 on Debian Lenny (VirtualBox image)

One record (search for “environment”) has been loaded on this system, giving you a relatively clean slate to play with. This image includes an X server and Web browser so that you can test the complete system in a single image.

System requirements

Disk space

This image is 441 MB compressed, and 3.9 GB when it has been uncompressed, so ensure you have at least 5.0 GB of free disk space available before downloading the image.

Application

This virtual image was created with VirtualBox, a free and open source virtualization application available for Windows, Linux, OS X, and Solaris. You must download and install VirtualBox before you can use this image.

You also need an application that supports decompressing bzip2 archives. This is usually installed by default on Linux; on Windows, you can <a href=“http://www.bzip.org/downloads.html”>download the bzip2 command line utility</a>. To decompress the image, issue the following command:

bunzip2 Debian_Lenny-1.4.0.4.vdi.bz2

Memory

Due to the memory requirements of the graphical environment, we recommend you allocate 1GB of RAM to this image. Your system, therefore, should have a minimum of 1.5GB of RAM.

Startup Failures

If your image fails to boot with the message “this kernel requires the following features not present on the cpu”, try this fix.

Installing Guest Additions

VirtualBox Guest additions give you better mouse and window size control.

$ sudo dhclient eth1
$ sudo apt-get install linux-image-2.6.24-21-server linux-headers-2.6.24-21-server
# Disclaimer: The guest additions file below was used with (K)Ubuntu 8.10.  You may need different guest additions file if you are on a different version  
$ wget 'http://open-ils.org/~erickson/VBoxLinuxAdditions-x86.run'
$ sudo sh VBoxLinuxAdditions-x86.run
$ sudo reboot

Using the image

Linux login:

  • username: evergreen
  • password: evergreen

Starting and stopping Evergreen

To start Evergreen, open a terminal window (right-click on the desktop and select Applications → Terminal Emulators → Rxvt-Unicode) and run the command:

sudo /usr/local/bin/start_evergreen.sh

(The password for sudo is evergreen).

Starting Firefox

To start Firefox, right-click on the desktop and select Applications → Network → Web Browsing. Once you have started Evergreen, you can find the OPAC at http://localhost/

Starting the staff client

You can try the staff client in this image, although it only contains XULRunner 1.9 and certain features are not supported.

To start the staff client, open a terminal window (right-click on the desktop and select Applications → Terminal Emulators → Rxvt-Unicode) and run the command:

xulrunner-1.9 /home/evergreen/Evergreen-1.4.0.4/Open-ILS/xul/staff_client/build/application.ini

When prompted by the staff client, log in with your Evergreen administrator login:

  • username: admin
  • password: open-ils

Getting an external IP address

If you are running VirtualBox 2.1.x and the host workstation running VirtualBox is attached to a router that supports DHCP, it's easy to get an external IP address for your VirtualBox guest image. Open a terminal window and run the following command:

sudo dhclient eth1

If the command succeeds, it will say something like “Bound to xxx.yyy.aaa.bbb” - and xxx.yyy.aaa.bbb is the IP address from which your VirtualBox image can be accessed on the network.

 
virtual/virtualbox/lenny.txt · Last modified: 2009/03/31 21:35 by stompro
 
Recent changes RSS feed Powered by PHP Valid XHTML 1.0 Valid CSS Debian Driven by DokuWiki