Ubuntu 8.04 / Evergreen 1.2.3.1 VMWare image

Download the image: Ubuntu 8.04 (523 MB)

The Evergreen 1.2.3.1 on Ubuntu 8.04 VMWare image was built following the documentation at: http://open-ils.org/dokuwiki/doku.php?id=installing_evergreen_1.2_on_ubuntu_7.10

This image comes with no preloaded data. It is a blank slate for you to play with.

I have been running this VMWare image on a laptop with 1.5GB of RAM. Any workstation with 1GB of RAM or more should be sufficient to run this VMWare image (the VMWare image itself only requires 512 MB of RAM).

1. Download and install a VMWare product from http://vmware.com(VMWare Player and VMWare Server are both free downloads) onto your system.
2. Extract the zipped Evergreen Ubuntu VMWare image onto your hard drive to create a new directory, Ubuntu804.
3. In the VMWare product, open the VMWare image by pointing to the Ubuntu804/Other Linux 2.6.x kernel.vmx file found in the unzipped directory. Your Ubuntu Linux operating system should begin booting up, eventually presenting you with a login prompt.

• user ID: evergreen
• password: evergreen

This is an Ubuntu 8.04 system with all of the Evergreen development dependencies installed. The Ubuntu packages were upgraded 2008/09/25, and the Perl CPAN modules were last updated 2008/09/25. This image was built with Evergreen 1.2.3.1.

To find out what your IP address is for this virtual machine:

(evergreen) $ /sbin/ifconfig

You will see something like:

eth0      Link encap:Ethernet  HWaddr 00:16:41:54:6B:FF
          inet addr:192.168.1.128 

The number following 'inet addr:' is your IP address. You must use the IP address for the eth0 or eth1 adapter, the lo adapter is a loopback connection that can accept no connection outside of the VMWare image.

If you do not have an IP address, try running the following commands:

$ sudo rm /etc/udev/rules.d/70-persistent-net.rules
$ sudo reboot

This will reboot the Ubuntu VMWare image and force it to create new network bindings. You may need to restart the network before you are able to get an IP address by running the following command:

$ sudo /etc/init.d/networking restart

(evergreen) # sudo su - opensrf
(opensrf) $ cd /openils/bin
(opensrf) $ osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_router
(opensrf) $ osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_perl
(opensrf) $ osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_c
(opensrf) $ clark-kent.pl --daemon

Once the services are up and running, switch to a new virtual terminal with ALT-F2, login, and start Apache:

(evergreen) $ sudo /etc/init.d/apache2 start

You can then open up that IP address in the browser on your host machine to see the beautiful default Evergreen catalog interface.

You can launch the staff client on your host operating system by pointing to that IP address and using 'admin' as the username and 'open-ils' as the password.

To run the staff client on a Windows host, download the Windows 1.2.3.0 version of the staff client from http://open-ils.org/downloads.php

You can also use the Windows 1.2.3.1 version of the staff client if you issue the following commands:

$ cd /openils/var/web/xul
$ sudo ln -sf rel_1_2_3_0 rel_1_2_3_1

Questions about Evergreen or this image? Contact the open-ils-general mailing list: http://open-ils.org/listserv.html

Dan Scott - dscott@laurentian.ca (but *please* send questions to the mailing list!) Laurentian University