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