Return-Path:
This document covers compilation and installation of Apache
- on Unix systems, using the manual build and install method. If
- you wish to use the autoconf-style configure interface, you
- should instead read the INSTALL file in the root directory of
- the Apache source distribution. For compiling and installation
- on specific platforms, see This document covers compilation and installation of Apache on Unix
+ systems. For compiling and installation on other platforms, see You may download the latest version of Apache either directly from the
+ Apache web site, at http://www.apache.org/dist/httpd/,
+ or from one of the many mirror sites, listed at http://www.apache.org/dyn/closer.cgi.
+ These sites will list the current release, and more recent beta releases,
+ and have links to older versions, and binary distributions for a variety
+ of platforms. Like all good things, there are two ways to configure, compile, and
+ install Apache. You can go for the 3-minute installation process using
+ the APACI process described below; or, you can opt for the same mechanism
+ used in previous versions of Apache, as described in the file
+ 'src/INSTALL'. Each mechanism has its benefits and drawbacks - APACI is
+ newer and a little more raw, but it gets you up and running the least
+ amount of time, whereas the "Configuration.tmpl" mechanism may be more
+ familiar and give you some more flexibility to the power user. We'd be
+ very interested in your comments and feedback regarding each
+ approach. NOTE: The following requirements exist for building Apache: To provide maximum flexibility Apache now is able to load modules
+ under runtime via the DSO mechanism by using the pragmatic
+ dlopen()/dlsym() system calls. These system calls are not available
+ under all operating systems therefore you cannot use the DSO
+ mechanism on all platforms. And Apache currently has only limited
+ built-in knowledge on how to compile shared objects because this is
+ heavily platform-dependent. The current state is this:
+ Compiling and Installing Apache 1.3
-
-
+
+
+
+
+
- Downloading Apache
- Introduction
+
+ Installing the Apache 1.3 HTTP server with
+ APACI
- Overview for the impatient
+
+ $ ./configure --prefix=PREFIX
+ $ make
+ $ make install
+ $ PREFIX/bin/apachectl start
+
+
+ PREFIX
is not the string "PREFIX". Instead
+ use the Unix filesystem path under which Apache should be installed. For
+ instance use "/usr/local/apache
" for PREFIX above.Requirements
+
+
+
+
+
+
+
+ Linux
+ SunOS
+ UnixWare
+ Darwin/Mac OS
+
+
+ FreeBSD
+ Solaris
+ AIX
+ OpenStep/Mach
+
+
+ OpenBSD
+ IRIX
+ SCO
+ DYNIX/ptx
+
+
+ NetBSD
+ HPUX
+ ReliantUNIX
+ BSDI
+
+
+ Digital Unix
+ DGUX
+
Ultrix
+If your system is not on these lists but has the dlopen-style + interface, you either have to provide the appropriate compiler and + linker flags (see CFLAGS_SHLIB, LDFLAGS_SHLIB and + LDFLAGS_SHLIB_EXPORT below) manually or at least make sure a Perl 5 + interpreter is installed from which Apache can guess the options.
+ +For more in-depth information about DSO support in Apache 1.3 + please read the document htdocs/manual/dso.html carefully. Especially + the section entitled "Advantages & Disadvantages" because using + the DSO mechanism can have strange side-effects if you are not + carefully. BE WARNED!
+ + + +The next step is to configure the Apache source tree for your + particular platform and personal requirements. The most important setup + here is the location prefix where Apache is to be installed later, + because Apache has to be configured for this location to work correctly. + But there are a lot of other options available for your pleasure.
+ +For a short impression of what possibilities you have, here is a + typical example which compiles Apache for the installation tree + /sw/pkg/apache with a particular compiler and flags plus the two + additional modules mod_rewrite and mod_proxy for later loading through + the DSO mechanism:
++ $ CC="pgcc" OPTIM="-O2" \ + ./configure --prefix=/usr/local/apache \ + --enable-module=rewrite --enable-shared=rewrite \ + --enable-module=proxy --enable-shared=proxy ++ +
For a complete list of the available options, type the following + command:
+./configure --help
See also the file README.configure
for listings of
+ example configurations.
Now you can build the various parts which form the Apache package by + simply running the command
++ $ make ++ +
Please be patient here, this takes approximately 2 minutes to complete + under a Pentium-166/FreeBSD-2.2 system, dependent on the amount of + modules you have enabled.
+ +Now its time to install the package under the configured installation
+ PREFIX
(see the --prefix
option above):
+ $ make install +-
If you downloaded a binary distribution, skip to Installing Apache. Otherwise read the next - section for how to compile the server.
+In the following examples, PREFIX
is not the literal string
+ "PREFIX", but whatever argument you provided to
+ the--prefix
option.
Configure -file Configuration.ai
).
+make
.httpd
in the
src
directory. A binary distribution of Apache
will supply this file.
@@ -180,14 +381,7 @@
.htaccess
files in directories accessed by the
server.
- httpd
server which is
compiled and configured as above, Apache includes a number of
support programs. These are not compiled by default. The
@@ -197,7 +391,31 @@
make- + +
Now you can fire up your Apache HTTP server by immediately running
++ $ PREFIX/bin/apachectl start ++ +
and then you should be able to request your first document via URL + http://localhost/ (when you built and installed Apache as root or at + least used the --without-confadjust option) or http://localhost:8080/ + (when you built and installed Apache as a regular user). Then stop the + server again by running:
++ $ PREFIX/bin/apachectl stop ++ +
net time
command on NT.
+
+
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org