1 | Note: more up-to-date notes may be available on our website, at
|
---|
2 | http://www.cs.waikato.ac.nz/~nzdl/gsdl-docs/compiling.html
|
---|
3 |
|
---|
4 | -- Compiling and installing on Unix --
|
---|
5 |
|
---|
6 | cd to the top level gsdl directory (i.e. the directory where this file
|
---|
7 | lives) and perform the following three steps.
|
---|
8 |
|
---|
9 | 1. ./configure
|
---|
10 | 2. make
|
---|
11 | 3. make install
|
---|
12 |
|
---|
13 | This will install the library executable to gsdl/cgi-bin. If you want to
|
---|
14 | run Greenstone from a system cgi-bin directory you'll need to move the
|
---|
15 | library executable and gsdlsite.cfg from gsdl/cgi-bin to your system
|
---|
16 | cgi-bin.
|
---|
17 |
|
---|
18 | Note that the Greenstone directory structure is important to the operation
|
---|
19 | of the software. Therefore the --prefix, --bindir etc. options to configure
|
---|
20 | make no sense and will have no effect. If you want Greenstone to be
|
---|
21 | installed somewhere specific (say /usr/local) you'll need to move the
|
---|
22 | entire gsdl directory there.
|
---|
23 |
|
---|
24 | Greenstone does not currently compile under gcc-3.0
|
---|
25 |
|
---|
26 |
|
---|
27 | -- Compiling on Windows --
|
---|
28 |
|
---|
29 | Greenstone has been successfully compiled using Microsoft Visual C++
|
---|
30 | versions 4.2 and 6.0. If anyone succeeds in compiling Greenstone with
|
---|
31 | another compiler (or another version of VC++) we'd appreciate hearing about
|
---|
32 | it at [email protected].
|
---|
33 |
|
---|
34 | The major difference between compiling with VC++ 4.2 compared with VC++ 6.0
|
---|
35 | is that 4.2 must use the STLport standard template library (packaged with
|
---|
36 | Greenstone) while VC++ 6.0 may use its own built in STL implementation.
|
---|
37 |
|
---|
38 | Perform the following steps to compile and install Greenstone. Note that
|
---|
39 | some parts of the process described are specific to one or other of the two
|
---|
40 | compilation options mentioned above (STLport or non-STLport). These steps
|
---|
41 | are marked as such.
|
---|
42 |
|
---|
43 | 1. Unzip the following zip archives (into the directories in which the
|
---|
44 | zip files themselves are contained).
|
---|
45 |
|
---|
46 | * gsdl\packages\windows\gdbm\gdbm.zip
|
---|
47 | * gsdl\packages\windows\crypt\crypt.zip
|
---|
48 | * gsdl\packages\windows\stlport\stlport.zip (STLport version only)
|
---|
49 |
|
---|
50 | 2. To use VC++ command line tools you may need to execute the
|
---|
51 | MSDEV\BIN\VCVARS32.BAT batch file to set up your environment.
|
---|
52 |
|
---|
53 | 3. cd to the top level gsdl directory (i.e. the directory where this file
|
---|
54 | lives).
|
---|
55 |
|
---|
56 | 4. compile the web library (library.exe) with
|
---|
57 | "nmake /f win32.mak USE_STLPORT=1" (STLport version)
|
---|
58 | or
|
---|
59 | "nmake /f win32.mak" (non-STLport version).
|
---|
60 |
|
---|
61 | 5. compile the local library (server.exe) with
|
---|
62 | "nmake /f win32.mak USE_STLPORT=1 LOCAL_LIBRARY=1" (STLport version)
|
---|
63 | or
|
---|
64 | "nmake /f win32.mak LOCAL_LIBRARY=1" (non-STLport version)
|
---|
65 |
|
---|
66 | This will install library.exe to the gsdl\cgi-bin directory and server.exe
|
---|
67 | to the top level gsdl directory.
|
---|