]> granicus.if.org Git - apache/blob - INSTALL
I don't like underscore as a name prefix.
[apache] / INSTALL
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.0/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 building on FreeBSD, be aware that threads will
21               be disabled and the prefork MPM will be used by default,
22               as threads do not work well with Apache on FreeBSD.  If
23               you wish to try a threaded Apache on FreeBSD anyway, use
24               "./configure --enable-threads".
25
26             * If you are a developer building Apache directly from CVS,
27               you will need to run ./buildconf before running configure.
28
29   For a short impression of what possibilities you have, here is a
30   typical example which configures Apache for the installation tree
31   /sw/pkg/apache with a particular compiler and flags plus the two
32   additional modules mod_rewrite and mod_speling for later loading
33   through the DSO mechanism:
34
35      $ CC="pgcc" CFLAGS="-O2" \
36      ./configure --prefix=/sw/pkg/apache \
37      --enable-rewrite=shared \
38      --enable-speling=shared 
39
40   The easiest way to find all of the configuration flags for Apache 2.0
41   is to run ./configure --help.
42
43
44   Quick Start - Windows
45   ---------------------
46
47   For complete documentation, see [ht]docs/manual/platform/windows.html or
48   http://httpd.apache.org/docs-2.0/platform/windows.html.
49
50   The Apache/Win32 binaries are primarily distributed as a Windows Installer 
51   package (.msi), and may be available as a .zip file as well.  These packages 
52   are named apache-2.0.xx-win32-x86.msi and apache-2.0.xx-win32-x86.zip.  
53   Please choose the .msi package if at all possible.
54
55   If you have unpacked a source distribution (named httpd-2.0-xx.zip, without
56   any -win32-x86 notation) you must compile the package yourself, see the links
57   mentioned above.  Unless you intended to do this, please look again for the 
58   binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
59   install that .msi (or .zip package, if you must.)
60
61   If you have unpacked this binary distribution from the .zip package, you 
62   _must_ edit the conf/httpd.conf file (with notepad or another text editor) 
63   to reflect the correct ServerName, Domain, and directory paths.  Search for 
64   the text "@@" to discover what you must edit.  To install and start the 
65   service after you have corrected the httpd.conf file, use the command
66
67     bin\Apache -k install
68     bin\Apache -k start
69
70   The .msi package configures the httpd.conf file, and installs and starts 
71   the Apache2 service for you.  It also installs plenty of useful shortcuts
72   and the taskbar ApacheMonitor.  We strongly encourage you to use it.
73
74
75   Postscript
76   ----------
77
78   The Apache HTTP Server group cannot field user's installation questions.
79   There are many valuable forums to help you get started.  Please refer your
80   questions to the appropriate forum, such as the user supported newsgroups
81   comp.infosystems.www.servers.unix and comp.infosystems.www.servers.ms-windows.
82
83   Thanks for using the Apache HTTP Server, version 2.0.
84
85                                      The Apache Software Foundation
86                                      http://www.apache.org/