1 |
|
---|
2 | Greenstone installation instructions
|
---|
3 |
|
---|
4 | Greenstone software:
|
---|
5 |
|
---|
6 | * Unix
|
---|
7 | + Source distribution
|
---|
8 | + Building collections
|
---|
9 | * Windows
|
---|
10 | + Source distribution
|
---|
11 | + Binary distributions
|
---|
12 | + Building collections
|
---|
13 |
|
---|
14 | Greenstone Collections
|
---|
15 |
|
---|
16 | Other software:
|
---|
17 | * Perl for Windows
|
---|
18 | * Apache web server
|
---|
19 |
|
---|
20 | For more information about how to use the software, consult The
|
---|
21 | Greenstone Digital Library Software manual.
|
---|
22 |
|
---|
23 | Unix source distribution
|
---|
24 |
|
---|
25 | * Download the latest version of the source distribution
|
---|
26 | * Extract the gzipped tar archive (tar xvzf gsdl-xx.x.tgz); this
|
---|
27 | will create a directory gsdl into which all software is installed
|
---|
28 | * In the gsdl directory, type ./configure
|
---|
29 | * When the configure script has finished running, type make
|
---|
30 | * Type make install, which copies the compiled library file into the
|
---|
31 | gsdl/cgi-bin directory, and also installs several executables that
|
---|
32 | are used to build collections into gsdl/bin/$GSDLOS
|
---|
33 | * Move both library and the gsdlsite.cfg configuration file to your
|
---|
34 | system's cgi-bin directory, so that the library runs as a cgi
|
---|
35 | script
|
---|
36 | * Edit the gsdlsite.cfg configuration file to suit your site. Set
|
---|
37 | the gsdlhome field to point to your gsdl directory. Other fields
|
---|
38 | that may need changing are httpprefix (the web path to the gsdl
|
---|
39 | directory) and httpimg (the path to gsdl/images)
|
---|
40 | * Build the Demo Collection that comes with the distribution
|
---|
41 | * Access the Greenstone Digital Library home page at
|
---|
42 | http://localhost/cgi-bin/library (replace "localhost" by the
|
---|
43 | server's URL if your Internet browser is not running on the server
|
---|
44 | computer)
|
---|
45 | * If the Demo Collection does not appear on the home page, run
|
---|
46 | library from the Unix command line to generate debugging
|
---|
47 | information to help you locate the problem
|
---|
48 | * Access the administration page at
|
---|
49 | http://localhost/cgi-bin/library?a=status
|
---|
50 |
|
---|
51 | Windows source distribution
|
---|
52 |
|
---|
53 | * Download the latest version of the source distribution--the same
|
---|
54 | source code as for Unix (though for Windows you may want to select
|
---|
55 | a zipped version)
|
---|
56 | * Extract the distribution using WinZip or a similar utility
|
---|
57 | * The default is to extract Greenstone directly into C:\ (i.e. a
|
---|
58 | directory C:\gsdl will be created into which all software is
|
---|
59 | installed)
|
---|
60 | * In the resulting gsdl directory type nmake win32.mak
|
---|
61 | * Type nmake /f win32.mak install, which copies the Web Library
|
---|
62 | version of library.exe into the gsdl\cgi-bin directory and the
|
---|
63 | Local Library version into the gsdl directory; it also installs
|
---|
64 | several executables that are used to build collections into
|
---|
65 | gsdl\bin\windows
|
---|
66 |
|
---|
67 | Windows binary distributions
|
---|
68 |
|
---|
69 | Three separate binary distributions are available for Windows: the
|
---|
70 | Local Library, the Web Library, and the Collection Builder. First
|
---|
71 | decide which distribution you want; then:
|
---|
72 |
|
---|
73 | * Download the latest version of the desired binary distribution
|
---|
74 | * Extract the distribution using WinZip or a similar utility
|
---|
75 | * The default is to extract Greenstone directly into C:\ (i.e. a
|
---|
76 | directory C:\gsdl will be created into which all software is
|
---|
77 | installed).
|
---|
78 | * If installing the Collection Builder as well as one of the
|
---|
79 | Libraries, be sure to extract both distributions in the same
|
---|
80 | directory. It is safe to allow files occurring in the second
|
---|
81 | distribution installed to overwrite those in the first.
|
---|
82 | * Follow the instructions below for the version you have downloaded:
|
---|
83 | Local Library
|
---|
84 | + Run the library.exe executable. This will automatically start
|
---|
85 | your Internet browser and load the Greenstone Digital Library
|
---|
86 | home page. The Demo collection should be accessible from this
|
---|
87 | page.
|
---|
88 | + Access the administration page at
|
---|
89 | http://localhost/cgi-bin/library?a=status
|
---|
90 | Web Library
|
---|
91 | + If Greenstone is not installed to C:\gsdl, edit the
|
---|
92 | gsdlsite.cfg configuration file (in the cgi-bin directory) by
|
---|
93 | setting the gsdlhome field to point to your gsdl directory
|
---|
94 | + If you do not already have a webserver, install Apache as
|
---|
95 | described below
|
---|
96 | + If using an existing webserver, check the gsdlsite.cfg
|
---|
97 | configuration file to ensure that httpprefix contains the web
|
---|
98 | path to the gsdl directory and httpimg contains the path to
|
---|
99 | gsdl\images
|
---|
100 | + The Greenstone Digital Library home page will appear as
|
---|
101 | http://localhost/cgi-bin/library (replace "localhost" by the
|
---|
102 | server's URL if your Internet browser is not running on the
|
---|
103 | server computer)
|
---|
104 | + If the Demo Collection does not appear on the home page, run
|
---|
105 | library.exe from the DOS prompt to generate debugging
|
---|
106 | information to help you locate the problem
|
---|
107 | + Access the administration page at
|
---|
108 | http://localhost/cgi-bin/library?a=status
|
---|
109 | Collection Builder
|
---|
110 | + If you do not already have Perl, you will need to install it
|
---|
111 | (see below)
|
---|
112 | + Download a test collection (e.g. the Demo Collection) and
|
---|
113 | build it
|
---|
114 | + Reload the Greenstone home page at
|
---|
115 | http://localhost/cgi-bin/library
|
---|
116 | + If the Demo Collection does not appear on the home page, run
|
---|
117 | library.exe from the DOS prompt to generate debugging
|
---|
118 | information to help you locate the problem
|
---|
119 |
|
---|
120 | Greenstone Collections
|
---|
121 |
|
---|
122 | * Install Greenstone as described above
|
---|
123 | * Download the required collection. Collection distributions with
|
---|
124 | filenames like ***_prebuilt.zip are pre-built collections. All
|
---|
125 | others will require building.
|
---|
126 | * Extract the .zip or .tgz file to your gsdl/collect directory
|
---|
127 | * Build the collection if it was not pre-built
|
---|
128 |
|
---|
129 | Once a new collection has been built, Greenstone will automatically
|
---|
130 | notice it and include it on the home page (when you click Reload).
|
---|
131 |
|
---|
132 | Building Greenstone Collections on Unix
|
---|
133 | * Source setup.bash or setup.csh from within the gsdl directory to
|
---|
134 | set up environment variables and path (e.g. source setup.bash)
|
---|
135 | * Note that pwd is used to set $GSDLHOME. If you need to be able to
|
---|
136 | source setup.bash or setup.csh from a directory other than gsdl
|
---|
137 | (e.g. from your .profile or .bashrc) you will need to edit the
|
---|
138 | script.
|
---|
139 | * Run build colname, where colname is the directory name of your
|
---|
140 | collection (e.g. demo).
|
---|
141 |
|
---|
142 | Building Greenstone Collections on Windows
|
---|
143 | * Make sure the setup.bat batch file is correct (i.e. that it sets
|
---|
144 | the GSDLHOME environment variable to the correct path of your gsdl
|
---|
145 | directory)
|
---|
146 | * run setup.bat
|
---|
147 | * Run build colname, where colname is the directory name of your
|
---|
148 | collection (e.g. demo).
|
---|
149 |
|
---|
150 | To find out more about building collections, consult The Greenstone
|
---|
151 | Digital Library Software manual.
|
---|
152 |
|
---|
153 | Perl for Windows
|
---|
154 |
|
---|
155 | * Download Perl (pre-5.6 version)
|
---|
156 | * Doubleclick the self-extracting executable and follow instructions
|
---|
157 |
|
---|
158 | The Apache Webserver
|
---|
159 |
|
---|
160 | * Download the latest version of the Apache distribution
|
---|
161 | * Doubleclick the self-extracting executable and follow instructions
|
---|
162 | * Configure Apache for use with Greenstone by adding the following
|
---|
163 | to your Apache server's httpd.conf configuration file (which
|
---|
164 | resides in the Apache conf directory)
|
---|
165 | * Existing server configurations may need to be configured
|
---|
166 | differently--see your system administrator if necessary
|
---|
167 | _____________________________________________________________
|
---|
168 |
|
---|
169 | # Some NT installations complain about an inability to work
|
---|
170 | ServerName
|
---|
171 | # out for themselves -- on most systems you can leave it commented
|
---|
172 | out.
|
---|
173 | # "localhost" should be replaced by www.yourserver.com if you plan
|
---|
174 | # to serve Greenstone to anyone other than the local machine.
|
---|
175 | # ServerName localhost
|
---|
176 | # Make cgi-bin point to your Greenstone cgi-bin directory.
|
---|
177 | # Note the forward
|
---|
178 | # slashes (/) instead of standard Windows
|
---|
179 | # backslashes (\) -- a hangover from Apache's Unix roots.
|
---|
180 | ScriptAlias /cgi-bin/ "c:/gsdl/cgi-bin/"
|
---|
181 | <Directory "c:/gsdl/cgi-bin">
|
---|
182 | AllowOverride None
|
---|
183 | Options None
|
---|
184 | </Directory>
|
---|
185 | # DocumentRoot points to your Greenstone root directory.
|
---|
186 | # Make sure that httpd.conf doesn't contain any other DocumentRoot
|
---|
187 | # directives -- if they come after this they'll override it
|
---|
188 | DocumentRoot "c:/gsdl"
|
---|
189 | <Directory "c:/gsdl">
|
---|
190 | Allow from All
|
---|
191 | </Directory>
|
---|
192 | # Redirect http://localhost to http://localhost/cgi-bin/library
|
---|
193 | # "localhost" should be replaced by www.yourserver.com if you plan
|
---|
194 | # to serve Greenstone to anyone other than the local machine.
|
---|
195 | Redirect /index.html http://localhost/cgi-bin/library
|
---|
196 | _____________________________________________________________
|
---|