home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / apach139.zip / INSTALL < prev    next >
Text File  |  1999-08-09  |  27KB  |  532 lines
  1.  
  2.   APACHE INSTALLATION
  3.  
  4.   NOTE: Windows users please read the documents README.NT and
  5.         http://www.apache.org/docs/windows.html, (or the
  6.         htdocs/manual/windows.html file included with Apache). 
  7.         The following applies only to Unix users.
  8.  
  9.   Introduction
  10.   ============
  11.  
  12.   Like all good things, there are two ways to configure, compile, and install
  13.   Apache.  You can go for the 3-minute installation process using the APACI
  14.   process described below; or, you can opt for the same mechanism used in
  15.   previous versions of Apache, as described in the file 'src/INSTALL'.  Each
  16.   mechanism has its benefits and drawbacks - APACI is newer and a little more
  17.   raw, but it gets you up and running the least amount of time, whereas the
  18.   "Configuration.tmpl" mechanism may be more familiar and give you some more
  19.   flexibility to the power user.  We'd be very interested in your comments and
  20.   feedback regarding each approach.
  21.  
  22.  
  23.   Installing the Apache 1.3 HTTP server with APACI
  24.   ================================================
  25.  
  26.   1. Overview for the impatient
  27.      --------------------------
  28.  
  29.      $ ./configure --prefix=PREFIX
  30.      $ make
  31.      $ make install
  32.      $ PREFIX/bin/apachectl start
  33.  
  34.      NOTE: PREFIX is not the string "PREFIX". Instead use the Unix
  35.            filesystem path under which Apache should be installed. For
  36.            instance use "/usr/local/apache" for PREFIX above.
  37.  
  38.   2. Requirements
  39.      ------------
  40.  
  41.      The following requirements exist for building Apache:
  42.  
  43.      o  Disk Space: 
  44.  
  45.         Make sure you have approximately 12 MB of temporary free disk space
  46.         available.  After installation Apache occupies approximately 3 MB of
  47.         disk space (the actual required disk space depends on the amount of
  48.         compiled in third party modules, etc).
  49.  
  50.      o  ANSI-C Compiler: 
  51.  
  52.         Make sure you have an ANSI-C compiler installed. The GNU C compiler
  53.         (GCC) from the Free Software Foundation (FSF) is recommended (version
  54.         2.7.2 is fine). If you don't have GCC then at least make sure your
  55.         vendors compiler is ANSI compliant. You can find the homepage of GNU
  56.         at http://www.gnu.org/ and the GCC distribution under
  57.         http://www.gnu.org/order/ftp.html .
  58.  
  59.      o  Perl 5 Interpreter [OPTIONAL]:
  60.  
  61.         For some of the support scripts like `apxs' or `dbmmanage' (which are
  62.         written in Perl) the Perl 5 interpreter is required (versions 5.003
  63.         and 5.004 are fine). If no such interpreter is found by APACI's
  64.         `configure' script this is no harm.  Of course, you still can build
  65.         and install Apache 1.3. Only those support scripts cannot be used. If
  66.         you have multiple Perl interpreters installed (perhaps a Perl 4 from
  67.         the vendor and a Perl 5 from your own), then it is recommended to use
  68.         the --with-perl option (see below) to make sure the correct one is
  69.         selected by APACI.
  70.  
  71.      o  Dynamic Shared Object (DSO) support [OPTIONAL]:
  72.  
  73.         To provide maximum flexibility Apache now is able to load modules
  74.         under runtime via the DSO mechanism by using the pragmatic
  75.         dlopen()/dlsym() system calls. These system calls are not available
  76.         under all operating systems therefore you cannot use the DSO mechanism
  77.         on all platforms. And Apache currently has only limited built-in
  78.         knowledge on how to compile shared objects because this is heavily
  79.         platform-dependent. The current state is this:
  80.  
  81.         o Out-of-the-box supported platforms are:
  82.            - Linux     - SunOS         - UnixWare     - Mac OS X Server
  83.            - FreeBSD   - Solaris       - AIX          - Mac OS
  84.            - OpenBSD   - IRIX          - SCO          - OpenStep/Mach
  85.            - NetBSD    - HPUX          - ReliantUNIX  - DYNIX/ptx
  86.            - BSDI      - Digital Unix  - DGUX
  87.  
  88.         o Entirely unsupported platforms are:
  89.            - Ultrix
  90.  
  91.         If your system is not on these lists but has the dlopen-style
  92.         interface, you either have to provide the appropriate compiler and
  93.         linker flags (see CFLAGS_SHLIB, LDFLAGS_SHLIB and LDFLAGS_SHLIB_EXPORT
  94.         below) manually or at least make sure a Perl 5 interpreter is
  95.         installed from which Apache can guess the options.
  96.  
  97.         For more in-depth information about DSO support in Apache 1.3 please
  98.         read the document htdocs/manual/dso.html carefully. Especially the
  99.         section entitled "Advantages & Disadvantages" because using the DSO
  100.         mechanism can have strange side-effects if you are not carefully. BE
  101.         WARNED!
  102.  
  103.   3. Configuring the source tree
  104.      ---------------------------
  105.  
  106.      NOTE: Although we'll often advise you to read the src/Configuration.tmpl
  107.            file parts to better understand the various options in this
  108.            section, there is _AT NO TIME_ any need to _EDIT_ this file. The
  109.            _COMPLETE_ configuration takes place via command line arguments and
  110.            local shell variables for the ./configure script. The
  111.            src/Configuration.tmpl file is just a _READ-ONLY_ resource, here.
  112.  
  113.      Introduction:
  114.  
  115.      The next step is to configure the Apache source tree for your particular
  116.      platform and personal requirements. The most important setup here is the
  117.      location prefix where Apache is to be installed later, because Apache has
  118.      to be configured for this location to work correctly. But there are a lot
  119.      of other options available for your pleasure.
  120.  
  121.      For a short impression of what possibilities you have, here is a typical
  122.      example which compiles Apache for the installation tree /sw/pkg/apache
  123.      with a particular compiler and flags plus the two additional modules
  124.      mod_rewrite and mod_proxy for later loading through the DSO mechanism: 
  125.  
  126.      $ CC="pgcc" OPTIM="-O2" \
  127.        ./configure --prefix=/sw/pkg/apache \
  128.                    --enable-module=rewrite --enable-shared=rewrite \
  129.                    --enable-module=proxy   --enable-shared=proxy
  130.  
  131.      The complete reference of all configuration possibilities follows. For
  132.      more real-life configuration examples please check out the file
  133.      README.configure.
  134.  
  135.      Reference:
  136.  
  137.      $ [CC=...]        [CFLAGS_SHLIB=...]           [TARGET=...]
  138.        [OPTIM=...]     [LD_SHLIB=...]
  139.        [CFLAGS=...]    [LDFLAGS_SHLIB=...]        
  140.        [INCLUDES=...]  [LDFLAGS_SHLIB_EXPORT=...] 
  141.        [LDFLAGS=...]   [RANLIB=...]  
  142.        [LIBS=...]      [DEPS=...]
  143.        ./configure
  144.            [--quiet]         [--prefix=DIR]            [--enable-rule=NAME]    
  145.            [--verbose]       [--exec-prefix=PREFIX]    [--disable-rule=NAME]   
  146.            [--shadow[=DIR]]  [--bindir=EPREFIX]        [--add-module=FILE]     
  147.            [--show-layout]   [--sbindir=DIR]           [--activate-module=FILE]
  148.            [--help]          [--libexecdir=DIR]        [--enable-module=NAME]  
  149.                              [--mandir=DIR]            [--disable-module=NAME] 
  150.                              [--sysconfdir=DIR]        [--enable-shared=NAME]  
  151.                              [--datadir=DIR]           [--disable-shared=NAME] 
  152.                              [--includedir=DIR]        [--permute-module=N1:N2]
  153.                              [--localstatedir=DIR]
  154.                              [--runtimedir=DIR]        [--enable-suexec]
  155.                              [--logfiledir=DIR]        [--suexec-caller=UID]
  156.                              [--proxycachedir=DIR]     [--suexec-docroot=DIR]
  157.                              [--with-layout=[FILE:]ID] [--suexec-logfile=FILE]
  158.                                                        [--suexec-userdir=DIR]
  159.                              [--with-perl=FILE]        [--suexec-uidmin=UID]
  160.                              [--without-support]       [--suexec-gidmin=GID]
  161.                              [--without-confadjust]    [--suexec-safepath=PATH]
  162.                              [--without-execstrip]
  163.  
  164.      Use the CC, OPTIM, CFLAGS, INCLUDES, LDFLAGS, LIBS, CFLAGS_SHLIB,
  165.      LD_SHLIB, LDFLAGS_SHLIB, LDFLAGS_SHLIB_EXPORT, RANLIB, DEPS and TARGET
  166.      environment variables to override the corresponding default entries in
  167.      the src/Configuration.tmpl file (see there for more information about
  168.      their usage).
  169.  
  170.          Note: The syntax ``KEY=VALUE ./configure ...'' (one single line!) is
  171.                the GNU Autoconf compatible way of specifying defines and can
  172.                be used with Bourne shell compatible shells only (sh, bash,
  173.                ksh). If you use a different type of shell either use ``env
  174.                KEY=VALUE ./configure ...'' when the `env' command is available
  175.                on your system or use ``setenv KEY VALUE; ./configure ...'' if
  176.                you use one of the C-shell variants (csh, tcsh).
  177.  
  178.          Note: The above parameter names are the canonical ones used in
  179.                Autoconf-style interfaces. But because src/Configuration.tmpl
  180.                uses the prefix EXTRA_ for some variables (e.g. EXTRA_CFLAGS)
  181.                these variants are accepted for backward-compatibility reasons,
  182.                too. But please use the canonical Autoconf-style names and
  183.                don't rely on this.
  184.  
  185.      Use the --prefix=PREFIX and --exec-prefix=EPREFIX options to configure
  186.      Apache to use a particular installation prefix. The default is
  187.      PREFIX=/usr/local/apache and EPREFIX=PREFIX.
  188.  
  189.      Use the --bindir=DIR, --sbindir=DIR, --libexecdir=DIR, --mandir=DIR,
  190.      --sysconfdir=DIR, --datadir=DIR, --includedir=DIR, --localstatedir=DIR,
  191.      --runtimedir=DIR, --logfiledir=DIR and proxycachedir=DIR option to change
  192.      the paths for particular subdirectories of the installation tree.
  193.      Defaults are bindir=EPREFIX/bin, sbindir=EPREFIX/sbin,
  194.      libexecdir=EPREFIX/libexec, mandir=PREFIX/man, sysconfdir=PREFIX/etc,
  195.      datadir=PREFIX/share, includedir=PREFIX/include,
  196.      localstatedir=PREFIX/var, runtimedir=PREFIX/var/run,
  197.      logfiledir=PREFIX/var/log and proxycachedir=PREFIX/var/proxy.
  198.  
  199.          Note: To reduce the pollution of shared installation locations
  200.                (like /usr/local/ or /etc) with Apache files to a minimum the
  201.                string ``/apache'' is automatically appended to 'libexecdir',
  202.                'sysconfdir', 'datadir', 'localstatedir' and 'includedir' if
  203.                (and only if) the following points apply for each path
  204.                individually:
  205.  
  206.                    1. the path doesn't already contain the word ``apache''
  207.                    2. the path was not directly customized by the user
  208.  
  209.                Keep in mind that per default these paths are derived from
  210.                'prefix' and 'exec-prefix', so usually its only a matter
  211.                whether these paths contain ``apache'' or not. Although the
  212.                defaults were defined with experience in mind you always should
  213.                make sure the paths fit your situation by checking the finally
  214.                chosen paths via the --layout option.
  215.  
  216.      Use the --with-layout=[F:]ID option to select a particular installation
  217.      path base-layout. You always _HAVE_ to select a base-layout. There are
  218.      currently two layouts pre-defined in the file config.layout: `Apache' for
  219.      the classical Apache path layout and `GNU' for a path layout conforming
  220.      to the GNU `standards' document. When you want to use your own custom
  221.      layout FOO, either add a corresponding "<Layout FOO>...</Layout>" section
  222.      to config.layout and use --with-layout=FOO or place it into your own
  223.      file, say config.mypaths, and use --with-layout=config.mypaths:FOO.
  224.  
  225.      Use the --show-layout option to check the final installation path layout
  226.      while fiddling with the options above.
  227.  
  228.      Use the --enable-rule=NAME and --disable-rule=NAME options to enable or
  229.      disable a particular Rule from the Apache src/Configuration.tmpl file. The
  230.      defaults (yes=enabled, no=disabled) can either be seen when running
  231.      `./configure --help' or manually looked up in the src/Configuration.tmpl
  232.      file.
  233.  
  234.      Use the --add-module=FILE option to copy a module source file to the
  235.      Apache src/modules/extra/ directory and on-the-fly add an entry for it in
  236.      the configuration file. FILE has to be a valid path to a C source file
  237.      outside the Apache source tree, for instance /path/to/mod_foo.c. The added
  238.      module this is way is automatically activated and enabled. Use this option
  239.      to automatically include a simple third-party module to the Apache build
  240.      process.
  241.  
  242.      Use the --activate-module=FILE option to add an entry for an existing
  243.      module source file into the configuration file on-the-fly. FILE has to be
  244.      a valid path beginning with "src/modules/", and the file has to have been
  245.      copied to this location in the Apache source tree before running
  246.      configure.  The module is automatically enabled. Use this option to
  247.      automatically include a complex third-party module to the Apache build
  248.      process where, for instance a module like mod_perl or mod_php3 consisting
  249.      of more than one file which are created by a third-party configuration
  250.      scheme.
  251.  
  252.      Use the --enable-module=NAME and --disable-module=NAME options to enable
  253.      or disable a particular already distributed module from the Apache
  254.      src/Configuration.tmpl file. The correct module names (no `mod_' prefix!)
  255.      and defaults (yes=enabled, no=disabled) can be seen when running
  256.      `./configure --help'.  There are two special NAME variants: `all' for
  257.      enabling or disabling all modules and `most' for enabling or disabling
  258.      only these modules which are useable on all platforms (currently this is
  259.      `all' minus the modules `auth_db', `log_agent', `log_referer', `example',
  260.      `so' and `mmap_static'). For a compact overview of available modules see
  261.      the following list (remove the `mod_' prefix to get the NAME).
  262.  
  263.      _________________________________________________________________________
  264.      LIST OF AVAILABLE MODULES
  265.  
  266.      Environment creation
  267.       (+) mod_env .......... Set environment variables for CGI/SSI scripts
  268.       (+) mod_setenvif ..... Set environment variables based on HTTP headers
  269.       (-) mod_unique_id .... Generate unique identifiers for request
  270.      Content type decisions
  271.       (+) mod_mime ......... Content type/encoding determination (configured)
  272.       (-) mod_mime_magic ... Content type/encoding determination (automatic)
  273.       (+) mod_negotiation .. Content selection based on the HTTP Accept* headers
  274.      URL mapping
  275.       (+) mod_alias ........ Simple   URL translation and redirection
  276.       (-) mod_rewrite ...... Advanced URL translation and redirection
  277.       (+) mod_userdir ...... Selection of resource directories by username
  278.       (-) mod_speling ...... Correction of misspelled URLs
  279.      Directory Handling
  280.       (+) mod_dir .......... Directory and directory default file handling
  281.       (+) mod_autoindex .... Automated directory index file generation
  282.      Access Control
  283.       (+) mod_access ....... Access Control (user, host, network)
  284.       (+) mod_auth ......... HTTP Basic Authentication (user, passwd)
  285.       (-) mod_auth_dbm ..... HTTP Basic Authentication via Unix NDBM files
  286.       (-) mod_auth_db ...... HTTP Basic Authentication via Berkeley-DB files
  287.       (-) mod_auth_anon .... HTTP Basic Authentication for Anonymous-style users
  288.       (-) mod_digest ....... HTTP Digest Authentication
  289.      HTTP response
  290.       (-) mod_headers ...... Arbitrary HTTP response headers (configured)
  291.       (-) mod_cern_meta .... Arbitrary HTTP response headers (CERN-style files)
  292.       (-) mod_expires ...... Expires HTTP responses 
  293.       (+) mod_asis ......... Raw HTTP responses 
  294.      Scripting
  295.       (+) mod_include ...... Server Side Includes (SSI) support
  296.       (+) mod_cgi .......... Common Gateway Interface (CGI) support
  297.       (+) mod_actions ...... Map CGI scripts to act as internal `handlers'
  298.      Internal Content Handlers
  299.       (+) mod_status ....... Content handler for server run-time status
  300.       (-) mod_info ......... Content handler for server configuration summary
  301.      Request Logging
  302.       (+) mod_log_config ... Customizable logging of requests
  303.       (-) mod_log_agent .... Specialized HTTP User-Agent logging (deprecated)
  304.       (-) mod_log_refer .... Specialized HTTP Referrer logging   (deprecated)
  305.       (-) mod_usertrack .... Logging of user click-trails via HTTP Cookies
  306.      Miscellaneous
  307.       (+) mod_imap ......... Server-side Image Map support
  308.       (-) mod_proxy ........ Caching Proxy Module (HTTP, HTTPS, FTP)
  309.       (-) mod_so ........... Dynamic Shared Object (DSO) bootstrapping
  310.      Experimental
  311.       (-) mod_mmap_static .. Caching of frequently served pages via mmap()
  312.      Development
  313.       (-) mod_example ...... Apache API demonstration (developers only)
  314.      _________________________________________________________________________
  315.                     (+) = enabled  per default [disable with --disable-module]
  316.                     (-) = disabled per default [enable  with --enable-module ]
  317.  
  318.  
  319.      Use the --enable-shared=NAME and --disable-shared=NAME options to enable
  320.      or disable the shared object support for a particular module from the
  321.      Apache src/Configuration.tmpl file. The defaults (yes=enabled,
  322.      no=disabled) can be seen when running `./configure --help'. There are two
  323.      special NAME variants: `max' for enabling or disabling DSO on all modules
  324.      except the bootstrapping `so' module and `remain' for enabling or
  325.      disabling DSO for only those modules which are still not enabled (which
  326.      this way implicitly enables them itself). 
  327.      
  328.          Note 1: The --enable-shared option DOES NOT AUTOMATICALLY enable the
  329.                  module because there are variants like `--enable-shared=max'
  330.                  which should not imply `--enable-module=all'.  
  331.  
  332.          Note 2: Per default the DSO mechanism is globally disabled, i.e. no
  333.                  modules are build as shared objects.
  334.  
  335.          Note 3: The usage of any --enable-shared option automatically implies
  336.                  a --enable-module=so option because the bootstrapping module
  337.                  mod_so is always needed for DSO support.
  338.  
  339.          Note 4: When you later want to extend your Apache installation via
  340.                  third-party modules through the DSO+APXS mechanism make sure
  341.                  that you at least compile with mod_so included, even when no
  342.                  distributed modules are build as shared objects. This can be
  343.                  achieved by explicitly using --enable-module=so.
  344.  
  345.          Note 5: Some platforms require --enable-rule=SHARED_CORE for
  346.                  the DSO mechanism to work, i.e. when you want to use
  347.                  --enable-shared for some modules on these platforms you also
  348.                  have to enable the SHARED_CORE rule. For more details please
  349.                  read the document `htdocs/manual/dso.html'.
  350.  
  351.      Use the --permute-module=N1:N2 option to permutate the AddModule lines of
  352.      modules mod_N1 and mod_N2 in the Configuration file. This way one can
  353.      give modules different priorities.  Two special and important variants
  354.      are supported for the option argument: first BEGIN:N which permutes
  355.      module mod_N with the begin of the module list, i.e. it `moves' the
  356.      module to the begin of the list (gives it lowest priority).  And second
  357.      N:END which permutes mod_N with the end of the module list, i.e. it
  358.      `moves' the module to the end of the list (gives it highest priority).
  359.  
  360.      Use the --with-perl=FILE option to select a particular Perl interpreter
  361.      executable to be used with Apache. Per default APACI tries to find it
  362.      automatically. But if multiple Perl instances exist on your system you
  363.      have to select the correct one manually.
  364.  
  365.      Use the --without-support option to explicitly disable the build and
  366.      installation of support tools from the src/support/ area. This can be
  367.      useful when you have compilation problems with one or more of these not
  368.      programs on your platform or if you just don't need them.
  369.  
  370.      Use the --without-confadjust option to explicitly disable some built
  371.      user/situation dependent adjustments to the config files (Group, Port,
  372.      ServerAdmin, ServerName, etc.).  This is usually only interesting for
  373.      vendor package maintainers who wants to force the keeping of defaults.
  374.  
  375.      Use the --without-execstrip option to disable the stripping of
  376.      executables on installation. This can be important on some platforms in
  377.      combination with --enable-rule=SHARED_CORE or when Apache was built with
  378.      debugging symbols which shouldn't be lost.
  379.  
  380.      Use the --enable-suexec option to enable the suEXEC feature by building
  381.      and installing the "suexec" support program. Use --suexec-caller=UID to
  382.      set the allowed caller user id, --suexec-userdir=DIR to set the user
  383.      subdirectory, --suexec-docroot=DIR to set the suexec root directory,
  384.      --suexec-uidmin=UID/--suexec-gidmin=GID to set the minimal allowed
  385.      UID/GID, --suexec-logfile=FILE to set the logfile and
  386.      --suexec-safepath=PATH to set the safe shell PATH for the suEXEC
  387.      feature. At least one --suexec-xxxxx option has to be provided together
  388.      with the --enable-suexec option to let APACI accept your request for
  389.      using the suEXEC feature.
  390.  
  391.      CAUTION: FOR DETAILS ABOUT THE SUEXEC FEATURE WE HIGHLY RECOMMEND YOU TO
  392.               FIRST READ THE DOCUMENT htdocs/manual/suexec.html BEFORE USING
  393.               THE ABOVE OPTIONS.
  394.      
  395.               USING THE SUEXEC FEATURE PROPERLY CAN REDUCE CONSIDERABLY THE
  396.               SECURITY RISKS INVOLVED WITH ALLOWING USERS TO DEVELOP AND RUN
  397.               PRIVATE CGI OR SSI PROGRAMS. HOWEVER, IF SUEXEC IS IMPROPERLY
  398.               CONFIGURED, IT CAN CAUSE ANY NUMBER OF PROBLEMS AND POSSIBLY
  399.               CREATE NEW HOLES IN YOUR COMPUTER'S SECURITY.  IF YOU AREN'T
  400.               FAMILIAR WITH MANAGING SETUID ROOT PROGRAMS AND THE SECURITY
  401.               ISSUES THEY PRESENT, WE HIGHLY RECOMMEND THAT YOU NOT CONSIDER
  402.               USING SUEXEC AND KEEP AWAY FROM THESE OPTIONS!
  403.  
  404.      Use the --shadow option to let APACI create a shadow source tree of the
  405.      sources for building. This is useful when you want to build for different
  406.      platforms in parallel (usually through a NFS, AFS or DFS mounted
  407.      filesystem).  You may specify a directory to the --shadow option into
  408.      which the shadow tree will be created.
  409.  
  410.      Use the --quiet option to disable all configuration verbose messages.
  411.  
  412.      Use the --verbose option to enable additional verbose messages.
  413.      
  414.   4. Building the package
  415.      --------------------
  416.      
  417.      Now you can build the various parts which form the Apache package by
  418.      simply running the command
  419.  
  420.         $ make 
  421.  
  422.      Please be patient here, this takes approximately 2 minutes to complete
  423.      under a Pentium-166/FreeBSD-2.2 system, dependend on the amount of
  424.      modules you have enabled. 
  425.  
  426.   5. Installing the package
  427.      ----------------------
  428.      
  429.      Now its time to install the package under the configured installation
  430.      PREFIX (see --prefix option above) by running:
  431.  
  432.         $ make install
  433.  
  434.      For the paranoid hackers under us: The above command really installs under
  435.      prefix _only_, i.e. no other stuff from your system is touched. Even if
  436.      you upgrade an existing installation your configuration files in
  437.      PREFIX/etc/ are preserved.
  438.  
  439.      Note for package authors:
  440.  
  441.      To simplify rolling a package tarball from the installed files APACI
  442.      provides a way to override the installation root for the install step.
  443.      Additionally you can get rid of the user message at the end of the
  444.      installation process by using the `install-quiet' target. Example:
  445.  
  446.          $ make install-quiet root=/tmp/apache-root
  447.  
  448.      Notes for specific platforms:
  449.  
  450.      NOTE: Please note that for re-installing Apache on AIX you should use the
  451.            command `slibclean' before using `make install' to really unload
  452.            any old versions of the DSO's that might still be cached by the
  453.            dynamic loader.  
  454.  
  455.   6. Testing the package
  456.      -------------------
  457.  
  458.      Now you can fire up your Apache HTTP server by immediately running
  459.  
  460.         $ PREFIX/bin/apachectl start
  461.  
  462.      and then you should be able to request your first document via URL
  463.      http://localhost/ (when you built and installed Apache as root or at
  464.      least used the --without-confadjust option) or http://localhost:8080/
  465.      (when you built and installed Apache as a regular user). Then stop the
  466.      server again by running: 
  467.  
  468.         $ PREFIX/bin/apachectl stop
  469.  
  470.   7. Customizing the package
  471.      -----------------------
  472.  
  473.      Finally you can customize your Apache HTTP server by editing the
  474.      configuration files under PREFIX/etc/.
  475.  
  476.         $ vi PREFIX/etc/httpd.conf
  477.         $ vi PREFIX/etc/access.conf
  478.         $ vi PREFIX/etc/srm.conf
  479.  
  480.      Have a look at the Apache manual under htdocs/manual/ or
  481.      http://www.apache.org/docs/ for a complete reference of available
  482.      configuration directives.
  483.  
  484.   8. Preparing the system
  485.      --------------------
  486.  
  487.      Proper operation of a public HTTP server requires at least the following:
  488.  
  489.      1. A correctly working TCP/IP layer, since HTTP is implemented on top of
  490.         TCP/IP. Although modern Unix platforms have good networking layers,
  491.         always make sure you have all official vendor patches referring to the
  492.         network layer applied.
  493.  
  494.      2. Accurate time keeping, since elements of the HTTP protocol are
  495.         expressed as the time of day.  So, it's time to investigate setting
  496.         some time synchronization facility on your system. Usually the ntpdate
  497.         or xntpd programs are used for this purpose which are based on the
  498.         Network Time Protocol (NTP). See the Usenet newsgroup
  499.         comp.protocols.time.ntp and the NTP homepage at
  500.         http://www.eecis.udel.edu/~ntp/ for more details about NTP software
  501.         and public time servers.
  502.  
  503.   9. Contacts
  504.      --------
  505.  
  506.      o If you want to be informed about new code releases, bug fixes, 
  507.        security fixes, general news and information about the Apache server
  508.        subscribe to the apache-announce mailing list as described under
  509.        http://www.apache.org/announcelist.html
  510.  
  511.      o If you want freely available support for running Apache please join the
  512.        Apache user community by subscribing at least to the following USENET
  513.        newsgroup:
  514.        comp.infosystems.www.servers.unix
  515.  
  516.      o If you want commercial support for running Apache please contact
  517.        one of the companies and contractors which are listed at
  518.        http://www.apache.org/info/support.cgi
  519.  
  520.      o If you have a concrete bug report for Apache please go to the
  521.        Apache Group Bug Database and submit your report:
  522.        http://www.apache.org/bug_report.html
  523.  
  524.      o If you want to participate in actively developing Apache please
  525.        subscribe to the `new-httpd' mailing list as described at
  526.        http://dev.apache.org/mailing-lists
  527.  
  528.      Thanks for running Apache.
  529.                                           The Apache Group
  530.                                           http://www.apache.org/
  531.  
  532.