Ignore:
Timestamp:
07/22/10 17:08:16 (10 years ago)
Author:
ak19
Message:
  1. Added instructions on how to set up the relocatable Apache HTTPD web server. 2. Improved formatting.
File:
1 edited

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
Note: See TracChangeset for help on using the changeset viewer.