greenstone.org greenstone wiki greenstone trac planet greenstone

Installing Greenstone 2 from SVN source on Windows

From GreenstoneWiki

You will need:

  • Visual Studio, to use its compiling capabilities which work with the Windows makefiles of Greenstone


Contents

Where to get the source code

You can get the source code from SVN (as described below) or alternatively, you can either get the source distribution or during the installation of the binary distribution, choose to include the source code (for these see Installing Greenstone 2 from source for Beginners#Where to get the source to install from.

  1. If you plan on getting it from SVN, you will need an SVN command-line client. There's an SVN command-line client release for Windows, from http://subversion.tigris.org/getting.html#binary-packages
    For example, I got svn-1.4.6-setup.exe from http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91
  2. Open an MSDOS prompt. As given in the Greenstone SVN page, to get the gsdl source code, you will need to type the following at the prompt:
    svn co http://svn.greenstone.org/gsdl/trunk gsdl
    which will checkout code from Greenstone's gsdl/trunk into a new folder it will create on your computer called "gsdl".</pre>
  3. For Greenstone 2.80 and before:
    Once it has finished checking out gsdl code, change directory to into the newly created gsdl folder and type:
    svn co http://svn.greenstone.org/indexers/trunk indexers
    Since you are in the gsdl folder, this will checkout the indexers code into a folder called "indexers".

Getting winbin

This is required to get the conversion tools used for importing different types of files, such as wvware.

  1. In an DOS prompt, go into the bin directory inside your Greenstone 2 installation folder. For example:
    cd C:\greenstone2\bin
    
  2. Now check out winbin using the following command, which will create a new folder called windows:
    svn co http://svn.greenstone.org/other-projects/trunk/winbin/bin windows

Compiling Greenstone 2 source code on Windows

Follow the instructions at Compiling Greenstone, the Windows section.

Getting the Greenstone Librarian Interface (GLI)

  1. In your top-level gsdl folder, check out GLI from svn. The following will do so and put the checked out GLI files into a new folder called gli:
    svn co http://svn.greenstone.org/gli/trunk gli
  2. Move into the newly created folder gli and compile it up:
    * cd gli
    * makegli.bat
  3. Setup the environment for Greenstone 2 by going into the top level directory again and running setup.bat (make sure you first edit setup.bat as explained on the Compiling Greenstone page, Windows section):
    * cd ..
    * setup.bat
  4. As things are now, launching GLI will always bring up a little popup asking whether you want to enter the Library and if you click to confirm, it will open a browser window before the GLI application itself appears. To avoid having to go through this procedure each time, you can edit the glisite.cfg file.
    Still in the top-level Greenstone 2 folder, make a copy of the file glisite.cfg and name it gsdlsite.cfg. Then open up the original (glisite.cfg) and change the following two lines to become:
    * autoenter=1
    * start_browser=0
    
  5. GLI can be launched by moving back into the gli folder and running gli.bat:
    * cd gli
    * gli.bat