Changeset 22483

Show
Ignore:
Timestamp:
22.07.2010 17:08:16 (9 years ago)
Author:
ak19
Message:

1. Added instructions on how to set up the relocatable Apache HTTPD web server. 2. Improved formatting.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • main/trunk/greenstone2/runtime-src/packages/apache-httpd/README.txt

    r22482 r22483  
    1 This Readme explains the customisations made to binary files and zipped files in this folder. 
     1*****************************************  
     2README: 
     3runtime-src/packages/apache-httpd 
     4*****************************************  
    25 
    3 * The first is the Apache Httpd 2, whose unmodified source code was originally being compiled up on Linux alone. The first greenstone-modified version was added to include windows makefiles to compile these. 
     6This Readme explains the customisations made to binary files and 
     7zipped files in this folder. 
    48 
    59 
    6 (A) FILE: httpd-2.2.11-gs.tar.gz 
    7 Apache Httpd 2 src code with modifications for Greenstone 
     10* The first is the Apache Httpd 2, whose unmodified source code was 
     11  originally being compiled up on Linux alone. The first 
     12  greenstone-modified version was added to include windows makefiles 
     13  to compile these. 
    814 
    9 This Readme file was originally created on July 22. The dates in the commit messages below, upto and including point 6, are relative to this. 
     15 
     16******************************************************************************************** 
     17(A) FILE: httpd-2.2.11-gs.tar.gz: Apache Httpd 2 src code with 
     18modifications for Greenstone. 
     19******************************************************************************************** 
     20 
     21This Readme file was originally created on 22 July 2010. The dates in 
     22the commit messages below, upto and including point 6, are relative to 
     23this.  Some more notes to do with Apache Httpd and how Greenstone 
     24compiles and installs (including upon Installation of Greenstone) are 
     25at the bottom. 
     26 
     27 
     28The httpd tar.gz file works with the files httpd.conf.in for linux and 
     29windows-httpd.conf.in for windows. 
     30http://trac.greenstone.org/browser/gsdl/trunk/runtime-src/packages/apache-httpd/windows-httpd.conf.in?rev=20171 
     31Revision 20171, 17.6 KB (checked in by ak19, 12 months ago) explains: 
     32"Windows httpd.conf.in file is not the same as the one for linux and 
     33darwin (Mac), since one gets the Modules Already Loaded message on 
     34Linux if the existing httpd.conf.in was interchanged with the Windows 
     35one." 
    1036 
    1137 
    12381. http://trac.greenstone.org/browser/gsdl/trunk/runtime-src/packages/apache-httpd/httpd-2.2.11-gs.tar.gz?rev=20169 
    1339 
    14 Revision 20169, 7.9 MB  (checked in by ak19, 12 months ago) 
     40Revision 20169, 7.9 MB (checked in by ak19, 12 months ago) 
    1541 
    16 Adding the customised apache web server source folder: a linux source release plus apache's official windows makefiles. Now it compiles up on both OS. 
     42Adding the customised apache web server source folder: a linux source 
     43release plus apache's official windows makefiles. Now it compiles up 
     44on both OS. 
    1745 
    1846    * Property svn:mime-type set to application/octet-stream 
     
    21492. http://trac.greenstone.org/browser/gsdl/trunk/runtime-src/packages/apache-httpd/httpd-2.2.11-gs.tar.gz?rev=20349 
    2250 
    23 Revision 20349, 7.9 MB  (checked in by ak19, 11 months ago) 
     51Revision 20349, 7.9 MB (checked in by ak19, 11 months ago) 
    2452 
    25 Dr Bainbridge fixed the configure.in (and generated the configure file from it) so that it generates the libexpat.so.0 file it needs. This way the apache web server won't look elsewhere for the so file and perhaps find an incompatible version of it. 
     53Dr Bainbridge fixed the configure.in (and generated the configure file 
     54from it) so that it generates the libexpat.so.0 file it needs. This 
     55way the apache web server won't look elsewhere for the so file and 
     56perhaps find an incompatible version of it. 
    2657 
    2758    * Property svn:mime-type set to application/octet-stream 
     
    30613. http://trac.greenstone.org/browser/gsdl/trunk/runtime-src/packages/apache-httpd/httpd-2.2.11-gs.tar.gz?rev=20668 
    3162 
    32 Revision 20668, 7.9 MB  (checked in by davidb, 10 months ago) 
     63Revision 20668, 7.9 MB (checked in by davidb, 10 months ago) 
    3364 
    34 better to include builtin libiconv support. Should prevent .so version conflicts on Mac 
     65better to include builtin libiconv support. Should prevent .so version 
     66conflicts on Mac 
    3567 
    3668    * Property svn:mime-type set to application/octet-stream 
     
    39714. http://trac.greenstone.org/browser/gsdl/trunk/runtime-src/packages/apache-httpd/httpd-2.2.11-gs.tar.gz?rev=20850 
    4072 
    41 Revision 20850, 7.7 MB  (checked in by ak19, 9 months ago) 
     73Revision 20850, 7.7 MB (checked in by ak19, 9 months ago) 
    4274 
    43 Teaches the apache web server being compiled up where the static libiconv lib file, libiconv.a, is to be found (which greenstone would have compiled up during the greenstone configure stage). The with-iconv flag is set in runtime-src/packages/configure file to point to the common-src/packages/iconv folder wherein the lib folder contains the generated libiconv.a file. The apache server tar file is updated as well: no longer does it add the with-iconv flag explicitly since this is now already set at a higher up level and is passed down to it. 
     75Teaches the apache web server being compiled up where the static 
     76libiconv lib file, libiconv.a, is to be found (which greenstone would 
     77have compiled up during the greenstone configure stage). The 
     78with-iconv flag is set in runtime-src/packages/configure file to point 
     79to the common-src/packages/iconv folder wherein the lib folder 
     80contains the generated libiconv.a file. The apache server tar file is 
     81updated as well: no longer does it add the with-iconv flag explicitly 
     82since this is now already set at a higher up level and is passed down 
     83to it. 
    4484 
    4585    * Property svn:mime-type set to application/octet-stream 
     
    4787 
    48885. http://trac.greenstone.org/browser/gsdl/trunk/runtime-src/packages/apache-httpd/httpd-2.2.11-gs.tar.gz?rev=20892 
    49 Revision 20892, 7.7 MB  (checked in by oranfry, 9 months ago) 
     89 
     90Revision 20892, 7.7 MB (checked in by oranfry, 9 months ago) 
    5091 
    5192the change I think will force apr not to use sendfile 
     
    5798(http://trac.greenstone.org/browser/main/trunk/greenstone2/runtime-src/packages/apache-httpd/httpd-2.2.11-gs.tar.gz) 
    5899 
    59 Revision 20893, 7.9 MB  (checked in by ak19, 9 months ago) 
     100Revision 20893, 7.9 MB (checked in by ak19, 9 months ago) 
    60101 
    61 Dr Bainbridge updated srclib/apr/configure.in so that sendfile is set to 0 for Darwin (Mac) to tell Darwin systems that we won't be working with calls to sendfile, since Tiger OS does not have sendfile even though we are compiling on Leopard which does. 
     102Dr Bainbridge updated srclib/apr/configure.in so that sendfile is set 
     103to 0 for Darwin (Mac) to tell Darwin systems that we won't be working 
     104with calls to sendfile, since Tiger OS does not have sendfile even 
     105though we are compiling on Leopard which does. 
    62106 
    63107    * Property svn:mime-type set to application/octet-stream 
    64108 
     109 
     110 
     111***************************************************************** 
     112NOTES ON COMPILING AND INSTALLING APACHE HTTPD 2.2 FOR GREENSTONE 
     113***************************************************************** 
     114 
     115The Relocatable Apache web server: 
     116 
     117 
     118A) RELEASE KIT needs to run: 
     119 
     1201. ./configure --enable-apache-httpd 
     1212. make 
     1223. make install 
     1234. make apache-for-dist 
     124 
     125 
     126B) INSTALLER needs to: 
     127 
     1281. Copy the compiled up apache-httpd folder and put it into its 
     129   destination for installation: 
     130GSDLHOME/apache-httpd. 
     131 
     132X 2. Not necessary:  
     133cd into there and into the linux (=GSDLOS) folder in there: 
     134    cd <GSDLHOME>/apache-httpd/linux 
     135 
     1363. Run the script install-bindist.sh (in apache-httpd/<GSDLOS> folder) 
     137   passing as argument: <GSDLHOME>/apache-httpd/linux 
     138 
     1394. Now it should be good to go: can run the webserver after 
     140   configuring the port (in linux/conf/httpd.conf) as follows 
     141    ./bin/apachectl start 
     142 
     143- Change port in httpd.conf file 
     144- run gs2-server.sh 
     145