X-Git-Url: https://granicus.if.org/sourcecode?a=blobdiff_plain;f=INSTALL;h=5205ce10e07ca32b1de34c5d1161df028650e2f5;hb=260f53e67ac6c31d17f8c41d0dd4297912e4ca5f;hp=1e67c20447c6efecc1e1f29715e6de00b0d6bbe3;hpb=3ec5b99dfbc36f874159d5b0896087b54401be13;p=apache diff --git a/INSTALL b/INSTALL index 1e67c20447..5205ce10e0 100644 --- a/INSTALL +++ b/INSTALL @@ -17,12 +17,7 @@ might use "/usr/local/apache2" for PREFIX (without the quotes). - * If you want to build a threaded MPM (for instance worker) - on FreeBSD, be aware that threads do not work well with - Apache on FreeBSD versions before 5.4-RELEASE. If you wish - to try a threaded Apache on an earlier version of FreeBSD, - use the --enable-threads parameter to ./configure in - addition to the --with-mpm parameter. + * Read the section "APR - Unix" below. * If you are a developer building Apache directly from Subversion, you will need to run ./buildconf before running @@ -31,6 +26,13 @@ build Apache from a release tarball, you don't have to run buildconf. + * If you want to build a threaded MPM (for instance worker) + on FreeBSD, be aware that threads do not work well with + Apache on FreeBSD versions before 5.4-RELEASE. If you wish + to try a threaded Apache on an earlier version of FreeBSD, + use the --enable-threads parameter to ./configure in + addition to the --with-mpm parameter. + * If you are building directly from Subversion on Mac OS X (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All recent versions of the developer tools on this platform @@ -48,54 +50,83 @@ --enable-rewrite=shared \ --enable-speling=shared - The easiest way to find all of the configuration flags for Apache 2.3 + The easiest way to find all of the configuration flags for Apache 2.5 is to run ./configure --help. + APR - Unix + ---------- - Quick Start - Windows - --------------------- + httpd trunk (httpd development version 2.5) can use APR trunk (future + APR version 2.0) or the combination of the current APR 1.x branch and + the current APR-util 1.x branch. (APR trunk bundles the features in + APR-util 1.x.) + + The httpd buildconf step, required when building httpd from Subversion, + must have access to the APR source. The httpd configure step, always + required, can configure the APR source in srclib or use a previously- + built APR. + + APR (and APR-util if using APR 1.x) can be built with httpd from httpd's + srclib directory or can be built separately, prior to building httpd. + + Building APR with httpd from httpd's srclib directory is required if + you don't have the compiler which the system APR was built with, and it + can also be advantageous if you are a developer who will be linking your + code with httpd or using a debugger to step through server code, as it + removes the possibility of version or compile-option mismatches with + APR and APR-util code. + + To use APR trunk in srclib: + + Check out APR trunk in srclib/apr with the following command: + + svn co http://svn.apache.org/repos/asf/apr/apr/trunk srclib/apr + + buildconf will find it automatically. Use the --with-included-apr + argument to httpd configure. + + To use APR 1.x and APR-util 1.x in srclib: - For complete documentation, see [ht]docs/manual/platform/windows.html or - http://httpd.apache.org/docs/trunk/platform/windows.html. + Check out the current branches as srclib/apr and srclib/apr-util with + the following commands: - The Apache/Win32 binaries are primarily distributed as a Windows Installer - package (.msi), and may be available as a .zip file as well. These packages - are named apache-2.3.xx-win32-x86.msi and apache-2.3.xx-win32-x86.zip. - Please choose the .msi package if at all possible. Note that Apache version - 2.3 is a development version and binaries may not be available. Use a - released version from the stable 2.2 branch instead. + svn co http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x srclib/apr + svn co http://svn.apache.org/repos/asf/apr/apr-util/branches/1.5.x srclib/apr-util - If you have unpacked a source distribution (named httpd-2.3-xx.zip, without - any -win32-x86 notation) you must compile the package yourself, see the links - mentioned above. Unless you intended to do this, please look again for the - binary package from http://www.apache.org/dist/httpd/binaries/win32/ and - install that .msi (or .zip package, if you must.) + buildconf will find them automatically. Use the --with-included-apr + argument to httpd configure. - If you have unpacked this binary distribution from the .zip package, you - _must_ edit the conf/httpd.conf file (with notepad or another text editor) - to reflect the correct ServerName, Domain, and directory paths. Search for - the text "@@" to discover what you must edit. To install and start the - service after you have corrected the httpd.conf file, use the command + To use existing checkouts of APR (and APR-util if using APR 1.x): - bin\Apache -k install - bin\Apache -k start + httpd buildconf must have access to the source trees. Use these arguments + to httpd buildconf: + + --with-apr=[path to apr source] --with-apr-util=[path to apr-util source] + + (Omit --with-apr-util if using APR trunk.) + + httpd configure must have access to a previously build apr. Use these + arguments to httpd configure: + + --with-apr=[path to apr install] --with-apr-util=[path to apr-util install] + + (Omit --with-apr-util if using APR trunk.) + + + Quick Start - Windows + --------------------- - The .msi package configures the httpd.conf file, and installs and starts - the Apache2 service for you. It also installs plenty of useful shortcuts - and the taskbar ApacheMonitor. We strongly encourage you to use it. + For complete documentation, see manual/platform/windows.html.en or + Postscript ---------- - The Apache HTTP Server group cannot field user's installation questions. - There are many valuable forums to help you get started. Please refer your - questions to the appropriate forum, such as the Users Mailing List at - http://httpd.apache.org/userslist.html or the usenet newsgroups - comp.infosystems.www.servers.unix or - comp.infosystems.www.servers.ms-windows. + To obtain help with installation problems, please see the resources at + - Thanks for using the Apache HTTP Server, version 2.3. + Thanks for using the Apache HTTP Server, version 2.5. The Apache Software Foundation http://www.apache.org/