Greenstone tutorial exercise

Back to wiki
Back to index
Devised for Greenstone version: 2.60
Modified for Greenstone version: 2.87

Installing Greenstone

Installing Greenstone on a Windows system

There are various ways of getting Greenstone:

From a UNESCO CD-ROM (version 2.70) (or FAO IMARK CD-ROM, but this is an earlier version 2.51)
These CD-ROMs contain the Greenstone software, plus documented example collections, four language interfaces (English French Spanish Russian), the Export to CD-ROM package, the ImageMagick graphics package, the Java runtime environment, and an installer that installs all of these.

From the IITE Digital Libraries in Education CD-ROM, or a Greenstone workshop CD-ROM

In addition to all the above software, these CD-ROMs contain the tutorial exercises and a set of sample files to be used for these exercises.CD-ROMs with Greenstone version 2.62 or earlier also include the Greenstone Language Pack, which gives reader's interfaces in many languages (currently about 40). This has its own installer which you have to invoke separately, after you have installed Greenstone.CD-ROMs with version 2.70 or later now come with reader's interfaces in all available languages. Textual images have been removed from the interface; they are now done using CSS (Cascading Style Sheets). The Greenstone Language Pack is no longer needed. Instead, these CD-ROMs come with the Classic Interface Pack, which contains the old text images for use with a backwards compatibility macro file.

All these CD-ROMs contain the full Greenstone software, which allows you to view collections and build new ones. They are not the same as CD-ROMs that contain a pre-packaged Greenstone collection, which only allow you to view that collection.

From http://www.greenstone.org/download
Most people download the Windows distribution from http://www.greenstone.org/download, which contains the latest version of Greenstone.
To avoid a single massive download the documented example collections can be downloaded separately. To reduce the download size these collections are distributed in unbuilt form and need to be built.
There is also the set of sample files used in these exercises.

Most Greenstone CD-ROMs start the installation process as soon as they are inserted into the drive, assuming that the AutoPlay feature is enabled on your computer. If installation does not begin by itself, locate the file setup.exe on the CD and double click it to start the installation process. (On the IMARK CD-ROM this file resides in the folder software_tools → Greenstone). If you download Greenstone over the web, what you get is the installer—just double-click it.

If Greenstone has been installed on your computer before, you should completely remove the old version before installing a new one. (However, you need not remove any pre-packaged collections that you may have installed.) To do this, see Updating a Greenstone installation.

Here is what you need to do to install Greenstone. Older versions of the installer follow much the same sequence but use slightly different wording.

Select the language for this installation. We choose English
Welcome to the Greenstone Digital Library Software Installer. It is recommended that you uninstall any previous installations of Greenstone2 before running this installer. Click <Next>
License Agreement. Click <Accept>
Choose location to install Greenstone. Leave at the default and click <Next>
Components. Click the question mark button on the right of each component will display the description of this component in a popup window. Leave at the default (all components are selected) and click <Next>
Enable administration pages. Read the description on this page, if you check to enable, click <Next> to set admin password. Choose a suitable password and click <Next> (If your computer will not be serving collections online, the password doesn't matter)
Click <Install> to start the installation. Click <Show Details> to show the details of this installation
Files are copied across
Installation is complete.

To invoke the Greenstone Reader's Interface, go to the Greenstone-2.87 item under All Programs on the Windows Start menu and select Greenstone Server, once the server window is displayed click <Enter Library>.

To invoke the Greenstone Librarian Interface, go to the same item and select Librarian Interface (GLI).

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