You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rs...@hyperreal.org on 1998/04/01 14:59:58 UTC
cvs commit: apache-1.3/src INSTALL
rse 98/04/01 04:59:58
Modified: . README INSTALL
src INSTALL
Log:
Reorganisation and cleanup of the README, INSTALL and src/INSTALL
files to avoid confusion by the user:
1. Merge the installation and compilation instructions for the manual way from
top-level README into src/INSTALL because this is the INSTALL file for it.
Now any information we have about this is there. I've not changed the text
itself greatly, just merged and adjusted the sentences.
2. Made the same style for INSTALL and src/INSTALL plus cross-hints
for the user where to find what plus general hint for both files about
Windows installation.
3. Inserted a new and simple reference to top-level INSTALL file
under the topic "Installation" to the top-level README file.
I've also cleaned up the README file a little bit.
Feel free to fix me where I've written down bad english...
Revision Changes Path
1.15 +57 -111 apache-1.3/README
Index: README
===================================================================
RCS file: /export/home/cvs/apache-1.3/README,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- README 1997/11/25 09:47:47 1.14
+++ README 1998/04/01 12:59:55 1.15
@@ -1,117 +1,63 @@
+
Apache
Version 1.3 (and up)
-What is it?
------------
+ What is it?
+ -----------
+
+ Apache is an HTTP server designed as a plug-in replacement for
+ the NCSA server version 1.3 (or 1.4). It fixes numerous bugs in
+ the NCSA server and includes many frequently requested new
+ features, and has an API which allows it to be extended to meet
+ users' needs more easily.
+
+ The Latest Version
+ ------------------
+
+ Details of the latest version can be found on the Apache HTTP
+ server project page under http://www.apache.org/.
+
+ Documentation
+ -------------
+
+ The documentation available as of the date of this release is
+ also included, in HTML format, in the htdocs/manual/ directory.
+ For the most up-to-date documentation can be found on
+ http://www.apache.org/docs/.
+
+ Installation
+ ------------
+
+ From Apache version 1.3 and up you have two possibilities to
+ build and install the Apache package: The old commonly known
+ but manual way from Apache 1.2 and below and the new
+ out-of-the-box way through the new Apache Autoconf-style
+ Interface (APACI). For detailed instructions see the file
+ INSTALL in this directory.
+
+ Licensing
+ ---------
+
+ Please see the file called LICENSE.
+
+ Acknowledgments
+ ----------------
+
+ We wish to acknowledge the following copyrighted works that
+ make up portions of the Apache software:
+
+ Portions of this software were developed at the National Center
+ for Supercomputing Applications (NCSA) at the University of
+ Illinois at Urbana-Champaign.
+
+ This software contains code derived from the RSA Data Security
+ Inc. MD5 Message-Digest Algorithm, including various
+ modifications by Spyglass Inc., Carnegie Mellon University, and
+ Bell Communications Research, Inc (Bellcore).
-Apache is an HTTP server designed as a plug-in replacement for the NCSA
-server version 1.3 (or 1.4). It fixes numerous bugs in the NCSA server and
-includes many frequently requested new features, and has an API which
-allows it to be extended to meet users' needs more easily.
-
-Documentation
--------------
-
-The documentation available as of the date of this release is also
-included, in HTML format, in the htdocs/manual/ directory. For the
-most up-to-date documentation, visit us on the WWW, at
-<URL:http://www.apache.org/>.
-
-New Installations
------------------
-
-NOTE: Windows users please see http://www.apache.org/docs/windows.html,
- or the htdocs/manual/windows.html file included with Apache. The
- following applies only to Unix users.
-
-Unless you grabbed a binary distribution of Apache, you must compile
-it for your specific platform. In order to compile it, you must set
-compile-time options (in particular, system type) for your system by
-editing a Configuration file, run a script which generates a Makefile
-and a small piece of C code, and then compile it.
-
-For instructions on compilation, see the file 'INSTALL' in the src/ directory.
-
-After compilation, you will have a binary called "httpd" in the src/
-directory. If you received a binary distribution of apache, you
-should have this file already.
-
-The next step is to edit the configuration files for the server. In
-the subdirectory called "conf" you should find distribution versions
-of the three configuration files: srm.conf-dist, access.conf-dist, and
-httpd.conf-dist. Copy them to srm.conf, access.conf, httpd.conf
-respectively.
-
-First edit httpd.conf. This sets up general attributes about the
-server - the port number, the user it runs as, etc. Next edit the
-srm.conf file - this sets up the root of the document tree, special
-functions like server-parsed HTML or internal imagemap parsing, etc.
-Finally, edit the access.conf file to at least set the base cases of
-access. Documentation for all of these is located at
-<URL:http://www.apache.org/docs/>.
-
-Finally, make a call to httpd, with a -f to the full path to the
-httpd.conf file. I.e., the common case:
-
- /usr/local/apache/httpd -f /usr/local/apache/conf/httpd.conf
-
-And voila! The server should be running.
-
-By default the srm.conf and access.conf files are located by name - to
-specifically call them by other names, use the AccessConfig and
-ResourceConfig directives in httpd.conf.
-
-Upgrading an Existing Apache Environment
-----------------------------------------
-
-Between releases of Apache, there are several files that are likely
-to get changed (aside from the source, of course). These include:
-
- src/Makefile.tmpl
- src/Configuration.tmpl
- src/Configure
- conf/*.conf-dist
- conf/mime.types
-
-It's recommended that you unpack a new Apache version distribution
-into a different directory than the existing one, and check these
-files against the ones you already have for new or changed directives.
-It's almost certain that the Configure, Configuration.tmpl, and
-Makefile.tmpl files are going to change, so pay particular attention
-to merging your existing Configuration settings with the ones in
-the Configuration.tmpl file to make a new Configuration file in the
-new Apache src directory. Then follow the steps for a new
-installation to build and test the new server before replacing
-the existing Apache directory tree with the one from the new
-distribution.
-
-The Latest Version
-------------------
-
-Details of the latest version are in the apache project page (above).
-
-Licensing
----------
-
-Please see the file called LICENSE.
-
-Acknowledgments
-----------------
-
-We wish to acknowledge the following copyrighted works that make up
-portions of the Apache software:
-
-Portions of this software were developed at the National Center for
-Supercomputing Applications at the University of Illinois at
-Urbana-Champaign.
-
-This software contains code derived from the RSA Data Security Inc. MD5
-Message-Digest Algorithm, including various modifications by Spyglass Inc.,
-Carnegie Mellon University, and Bell Communications Research, Inc.
-(Bellcore).
+ This package contains software written and copyrighted by Henry
+ Spencer. Please see the file called src/regex/COPYRIGHT.
-This package contains software written and copyrighted by Henry Spencer.
-Please see the file called src/regex/COPYRIGHT.
+ The NT port was started with code provided to the Apache Group
+ by Ambarish Malpani of ValiCert, Inc. (http://www.valicert.com/).
-The NT port was started with code provided to the Apache Group
-by Ambarish Malpani of ValiCert, Inc. (<http://www.valicert.com/>).
1.3 +5 -0 apache-1.3/INSTALL
Index: INSTALL
===================================================================
RCS file: /export/home/cvs/apache-1.3/INSTALL,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- INSTALL 1998/04/01 11:28:32 1.2
+++ INSTALL 1998/04/01 12:59:56 1.3
@@ -1,6 +1,11 @@
A P A C H E I N S T A L L A T I O N
+ NOTE: Windows users please read the documents README.NT and
+ http://www.apache.org/docs/windows.html, (or the
+ htdocs/manual/windows.html file included with Apache).
+ The following applies only to Unix users.
+
Installing the Apache 1.3 HTTP server manually
==============================================
1.20 +159 -87 apache-1.3/src/INSTALL
Index: INSTALL
===================================================================
RCS file: /export/home/cvs/apache-1.3/src/INSTALL,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- INSTALL 1997/11/13 18:22:55 1.19
+++ INSTALL 1998/04/01 12:59:57 1.20
@@ -1,89 +1,161 @@
-***
-*** Building the Apache Web server absolutely REQUIRES an ANSI C-compliant
-*** compiler. If your compiler does not meet this requirement, don't
-*** even bother trying to build the server; it won't work.
-***
-*** The server may or may not build correctly with a C++ compiler. Making
-*** it compilable with C++ is not a goal at this point, so if it doesn't
-*** work please use a normal ANSI C compiler instead.
-***
-
-This release of Apache supports the notion of "optional modules".
-However, the server has to know which modules are compiled into it, in
-order for those modules to be effective; this requires generation of a
-short bit of code ("modules.c") which simply has a list of them.
-
-It is also necessary to choose the correct options for your platform.
-
-To do this:
-
-1) Copy the file "Configuration.tmpl" to "Configuration" and then edit
- "Configuration". This contains the list and settings of various
- "Rules" and an additional section at the bottom which
- lists the modules which have been compiled in, and also names the
- files containing them. You will need to:
-
- a) Adjust the Rules and EXTRA_CFLAGS|LIBS|LDFLAGS|INCLUDES if
- you feel so inclined.
-
- b) Uncomment lines corresponding to those optional modules you wish
- to include (among the Module lines at the bottom of the file),
- or add new lines corresponding to custom modules you have written.
- (See API.html for preliminary docs on how to do that).
-
- Note that DBM auth has to be explicitly configured in, if you want
- it --- just uncomment the corresponding line.
-
-2) Run the "Configure" script:
-
- % ./Configure
- Using config file: Configuration
- Creating Makefile
- + configured for <whatever> platform
- + setting C compiler to <whatever>
- + Adding selected modules
- + doing sanity check on compiler and options
- Creating Makefile in support
- Creating Makefile in main
- Creating Makefile in os/unix
- Creating Makefile in modules/standard
- %
-
- This generates new versions of the Makefile and of modules.c. (If
- you want to maintain multiple configurations, you can say, e.g.,
-
- % ./Configure -file Configuration.ai
- Using config file: Configuration.ai
- Creating Makefile
- + configured for <whatever> platform
- + setting C compiler to <whatever>
- + Adding selected modules
- + doing sanity check on compiler and options
- Creating Makefile in support
- Creating Makefile in main
- Creating Makefile in os/unix
- Creating Makefile in modules/standard
- %
-
-
-3) Type "make".
-
-The modules we place in the Apache distribution are the ones we have
-tested and are used regularly by various members of the Apache
-development group. Additional modules contributed by members or third
-parties with specific needs or functions are available at
-<URL:http://www.apache.org/dist/contrib/modules/>. There are
-instructions on that page for linking these modules into the
-core Apache code.
-
-If during compilation you get a warning about a missing 'regex.h', set
-WANTHSREGEX=yes in the 'Configuration', and let The Apache Group know
-you needed to do this for your OS by filling out a problem report form
-at <http://www.apache.org/bugdb.cgi>, or by sending a mail message to
-apache-bugs@apache.org. Include the output of the command "uname -a".
-
---------------------------------------------------------------------
+ A P A C H E I N S T A L L A T I O N
+
+ NOTE: Windows users please read the documents ../README.NT and
+ http://www.apache.org/docs/windows.html, (or the
+ htdocs/manual/windows.html file included with Apache).
+ The following applies only to Unix users.
+
+ Installing the Apache 1.3 HTTP server with APACI
+ ================================================
+
+ For the out-of-the-box build and installation through the new Apache
+ Autoconf-style Interface (APACI) see the file INSTALL in the parent
+ directory. This document describes only the manual way of installing Apache.
+
+ Installing the Apache 1.3 HTTP server manually
+ ==============================================
+
+ Unless you grabbed a binary distribution of Apache, you must compile it for
+ your specific platform. In order to compile it, you must set compile-time
+ options (in particular, system type) for your system by editing a
+ Configuration file, run a script which generates a Makefile and a small
+ piece of C code, and then compile it.
+
+ Compilation
+ -----------
+
+ Building the Apache Web server absolutely REQUIRES an ANSI C-compliant
+ compiler. If your compiler does not meet this requirement, don't even
+ bother trying to build the server; it won't work. The server may or may not
+ build correctly with a C++ compiler. Making it compilable with C++ is not a
+ goal at this point, so if it doesn't work please use a normal ANSI C
+ compiler instead.
+
+ This release of Apache supports the notion of "optional modules". However,
+ the server has to know which modules are compiled into it, in order for
+ those modules to be effective; this requires generation of a short bit of
+ code ("modules.c") which simply has a list of them.
+
+ It is also necessary to choose the correct options for your platform.
+
+ To do this:
+
+ 1) Copy the file "Configuration.tmpl" to "Configuration" and then edit
+ "Configuration". This contains the list and settings of various "Rules"
+ and an additional section at the bottom which lists the modules which
+ have been compiled in, and also names the files containing them. You
+ will need to:
+
+ a) Adjust the Rules and EXTRA_CFLAGS|LIBS|LDFLAGS|INCLUDES if
+ you feel so inclined.
+
+ b) Uncomment lines corresponding to those optional modules you wish to
+ include (among the Module lines at the bottom of the file), or add new
+ lines corresponding to custom modules you have written. (See API.html
+ for preliminary docs on how to do that).
+
+ Note that DBM auth has to be explicitly configured in, if you want it ---
+ just uncomment the corresponding line.
+
+ 2) Run the "Configure" script:
+
+ $ ./Configure
+ Using config file: Configuration
+ Creating Makefile
+ + configured for <whatever> platform
+ + setting C compiler to <whatever>
+ + Adding selected modules
+ + doing sanity check on compiler and options
+ Creating Makefile in support
+ Creating Makefile in main
+ Creating Makefile in os/unix
+ Creating Makefile in modules/standard
+ $ _
+
+ This generates new versions of the Makefiles and of modules.c. (If you
+ want to maintain multiple configurations, you can say, e.g.,
+
+ $ ./Configure -file Configuration.ai
+ Using config file: Configuration.ai
+ Creating Makefile
+ + configured for <whatever> platform
+ + setting C compiler to <whatever>
+ + Adding selected modules
+ + doing sanity check on compiler and options
+ Creating Makefile in support
+ Creating Makefile in main
+ Creating Makefile in os/unix
+ Creating Makefile in modules/standard
+ $ _
+
+ 3) Now compile the program:
+
+ $ make
+
+ The modules we place in the Apache distribution are the ones we have tested
+ and are used regularly by various members of the Apache development group.
+ Additional modules contributed by members or third parties with specific
+ needs or functions are available at
+ http://www.apache.org/dist/contrib/modules/. There are instructions
+ on that page for linking these modules into the core Apache code.
+
+ If during compilation you get a warning about a missing 'regex.h', set
+ WANTHSREGEX=yes in the 'Configuration', and let The Apache Group know you
+ needed to do this for your OS by filling out a problem report form at
+ http://www.apache.org/bugdb.cgi, or by sending a mail message to
+ apache-bugs@apache.org. Include the output of the command "uname -a".
+
+ Installation
+ ------------
+
+ After compilation, you will have a binary called "httpd" in this src/
+ directory. If you received a binary distribution of apache, you should have
+ this file already.
+
+ The next step is to edit the configuration files for the server. In the
+ top-level subdirectory called "conf" you should find distribution versions
+ of the three configuration files: srm.conf-dist, access.conf-dist, and
+ httpd.conf-dist. Copy them to srm.conf, access.conf, httpd.conf
+ respectively.
+
+ First edit httpd.conf. This sets up general attributes about the server -
+ the port number, the user it runs as, etc. Next edit the srm.conf file -
+ this sets up the root of the document tree, special functions like
+ server-parsed HTML or internal imagemap parsing, etc. Finally, edit the
+ access.conf file to at least set the base cases of access. Documentation for
+ all of these is located at http://www.apache.org/docs/.
+
+ Finally, make a call to httpd, with a -f to the full path to the httpd.conf
+ file. I.e., the common case:
+
+ $ /usr/local/apache/httpd -f /usr/local/apache/conf/httpd.conf
+
+ And voila! The server should be running.
+
+ By default the srm.conf and access.conf files are located by name - to
+ specifically call them by other names, use the AccessConfig and
+ ResourceConfig directives in httpd.conf.
+
+ Upgrading an Existing Apache Environment
+ ----------------------------------------
+
+ Between releases of Apache, there are several files that are likely to get
+ changed (aside from the source, of course). These include:
+
+ src/Makefile.tmpl
+ src/Configuration.tmpl
+ src/Configure
+ conf/*.conf-dist
+ conf/mime.types
+
+ It's recommended that you unpack a new Apache version distribution into a
+ different directory than the existing one, and check these files against the
+ ones you already have for new or changed directives. It's almost certain
+ that the Configure, Configuration.tmpl, and Makefile.tmpl files are going to
+ change, so pay particular attention to merging your existing Configuration
+ settings with the ones in the Configuration.tmpl file to make a new
+ Configuration file in the new Apache src directory. Then follow the steps
+ for a new installation to build and test the new server before replacing the
+ existing Apache directory tree with the one from the new distribution.
-Now that you have compiled Apache, go back to the README file in the
-top-level directory of this distribution to continue the installation.