This VMWare image was built following the documentation at: http://open-ils.org/dokuwiki/doku.php?id=installing_prerequisites_on_gentoo

* 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).

• Download and install a VMWare product from http://vmware.com (VMWare Player and VMWare Server are both free downloads) onto your system.

• Extract the zipped Evergreen Gentoo VMWare image onto your hard drive to create a new directory, Evergreen_Gentoo.

• In the VMWare product, open the VMWare image by pointing to Evergreen_Gentoo/Other Linux 2.6.x kernel.vmx file found in the unzipped directory. Your Evergreen Gentoo Linux operating system should begin booting up, presenting you with a login prompt.

• To log in:

  userid: root
  password: openils

This is a Gentoo system with all of the Evergreen development dependencies installed. The Gentoo world was emerged 2007/09/21, and the Perl CPAN modules were last updated 2007/09/21. Evergreen SVN was checked out on 2007/09/21. This image was built with Evergreen 1.2.0-rc4.

The hostname for this image was evergreen.sympatico.ca (yes, my fellow Canadians, I know how lame that is). Run the following command:

perl -MNet::Domain=hostfqdn -e 'print hostfqdn'

If the result is not evergreen.sympatico.ca, you must change the corresponding string in /openils/conf/opensrf.xml from evergreen.sympatico.ca to the result of the command for Evergreen to work properly.

Note: If you do change your hostname, you will need to edit /usr/lib/perl5/5.8.8/Net/libnet.cfg and edit the line 'inet_domain' => 'sypatico.ca' for Net::Domain to respond properly.

To start Evergreen:

(root) # 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

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

(root) # /etc/init.d/apache2 start

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

(root) # /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 can then open up that IP address in the browser on your host machine to see the beautiful default Evergreen catalog interface.

To start the staff client: 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, you can download a Windows version of the staff client from http://open-ils.org/downloads.php

There is a known problem with the 1.2.0-rc4 Gentoo VMWare image - it was inadvertently released with the wrong password for the admin user. You can change the password back to open-ils by running the following commands:

psql -U postgres evergreen
# update actor.usr set passwd = 'open-ils' where usrname = 'admin';
# \q

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

Dan Scott - dscott@laurentian.ca Laurentian University