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 in the same directory. It is safe to allow files occurring in the second distribution installed to overwrite those in the first. * 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 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 + 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 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 _____________________________________________________________