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>
|
---|