About this manual

This document explains how to install Greenstone so that you can run it on your own computer. It also describes how to obtain associated software that is freely available—the Apache Webserver and Perl. We have striven to make the installation procedure as simple as it possibly can be.

The software runs on different platforms, and in different configurations. Consequently there are many issues that affect (or might affect) the installation procedure. Section versions_of_greenstone mentions some questions that you will need to consider before installing Greenstone. Section installation_procedure details the installation procedure for all the different versions; you need only read the part that relates to your operating system. Section greenstone_collections describes the demonstration digital library collections that are included in the distribution. Section setting_up_webserver explains how to set up common webservers, Apache and Microsoft PWS/IIS, to work with Greenstone. Section configuring_your_site describes various Greenstone configuration options, and Section personalizing shows how to make a personalized home page for your digital library installation. Finally, an Appendix appendix_associated_software lists pieces of associated software and how to obtain them.

Companion documents

The complete set of Greenstone documents include five volumes:

  • Greenstone Digital Library Installer's Guide (this document)
  • Greenstone Digital Library User's Guide
  • Greenstone Digital Library Developer's Guide
  • Greenstone Digital Library: From Paper to Collection
  • Greenstone Digital Library: Using the Organizer

Copyright © 2002 2003 2004 2005 2006 2007 by the New Zealand Digital Library Project at the University of Waikato, New Zealand.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License.”

Acknowledgements

The Greenstone software is a collaborative effort between many people. Rodger McNab and Stefan Boddie are the principal architects and implementors. Contributions have been made by David Bainbridge, George Buchanan, Hong Chen, Michael Dewsnip, Katherine Don, Elke Duncker, Carl Gutwin, Geoff Holmes, Dana McKay, John McPherson, Craig Nevill-Manning, Dynal Patel, Gordon Paynter, Bernhard Pfahringer, Todd Reed, Bill Rogers, John Thompson, and Stuart Yeates. Other members of the New Zealand Digital Library project provided advice and inspiration in the design of the system: Mark Apperley, Sally Jo Cunningham, Matt Jones, Steve Jones, Te Taka Keegan, Michel Loots, Malika Mahoui, Gary Marsden, Dave Nichols and Lloyd Smith. We would also like to acknowledge all those who have contributed to the GNU-licensed packages included in this distribution: MG, GDBM, PDFTOHTML, PERL, WGET, WVWARE and XLHTML.