| 1 | <html>
|
|---|
| 2 | <head>
|
|---|
| 3 | <meta http-equiv="content-type" content="text/html;charset=utf-8">
|
|---|
| 4 | <title>Greenstone 2.50 for Mac OS X</title>
|
|---|
| 5 | </head>
|
|---|
| 6 |
|
|---|
| 7 | <body>
|
|---|
| 8 | <H1>Greenstone 2.50a for Mac OS X</H1>
|
|---|
| 9 |
|
|---|
| 10 | <p>
|
|---|
| 11 | This package contains a binary version of Greenstone 2.50a, compiled on
|
|---|
| 12 | Mac OS X version 10.2.6 and tested on 10.3.2.
|
|---|
| 13 | It should work on Jaguar (OS X version 10.3) and earlier.
|
|---|
| 14 | </p>
|
|---|
| 15 |
|
|---|
| 16 | <p>There may be a newer version of this help file online at
|
|---|
| 17 | <a href="http://www.greenstone.org/docs/Install-Notes-osx.html"
|
|---|
| 18 | >http://www.greenstone.org/docs/Install-Notes-osx.html</a>.
|
|---|
| 19 | </p>
|
|---|
| 20 |
|
|---|
| 21 | <p>This packages includes the Greenstone Librarian Interface, a new module
|
|---|
| 22 | designed to make it easier to create collections.
|
|---|
| 23 | </p>
|
|---|
| 24 |
|
|---|
| 25 |
|
|---|
| 26 | <p>The Greenstone Mac OSX Binary package 2.50a is identical to Version
|
|---|
| 27 | 2.50 except it includes a fix for the installation of "GLI". If you
|
|---|
| 28 | have already downloaded version 2.50, instead of downloading 2.50a you
|
|---|
| 29 | can correct this mistake by editting the file
|
|---|
| 30 | <tt>/Applications/Greenstone/gli/classes/xml/config.xml</tt>
|
|---|
| 31 | and changing the line that says
|
|---|
| 32 | <pre>
|
|---|
| 33 | <Argument name="general.exec_address">http://127.0.0.1/cgi-bin/library</Address>
|
|---|
| 34 | </pre>
|
|---|
| 35 | to
|
|---|
| 36 | <pre>
|
|---|
| 37 | <Argument name="general.exec_address">http://127.0.0.1/cgi-bin/library</Argument>
|
|---|
| 38 | </pre>
|
|---|
| 39 | </p>
|
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 | <H2>Installation</H2>
|
|---|
| 43 | The recommended way to install Greenstone 2.50 for Mac OS X is by using the
|
|---|
| 44 | "Greenstone Installer".
|
|---|
| 45 |
|
|---|
| 46 | <h3>Using the "Greenstone Installer"</h3>
|
|---|
| 47 | This requires an administrator account so that
|
|---|
| 48 | required files can be copied into the correct locations (such as for the Apache
|
|---|
| 49 | Webserver). By default this will install into the /Applications/Greenstone
|
|---|
| 50 | folder.
|
|---|
| 51 |
|
|---|
| 52 | <h3>Manual Install</h3>
|
|---|
| 53 | You may copy the <tt>Greenstone</tt> directory to anywhere
|
|---|
| 54 | you like on the hard drive, but you will need to manually make some changes:
|
|---|
| 55 | <ol>
|
|---|
| 56 | <li>edit <tt>Greenstone/cgi-bin/gsdlsite.cfg</tt> and set the correct
|
|---|
| 57 | Greenstone directory for the <tt>gsdlhome</tt> configuration item.</li>
|
|---|
| 58 | <li>edit <tt>Greenstone/gli/gli.sh</tt> and provide the correct Greenstone
|
|---|
| 59 | directory for the <tt>gsdlpath</tt> flag.</li>
|
|---|
| 60 | <li>Copy or symbolic link some files into the Apache Webserver's directories:
|
|---|
| 61 | <ul>
|
|---|
| 62 | <li><tt>Greenstone/cgi-bin/gsdlsite.cfg</tt> into
|
|---|
| 63 | <tt>/Library/WebServer/CGI-Executables</tt></li>
|
|---|
| 64 | <li><tt>Greenstone/cgi-bin/library</tt> into
|
|---|
| 65 | <tt>/Library/WebServer/CGI-Executables</tt></li>
|
|---|
| 66 | <li>Create a <tt>/Library/WebServer/Documents/gsdl</tt> directory</li>
|
|---|
| 67 | <li><tt>Greenstone/images</tt> into
|
|---|
| 68 | <tt>/Library/WebServer/Documents/gsdl/images</tt></li>
|
|---|
| 69 | <li><tt>Greenstone/collect</tt> into
|
|---|
| 70 | <tt>/Library/WebServer/Documents/gsdl/collect</tt></li>
|
|---|
| 71 | </ul>
|
|---|
| 72 | </li>
|
|---|
| 73 | <li>The Webserver needs to be able to write to some files in the
|
|---|
| 74 | <tt>Greenstone/etc</tt> directory: <tt>error.txt, history.db, key.db,
|
|---|
| 75 | usage.txt</tt> and <tt> users.db</tt>.
|
|---|
| 76 |
|
|---|
| 77 | <li>Because the default password for the Greenstone web administration
|
|---|
| 78 | interface can't be changed during a manual install, the web administration is
|
|---|
| 79 | turned off by default. Edit the <tt>Greenstone/etc/main.cfg</tt> file and
|
|---|
| 80 | change the "status" and "collector" options from disabled to enabled. After
|
|---|
| 81 | this, the first thing you should do is use the web interface to change the
|
|---|
| 82 | administrator password. (The default password is "admin").
|
|---|
| 83 | </li>
|
|---|
| 84 | </ol>
|
|---|
| 85 |
|
|---|
| 86 | <p>
|
|---|
| 87 | Once Greenstone has been installed and successfully set up to run under
|
|---|
| 88 | Apache Webserver, you should be able to visit
|
|---|
| 89 | <a href="http://127.0.0.1/cgi-bin/library">http://127.0.0.1/cgi-bin/library</a>
|
|---|
| 90 | to see your Greenstone installation via the web.</p>
|
|---|
| 91 |
|
|---|
| 92 |
|
|---|
| 93 |
|
|---|
| 94 |
|
|---|
| 95 | <h2>"Apache" Web Server Setup</h2>
|
|---|
| 96 |
|
|---|
| 97 | <p>Mac OSX comes with a built-in webserver, named "apache".
|
|---|
| 98 | To configure apache to run Greenstone via the web, you have to place
|
|---|
| 99 | some Greenstone files in certain places. With Mac OS X, only users in the
|
|---|
| 100 | "admin" group can modify apache settings.
|
|---|
| 101 | </p>
|
|---|
| 102 |
|
|---|
| 103 | <p>
|
|---|
| 104 | Make sure apache is running. You can start apache by clicking on the
|
|---|
| 105 | Apple in the top-left corner of the screen, going to "System
|
|---|
| 106 | Preferences...", and clicking on "Sharing" in the Internet & Network
|
|---|
| 107 | group. If it says Web Sharing On then apache is already running. If it
|
|---|
| 108 | is off and you can't turn it on, then someone who knows the
|
|---|
| 109 | administrator password must click on the lock at the bottom of the
|
|---|
| 110 | window.
|
|---|
| 111 | </p>
|
|---|
| 112 |
|
|---|
| 113 | <p>If you want other people to be able to access your Greenstone
|
|---|
| 114 | installation via a network, make sure that "Personal Web Sharing" is set
|
|---|
| 115 | to "allowed" in the Firewall properties tab.</p>
|
|---|
| 116 |
|
|---|
| 117 |
|
|---|
| 118 | <h2>Interface Language Support</h2>
|
|---|
| 119 | <p>
|
|---|
| 120 | This version of greenstone only includes English, French, Russian and Spanish
|
|---|
| 121 | language support in the base install. To get support for all the other languages
|
|---|
| 122 | that Greenstone can use, please install the Greenstone Language Pack from
|
|---|
| 123 | <a href="http://sourceforge.net/projects/greenstone">Greenstone's Sourceforge pages</a>.
|
|---|
| 124 | (Choose the unix.sh version of the Language Pack.)
|
|---|
| 125 | </p>
|
|---|
| 126 |
|
|---|
| 127 |
|
|---|
| 128 | <h2>Greenstone Librarian Interface</h2>
|
|---|
| 129 | <p>
|
|---|
| 130 | This binary distribution of Greenstone includes the Greenstone
|
|---|
| 131 | Librarian Interface (GLI). This interface is a new way of creating and
|
|---|
| 132 | modifying digital libraries, and is more user-friendly than the command-line
|
|---|
| 133 | and web-based methods.
|
|---|
| 134 | </p> <p>
|
|---|
| 135 | When you first start the Greenstone Librarian Interface, it will ask for the
|
|---|
| 136 | URL to the local running Webserver. If you installed Greenstone into the
|
|---|
| 137 | default locations, then You should enter the above url:
|
|---|
| 138 | <blockquote>http://127.0.0.1/cgi-bin/library</blockquote>
|
|---|
| 139 | If you choose not to enter this during the first start up, you can change this
|
|---|
| 140 | setting at anytime by going to the <tt>File</tt> menu, selecting
|
|---|
| 141 | <tt>Preferences</tt>, and change the "Library Path" setting in the
|
|---|
| 142 | <tt>Connection</tt> tab.
|
|---|
| 143 | </p> <p>
|
|---|
| 144 | If you chose to use the Greenstone Installer, then you will find the Greenstone
|
|---|
| 145 | Librarian Interface installed by default in
|
|---|
| 146 | <tt>/Applications/Greenstone/GLI</tt>.
|
|---|
| 147 | </p>
|
|---|
| 148 |
|
|---|
| 149 | <h2>Other</h2>
|
|---|
| 150 | <p>
|
|---|
| 151 | This distribution of Greenstone for Mac OS X includes a working
|
|---|
| 152 | version of the KEA Keyphrase extractor. Unfortunately it is not yet
|
|---|
| 153 | incorporated into the Librarian Interface, but it can be used by
|
|---|
| 154 | adding "-extract_keyphrases" as a custom argument to plugins. In the
|
|---|
| 155 | Librarian Interface, this is done in the "Design" tab, under
|
|---|
| 156 | "Plug-ins", and then "Configure Selected Plugin". Otherwise if you are
|
|---|
| 157 | not using the Librarian Interface, this can be added manually after
|
|---|
| 158 | the plugin's name in the collection's <tt>collect.cfg</tt> file.
|
|---|
| 159 | </p>
|
|---|
| 160 |
|
|---|
| 161 | <p>
|
|---|
| 162 | This distribution includes Greenstone's "Demo" collection. It is pre-built,
|
|---|
| 163 | but the source documents are also provided so that you can re-build it
|
|---|
| 164 | using the command line instructions, the "Collector" web
|
|---|
| 165 | interface, or you can clone the collection using the Greenstone Librarian
|
|---|
| 166 | Interface.
|
|---|
| 167 | </p>
|
|---|
| 168 |
|
|---|
| 169 | <p>
|
|---|
| 170 | Mac OS X version 10.3 uses a more recent version of the perl scripting
|
|---|
| 171 | language (perl 5.8) than 10.2 and earlier (perl 5.6). While we believe that
|
|---|
| 172 | this distribution will work with perl 5.8, please let us know if you
|
|---|
| 173 | encounter any problems that appear to be related to perl.
|
|---|
| 174 | </p>
|
|---|
| 175 |
|
|---|
| 176 | <p>
|
|---|
| 177 | If you want to use the Image Plugin, you will need to do two things:
|
|---|
| 178 | <ol>
|
|---|
| 179 | <li>Download and install the ImageMagick package if it is not already
|
|---|
| 180 | installed. Greenstone's ImagePlug needs the "<tt>convert</tt>" and
|
|---|
| 181 | "<tt>identify</tt>" programs in this package.</li>
|
|---|
| 182 | <li>Make sure your Greenstone can find these programs. If they are installed
|
|---|
| 183 | anywhere other than "/usr/bin", then you will probably need to set your
|
|---|
| 184 | PATH correctly, both in the command line, and for the Greenstone Librarian
|
|---|
| 185 | Interface. Add the following line somewhere after the first line of
|
|---|
| 186 | /Applications/Greenstone/gli/gli.sh:<br>
|
|---|
| 187 | <tt>PATH="$PATH:/usr/local/bin"</tt><br>
|
|---|
| 188 | (assuming you installed it into the /usr/local/bin directory.)
|
|---|
| 189 | </li>
|
|---|
| 190 | </ol>
|
|---|
| 191 | </p>
|
|---|
| 192 |
|
|---|
| 193 |
|
|---|
| 194 | <p>
|
|---|
| 195 | For support, feedback, and more documentation, visit Greenstone's
|
|---|
| 196 | <a href="http://www.greenstone.org/">home page</a>.
|
|---|
| 197 | </p>
|
|---|
| 198 | <p>
|
|---|
| 199 | <address>Last modified 27 Apr 2004 by John McPherson</address>
|
|---|
| 200 | </body>
|
|---|
| 201 | </html>
|
|---|
