Annotation of loncom/httpd.conf, revision 1.3

1.1       harris41    1: ##
                      2: ## httpd.conf -- Apache HTTP server configuration file
                      3: ##
                      4: 
                      5: # This is the main server configuration file. See URL http://www.apache.org/
                      6: # for instructions.
                      7: 
                      8: # Do NOT simply read the instructions in here without understanding
                      9: # what they do, if you are unsure consult the online docs. You have been
                     10: # warned.  
                     11: 
                     12: # Originally by Rob McCool
                     13: 
                     14: # ServerType is either inetd, or standalone.
                     15: 
                     16: ServerType standalone
                     17: 
                     18: # If you are running from inetd, go to "ServerAdmin".
                     19: 
                     20: # Port: The port the standalone listens to. For ports < 1023, you will
                     21: # need httpd to be run as root initially.
                     22: 
                     23: Port 80
                     24: 
                     25: # HostnameLookups: Log the names of clients or just their IP numbers
                     26: #   e.g.   www.apache.org (on) or 204.62.129.132 (off)
                     27: # The default is off because it'd be overall better for the net if people
                     28: # had to knowingly turn this feature on.
                     29: 
                     30: HostnameLookups off
                     31: 
                     32: # If you wish httpd to run as a different user or group, you must run
                     33: # httpd as root initially and it will switch.  
                     34: 
                     35: # User/Group: The name (or #number) of the user/group to run httpd as.
                     36: #  On SCO (ODT 3) use User nouser and Group nogroup
                     37: #  On HPUX you may not be able to use shared memory as nobody, and the
                     38: #  suggested workaround is to create a user www and use that user.
                     39: #  NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)
                     40: #  when the value of (unsigned)Group is above 60000; 
                     41: #  don't use Group nobody on these systems!
                     42: 
                     43: User www
                     44: Group users
                     45: 
                     46: # ServerAdmin: Your address, where problems with the server should be
                     47: # e-mailed.
                     48: 
                     49: ServerAdmin korte@lite.msu.edu
                     50: 
                     51: # ServerRoot: The directory the server's config, error, and log files
                     52: # are kept in.
                     53: # NOTE!  If you intend to place this on a NFS (or otherwise network)
                     54: # mounted filesystem then please read the LockFile documentation,
                     55: # you will save yourself a lot of trouble.
                     56: 
                     57: ServerRoot /etc/httpd
                     58: 
                     59: # BindAddress: You can support virtual hosts with this option. This option
                     60: # is used to tell the server which IP address to listen to. It can either
                     61: # contain "*", an IP address, or a fully qualified Internet domain name.
                     62: # See also the VirtualHost directive.
                     63: 
                     64: #BindAddress *
                     65: 
                     66: # ErrorLog: The location of the error log file. If this does not start
                     67: # with /, ServerRoot is prepended to it.
                     68: 
                     69: ErrorLog logs/error_log
                     70: 
                     71: # LogLevel: Control the number of messages logged to the error_log.
                     72: # Possible values include: debug, info, notice, warn, error, crit,
                     73: # alert, emerg.
                     74: 
                     75: LogLevel warn
                     76: 
                     77: # Dynamic Shared Object (DSO) Support
                     78: #
                     79: # To be able to use the functionality of a module which was built as a DSO you
                     80: # have to place corresponding `LoadModule' lines at this location so the
                     81: # directives contained in it are actually available _before_ they are used.
                     82: # Please read the file README.DSO in the Apache 1.3 distribution for more
                     83: # details about the DSO mechanism and run `httpd -l' for the list of already
                     84: # built-in (statically linked and thus always available) modules in your httpd
                     85: # binary.
                     86: #
                     87: # Example:
                     88: # LoadModule foo_module libexec/mod_foo.so
                     89: #
                     90: # Documentation for modules is in "/home/httpd/manual/mod" in HTML format.
                     91: 
                     92: #LoadModule mmap_static_module modules/mod_mmap_static.so
                     93: LoadModule env_module         modules/mod_env.so
                     94: LoadModule config_log_module  modules/mod_log_config.so
                     95: LoadModule agent_log_module   modules/mod_log_agent.so
                     96: LoadModule referer_log_module modules/mod_log_referer.so
                     97: #LoadModule mime_magic_module  modules/mod_mime_magic.so
                     98: LoadModule mime_module        modules/mod_mime.so
                     99: LoadModule negotiation_module modules/mod_negotiation.so
                    100: LoadModule status_module      modules/mod_status.so
                    101: LoadModule info_module        modules/mod_info.so
                    102: LoadModule includes_module    modules/mod_include.so
                    103: LoadModule autoindex_module   modules/mod_autoindex.so
                    104: LoadModule dir_module         modules/mod_dir.so
                    105: LoadModule cgi_module         modules/mod_cgi.so
                    106: LoadModule asis_module        modules/mod_asis.so
                    107: LoadModule imap_module        modules/mod_imap.so
                    108: LoadModule action_module      modules/mod_actions.so
                    109: #LoadModule speling_module     modules/mod_speling.so
                    110: LoadModule userdir_module     modules/mod_userdir.so
                    111: LoadModule proxy_module       modules/libproxy.so
                    112: LoadModule alias_module       modules/mod_alias.so
                    113: LoadModule rewrite_module     modules/mod_rewrite.so
                    114: LoadModule access_module      modules/mod_access.so
                    115: LoadModule auth_module        modules/mod_auth.so
                    116: LoadModule anon_auth_module   modules/mod_auth_anon.so
                    117: #LoadModule dbm_auth_module    modules/mod_auth_dbm.so
                    118: LoadModule db_auth_module     modules/mod_auth_db.so
                    119: LoadModule digest_module      modules/mod_digest.so
                    120: #LoadModule cern_meta_module   modules/mod_cern_meta.so
                    121: LoadModule expires_module     modules/mod_expires.so
                    122: LoadModule headers_module     modules/mod_headers.so
                    123: LoadModule usertrack_module   modules/mod_usertrack.so
                    124: #LoadModule example_module     modules/mod_example.so
                    125: #LoadModule unique_id_module   modules/mod_unique_id.so
                    126: LoadModule setenvif_module    modules/mod_setenvif.so
                    127: 
                    128: # Extra Modules
                    129: #LoadModule php_module         modules/mod_php.so
                    130: #LoadModule php3_module        modules/libphp3.so
                    131: LoadModule perl_module        modules/libperl.so
                    132: 
                    133: #  Reconstruction of the complete module list from all available modules
                    134: #  (static and shared ones) to achieve correct module execution order.
                    135: #  [WHENEVER YOU CHANGE THE LOADMODULE SECTION ABOVE UPDATE THIS, TOO]
                    136: ClearModuleList
                    137: #AddModule mod_mmap_static.c
                    138: AddModule mod_env.c
                    139: AddModule mod_log_config.c
                    140: AddModule mod_log_agent.c
                    141: AddModule mod_log_referer.c
                    142: #AddModule mod_mime_magic.c
                    143: AddModule mod_mime.c
                    144: AddModule mod_negotiation.c
                    145: AddModule mod_status.c
                    146: AddModule mod_info.c
                    147: AddModule mod_include.c
                    148: AddModule mod_autoindex.c
                    149: AddModule mod_dir.c
                    150: AddModule mod_cgi.c
                    151: AddModule mod_asis.c
                    152: AddModule mod_imap.c
                    153: AddModule mod_actions.c
                    154: #AddModule mod_speling.c
                    155: AddModule mod_userdir.c
                    156: AddModule mod_proxy.c
                    157: AddModule mod_alias.c
                    158: AddModule mod_rewrite.c
                    159: AddModule mod_access.c
                    160: AddModule mod_auth.c
                    161: AddModule mod_auth_anon.c
                    162: #AddModule mod_auth_dbm.c
                    163: AddModule mod_auth_db.c
                    164: AddModule mod_digest.c
                    165: #AddModule mod_cern_meta.c
                    166: AddModule mod_expires.c
                    167: AddModule mod_headers.c
                    168: AddModule mod_usertrack.c
                    169: #AddModule mod_example.c
                    170: #AddModule mod_unique_id.c
                    171: AddModule mod_so.c
                    172: AddModule mod_setenvif.c
                    173: 
                    174: # Extra Modules
                    175: #AddModule mod_php.c
                    176: #AddModule mod_php3.c
                    177: AddModule mod_perl.c
                    178: 
                    179: 
                    180: # The following directives define some format nicknames for use with
                    181: # a CustomLog directive (see below).
                    182: 
                    183: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
                    184: LogFormat "%h %l %u %t \"%r\" %>s %b" common
                    185: LogFormat "%{Referer}i -> %U" referer
                    186: LogFormat "%{User-agent}i" agent
                    187: 
                    188: # The location of the access logfile (Common Logfile Format).
                    189: # If this does not start with /, ServerRoot is prepended to it.
                    190: 
                    191: CustomLog logs/access_log common
                    192: 
                    193: # If you would like to have an agent and referer logfile uncomment the
                    194: # following directives.
                    195: 
                    196: #CustomLog logs/referer_log referer
                    197: #CustomLog logs/agent_log agent
                    198: 
                    199: # If you prefer a single logfile with access, agent and referer information
                    200: # (Combined Logfile Format) you can use the following directive.
                    201: 
                    202: #CustomLog logs/access_log combined
                    203: 
                    204: # PidFile: The file the server should log its pid to
                    205: PidFile /var/run/httpd.pid
                    206: 
                    207: # ScoreBoardFile: File used to store internal server process information.
                    208: # Not all architectures require this.  But if yours does (you'll know because
                    209: # this file is created when you run Apache) then you *must* ensure that
                    210: # no two invocations of Apache share the same scoreboard file.
                    211: ScoreBoardFile /var/run/httpd.scoreboard
                    212: 
                    213: # The LockFile directive sets the path to the lockfile used when Apache
                    214: # is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
                    215: # USE_FLOCK_SERIALIZED_ACCEPT. This directive should normally be left at
                    216: # its default value. The main reason for changing it is if the logs
                    217: # directory is NFS mounted, since the lockfile MUST BE STORED ON A LOCAL
                    218: # DISK. The PID of the main server process is automatically appended to
                    219: # the filename. 
                    220: #
                    221: #LockFile /var/lock/httpd.lock
                    222: 
                    223: # ServerName allows you to set a host name which is sent back to clients for
                    224: # your server if it's different than the one the program would get (i.e. use
                    225: # "www" instead of the host's real name).
                    226: #
                    227: # Note: You cannot just invent host names and hope they work. The name you 
                    228: # define here must be a valid DNS name for your host. If you don't understand
                    229: # this, ask your network administrator.
                    230: 
                    231: #ServerName new.host.name
                    232: 
                    233: # UseCanonicalName:  (new for 1.3)  With this setting turned on, whenever
                    234: # Apache needs to construct a self-referencing URL (a url that refers back
                    235: # to the server the response is coming from) it will use ServerName and
                    236: # Port to form a "canonical" name.  With this setting off, Apache will
                    237: # use the hostname:port that the client supplied, when possible.  This
                    238: # also affects SERVER_NAME and SERVER_PORT in CGIs.
                    239: UseCanonicalName on
                    240: 
                    241: # CacheNegotiatedDocs: By default, Apache sends Pragma: no-cache with each
                    242: # document that was negotiated on the basis of content. This asks proxy
                    243: # servers not to cache the document. Uncommenting the following line disables
                    244: # this behavior, and proxies will be allowed to cache the documents.
                    245: 
                    246: #CacheNegotiatedDocs
                    247: 
                    248: # Timeout: The number of seconds before receives and sends time out
                    249: 
                    250: Timeout 300
                    251: 
                    252: # KeepAlive: Whether or not to allow persistent connections (more than
                    253: # one request per connection). Set to "Off" to deactivate.
                    254: 
                    255: KeepAlive On
                    256: 
                    257: # MaxKeepAliveRequests: The maximum number of requests to allow
                    258: # during a persistent connection. Set to 0 to allow an unlimited amount.
                    259: # We reccomend you leave this number high, for maximum performance.
                    260: 
                    261: MaxKeepAliveRequests 100
                    262: 
                    263: # KeepAliveTimeout: Number of seconds to wait for the next request
                    264: 
                    265: KeepAliveTimeout 15
                    266: 
                    267: # Server-pool size regulation.  Rather than making you guess how many
                    268: # server processes you need, Apache dynamically adapts to the load it
                    269: # sees --- that is, it tries to maintain enough server processes to
                    270: # handle the current load, plus a few spare servers to handle transient
                    271: # load spikes (e.g., multiple simultaneous requests from a single
                    272: # Netscape browser).
                    273: 
                    274: # It does this by periodically checking how many servers are waiting
                    275: # for a request.  If there are fewer than MinSpareServers, it creates
                    276: # a new spare.  If there are more than MaxSpareServers, some of the
                    277: # spares die off.  These values are probably OK for most sites ---
                    278: 
                    279: MinSpareServers 8
                    280: MaxSpareServers 20
                    281: 
                    282: # Number of servers to start --- should be a reasonable ballpark figure.
                    283: 
                    284: StartServers 10
                    285: 
                    286: # Limit on total number of servers running, i.e., limit on the number
                    287: # of clients who can simultaneously connect --- if this limit is ever
                    288: # reached, clients will be LOCKED OUT, so it should NOT BE SET TOO LOW.
                    289: # It is intended mainly as a brake to keep a runaway server from taking
                    290: # Unix with it as it spirals down...
                    291: 
                    292: MaxClients 150
                    293: 
                    294: # MaxRequestsPerChild: the number of requests each child process is
                    295: #  allowed to process before the child dies.
                    296: #  The child will exit so as to avoid problems after prolonged use when
                    297: #  Apache (and maybe the libraries it uses) leak.  On most systems, this
                    298: #  isn't really needed, but a few (such as Solaris) do have notable leaks
                    299: #  in the libraries.
                    300: 
                    301: MaxRequestsPerChild 100
                    302: 
                    303: # Proxy Server directives. Uncomment the following line to
                    304: # enable the proxy server:
                    305: 
                    306: #ProxyRequests On
                    307: 
                    308: # To enable the cache as well, edit and uncomment the following lines:
                    309: 
                    310: #CacheRoot /var/cache/httpd
                    311: #CacheSize 5
                    312: #CacheGcInterval 4
                    313: #CacheMaxExpire 24
                    314: #CacheLastModifiedFactor 0.1
                    315: #CacheDefaultExpire 1
                    316: #NoCache a_domain.com another_domain.edu joes.garage_sale.com
                    317: 
                    318: # Listen: Allows you to bind Apache to specific IP addresses and/or
                    319: # ports, in addition to the default. See also the VirtualHost command
                    320: 
                    321: #Listen 3000
                    322: #Listen 12.34.56.78:80
                    323: 
                    324: # VirtualHost: Allows the daemon to respond to requests for more than one
                    325: # server address, if your server machine is configured to accept IP packets
                    326: # for multiple addresses. This can be accomplished with the ifconfig 
                    327: # alias flag, or through kernel patches like VIF.
                    328: 
                    329: # Any httpd.conf or srm.conf directive may go into a VirtualHost command.
                    330: # See also the BindAddress entry.
                    331:  
                    332: #<VirtualHost host.some_domain.com>
                    333: #ServerAdmin webmaster@host.some_domain.com
                    334: #DocumentRoot /www/docs/host.some_domain.com
                    335: #ServerName host.some_domain.com
                    336: #ErrorLog logs/host.some_domain.com-error_log
                    337: #TransferLog logs/host.some_domain.com-access_log
                    338: #</VirtualHost>
                    339: 
1.2       albertel  340: ExtendedStatus On
1.3     ! harris41  341: 
        !           342: Include conf/loncapa.conf

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>