mirror of
https://github.com/apache/httpd.git
synced 2025-08-15 23:27:39 +00:00
7fc4466fa7
your OS-delivered APR was built with xlc vs gcc SunStudio vs gcc gcc n vs gcc n-bignum etc. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@749512 13f79535-47bb-0310-9956-ffa450edef68
113 lines
5.0 KiB
Plaintext
113 lines
5.0 KiB
Plaintext
|
|
APACHE INSTALLATION OVERVIEW
|
|
|
|
Quick Start - Unix
|
|
------------------
|
|
|
|
For complete installation documentation, see [ht]docs/manual/install.html or
|
|
http://httpd.apache.org/docs/2.3/install.html
|
|
|
|
$ ./configure --prefix=PREFIX
|
|
$ make
|
|
$ make install
|
|
$ PREFIX/bin/apachectl start
|
|
|
|
NOTES: * Replace PREFIX with the filesystem path under which
|
|
Apache should be installed. A typical installation
|
|
might use "/usr/local/apache2" for PREFIX (without the
|
|
quotes).
|
|
|
|
* Consider if you need to use the bundled APR and APR-Util
|
|
via ./configure's --with-included-apr option, to use the
|
|
bundled source instead of a previously installed APR and
|
|
APR-Util (such as those provided with many OSes). This
|
|
is required if you don't have the compiler which the
|
|
system APR was built with. This can be advantageous if
|
|
you are a developer who will be linking your code with
|
|
Apache 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.
|
|
|
|
* If you are a developer building Apache directly from
|
|
Subversion, you will need to run ./buildconf before running
|
|
configure. This script bootstraps the build environment and
|
|
requires Python as well as GNU autoconf and libtool. If you
|
|
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
|
|
include a sufficiently recent version of GNU Libtool (named
|
|
glibtool, but buildconf knows where to find it).
|
|
|
|
For a short impression of what possibilities you have, here is a
|
|
typical example which configures Apache for the installation tree
|
|
/sw/pkg/apache with a particular compiler and flags plus the two
|
|
additional modules mod_rewrite and mod_speling for later loading
|
|
through the DSO mechanism:
|
|
|
|
$ CC="pgcc" CFLAGS="-O2" \
|
|
./configure --prefix=/sw/pkg/apache \
|
|
--enable-rewrite=shared \
|
|
--enable-speling=shared
|
|
|
|
The easiest way to find all of the configuration flags for Apache 2.3
|
|
is to run ./configure --help.
|
|
|
|
|
|
Quick Start - Windows
|
|
---------------------
|
|
|
|
For complete documentation, see [ht]docs/manual/platform/windows.html or
|
|
http://httpd.apache.org/docs/2.3/platform/windows.html.
|
|
|
|
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.
|
|
|
|
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.)
|
|
|
|
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
|
|
|
|
bin\httpd.exe -k install
|
|
bin\httpd.exe -k start
|
|
|
|
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.
|
|
|
|
|
|
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.3.
|
|
|
|
The Apache Software Foundation
|
|
http://www.apache.org/
|