This package contains a binary version of Greenstone 2.50a, compiled on Mac OS X version 10.2.6 and tested on 10.3.2. It should work on Jaguar (OS X version 10.3) and earlier.
There may be a newer version of this help file online at http://www.greenstone.org/docs/Install-Notes-osx.html.
This packages includes the Greenstone Librarian Interface, a new module designed to make it easier to create collections.
The Greenstone Mac OSX Binary package 2.50a is identical to Version 2.50 except it includes a fix for the installation of "GLI". If you have already downloaded version 2.50, instead of downloading 2.50a you can correct this mistake by editting the file /Applications/Greenstone/gli/classes/xml/config.xml and changing the line that says
<Argument name="general.exec_address">http://127.0.0.1/cgi-bin/library</Address>to
<Argument name="general.exec_address">http://127.0.0.1/cgi-bin/library</Argument>
Once Greenstone has been installed and successfully set up to run under Apache Webserver, you should be able to visit http://127.0.0.1/cgi-bin/library to see your Greenstone installation via the web.
Mac OSX comes with a built-in webserver, named "apache". To configure apache to run Greenstone via the web, you have to place some Greenstone files in certain places. With Mac OS X, only users in the "admin" group can modify apache settings.
Make sure apache is running. You can start apache by clicking on the Apple in the top-left corner of the screen, going to "System Preferences...", and clicking on "Sharing" in the Internet & Network group. If it says Web Sharing On then apache is already running. If it is off and you can't turn it on, then someone who knows the administrator password must click on the lock at the bottom of the window.
If you want other people to be able to access your Greenstone installation via a network, make sure that "Personal Web Sharing" is set to "allowed" in the Firewall properties tab.
This version of greenstone only includes English, French, Russian and Spanish language support in the base install. To get support for all the other languages that Greenstone can use, please install the Greenstone Language Pack from Greenstone's Sourceforge pages. (Choose the unix.sh version of the Language Pack.)
This binary distribution of Greenstone includes the Greenstone Librarian Interface (GLI). This interface is a new way of creating and modifying digital libraries, and is more user-friendly than the command-line and web-based methods.
When you first start the Greenstone Librarian Interface, it will ask for the URL to the local running Webserver. If you installed Greenstone into the default locations, then You should enter the above url:
http://127.0.0.1/cgi-bin/libraryIf you choose not to enter this during the first start up, you can change this setting at anytime by going to the File menu, selecting Preferences, and change the "Library Path" setting in the Connection tab.
If you chose to use the Greenstone Installer, then you will find the Greenstone Librarian Interface installed by default in /Applications/Greenstone/GLI.
This distribution of Greenstone for Mac OS X includes a working version of the KEA Keyphrase extractor. Unfortunately it is not yet incorporated into the Librarian Interface, but it can be used by adding "-extract_keyphrases" as a custom argument to plugins. In the Librarian Interface, this is done in the "Design" tab, under "Plug-ins", and then "Configure Selected Plugin". Otherwise if you are not using the Librarian Interface, this can be added manually after the plugin's name in the collection's collect.cfg file.
This distribution includes Greenstone's "Demo" collection. It is pre-built, but the source documents are also provided so that you can re-build it using the command line instructions, the "Collector" web interface, or you can clone the collection using the Greenstone Librarian Interface.
Mac OS X version 10.3 uses a more recent version of the perl scripting language (perl 5.8) than 10.2 and earlier (perl 5.6). While we believe that this distribution will work with perl 5.8, please let us know if you encounter any problems that appear to be related to perl.
If you want to use the Image Plugin, you will need to do two things:
For support, feedback, and more documentation, visit Greenstone's home page.
Last modified 27 Apr 2004 by John McPherson