How to: Configure Web Server Options
====================================

Purpose
-------

The following procedure explains how to configure Apache server options using
InterWorx. The most common configuration options are exposed in the InterWorx
interface. As with many of the system services, a system administrator still
retains the ability to configure the service by editing the configuration file.


Configure Web Server Options
----------------------------

#. Click the **System Services** menu item if it is not already open.
#. Click the **Web Server** menu item.
#. Locate the **Apache Server Options** section.
#. Change the option(s) you wish to update to the desired value(s).
#. Click the **Update** button.

Apache Server Options
---------------------

Max Clients
^^^^^^^^^^^

The maximum number of simultaneous requests that will be served.  Possible
values range from 1 to 20000.  `Apache docs on Max Clients directive
<http://httpd.apache.org/docs/2.0/mod/mpm_common.html#maxclients>`__

Server Limit
^^^^^^^^^^^^

The maximum configured value for the max clients directive for the lifetime of
the Apache Process. Possible values range from 1 to 20000.  `Apache docs on
Server Limit directive
<http://httpd.apache.org/docs/2.0/mod/mpm_common.html#serverlimit>`__

Start Servers
^^^^^^^^^^^^^

The number of child server process created on server startup. As the number of
processes is dynamically controlled depending on the load, there is usually
little reason to adjust this parameter. Possible values range from 1 to 20000.
`Apache docs on Start Servers directive
<http://httpd.apache.org/docs/2.0/mod/mpm_common.html#startservers>`__

Spare Servers (min)
^^^^^^^^^^^^^^^^^^^

The minimum number of idle child processes. An idle process is one which is not
handling a request. Possible values range from 1 to 20000.  `Apache docs on the
Minimum Number of Spare Servers
<http://httpd.apache.org/docs/2.0/mod/prefork.html#minspareservers>`__

Spare Servers (max)
^^^^^^^^^^^^^^^^^^^

The maximum number of idle child processes. An idle process is one which is not
handling a request. Possible values range from 1 to 20000. The spare servers
directives are used to help deal with spikes in web traffic.  `Apache docs on
the Maximum Number of Spare Servers
<http://httpd.apache.org/docs/2.0/mod/prefork.html#maxspareservers>`__

Max Requests per Server
^^^^^^^^^^^^^^^^^^^^^^^

The limit on the number of requests that an individual child server process
will handle. Setting this to 0 will allow for an unlimited number of requests
to be handled. Possible values range from 0 to 1000000.  `Apache docs on
Maximum Requests Per Child Process
<http://httpd.apache.org/docs/2.0/mod/mpm_common.html#maxrequestsperchild>`__

Timeout
^^^^^^^

The amount of time Apache will wait for any of three things:

-  The total amount of time for a GET request to be received.
-  The amount of time between receipt of TCP packets on a POST or PUT
   request.
-  The amount of time between ACKs on transmissions of TCP packets in
   responses.

`Apache docs on TimeOut directive
<http://httpd.apache.org/docs/2.0/mod/core.html#timeout>`__

Keepalive
^^^^^^^^^

Turning the Keepalive directive on will provide long-lived HTTP sessions which
allow multiple requests to be sent over the same TCP connection. In some
instances, turning keepalive on has resulted in a reduction in latency for HTML
documents containing many images.  `Apache docs on Keepalive directive
<http://httpd.apache.org/docs/2.0/mod/core.html#keepalive>`__

Keepalive Requests
^^^^^^^^^^^^^^^^^^

The number of requests allowed per connection. If this is set to 0, an ulimited
number of requests is allowed.Possible values range from 0 to 65336.  `Apache
docs on Keepalive Requests directive
<http://httpd.apache.org/docs/2.0/mod/core.html#maxkeepaliverequests>`__

Keepalive Timeout
^^^^^^^^^^^^^^^^^

The number of seconds Apache will wait for a request before closing the
connection.  `Apache docs on Keepalive Timeout directive
<http://httpd.apache.org/docs/2.0/mod/core.html#keepalivetimeout>`__ This value
will only be able to be changed if Keepalive is set to on.