Greenstone

The Linux version of Greenstone digital library software will run on the Dreamhost servers. The memory usage of the Linux installer script however is too high for the Dreamhost shared servers. It will work properly on a Dreamhost PS however as you can simply increase your resources.

Installation
For this you will need a shell user. You will be using SSH to connect to the Dreamhost server and issuing commands.

First after you have connected to the Dreamhost server using SSH you need to enter this command to download the installer binary to the Dreamhost server. This will copy download it as a file named Greenstone-2.83-linux in your current directory. wget http://downloads.sourceforge.net/project/greenstone/Binary%20Installer%20-%20Linux/Greenstone-2.83-linux

Second you will need to create a tmp directory in your user's directory and then set the environment variable TMPDIR to that location. mkdir $HOME/tmp export TMPDIR="$HOME/tmp"

Finally you will issue these two commands to first make the binary file executable and then run it. chmod 755 Greenstone-2.83-linux ./Greenstone-2.83-linux

Setup
The setup process will ask you a few questions. The default installation folder that it suggested wasn't good, instead you will want to make sure that installation folder is within your hosted directory. The value should be /home/username/yourdomain.com/foldername

Select an installation folder  [default:/home/username/Greenstone] /home/username/yourdomain.com/Greenstone

The remainder of the setup process can use the default settings.

Usage
You shouldn't need to do anything extra to Apache after that. Just access the cgi-bin/library.cgi file.

http://yourdomain.com/Greenstone/cgi-bin/library.cgi

Troubleshooting
On the shared servers you are likely to see an error like this during the install:

Yikes! One of your processes (java, pid 21411) was just killed because your processes are, as a whole, consuming too much memory. If you believe you've received this message in error, please contact Support. The installer exited with an error Greenstone may not be correctly installed Deleting the temp directory

This means the install script was killed because it hit the shared server's memory limits. The only workaround for this is to upgrade to a Dreamhost Private Server.