Home | History | Annotate | Download | only in apache-win32
      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