indexed_doc en utf8 wvWare/wvWare version 1.2.4 How to build your own digital library with Greenstone http://research/ak19/gs2-svn-22Aug2013/collect/Word-PDF-Formatting/tmp/1398926159/word05.html http://research/ak19/gs2-svn-22Aug2013/collect/Word-PDF-Formatting/tmp/1398926159/word05.html import/word05.doc tmp/1398926159/word05.html word05.html word05.doc word05.doc WordPlugin 488960 word05 Word _icondoc_ doc.doc doc.doc Ian H. Witten Stefan J. Boddie GREENSTONE DIGITAL LIBRARY INSTALLER’S GUIDE HASHeaa2a12e080949673150f3 1398925758 20140501 1398926159 20140501 HASHeaa2/a12e0809.dir word050.wmf:unknown: word051.png:image/png: word052.png:image/png: word053.jpg:image/jpeg: word054.jpg:image/jpeg: word055.jpg:image/jpeg: word056.jpg:image/jpeg: word057.jpg:image/jpeg: word058.jpg:image/jpeg: word059.jpg:image/jpeg: doc.doc:application/msword: <br> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 8.33mm 39.06mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="DarkGray"><b><img alt="0x08 graphic" src=""><br></b></font><font color="DarkGray"><b>GREENSTONE DIGITAL LIBRARY</b></font><font color="DarkGray"><b> </b></font><b>INSTALLER'S GUIDE</b><font color="Black"><b></b></font> </p></div> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Ian H. Witten and Stefan Boddie</b></font> </p></div> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div> <p><div name="paragraph" align="right" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><i>Department of Computer Science<br>University of Waikato, New Zealand</i></font> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 34.50mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone is a suite of software for building and distributing digital library collections. It provides a new way of organizing information and publishing it on the Internet or on CD-ROM. Greenstone is produced by the New Zealand Digital Library Project at the University of Waikato, and developed and distributed in cooperation with UNESCO and the Human Info NGO. It is open-source software, available from <i>http://greenstone.org</i> under the terms of the G<span style="text-transform:lowercase">nu</span> General Public License. </p></div> <p><div name="Normal" align="left" style="margin: 4.17mm 0.00mm 0.00mm 51.68mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="right" style="margin: 6.94mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black">We want to ensure that this software works well for you. Please report any problems to </font><font color="Black"><i>greenstone@cs.waikato.ac.nz</i></font> </p></div> <p><div name="Normal" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div>  <br> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>About this manual</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 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. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The software runs on different platforms, and in different configurations. Consequently there are many issues that affect (or might affect) the installation procedure. Section 1 mentions some questions that you will need to consider before installing Greenstone. Section 2 details the installation procedure for all the different versions; you need only read the part that relates to your operating system. Section 3 describes the demonstration digital library collections that are included in the distribution. Section 4 explains how to set up common webservers, Apache and Microsoft PWS/IIS, to work with Greenstone. Section 5 describes various Greenstone configuration options, and Section 6 shows how to make a personalized home page for your digital library installation. Finally, an Appendix lists pieces of associated software and how to obtain them. </p></div> <p><div name="Plain Text" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Companion documents</b> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The complete set of Greenstone documents include five volumes: </p></div> <ul> <li value="1"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Digital Library Installer's Guide <i>(this document)</i> </p></div></li> <li value="2"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Digital Library User's Guide </p></div></li> <li value="3"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Digital Library Developer's Guide </p></div></li> <li value="4"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Digital Library: From Paper to Collection </p></div></li> <li value="5"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Digital Library: Using the Organizer </p></div></li> </ul><p><div name="Plain Text" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b>Acknowledgements</b> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 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: <font color="Black"><span style="text-transform:lowercase">MG, GDBM, PDFTOHTML, </span></font><font color="Black"><span style="text-transform:lowercase">PERL, </span></font><font color="Black"><span style="text-transform:lowercase">WGET, WVWARE </span></font>and<font color="Black"><span style="text-transform:lowercase"> XLHTML.</span></font><font color="Black"><span style="text-transform:lowercase"></span></font> </p></div> <p><div name="TOA" align="right" style="margin: 12.50mm 0.00mm 12.50mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <span style="text-transform:uppercase"></span><span style="text-transform:uppercase">Contents</span> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b>About this manual</b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 3" align="left" style="margin: 0.00mm 0.00mm 0.00mm 9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 1" align="left" style="margin: 6.25mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b><b><span style="text-transform:uppercase"></span></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b><span style="text-transform:uppercase"></span></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="TOC 2" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b><b></b> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Heading 1" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div>  <br> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>1<br>Versions of Greenstone</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Greenstone software runs on different platforms, and in different configurations, as summarized in Figure 1. </p></div> <p><div name="Normal" align="right" style="margin: 0.00mm 0.00mm 0.00mm -9.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: White; background-color: White; "> <img width="576" height="19" alt="0x01 graphic" src="_httpdocimg_/word050.wmf"><br> </p></div> <p><div name="Normal" align="left" style="margin: 2.08mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <img alt="0x08 graphic" src=""><br>Figure 1 The different options for Windows and Unix versions of Greenstone </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> There are many issues that affect (or might affect) the installation procedure. Before reading on, you should consider these questions: </p></div> <ul> <li value="6"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Are you using Windows or Unix? </p></div></li> <li value="7"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If Windows, are you using Windows 3.1/3.11 or a more recent version? Although you can view collections on 3.1/3.11 machines, and serve other computers on the same network, you cannot build new collections. The full Greenstone software runs on 95/98/Me, and NT/2000. </p></div></li> <li value="8"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If Unix, are you using Linux or another version of Unix? For Linux, a binary version of the complete system is provided which is easy to install. For other types of Unix you will have to install the source code and compile it. This may require you to install some additional software on your machine. </p></div></li> <li value="9"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If Windows NT/2000 or Unix, can you log in as the system “administrator” or “root”? This may be required to configure a webserver appropriately for Greenstone. </p></div></li> <li value="10"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Do you want the source code? If you are using Windows or Linux, you can just install binaries. But you may want the source code as well—it's in the Greenstone distribution. </p></div></li> <li value="11"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Do you want to build new digital library collections? If so, you need to have Perl, which is freely available for both Windows and Unix. </p></div></li> <li value="12"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Is your computer running a webserver? The Greenstone software comes with a Windows webserver. However, if you are already running a Web server, you may want to stay with it. For Unix, you need to run a webserver. </p></div></li> <li value="13"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Do you know how to reconfigure your webserver? If you don't use the Greenstone webserver, you will have to reconfigure your existing one slightly to recognize the Greenstone software. </p></div></li> </ul><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div>  <br> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2<br>The Installation Procedure</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Versions of Greenstone are available for both Windows and Unix, as binaries and in source code form. The Greenstone user interface uses a Web browser: Netscape Navigator or Internet Explorer (version 4.0 or greater in both cases) are both suitable. In case you don't already have a Web browser, Windows versions of Netscape are provided on the CD-ROM. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2.1Windows</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you are a Unix user, please skip ahead to Section 2.2. For Windows users, if you want just a simple, straightforward installation, go through the following “simple installation” procedure. The Greenstone system occupies about 40 Mb of disk space. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you choose anything other than the default setup, you will have to decide whether you want to install the binary code or the source code. If in doubt, choose the binary code. The installation procedure is the same for both. The following sections tell you more about the options you will be presented with. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When you've finished installation you should skip ahead to Section 2.3. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Simple installation</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To install the Windows version from the CD-ROM, insert the disk into the drive (e.g. into <i>D:</i>). If the installation procedure does not start automatically after about 20 seconds, click on the <i>Start</i> menu, select <i>Run</i> and type <i>D:/setup.exe</i>, where “<i>D</i>” is the letter that identifies your CD-ROM drive. For Windows 3.1, select <i>Run</i> from the “File manager” and type <i>D:/Windows/win3.1/setup.exe</i>. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> For the simplest installation, just accept the default at each point by clicking the <i>Next</i> button. That's all you need to do! Greenstone is installed in the directory <i>C:/Program Files/gsdl</i>. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Once installation is complete, to start your Greenstone system click on the <i>Start</i> button, open the <i>Program </i>menu, and select <i>Greenstone Digital Library</i>. This brings up a dialogue box: just click <i>Enter Library. </i>This automatically starts your Internet browser and loads the Greenstone Digital Library home page, which should look something like the example in Figure 2. You enter the Greenstone Demo collection by clicking on its icon. </p></div> <table width="100.00%25" border="1" cols="2" rows="2"> <tr><td bgcolor="White" width="26.01%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Figure 2<br>Your Greenstone home page </p></div></td> <td bgcolor="White" width="73.99%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <img width="669" height="555" alt="0x01 graphic" src="_httpdocimg_/word051.png"><br> </p></div></td> </tr> <tr><td bgcolor="White" width="26.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="73.99%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> </tr> </table> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Windows binaries</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> There are two separate Windows binary programs on the CD-ROM: the <i>Local Library</i> and the <i>Web Library</i>. The default installation described above selects the Local Library version. We strongly recommend that you use this version. The Web Library, which is much harder to set up, is only necessary if you already run a web server and want to use it for Greenstone. Despite its modest name, the Local Library offers a complete, self-contained, web-serving capability. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Local Library.</b> This enables any Windows computer to serve pre-built Greenstone collections. The Greenstone Demo collection will automatically be installed; you can also install the other collections on the CD-ROM (Section 3). The Local Library software is the same as that used on CD-ROMs produced by the Greenstone system. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Local Library is intended for use on standalone computers or computers that do not already have webserver software. It contains a small built-in webserver so that other computers on the same network can also access the library. (However, the webserver has limited configurability.) </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Local Library software automatically determines whether your computer has network software installed or is connected to a network. It operates correctly under any combinations of these conditions. However, there are two possible problems that may be encountered. Greenstone may </p></div> <ul> <li value="14"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> cause an unwanted telephone dialup operation; </p></div></li> <li value="15"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> fail to run because network software is installed, but installed incorrectly. </p></div></li> </ul><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> A restricted version of the Local Library is supplied which is intended for use in these situations. The restricted version only works with Netscape (not Internet Explorer). When you invoke the Local Library version of Greenstone, the dialogue box contains a button that allows you to use the restricted version instead. Unless the above problems arise, you should always use the standard version. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Web Library</b>. This enables any computer with an existing webserver to serve pre-built Greenstone collections. As with the Local Library above, the Greenstone Demo collection will automatically be installed. You can also install the other collections on the CD-ROM (see Section 3). </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Web Library differs from the Local Library because it is intended for computers that already have webserver software. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To run the Web Library, you also need </p></div> <ul> <li value="16"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Webserver software. One possibility is Apache (see Appendix). </p></div></li> <li value="17"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>The Collector</b>. This component, which is included in both the Local Library and the Web Library, allows you to build collections containing material of your choice. (You will not be able to use the Collector on a Windows 3.1/3.11 machine.) </p></div></li> </ul><p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Windows webserver configuration (Web Library version only)</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> An advantage of the Local Library version of Greenstone is that it runs “out of the box” and does not require any special configuration. For the Web Library version, however, you will have to make some adjustments to your webserver setup. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you already have a webserver, some small changes have to be made to its configuration to make your Greenstone installation operate. The install script explains what these are for the Apache webserver—see Section 4.2 for instructions for configuring the PWS and IIS webservers. You may need help from a system administrator to reconfigure an existing webserver—they should be able to understand the instructions printed by the install script. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you do not already have a webserver, you will have to install one. (See the Appendix for information on the Apache webserver.) Then you will have to configure it appropriately. Section 4 gives a detailed account of the parts of a webserver installation that affect Greenstone, and how they need to be altered. It comes down to including half a dozen or so lines in a configuration file. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Windows source</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Greenstone source code occupies 50 Mb of disk space, but to compile it you will need about 90 Mb. To compile the source on Windows you need </p></div> <ul> <li value="18"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Microsoft Visual C++ compiler. (We are currently sorting out some minor problems in compiling Greenstone with various Windows ports of GNU GCC.) </p></div></li> </ul><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> (You do not need GDBM, the Gnu database manager, because it is included in the Greenstone source distribution.) </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> It is unlikely that you will be able to compile Greenstone on a Windows 3.1/3.11 machine. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> In the event that you recompile Greenstone and wish to use the recompiled version to create CD-ROMs, you should note that code produced by recent versions of the Visual C++ compiler does not run under Windows 3.1/3.11, although there is no problem with later Windows systems (95, 98, Me, NT, 2000). If you want your CD-ROMs to operate on early Windows machines, you will need a different version of the compiler. Moreover, Greenstone uses STL, the C++ standard template library, and although these compilers sometimes come with STL, the provided version does not always work properly. Hence to recompile Greenstone in such a way that it produces CD-ROMs that work on early versions of Windows, you need </p></div> <ul> <li value="19"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Microsoft Visual C++ compiler, Version 4.0 or 4.2. </p></div></li> <li value="20"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> An external version of STL, the C++ standard template library. STL is packaged with Greenstone for use with these compiler versions. </p></div></li> </ul><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Note that the Windows installation procedure does not attempt to compile Greenstone for you if you choose to install the source code. For platform- and compiler-specific instructions on compiling Greenstone, see the <i>Install.txt </i>document which is placed in the top-level Greenstone directory (<i>C:/Program Files/gsdl</i> by default) during the installation procedure. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2.2Unix</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This section is written for Unix users. (Windows users should skip ahead to Section 2.3.) You need to choose whether to install the binary code or the source code. The binary code occupies about 50 Mb of disk space; the source code requires about 160 Mb to compile. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Unix binaries</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The binary code requires an Intel x86-based Linux distribution which includes ELF binary support. Distributions that meet these requirements include: </p></div> <ul> <li value="21"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> RedHat 5.1 </p></div></li> <li value="22"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> SuSE Linux 6.1 </p></div></li> <li value="23"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Debian 2.1 </p></div></li> <li value="24"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Slackware 4.0 </p></div></li> </ul><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> More recent versions of these distributions should also work. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You will need a webserver: we recommend Apache. We also strongly recommend you to install your webserver <i>before</i> installing Greenstone—this will make it much easier to answer the questions that are asked during the Greenstone installation procedure. If you want to build new digital library collections, you will also need Perl if this is not already on your system. To check, open a terminal window, type <i>perl -v</i>, and see if a message appears specifying, amongst other things, the version number. For most versions of Linux, Perl is installed by default. The Appendix gives information on how to obtain Apache and Perl. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Unix source</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The source code is the same for Unix as for Windows. It has been compiled and tested on Linux, Solaris, and Macintosh OS/X; it should be a fairly routine matter to port it to other flavors of Unix. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To compile the Greenstone source code on Unix, you need </p></div> <ul> <li value="25"><p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> GCC, the Gnu C++ compiler. </p></div></li> <li value="26"><p><div name="bulleted list" align="left" style="margin: 0.00mm 0.00mm 0.00mm 6.25mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -6.25mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> GDBM, the Gnu database manager. </p></div></li> </ul><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To run the Greenstone software, you also need a Web server and Perl, as described above under <i>Unix binaries</i>. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Unix installation</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To install the Unix version from the CD-ROM, insert the disk into the drive, and type </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 66.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -27.08mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> mount /cdrommount the CD-ROM device (this command may differ from one system to another; for example on OS/X you <i>cd</i> to the <i>/Volumes</i> directory and then to the appropriate subdirectory for the CD-ROM) </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 66.44mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -27.07mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> cd /cdromchange directory to the CD-ROM's top level </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 66.44mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -27.07mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> cd Unixchange directory to where the Unix install script resides </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 66.44mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -27.07mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> sh Install.shbegin the installation process (an explicit <i>sh</i> is used because many installations forbid you to execute programs directly from CD-ROM) </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The final command begins an interactive dialogue which requests the information that is needed to install Greenstone on your system, and gives detailed feedback on what is happening. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The installation procedure begins by asking you which directory to install Greenstone into. The first file placed there is the “uninstall” program that cleans up any partial installation, should you encounter problems or terminate the installation prematurely. Next you choose whether you want to install binaries or source code. You are then asked some questions about your webserver setup. You need to have a valid cgi executable directory (normally called “cgi-bin” on Unix systems); you can either create a new one or use your existing one. If you create a new one, you will need to enter this information in your webserver's configuration file. In either case you need to enter the web address of the cgi directory. The installation dialogue will guide you through all these choices. It is important to set the file permissions correctly on certain directories, and you are prompted for the necessary information. Finally, you are prompted for a password for the “administrator” user <i>admin</i>. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> By default, all Greenstone software is installed in the directory <i>/usr/local/gsdl</i> if it is the root user who is doing the installation, and into the directory ~<i>/gsdl</i> otherwise (where “~” is the user's home directory). </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Installing the binaries takes just a few minutes, enough time for you to answer the appropriate questions. If you install the source code, the installation script will compile it, which takes from ten minutes to an hour or so, depending on the speed of your processor. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To uninstall the software, type </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 66.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -27.08mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> cd ~/gsdlor <i>/usr/local/gsdl</i> if it was the root user who installed Greenstone </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 66.44mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -27.07mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> sh Uninstall.sh </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> During the installation procedure you will be asked whether you want to install any Greenstone collections. The Greenstone Demo collection is installed automatically; other collections on the CD-ROM are described in Section 3. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Unix webserver configuration</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you already have a webserver, some small changes will have to be made to its configuration to make your Greenstone installation operate. The install script explains what these are. You will probably need help from your system administrator to reconfigure the webserver—he or she should be able to understand the instructions output by the install script. For your convenience, the output of the install script is written to a file called INSTALL_RECORD in the directory into which you installed Greenstone. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you do not already have a webserver, you will have to install one. The Appendix gives information on Apache. Then you will have to configure it appropriately. Section 4 gives a detailed account of the parts of an Apache webserver installation that affect Greenstone, and how they need to be altered. It comes down to including half a dozen or so lines in a configuration file. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You do not need to be the Unix “root” user to go through the installation procedure above. When it comes to configuring an existing Apache server, however, you may need “root” privileges—it all depends on how Apache is set up. If you install Apache yourself, you can do it as a user without “root” privileges. If you need to work your way around an uncooperative system administrator, you can always install a second Apache webserver on your computer—even if one exists already. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2.3How to find Greenstone</b></font> </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Local library (Windows only)</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you are using the Local Library, simply run the <i>Greenstone</i> program from the <i>Start</i> menu. This automatically opens a dialog box that starts your Internet browser and loads the Greenstone Digital Library home page. The Greenstone Demo collection should be accessible from this page. The dialog box contais a<i> File</i> menu item that allows you to change the default browser used by Greenstone. It doesn't matter whether you use Netscape or Internet Explorer, except that if you are running on Windows 2000, we recommend that you use Internet Explorer. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Web library (Windows and Unix)</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you are using the Web Library, once you have installed the software and configured the webserver, use this URL to enter your Greenstone system: </p></div> <p><div name="bulleted list" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -2.47mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>http://localhost/gsdl/cgi-bin/library</i> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Greenstone Demo collection should be accessible from this page. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>The Collector</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> A link to the Collector is provided on the digital library home page. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Administration</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> A link to the Administration pages is provided on the digital library home page. The “administrator” user is called <i>admin</i>, with a password that you specified during the installation process. The administrator is authorized to add new users, and to build collections. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2.4The Greenstone Librarian Interface (GLI)</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Greenstone Librarian Interface (GLI) is a tool to assist you with building digital libraries using Greenstone. It gives you access to Greenstone's collection-building functionality from an easy-to-use “point and click” interface. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> GLI is installed automatically with all distributions of Greenstone. It is placed in the subdirectory <i>gli</i> of the top-level Greenstone directory (<i>C:/Program Files/gsdl/gli</i> by default). Note that it runs in conjunction with Greenstone and will not work properly unless it is placed in a subdirectory of your Greenstone installation. If you have downloaded one of the Greenstone distributions, this will be the case. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To use the GLI, your computer needs to have the Java Runtime Environment. If it doesn't, the installer will offer to install a version that is included on the CD-ROM. On Unix, you will also need to ensure that Perl is installed (for Windows, Perl is already included in the Greenstone software). Please report any problems you have running or using the Librarian Interface to <font color="Blue"><u>greenstone@cs.waikato.ac.nz</u></font>. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Running under Windows </b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To run GLI under Windows, browse to the <i>gli</i> folder in your Greenstone installation (e.g. using Windows Explorer), and double-click on the file called <i>gli.bat</i>. This file checks that Greenstone, the Java Runtime Environment, and Perl are all installed, and starts the Greenstone Librarian Interface. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Running under Unix </b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To run GLI under Unix, change to the <i>gli </i>directory in your Greenstone installation, then run the <i>gli.sh</i> script. This script checks that Greenstone, the Java Runtime Environment, and Perl are all installed and on your search path, and starts the Greenstone Librarian Interface. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Getting help</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Greenstone Librarian Interface has extensive on-line help facilities. You get help by clicking the <i>Help</i> button at the top right of the screen. This opens up the text to a section that relates to what you are doing—which of the GLI panels you are on. You can click around the help text to learn what you need to know. Use it. </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 34.50mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Compiling the Greenstone Librarian Interface</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you have downloaded the Greenstone source distribution, you will have the Java source code of the Librarian Interface. To compile it, your computer needs to have a <font color="Black">Java Development Kit</font>. The Appendix gives information on how to obtain this. To compile the source code, run the <i>makegli.bat</i> (Windows) or <i>makegli.sh</i> (Unix) files. Once compiled, you can run GLI as described above. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2.5Testing and troubleshooting</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To test Greenstone, point your Web browser at the Greenstone home page and explore the Demo collection and any other collections that you have installed. Don't worry—you can't break anything. Click liberally: most images that appear on the screen are clickable. If you hold the mouse stationary over an image, most browsers will soon pop up a message that tells you what will happen if you click. Experiment! Choose common words like “the” and “and” to search for—that should evoke some responses, and nothing will break. For more information, see the <i>Greenstone Digital Library User's Guide</i>.<i></i> </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Troubleshooting </b></font> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <table width="100.00%25" border="1" cols="3" rows="5"> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Problem</b> </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Try this</b> </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <span style="text-transform:lowercase">Local Library (Windows only)</span> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When I start Greenstone my computer asks me to dial up my Internet Service Provider. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Push the <i>Cancel</i> button in the dialog box. This usually solves the problem. </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When I start Greenstone my computer <i>still</i> asks me to dial up my Internet Service Provider. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Choose the “Restricted version” when you run Greenstone. This version only works with Netscape. </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When I point my browser at the digital library, it can't find that page. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Check your Internet Proxy settings and turn proxies off (use <i>Edit preferences</i> on Netscape or <i>Internet options</i> on Explorer). </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Collector seems to be working very slowly! </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Are you using Netscape under Windows 2000? If so, try using Internet Explorer instead—on Windows 2000 (only) there seems to be some incompatibility with Netscape. </p></div></td> </tr> </table> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <table width="100.00%25" border="1" cols="3" rows="8"> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b></b> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Problem</b> </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Try this</b> </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <span style="text-transform:lowercase">Web Library (Windows and Unix)</span> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When I start Apache, it quits immediately. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Add a <i>ServerName localhost</i> directive to the Apache configuration file (see Section 4.1). </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When I point my browser at the digital library, it displays garbage—a binary file. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Check the <i>ScriptAlias</i> directive in the Apache configuration file, making sure it comes before the <i>Alias</i> directive (see Sections 4.2 and 4.3). </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <span style="text-transform:lowercase"></span> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> I get the Greenstone home page (Figure 2), but the Demo collection icon does not appear. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Run the program <i>library</i> (in the cgi-bin directory) from the DOS (or shell) prompt to generate debugging information that will help you locate the problem. </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <span style="text-transform:lowercase">Both versions</span> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When I point my browser at the digital library, it can't find that page. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Try using 127.0.0.1 in place of <i>localhost</i>. This reserved IP number is defined to be a “loopback” to your local computer. </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <span style="text-transform:lowercase"></span> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> My browser complains that it can't find <i>main.cfg</i><i>.</i> </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Check that the Greenstone files exist and are world-readable. If you are using the Web library, try running the <i>library</i> program from the command line. If it runs OK, the problem is with file permissions (see Section 5.1). If not, the <i>gsdlhome</i> variable is probably set incorrectly in the <i>gsdlsite.cfg</i> configuration file (see Section 5.2). </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> I'm having trouble using the Collector. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Read the <i>Greenstone Digital Library User's Guide</i>, Section 3. </p></div></td> </tr> <tr><td bgcolor="White" width="25.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="28.57%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> I've added a new user but they can't seem to log in. </p></div></td> <td bgcolor="White" width="46.42%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Check that the directory <i>C:/Program Files/gsdl/etc</i> and all its contents are globally writeable (see Section 5.1). </p></div></td> </tr> </table> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>2.6To learn more</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To learn more about the innards of your Greenstone installation, consult the <i>Greenstone Digital Library Developer's Guide</i>. It includes (for example) details of the directory structure that has been created, and information about how to configure your Greenstone site. </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div>  <br> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>3<br>Greenstone Collections</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Several demonstration Greenstone collections are included on the CD-ROM. If you have Web access, many others can be downloaded, in either pre-built or unbuilt form, from the New Zealand Digital Library Project website (<i>nzdl.org</i>). </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Greenstone Demo collection is a small subset of the Humanity Development Library (HDL), a polished collection. It illustrates that relatively rich browsing capabilities can be provided (so long as suitable metadata is available). It is included automatically when the software is installed. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 2.08mm 34.50mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone also comes with some well-documented example collections whose “about” page describes how they are constructed. They demonstrate various capabilities of Greenstone. The install dialogue will ask you whether you want to include them in your Greenstone installation; the approximate amount of disk space needed for each collection is shown below. </p></div> <table width="100.00%25" border="1" cols="3" rows="12"> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>demo</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Demo<br>(7 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> A small subset of the HDL. If you clone this collection, the full facilities will only appear if your new files provide appropriate metadata information. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="Normal" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>dls-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Development Library Subset collection <br>(150 Mb) </p></div> <p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Like the Greenstone Demo, this is a subset of the HDL—but much larger. It contains 250 publications—books, reports and magazines—in various areas of human development (the full HDL contains 1,230 publications). It has the same structure as the Greenstone Demo. It's fairly complex, and if you're just starting out you might prefer to look at some other collections first (e.g. <i>MSWord and PDF demonstration</i>, the <i>Greenstone Archives</i>, or the <i>Simple image collection</i>). </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>wrdpdf-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> MSWord and PDF demonstration <br>(4 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This contains a few documents in PDF, MSWord, RTF, and Postscript formats, demonstrating the ability to build collections from documents in different formats. The collection configuration file is very simple. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="Normal" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>gsarch-e </i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone Archives collection <br>(5 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> A collection of email messages from the Greenstone mailing list archives, this uses the Email plugin, which parses files in email formats. The collection configuration file is very simple. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="Normal" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>cltbib-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Bibliography collection <br>(7 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> With about 4,000 bibliography entries, this collection incorporates a form-based search interface that allows fielded searching. It is fairly complex. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="Normal" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>cltext-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Bibliography supplement <br>(1 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This tiny collection of 10 bibliography entries illustrates the "supercollection" facility which searches several collections together, seamlessly. It operates together with the <i>Bibliography</i> collection, and its configuration file is almost the same. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>MARC-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> MARC example <br>(1 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Based on some MARC records from the Library of Congress, this is a simple collection (and does not allow form-based searching). </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="Normal" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>oai-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> OAI demo collection <br>(18 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Using the Open Archive Protocol and the <i>Import-From</i> feature, this retrieves metadata from an archive and builds a collection from the records. In this case they are images, so both the OAI and Image plugins are used. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>image-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Simple image collection <br>(1 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="figure" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This very basic image collection contains no text and no explicit metadata—which makes it rather unrealistic. The configuration file is about as simple as you can get. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>authen-e</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Formatting and authentication demo <br>(8 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> With the same material as the original Greenstone demo collection, this shows off two independent features: non-standard document formatting, and controlled access to the documents via user authentication. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>garish</i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Garish version of demo collection <br>(8 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This collection also contains the same material as the Greenstone demo. Its appearance has been altered to show how the pages generated can be set out differently. It relies on a non-standard macro file that is supplied with Greenstone. </p></div></td> </tr> <tr><td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <i>isis-e</i><i></i> </p></div></td> <td bgcolor="White" width="24.25%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> CDS/ISIS example (1 Mb) </p></div></td> <td bgcolor="White" width="51.50%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This collection is built from a CDS/ISIS database of about 150 bibliography entries. It uses the ISISPlug plugin, which reads the standard ISIS .mst and .fdt files and converts them to Greenstone metadata. </p></div></td> </tr> </table> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div>  <br> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>4<br>Setting up the Webserver</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> In this section we describe how to set up your webserver to work with Greenstone. Note that all this is unnecessary when using the Windows Local Library, because this software works “out of the box” and does not require a webserver. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> We discuss both the Apache webserver, which is freely available for both Windows and Unix (see the Appendix for details) and Microsoft's Personal Web Server (PWS) and Internet Information Services (IIS) webserver. PWS is the standard Microsoft server for Windows 95/98; IIS is the standard webserver for Windows 2000 and the forthcoming Windows XP; Windows NT can use either. The Apache description applies equally to the Windows Web Library and Unix versions (though we use Windows-style terminology and pathnames); the PWS/IIS section applies only to the Windows Web Library. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Once you have installed your webserver, the next step is to install Greenstone. We will assume that during the install procedure you have taken the default action for each stage by clicking on the <i>Next</i> button. The result is that the directory <i>C:/Program Files/gsdl</i> is created and the Web Library binary is stored there, along with some supporting files. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> All webservers use the special URL “localhost” to denote the computer that the webserver is running on. Thus when you install a webserver, you can get at your <span style="text-transform:lowercase">html</span> documents by typing the URL <i>http://localhost</i> into a browser. If your computer has a domain name set up, this is used instead of localhost to identify your computer from remote sites. Thus on the New Zealand Digital Library's computer, <i>http://nzdl.org</i> and <i>http://localhost</i> are equivalent. If you type <i>http://nzdl.org</i> on your computer you will get the New Zealand Digital Library webserver, whereas if you type <i>http://localhost</i> you will get your own computer's webserver. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>4.1The Apache web server</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Apache webserver is usually installed in <i>C:/Program Files/Apache Group/Apache</i> and is configured so that the cgi-bin directory is in the subdirectory <i>/cgi-bin</i> and the document root is the subdirectory <i>/htdocs</i>. It is reconfigured by editing the configuration file <i>C:/Program Files/Apache Group/Apache/conf/httpd.conf</i>. This is a text file: it's quite easy to read it to see how things are set up. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Depending on how your computer's networking software is set up, you may have to add this line to Apache's <i>httpd.conf</i> configuration file: </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> ServerName localhost </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If this line is not included, the system attempts to find your server's name. However, there are bugs in some versions of Windows that cause this to fail. In this case, Apache will exit immediately when you start it up. It does display an error message, but it is immediately erased and you probably can't read it. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Setting up the Greenstone cgi-bin directory</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Cgi-bin is a directory from which the webserver treats documents as executable programs. Apache's <i>ScriptAlias</i> directive is used to create a cgi-bin directory. Note that this directive can make any directory a cgi executable directory—it doesn't have to be called “cgi-bin”! Conversely, a directory called “cgi-bin” isn't special unless <i>ScriptAlias</i> has been applied to it. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When installed, Apache has a cgi-bin directory of <i>C:/Program Files/Apache Group/Apache/cgi-bin</i>. This means that if presented with the URL <i>http://localhost/cgi-bin/hello</i>, the webserver will attempt to execute a file called <i>hello</i> from within the above directory. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> There is one Greenstone program, which is called “library.exe”, that needs to be executed by the webserver; it in turn reads a file called the Greenstone site configuration file, or “gsdlsite.cfg”, which needs to be located in the same directory. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The best way of arranging this is to use Apache's <i>ScriptAlias</i> directive to create a new cgi-bin directory. Here's the excerpt from Apache's <i>httpd.conf</i> configuration file that adds <i>C:/Program Files/gsdl/cgi-bin</i> as an additional cgi-bin directory: </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> ScriptAlias /gsdl/cgi-bin/ "C:/Program Files/gsdl/cgi-bin/" </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <Directory C:/Program Files/gsdl/cgi-bin> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Options None </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> AllowOverride None </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </Directory> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> (It's a curious fact that Apache configuration files use forward slashes in place of standard Windows backslashes.) </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This means that any URLs of the form <i>http://localhost/gsdl/cgi-bin</i> ... will be sought in the directory <i>C:/Program Files/gsdl/cgi-bin</i>, and executed by the web server. For example, if presented with the URL <i>http://localhost/gsdl/cgi-bin/hello</i>, the web server will attempt to retrieve the file <i>C:/Program Files/gsdl/cgi-bin/hello</i> and execute it. However, the URL <i>http://localhost/cgi-bin/hello</i> looks in Apache's regular <i>cgi-bin</i> directory for the file <i>C:/Program Files/Apache Group/Apache/</i><i>cgi-bin</i><i>/hello</i> and executes it, just as it did before. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>The document root directory</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The document root directory is the root of your webserver's directory structure. When installed, Apache has a document root <i>of C:/Program Files/Apache Group/Apache/htdocs</i>. This means that if presented with the URL <i>http://localhost/hello.html</i>, the webserver will attempt to retrieve a file called <i>hello.html</i> from within the above directory. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Several files within Greenstone need to be read by the webserver. The simplest way to arrange this is to use the <i>Alias</i> directive, which is just like <i>ScriptAlias</i> except that it applies to ordinary web pages, not cgi scripts. Insert these lines into your Apache configuration file, after the <i>ScriptAlias</i> directive, to add <i>C:/Program Files/gsdl</i> as an additional place to look for documents. </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Alias /gsdl/ "C:/Program Files/gsdl/" </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <Directory C:/Program Files/gsdl> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Options Indexes MultiViews FollowSymLinks </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> AllowOverride None </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Order allow,deny </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Allow from all </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </Directory> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This means that any URLs that match the first argument of Alias (gsdl) are sought as files in the place corresponding to the second argument. In other words, URLs of the form <i>http://localhost/gsdl/</i> ... will be sought as files in the directory <i>C:/Program Files/gsdl</i>. For example, if presented with the URL <i>http://localhost/gsdl/hello.html</i>, the webserver will attempt to retrieve the file <i>C:/Program Files/gsdl/hello.html</i>. However, the URL <i>http://localhost/hello.html</i> looks in the regular <i>htdocs</i> directory for the file <i>C:/Program Files/Apache Group/Apache/htdocs/hello.html</i>, just as it did before. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Be sure to add the <i>Alias</i> directive after the <i>ScriptAlias</i> directive. Instructing Apache to alias <i>/gsdl </i>before<i> /gsdl/cgi-bin</i> would match the URL <i>/gsdl/cgi-bin/library</i> against the Alias directive rather than the ScriptAlias, and it would be interpreted as a request for a document rather than the result of executing a program. The outcome would be to “display” the binary program file as a page in the Web browser, instead of executing it. </p></div> <p><div name="SubsectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Security</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You should be aware that if the web library version of Greenstone is set up as instructed above, anyone will be allowed to download any file in the <i>gsdl</i> directory structure. This includes the index files and source documents of any collections you make, the user database, usage logs, etc. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If you are concerned about this, you can easily tighten up your webserver configuration to improve security. For the Apache webserver, put these lines into the configuration file instead of those given in the previous subsection: </p></div> <p><div name="code line" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Alias /gsdl/ "C:/Program Files/gsdl/" </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <Directory "C:/Program Files/gsdl"> </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Order allow,deny </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Deny from all </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <FilesMatch </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> "/.(gif|jpe?g|png|css|mov|mpeg|ps|pdf|doc|rtf|jar|class)$"> </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Order allow,deny </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Allow from all </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </FilesMatch> </p></div> <p><div name="code line" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </Directory> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This means that only files whose extensions match the regular expression in the <i>FilesMatch</i> line may be downloaded. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>4.2The PWS and IIS webservers</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Although neither PWS nor IIS is installed by default on current Windows systems, they can easily be installed using the “Add/Remove programs” control panel. If they are not already on your Windows distribution CD-ROM you will have to download them from the Microsoft web site (<i>www.microsoft.com</i>). </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The setup procedure for Greenstone is identical for both PWS and IIS. Invoke the Personal Web Manager and perform the following actions. </p></div> <ol type="1"> <li value="1"><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Select <i>Advanced</i> to get the <i>Advanced Options</i> screen. </p></div></li> <li value="2"><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Select <i>Home</i> and click <i>Add</i>. Fill out the fields as follows: </p></div></li> </ol><p><div name="paragraph" align="left" style="margin: 2.08mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>Directory</i> field:<i>C:/Program Files/gsdl</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>Alias</i> field:<i>gsdl</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Access permissions:<i>Read</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Application permissions:<i>None</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Click <i>OK</i> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This makes Greenstone files accessible to the webserver. </p></div> <ol type="1"> <li value="3"><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Back in <i>Advanced Options</i>, select <i>gsdl</i> and click <i>Add</i>. Fill out the fields as follows: </p></div></li> </ol><p><div name="paragraph" align="left" style="margin: 2.08mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>Directory</i> field:<i>C:/Program Files/gsdl</i><i>/cgi-bin</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>Alias</i> field:<i>cgi-bin</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Access permissions:<i>None</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Application permissions:<i>Execute</i> </p></div> <p><div name="paragraph" align="left" style="margin: 0.00mm 0.00mm 0.00mm 49.22mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Click <i>OK</i> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This allows the Greenstone program <i>library.exe</i> to be executed by the webserver. </p></div> <ol type="1"> <li value="4"><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Go to the URL <i>http://localhost/gsdl/cgi-bin/library.exe</i>. </p></div></li> </ol><p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Note: you need to specify the <i>.exe</i> file extension with PWS and IIS. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 41.84mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div>  <br> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>5<br>Configuring your Site</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> For Greenstone to work properly, access permissions for certain files must be set up appropriately. Also, there is a configuration file associated with each Greenstone site. The install procedure creates a generic configuration file based on your installation choices; however its contents can be tailored to cope with different situations. This section explains both of these issues. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>5.1File permissions</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> This section is irrelevant for Windows 95/98, because these systems don't identify the owners of files. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> On Windows NT, 2000 and Unix systems, cgi scripts don't run as normal users, because users can't be identified over the Web. Instead, they run as the user who started up the webserver program (on Windows systems), or as a special user (commonly called <i>nobody </i>on Unix systems). Because of this, all files and directories within <i>C:/Program Files/gsdl</i> need to be globally readable (or at least readable by the cgi-script user, perhaps “<i>nobody</i>”). To test whether file permissions are set up correctly, run the program <i>library.exe</i> from the command line. If the files are in the right places but the permissions are set incorrectly, it will run from the command line—that is, when <i>you</i> execute it—but not from a browser—that is, when the “<i>nobody</i>” user executes it. Another test is to log in as another user to see if the file permissions are specific to your original user account. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To work through a Web browser, all the Greenstone directories must be globally readable. Also, the <i>C:/Program Files/gsdl/etc</i> directory and all its contents must be globally <i>writable</i>. This is the directory into which the library program writes the usage log, error and initialization logs, and various user databases. If you're reluctant to make this directory globally writable, you can set permissions so that just the files <i>errout.txt</i>, <i>initout.txt</i>, <i>key.db</i>, <i>users.db</i>, <i>history.db</i> and <i>usage.txt</i> are writable by the cgi user. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If file permissions are not set up correctly for <i>C:/Program Files/gsdl/etc</i>, you may find that user authentication and search history do not work, and that no usage log (<i>usage.txt</i>) is generated. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>5.2The gsdlsite.cfg configuration file</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The install procedure creates a generic Greenstone site configuration file based on your installation choices. For our installation this file is <i>C:/Program Files/gsdl/cgi-bin/gsdlsite.cfg</i> and its content is: </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # Site configuration file for Greenstone. </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # Lines begining with </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # are comments. </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # This file should be placed in the same directory as your library </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # executable file. it should be edited to suit your site. </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # points to the GSDLHOME directory </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> gsdlhome “C:/Program Files/gsdl” </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # this is the http address of GSDLHOME </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # if your webservers DocumentRoot is set to $GSDLHOME </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # then httpprefix can be commented out </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> httpprefix /gsdl </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # this is the http address of the directory which </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # contains the images for the interface. </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> httpimg /gsdl/images </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # should contain the http address of this cgi script. This </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # is not needed if the http server sets the environment variable </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # SCRIPT_NAME </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> #gwcgi /cgi-bin/library </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # maxrequests is the most requests a fastcgi process </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # will serve before it exits. This can be set to a </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # low figure (like 1) while debugging and then set </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # to a high figure (like 10000) when everything is </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # working well. </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> #maxrequests 10000 </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You can customise your installation by editing this file, although you will probably not need to do so. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The <i>gsdlhome</i> line simply points to the <i>C:/Program Files/gsdl</i> directory. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>httpprefix</i> is the web address of the directory that Greenstone is installed in. We explained earlier how to create an alias so that URLs of the form <i>http://localhost/gsdl/</i> ... are sought in the <i>C:/Program Files/gsdl</i> directory. Putting a line <i>httpprefix /gsdl</i> into the <i>gsdlsite</i> configuration file establishes the same convention for the Greenstone software. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>httpimg</i> is the web address of the <i>C:/Program Files/gsdl/images</i> directory, which contains all the gif images used in the interface. In any standard Greenstone installation this will always be <i>httpprefix/images</i>, and the line in the file above is left untouched. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>gwcgi</i> is the web address of the library cgi program. This is not required by most webservers (including Apache), and should remain commented out. Don't uncomment it unless you're sure you need to, because that may introduce problems. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>maxrequests</i> is only used by versions of Greenstone that are compiled with the “fast-cgi” option on. The standard binary distribution does not include this option because not all webservers are configured to support it. Fastcgi speeds up cgi executions by keeping the main executable in memory between invocations of the software, rather than loading it in from disk each time a web page is requested from the Greenstone software. The trade-off is the amount of memory used, which can grow the longer the program remains in memory. Once <i>maxrequests</i> pages have been generated, the cgi program quits, thereby freeing any accumulated memory. To respond to the next request for a Web page, the cgi program is read in from disk again, and a new cycle of page requests is begun. Most installations use the standard cgi protocol, which means that <i>maxrequests</i> can be safely ignored. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div>  <br> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>6<br>Personalizing your Installation</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Probably the first thing you will want to do once your Greenstone installation is up and running is personalize the home page. The file that generates the Greenstone home page is called <i>home.dm</i>, and is located in the <i>macros</i> subdirectory of the directory into which you installed Greenstone. (The default for Windows systems is <i>C:/Program Files/gsdl</i>.) This is a plain text file that you will have to edit to create a new home page. Instead of editing it, we recommend creating a new file, say <i>yourhome.dm</i>. This will be like <i>home.dm</i> but will define “package home”—which is the bit that does the actual work—in a different way. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> When you make a different home page, there must be some way of linking in to the digital library pages so that you can search and browse the collections on your system. The solution that Greenstone adopts is to use “macros”. That's why the home-page file is called “.dm” and not “.html”—it's a “macro” file rather than a regular <span style="text-transform:lowercase">html</span> file. But don't quail: the macro file basically contains just <span style="text-transform:lowercase">html</span>, sprinkled with a few mystical incantantations which are explained below. The macro language is a powerful facility, and only a small part of it is described below—see the <i>Greenstone Digital Library Developer's Guide</i> for more information. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>6.1Example</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Figure 3 shows an example of a new digital library home page. Each of the “Click here” links takes you to the appropriate Greenstone facility. This page was generated by the file called <i>yourhome.dm</i> shown in Figure 4. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You can use Figure 4 as a template for creating your own specialized Greenstone home page. Basically, it defines a macro called <i>content</i>. Inside the curly braces is ordinary <span style="text-transform:lowercase">html</span>. You could insert additional text, along with any <span style="text-transform:lowercase">html</span> formatting commands, to put the content that you <br>want to see on the page. The text is regular <span style="text-transform:lowercase">html</span>; if you want you can include hyperlinks and use all the other facilities that <span style="text-transform:lowercase">html</span> provides. </p></div> <table width="100.00%25" border="1" cols="2" rows="4"> <tr><td bgcolor="White" width="26.01%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Figure 3<br>Your own Greenstone home page </p></div></td> <td bgcolor="White" width="73.99%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <img width="666" height="384" alt="0x01 graphic" src="_httpdocimg_/word052.png"><br> </p></div></td> </tr> <tr><td bgcolor="White" width="26.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="73.99%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> </tr> <tr><td bgcolor="White" width="26.01%25" rowspan="1" colspan="1"><p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Figure 4<br><i>yourhome.dm</i> used to create Figure 3 </p></div></td> <td bgcolor="White" width="73.99%25" rowspan="1" colspan="1"><p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> package home </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> _content_ { </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <h2>Your own Greenstone home page</h2> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <ul> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <table> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr valign=top><td>Search page for the demo collection<br></td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httpquery_&c=demo">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr><td>"About" page for the demo collection</td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httppageabout_&c=demo">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr><td>Preferences page for the demo collection</td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httppagepref_&c=demo">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr><td>Home page</td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httppagehome_">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr><td>Help page</td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httppagehelp_">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr><td>Administration page</td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httppagestatus_">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <tr><td>The Collector</td> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <td><a href="_httppagecollector_">Click here</a></td></tr> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </table> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </ul> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> } </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # if you hate the squirly green bar down the left-hand side of the </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # page, uncomment these lines: </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Preformatted" align="left" style=" border: thin none Black; padding: 0.00mm 1.39mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # _header_ { </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> # } </p></div></td> </tr> <tr><td bgcolor="White" width="26.01%25" rowspan="1" colspan="1"><p><div name="paragraph" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> <td bgcolor="White" width="73.99%25" rowspan="1" colspan="1"><p><div name="Preformatted" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div></td> </tr> </table> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To make your new home page link in with other digital library pages, you need to use an appropriate magic spell. In this macro language, magic spells are words flanked by underscores. You can see these in Figure 4. For example, <i>_httppagehome_</i> takes you to the home page, <i>_httppagehelp_</i> to the help page, and so on. In some cases you need to include a collection name. For example, <i>_httpquery_</i><i>&c=demo</i> specifies the search page for the demo collection; for other collections you should replace <i>demo</i> by the appropriate collection name. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The definition of the macro called <i>_content_ </i>is plain <span style="text-transform:lowercase">html</span>. Any standard <span style="text-transform:lowercase">html</span> code may be placed within a macro definition. However, the special characters `{`, `}', `/', and `_' must be escaped with a backslash to prevent them from being processed by the macro language interpreter. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Note that the <i>_content_ </i>macro definition does not contain any <span style="text-transform:lowercase">html</span> header or footer. If you want to change the header or footer of your home page, you should define <i>_header_</i> and/or <i>_footer_</i> macros, adding them to the <i>yourhome.dm</i> file in the form </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> _macroname_ { </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> ... </p></div> <p><div name="Preformatted" align="left" style="margin: 0.00mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> } </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> For example, the squirly green bar down the left-hand side of Greenstone pages is defined in the <i>_header_ </i>macro, and making this macro null will remove it, as indicated at the end of Figure 4. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>6.2How to make it work</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You have to tell Greenstone about the new home page <i>yourhome.dm</i>. The system reads in the macro files that are specified in the main configuration file <i>main.cfg</i>, so if you create a new one you must include it there. Name clashes are handled sensibly: the most recent definition takes precedence. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Thus to make the Greenstone digital library software use the home page in Figure 3 instead of the default, first put the <i>yourhome.dm</i> file in Figure 4 into the <i>macros</i> directory. Then edit the <i>main.cfg </i>configuration file to replace <i>home.dm</i> with <i>yourhome.dm</i> in the list of macro files that are loaded at startup. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>6.3Redirecting a URL to Greenstone</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> You may want to redirect a more convenient URL to your Greenstone cgi program. For example, on our system the URL <i>http://nzdl.org</i> (which is shorthand for <i>http://nzdl.org/index.html)</i> is redirected to <i>http://nzdl.org/cgi-bin/library</i>. The Apache webserver accomplishes this with the <i>Redirect</i> directive. Along with other directives, this goes into the <i>C:/Program Files/Apache Group/Apache/conf/httpd.conf</i> configuration file. To redirect the URL <i>http://www.yourserver.com</i> to <i>http://www.yourserver.com/cgi-bin/library</i>, put this line into <i>httpd.conf</i>: </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Redirect /index.html http://www.yourserver.com/cgi-bin/library </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Then you will reach your digital library system directly from the URL <i>http://www.yourserver.com</i>. Instead, if you wanted a URL like <i>http://www.yourserver.com/greenstone</i> to be redirected to <i>http://www.yourserver.com/cgi-bin/library</i>, include in the <i>httpd.conf</i> file </p></div> <p><div name="Preformatted" align="left" style="margin: 2.08mm 0.00mm 0.00mm 39.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Redirect /greenstone http://www.yourserver.com/cgi-bin/library </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> If your computer doesn't have a domain name (like the “www.yourserver.com” above), just replace <i>www.yourserver.com</i> by <i>localhost</i> in the lines above. So long as the browser is running on the same machine as the webserver—which it surely is if your computer doesn't have a domain name—this has the same effect as the above redirections. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Instead of putting redirect directives into the file <i>httpd.conf</i>, you can equally well put them into a file called <i>.htaccess</i> within your server's document root directory. In fact, doing so has two advantages. First, changes to <i>.htaccess</i> take effect immediately, whereas you have to restart the Apache webserver to see the effect of changes to <i>httpd.conf</i>. Second, on Unix systems you usually have to be logged in as the “root” user to edit <i>httpd.conf</i>, whereas you don't to edit <i>.htaccess</i>. </p></div> <p><div name="ChapterTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b></b></font> </p></div>  <br> <p><div name="AppendixTitle" align="right" style="margin: 12.50mm 0.00mm 12.50mm 43.75mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>Appendix<br>Associated Software</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Here is how to obtain the software packages mentioned above. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>A.1Apache Webserver</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To run any version of Greenstone apart from the Windows Local Library version, you need an external webserver. Many installations, particularly larger ones, will already have a webserver. If you are using Linux, Apache may be on your installation disk but may not have been selected during the installation procedure. The Apache Webserver from <i>www.apache.org</i> is free, and easy to install. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>A.2Perl</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> Greenstone uses the Perl language when building collections. For Windows, Perl is already included in the Greenstone software. Most Unix systems already have Perl installed, but if not, source code and binaries for a wide range of Unix platforms are freely available at <i>www.perl.com</i>. Perl version 5.0 or higher is needed. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>A.3GCC</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> The Unix version of Greenstone compiles under the Gnu C++ compiler, GCC. Greenstone makes extensive use of the C++ standard template library (we've found it to be broken on some older versions of GCC; please tell us if you have STL problems). Note that this version of Greenstone does not compile under GCC 3.0. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>A.4GDBM</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> All versions of Greenstone use the Gnu Database Manager, GDBM. It is supplied with all Windows versions of Greenstone and installed automatically during the installation procedure. Linux systems already have GDBM, so we do not provide it for Linux. Most other Unix systems have it, but if necessary you can download it from <i></i><i></i><i></i><i><a href="_httpextlink_&rl=0&href=http:%2f%2fwww.gnu.org"></i><font color="Blue"><i><u>www.gnu.org</u></i></font><i></a></i>. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>A.5Java runtime environment</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> To use the Greenstone Librarian Interface, you need a suitable version of the Java Runtime Environment. If you don't already have this, a suitable version is included on the CD-ROM, or you can download the latest version from <font color="Blue"><u></u></font><font color="Blue"><u></u></font><font color="Blue"><u></u></font><font color="Blue"><u><a href="_httpextlink_&rl=0&href=http:%2f%2fjava.sun.com%2fj2se%2fdownloads.html"></u></font><font color="Blue"><u>http://java.sun.com/j2se/downloads.html</u></font><font color="Blue"><u></a></u></font>. Version 1.4.0 or higher is needed. </p></div> <p><div name="SectionHeading" align="left" style="margin: 4.17mm 0.00mm 0.00mm 7.38mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -7.38mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black"><b>A.6Java compiler</b></font> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <font color="Black">To compile the source code of the Greenstone Librarian Interface, you must first install a Java Development Kit. You can download the J2SE Software Development Kit from </font><font color="DarkGreen"><u></u></font><font color="DarkGreen"><u></u></font><font color="DarkGreen"><u></u></font><font color="DarkGreen"><u><a href="_httpextlink_&rl=0&href=http:%2f%2fjava.sun.com%2fj2se%2fdownloads.html"></u></font><font color="Blue"><u>http://java.sun.com/j2se/downloads.html</u></font><font color="DarkGreen"><u></a></u></font>. Version 1.4.0 or higher is needed. </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> ii APPENDIX B—GLOSSARY OF TERMS </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> APPENDIX B—GLOSSARY OF TERMS iii </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Footer" align="left" style="margin: 0.00mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <b>Greenstone gsdl-2.50</b><b>March</b><b> 2004</b> </p></div> <p><div name="Footer" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> iv CONTENTS </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> v </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word053.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Footer" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 2 VERSIONS OF GREENSTONE </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> 2 </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word054.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 12 INSTALLATION PROCEDURE </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> INSTALLATION PROCEDURE 13 </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word055.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 16 GREENSTONE COLLECTIONS </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> GREENSTONE COLLECTIONS 15 </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word056.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 22 SETTING UP THE WEBSERVER </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> SETTING UP THE WEBSERVER 21 </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style="margin: 0.00mm -4.91mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word057.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 26 CONFIGURING YOUR SITE </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> CONFIGURING YOUR SITE 25 </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 30 PERSONALIZING YOUR INSTALLATION </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> PERSONALIZING YOUR INSTALLATION 29 </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word058.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> 32 ASSOCIATED SOFTWARE </p></div> <p><div name="Header" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> PERSONALIZING YOUR INSTALLATION 33 </p></div> <p><div name="Header" align="right" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: right; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Header" align="left" style="margin: 0.00mm -4.91mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> <i>greenstone.org</i><img width="1491" height="77" alt="0x01 graphic" src="_httpdocimg_/word059.jpg"><br> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Caption" align="left" style="margin: 2.08mm 0.00mm 0.00mm 14.06mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -14.06mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Caption" align="left" style="margin: 2.08mm 0.00mm 0.00mm 14.06mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: -14.06mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Only “Administrators” can install software </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> NT/2000 </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> 3.x </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Full version available </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Full version available </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Serves collections but no building </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Binaries available for all versions </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Windows </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Windows or Unix? </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Other </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Sun Solaris or Macintosh OS/X </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Linux </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style="margin: 1.39mm 0.00mm 0.00mm 0.00mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Untested </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Source code tested </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Source code tested, binaries available </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Full version available </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Full version available </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Full version available </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> May need “root” login to install </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> Unix </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="center" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: center; line-height: 4.166667mm; color: Black; background-color: White; "> 95/98/Me </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="Normal" align="left" style=" padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div> <p><div name="paragraph" align="left" style="margin: 4.17mm 0.00mm 0.00mm 34.46mm; padding: 0.00mm 0.00mm 0.00mm 0.00mm; "> <p style="text-indent: 0.00mm; text-align: left; line-height: 4.166667mm; color: Black; background-color: White; "> </p></div>