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