1923N/A

1923N/A APACHE INSTALLATION OVERVIEW

1923N/A

1923N/A Quick Start - Unix

1923N/A ------------------

1923N/A

1923N/A For complete installation documentation, see [ht]docs/manual/install.html or

1923N/A http://httpd.apache.org/docs/2.5/install.html

1923N/A

1923N/A $ ./configure --prefix=PREFIX

1923N/A $ make

1923N/A $ make install

1923N/A $ PREFIX/bin/apachectl start

1923N/A

1923N/A NOTES: * Replace PREFIX with the filesystem path under which

1923N/A Apache should be installed. A typical installation

1923N/A might use "/usr/local/apache2" for PREFIX (without the

1923N/A quotes).

1923N/A

1923N/A * Consider if you want to use a previously installed APR and

1923N/A APR-Util (such as those provided with many OSes) or if

1923N/A you need to use the APR and APR-Util from the

3661N/A httpd-2.5.x-deps.tar.gz tarball via ./configure's

1923N/A --with-included-apr option. This is required if you don't

1923N/A have the compiler which the system APR was built with. It

1923N/A can also be advantageous if you are a developer who will be

1923N/A linking your code with Apache or using a debugger to step

1923N/A through server code, as it removes the possibility of

1923N/A version or compile-option mismatches with APR and APR-util

1923N/A code.

1923N/A

1923N/A * If you are a developer building Apache directly from

1923N/A Subversion, you will need to run ./buildconf before running

1923N/A configure. This script bootstraps the build environment and

1923N/A requires Python as well as GNU autoconf and libtool. If you

1923N/A build Apache from a release tarball, you don't have to run

1923N/A buildconf.

1923N/A

1923N/A * If you want to build a threaded MPM (for instance worker)

1923N/A on FreeBSD, be aware that threads do not work well with

1923N/A Apache on FreeBSD versions before 5.4-RELEASE. If you wish

1923N/A to try a threaded Apache on an earlier version of FreeBSD,

1923N/A use the --enable-threads parameter to ./configure in

1923N/A addition to the --with-mpm parameter.

1923N/A

1923N/A * If you are building directly from Subversion on Mac OS X

1923N/A (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All

1923N/A recent versions of the developer tools on this platform

1923N/A include a sufficiently recent version of GNU Libtool (named

3661N/A glibtool, but buildconf knows where to find it).

3661N/A

1923N/A For a short impression of what possibilities you have, here is a

1923N/A typical example which configures Apache for the installation tree

1923N/A /sw/pkg/apache with a particular compiler and flags plus the two

1923N/A additional modules mod_rewrite and mod_speling for later loading

1923N/A through the DSO mechanism:

1923N/A

1923N/A $ CC="pgcc" CFLAGS="-O2" \

1923N/A ./configure --prefix=/sw/pkg/apache \

1923N/A --enable-rewrite=shared \

1923N/A --enable-speling=shared

1923N/A

1923N/A The easiest way to find all of the configuration flags for Apache 2.5

1923N/A is to run ./configure --help.

1923N/A

1923N/A

1923N/A Quick Start - Windows

1923N/A ---------------------

1923N/A

1923N/A For complete documentation, see manual/platform/windows.html.en or

1923N/A http://httpd.apache.org/docs/2.5/platform/windows.html.

1923N/A

1923N/A The Apache/Win32 binaries are distributed as Windows Installer packages

1923N/A (.msi) named httpd-2.5.xx-win32-x86-no_ssl.msi for a version without mod_ssl

1923N/A and httpd-2.5.xx-win32-x86-openssl-1.0.1x.msi for a version including the

1923N/A mod_ssl plus the openssl library and command line utility. These packages

1923N/A may be unpacked without "installing" them by using the msiexec /a option.

1923N/A

1923N/A If you have unpacked a source distribution (named httpd-2.5-xx.zip, without

1923N/A any -win32-x86 notation) you must compile the package yourself, see the links

1923N/A mentioned above. Unless you intended to do this, please look again for the

1923N/A binary package from http://www.apache.org/dist/httpd/binaries/win32/ and

1923N/A install the desired .msi package.

1923N/A

1923N/A The .msi package configures the httpd.conf file, and installs and starts

1923N/A the Apache2.4 service for you. It also installs plenty of useful shortcuts

1923N/A and the taskbar ApacheMonitor. We strongly encourage you to use it.

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.

Thanks for using the Apache HTTP Server, version 2.5.

The Apache Software Foundation

http://www.apache.org/