Changeset 36234 for main/trunk/greenstone2/Install.txt
- Timestamp:
- 2022-05-31T13:26:19+12:00 (22 months ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
main/trunk/greenstone2/Install.txt
r30378 r36234 1 Compiling and Installing Greenstone 2 2 -------------------------------------- 1 3 2 4 Note: more up-to-date notes may be available on our website, at 3 http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone 5 http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation 6 4 7 5 8 The following instructions assume the top level Greenstone folder is called 6 Greenstone (which is the standard name used for Greenstone 2 releases).7 If you have got Greenstone from SVN, the top level directory will be greenstone2.9 Greenstone2. Please adjust these instructions to match the folder name in 10 your situation. 8 11 9 12 The Greenstone Librarian Interface (GLI) code will be in the gli folder inside 10 the Greenstone folder. If you are using SVN and you want to use the GLI to 11 build collections, you'll need to check it out by running 13 the Greenstone2 folder (if you have a Greenstone release). If you are using 14 SVN and you want to use the GLI to build collections, you'll need to check 15 it out by running 12 16 svn checkout http://svn.greenstone.org/main/trunk/gli 13 in the Greenstone folder.17 in the Greenstone2 folder. 14 18 15 19 -- Compiling and installing on Unix -- 16 20 17 cd to the top level Greenstone directory (i.e. the directory18 where this file lives) and perform the following three steps.21 cd to the top level Greenstone2 directory (i.e. the directory 22 where this file lives) and run the following: 19 23 20 1. ./configure --enable-apache-httpd 21 2. make 22 3. make install 24 1. makegs2.sh gnome-lib imagemagick 25 2. cd gli 26 3. ./makegli.sh 27 4. ./makejar.sh 23 28 24 This will install the library.cgi and oaiserver.cgi executables to 25 Greenstone/cgi-bin/linux. 26 If you want to run Greenstone from a system 27 cgi-bin directory you'll need to move the library executable and 28 gsdlsite.cfg from Greenstone/cgi-bin/linux to your system cgi-bin. 29 Notes: 30 1. [gnome-lib] parameter: This will checkout and compile gnome-lib. 31 gnome-lib is needed on most linux machines to compile wvware. If you 32 don't need it. you can omit this parameter. If you need it but don't want 33 to compile it, you can download a gnome-lib-minimal package for your OS by 34 visiting http://trac.greenstone.org/browser/gs2-extensions/gnome-lib/trunk 35 (choose the appropriate package for your OS) 36 Then unzip the downloaded gnome-lib minimal package into your Greenstone2/ext 37 folder. 38 2. [imagemagick] parameter - if you already have imagemagick installed, or 39 don't want it, you can omit this parameter. 40 41 3. CGI executables - This will install the library.cgi and oaiserver.cgi 42 executables to Greenstone2/cgi-bin/linux. 43 If you want to run Greenstone from a system cgi-bin directory you'll need to 44 move the library executable and gsdlsite.cfg from Greenstone2/cgi-bin/linux 45 to your system cgi-bin. 46 4. The steps 2-4 are for compiling the Greenstone Librarian interface. 29 47 30 48 Note that the Greenstone directory structure is important to the operation 31 of the software. Therefore the --prefix, --bindir etc. options to configure 49 of the software. Therefore the --prefix, --bindir etc. options to configure (which is run by makegs2.sh) 32 50 make no sense and will have no effect. If you want Greenstone to be 33 51 installed somewhere specific (say /usr/local) you'll need to move the 34 entire Greenstone directory there.52 entire Greenstone2 directory there. 35 53 36 54 Greenstone will install Apache into apache-httpd/linux. You can disable this 37 by running ./configure without the -enable-apache-httpd option. In that case 38 you'll need to set up your own apache to serve Greenstone. See See 39 http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough 55 by editing makegs2.sh and removing the -enable-apache-httpd option to the 56 configure command. In that case you'll need to set up your own apache to 57 serve Greenstone. See 58 http://wiki.greenstone.org/doku.php?id=en:user_advanced:gs2_server 40 59 for more details. 41 60 42 To compile the GLI, cd to the gli directory and run makegli.sh 61 43 62 44 63 -- Compiling on Windows -- 45 64 46 Greenstone has been successfully compiled using Microsoft Visual C++ 47 versions 4.2, 6.0 and 2005. If anyone succeeds in compiling Greenstone with 48 another compiler (or another version of VC++) we'd appreciate hearing about 49 it at [email protected] 50 51 If you have got Greenstone from svn, you'll also need to download some Windows binaries. 52 1. cd to top-level greenstone2 folder. 53 2. cd bin 54 3. svn co http://svn.greenstone.org/main/trunk/binaries/windows/bin windows 55 65 Prerequisites: 66 * Java JDK 8 or later 67 * PERL (ActivePerl for Windows 68 * Visual Studio 8 or later 56 69 57 70 There is a batch script you can run to set up and compile Greenstone. … … 71 84 72 85 73 For more information about compiling Greenstone, or for manual comp ling86 For more information about compiling Greenstone, or for manual compiling 74 87 instructions, see 75 http://wiki.greenstone.org/wiki/index.php/Compiling_Greenstone 88 http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation 89 http://wiki.greenstone.org/doku.php?id=en:developer:windows_source_install 76 90 77 91 These scripts will unpack necessary zip files, set up paths etc, then compile … … 80 94 directory and server.exe to the top level Greenstone directory. 81 95 82 To run the web library you'll need to set up a web server to serve Greenstone.83 Then you'll need to edit Greenstone\cgi-bin\gsdlsite.cfg. See84 http://wiki.greenstone.org/wiki/index.php/Setting_up_an_Apache_Web_Server_for_Greenstone_2_Walkthrough85 for more details about using Apache, or86 http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone#How_do_I_use_Greenstone.27s_web_library_with_IIS.3F87 for more details about using IIS.88 89 96 To compile the GLI, cd to the gli directory and run makegli.bat. 90 97
Note:
See TracChangeset
for help on using the changeset viewer.