Note: more up-to-date notes may be available on our website, at http://www.greenstone.org/english/docs/compiling.html -- Compiling and installing on Unix -- cd to the top level gsdl directory (i.e. the directory where this file lives) and perform the following three steps. 1. ./configure 2. make 3. make install This will install the library executable to gsdl/cgi-bin. If you want to run Greenstone from a system cgi-bin directory you'll need to move the library executable and gsdlsite.cfg from gsdl/cgi-bin to your system cgi-bin. Note that the Greenstone directory structure is important to the operation of the software. Therefore the --prefix, --bindir etc. options to configure make no sense and will have no effect. If you want Greenstone to be installed somewhere specific (say /usr/local) you'll need to move the entire gsdl directory there. -- Compiling on Windows -- Greenstone has been successfully compiled using Microsoft Visual C++ versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with another compiler (or another version of VC++) we'd appreciate hearing about it at greenstone@cs.waikato.ac.nz. The major difference between compiling with VC++ 4.2 compared with VC++ 6.0/2005 is that 4.2 must use the STLport standard template library (packaged with Greenstone) while VC++ 6.0/2005 may use its own built in STL implementation. Perform the following steps to compile and install Greenstone. Note that some parts of the process described are specific to one or other of the two compilation options mentioned above. These steps are marked as such. 1. Unzip the following zip archives (into the directories in which the zip files themselves are contained). * gsdl\packages\windows\gdbm\gdbm.zip * gsdl\packages\windows\crypt\crypt.zip * gsdl\packages\windows\stlport\stlport.zip (VC++ 4.2 only) 2. To use VC++ command line tools you may need to execute the MSDEV\BIN\VCVARS32.BAT batch file to set up your environment. 3. cd to the top level gsdl directory (i.e. the directory where this file lives). 4. compile the web library (library.exe) with "nmake /f win32.mak GSDL_VC4=1" (VC++ 4.2) or "nmake /f win32.mak" (VC++ 6.0/2005) 5. compile the local library (server.exe) with "nmake /f win32.mak GSDL_VC4=1 LOCAL_LIBRARY=1" (VC++ 4.2) or "nmake /f win32.mak LOCAL_LIBRARY=1" (VC++ 6.0/2005) This will install library.exe to the gsdl\cgi-bin directory and server.exe to the top level gsdl directory.