Greenstone installation instructions
Greenstone software:
* Unix
+ Source distribution
+ Building collections
* Windows
+ Source distribution
+ Binary distributions
+ Building collections
Greenstone Collections
Other software:
* Perl for Windows
* Apache web server
For more information about how to use the software, consult The
Greenstone Digital Library Software manual.
Unix source distribution
* Download the latest version of the source distribution
* Extract the gzipped tar archive (tar xvzf gsdl-xx.x.tgz); this
will create a directory gsdl into which all software is installed
* In the gsdl directory, type ./configure
* When the configure script has finished running, type make
* Type make install, which copies the compiled library file into the
gsdl/cgi-bin directory, and also installs several executables that
are used to build collections into gsdl/bin/$GSDLOS
* Move both library and the gsdlsite.cfg configuration file to your
system's cgi-bin directory, so that the library runs as a cgi
script
* Edit the gsdlsite.cfg configuration file to suit your site. Set
the gsdlhome field to point to your gsdl directory. Other fields
that may need changing are httpprefix (the web path to the gsdl
directory) and httpimg (the path to gsdl/images)
* Build the Demo Collection that comes with the distribution
* Access the Greenstone Digital Library home page at
http://localhost/cgi-bin/library (replace "localhost" by the
server's URL if your Internet browser is not running on the server
computer)
* If the Demo Collection does not appear on the home page, run
library from the Unix command line to generate debugging
information to help you locate the problem
* Access the administration page at
http://localhost/cgi-bin/library?a=status
Windows source distribution
* Download the latest version of the source distribution--the same
source code as for Unix (though for Windows you may want to select
a zipped version)
* Extract the distribution using WinZip or a similar utility
* The default is to extract Greenstone directly into C:\ (i.e. a
directory C:\gsdl will be created into which all software is
installed)
* In the resulting gsdl directory type nmake win32.mak
* Type nmake /f win32.mak install, which copies the Web Library
version of library.exe into the gsdl\cgi-bin directory and the
Local Library version into the gsdl directory; it also installs
several executables that are used to build collections into
gsdl\bin\windows
Windows binary distributions
Three separate binary distributions are available for Windows: the
Local Library, the Web Library, and the Collection Builder. First
decide which distribution you want; then:
* Download the latest version of the desired binary distribution
* Extract the distribution using WinZip or a similar utility
* The default is to extract Greenstone directly into C:\ (i.e. a
directory C:\gsdl will be created into which all software is
installed). If installing the Collection Builder as well as one of
the Libraries, be sure to extract both distributions to the same
directory
* If Greenstone is not installed to C:\gsdl, edit the gsdlsite.cfg
configuration file (in the cgi-bin directory) by setting the
gsdlhome field to point to your gsdl directory
* Follow the instructions below for the version you have downloaded:
Local Library
+ Run the library.exe executable. This will automatically start
your Internet browser and load the Greenstone Digital Library
home page. The Demo collection should be accessible from this
page.
+ Access the administration page at
http://localhost/cgi-bin/library?a=status
Web Library
+ If you do not already have a webserver, install Apache as
described below
+ If using an existing webserver, check the gsdlsite.cfg
configuration file to ensure that httpprefix contains the web
path to the gsdl directory and httpimg contains the path to
gsdl\images
+ The Greenstone Digital Library home page will appear as
http://localhost/cgi-bin/library (replace "localhost" by the
server's URL if your Internet browser is not running on the
server computer)
+ If the Demo Collection does not appear on the home page, run
library.exe from the DOS prompt to generate debugging
information to help you locate the problem
+ Access the administration page at
http://localhost/cgi-bin/library?a=status
Collection Builder
+ If you do not already have Perl, you will need to install it
(see below)
+ Download a test collection (e.g. the Demo Collection) and
build it
+ Reload the Greenstone home page at
http://localhost/cgi-bin/library
+ If the Demo Collection does not appear on the home page, run
library.exe from the DOS prompt to generate debugging
information to help you locate the problem
Greenstone Collections
* Install Greenstone as described above
* Download the required collection. Collection distributions with
filenames like ***_prebuilt.zip are pre-built collections. All
others will require building.
* Extract the .zip or .tgz file to your gsdl/collect directory
* Build the collection if it was not pre-built
Once a new collection has been built, Greenstone will automatically
notice it and include it on the home page (when you click Reload).
Building Greenstone Collections on Unix
* Source setup.bash or setup.csh from within the gsdl directory to
set up environment variables and path (e.g. source setup.bash)
* Note that pwd is used to set $GSDLHOME. If you need to be able to
source setup.bash or setup.csh from a directory other than gsdl
(e.g. from your .profile or .bashrc) you will need to edit the
script.
* Run build.sh colname, where colname is the directory name of your
collection (e.g. demo).
Building Greenstone Collections on Windows
* Make sure the setup.bat batch file is correct (i.e. that it sets
the GSDLHOME environment variable to the correct path of your gsdl
directory)
* run setup.bat
* Run build colname, where colname is the directory name of your
collection (e.g. demo).
To find out more about building collections, consult The Greenstone
Digital Library Software manual.
Perl for Windows
* Download Perl (pre-5.6 version)
* Doubleclick the self-extracting executable and follow instructions
The Apache Webserver
* Download the latest version of the Apache distribution
* Doubleclick the self-extracting executable and follow instructions
* Configure Apache for use with Greenstone by adding the following
to your Apache server's httpd.conf configuration file (which
resides in the Apache conf directory)
* Existing server configurations may need to be configured
differently--see your system administrator if necessary
_____________________________________________________________
# Some NT installations complain about an inability to work
ServerName
# out for themselves -- on most systems you can leave it commented
out.
# "localhost" should be replaced by www.yourserver.com if you plan
# to serve Greenstone to anyone other than the local machine.
# ServerName localhost
# Make cgi-bin point to your Greenstone cgi-bin directory.
# Note the forward
# slashes (/) instead of standard Windows
# backslashes (\) -- a hangover from Apache's Unix roots.
ScriptAlias /cgi-bin/ "c:/gsdl/cgi-bin/"
AllowOverride None
Options None
# DocumentRoot points to your Greenstone root directory.
# Make sure that httpd.conf doesn't contain any other DocumentRoot
# directives -- if they come after this they'll override it
DocumentRoot "c:/gsdl"
Allow from All
# Redirect http://localhost to http://localhost/cgi-bin/library
# "localhost" should be replaced by www.yourserver.com if you plan
# to serve Greenstone to anyone other than the local machine.
Redirect /index.html http://localhost/cgi-bin/library
_____________________________________________________________