Installing Greenstone in the ISRL

Greenstone's Digital Library software is installable as an enduser on the ISRL systems. Follow these few steps for installation.

• Downloading
• Software install
• Final fixups
• Notes

Downloading

Download the source code for Greenstone. These instructions work with version 2.39.

Once downloaded, unpack the source into your home directory (or whereever you wish). This is not the final install point for greenstone.

tar -zxvf gsdl-2.39-unix.tgz

Software install

For the rest of this, I will assume you wish to install greenstone into your own web space. I assume your username is myname, so substitute your real username for myname. I also assume that you wish to install it on the main web server, so I use /content/web/users in several places. Change this to /content/web3/users to install on www3.

Since this software requires passwords, you _must_ install it on one of the secure web servers. Change to the gsdl-2.39 directory, and change to the Unix directory. Run the install script.

cd gsdl-2.39-unix/Unix
./Install.sh

The install script asks several questions. When asked if you wish to continue, say yes. The paths should be as follows (yes, it's public_htmls, not public_html):

Continue: y
Greenstone install directory: /content/web/users/myname
Create uninstall script: y
Make directory globally writable (see notes below): y
Binary/Source: b
cgi-bin directory new/existing: 2
cgi-bin name: /content/web/users/myname/public_htmls/greenstone
Create it: y
URL: https://www-s.isrl.uiuc.edu/~myname/greenstone
new/existing web tree: 2
web tree name: /content/web/users/myname/public_htmls
URL: https://www-s.isrl.uiuc.edu/~myname/gsdl
Enter password: <whatever you want>

Final fixups

There are now a few misc. items to fix up the greenstone installation. First, since we don't have a ScriptAlias for the greenstone directory, you'll need to add the .cgi ending:

cd /content/web/users/myname/public_htmls/greenstone
mv library library.cgi

Set up the apache server so directory listings are not enabled on the new greenstone directories:

echo "Options    -Indexes" > /content/web/users/myname/public_htmls/greenstone/.htaccess
echo "Options    -Indexes" > /content/web/users/myname/public_htmls/gsdl/.htaccess

Finally, you'll likely want to make a forwarding link somewhere to make your greenstone installation easier to find. The appropriate link would be:

https://www-s.isrl.uiuc.edu/~myname/greenstone/library.cgi

Notes

Why globally writable?

The web server needs to be able to write to your collections directory. Since you cannot set up a space that only the webserver can write to, you must allow everyone write permissions.

What do I change in the URL's for www3?

URL's for the main secure server start https://www-s.isrl.uiuc.edu/. Therefore, if your username is bob, the URL would be https://www-s.isrl.uiuc.edu/~bob/greenstone/library.cgi. The secure server on www3 starts with https://www3.isrl.uiuc.edu/ so the URL would be https://www3.isrl.uiuc.edu/~bob/greenstone/library.cgi