1 2 APACHE INSTALLATION OVERVIEW 3 4 Quick Start - Unix 5 ------------------ 6 7 For complete installation documentation, see [ht]docs/manual/install.html or 8 http://httpd.apache.org/docs/2.2/install.html 9 10 $ ./configure --prefix=PREFIX 11 $ make 12 $ make install 13 $ PREFIX/bin/apachectl start 14 15 NOTES: * Replace PREFIX with the filesystem path under which 16 Apache should be installed. A typical installation 17 might use "/usr/local/apache2" for PREFIX (without the 18 quotes). 19 20 * If you are a developer who will be linking your code with 21 Apache or using a debugger to step through server code, 22 ./configure's --with-included-apr option may be advantageous, 23 as it removes the possibility of version or compile-option 24 mismatches with APR and APR-util code. (Many OSes now 25 include their own version of APR and APR-util.) 26 27 * If you are a developer building Apache directly from 28 Subversion, you will need to run ./buildconf before running 29 configure. This script bootstraps the build environment and 30 requires Python as well as GNU autoconf and libtool. If you 31 build Apache from a release tarball, you don't have to run 32 buildconf. 33 34 * If you want to build a threaded MPM (for instance worker) 35 on FreeBSD, be aware that threads do not work well with 36 Apache on FreeBSD versions before 5.4-RELEASE. If you wish 37 to try a threaded Apache on an earlier version of FreeBSD, 38 use the --enable-threads parameter to ./configure in 39 addition to the --with-mpm parameter. 40 41 * If you are building directly from Subversion on Mac OS X 42 (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All 43 recent versions of the developer tools on this platform 44 include a sufficiently recent version of GNU Libtool (named 45 glibtool, but buildconf knows where to find it). 46 47 For a short impression of what possibilities you have, here is a 48 typical example which configures Apache for the installation tree 49 /sw/pkg/apache with a particular compiler and flags plus the two 50 additional modules mod_rewrite and mod_speling for later loading 51 through the DSO mechanism: 52 53 $ CC="pgcc" CFLAGS="-O2" \ 54 ./configure --prefix=/sw/pkg/apache \ 55 --enable-rewrite=shared \ 56 --enable-speling=shared 57 58 The easiest way to find all of the configuration flags for Apache 2.2 59 is to run ./configure --help. 60 61 62 Quick Start - Windows 63 --------------------- 64 65 For complete documentation, see manual/platform/windows.html.en or 66 http://httpd.apache.org/docs/2.2/platform/windows.html. 67 68 The Apache/Win32 binaries are distributed as Windows Installer packages 69 (.msi) named httpd-2.2.xx-win32-x86-no_ssl.msi for a version without mod_ssl 70 and httpd-2.2.xx-win32-x86-openssl-0.9.8x.msi for a version including the 71 mod_ssl plus the openssl library and command line utility. These packages 72 may be unpacked without "installing" them by using the msiexec /a option. 73 74 If you have unpacked a source distribution (named httpd-2.2.x-win32-src.zip, 75 without any -x86 notation) you must compile the package yourself, see the links 76 mentioned above. Unless you intended to do this, please look again for the 77 binary package from http://www.apache.org/dist/httpd/binaries/win32/ and 78 install the desired .msi package. 79 80 The .msi package configures the httpd.conf file, and installs and starts 81 the Apache2.2 service for you. It also installs plenty of useful shortcuts 82 and the taskbar ApacheMonitor. We strongly encourage you to use it. 83 84 85 Postscript 86 ---------- 87 88 The Apache HTTP Server group cannot field user's installation questions. 89 There are many valuable forums to help you get started. Please refer your 90 questions to the appropriate forum, such as the Users Mailing List at 91 http://httpd.apache.org/userslist.html or the usenet newsgroups 92 comp.infosystems.www.servers.unix or 93 comp.infosystems.www.servers.ms-windows. 94 95 Thanks for using the Apache HTTP Server, version 2.2. 96 97 The Apache Software Foundation 98 http://www.apache.org/ 99