freebsd-dev/release/sysinstall/help/apache.hlp
1995-11-17 13:34:54 +00:00

52 lines
2.5 KiB
Plaintext

There are two sets of options that the Apache HTTP Server needs.
The first set covers how it operates. These are as follows:
The "HostName" field is the name of this host, as it is
reported to each client connection. Normally, the fully
qualified domain name of the host running the server is
returned. If you want this set to something else, however,
(usually "www.my.domain") then this can be entered here.
Additionally, the server needs to know how many connections
are allowed at one time - this is the "Max Connections"
field. If more than this number of clients attempt to connect
at once, the additional connections will be refused. This is
used to limit how much system load will be imposed by the HTTP
server.
The "Email Address" field is the address of the person (or
system alias) who is the administrator for this web site. In
addition to being used by the Apache Server itself, it is also
put at the bottom of the sample web page that is created.
Finally, the "Default User" and "Default Group" fields specify
what user id and group id should be used by the server for
remote connections. Local connections are kept as the UID and
GID of the local process.
The second set of options determine what information is made available
to each client:
The "Document Root Path" is the top of the tree of documents
that are made avaliable. For example, if the value is
"/usr/web", then the URL "http://www.foo.com/doc.html" would
translate as "/usr/web/doc.html".
Similarly, the "User Directory" is the location in each user's
home directory where their public web documents are
stored. Thus if the value if this is "Public", then the URL
"http://www.foo.com/~joe/doc" would translate to the path
"~joe/Public/doc".
Finally, if the URL points to a directory, there is always a
"Default Document" that Apache will use. This field holds the
name (not the path) of this document. By default, Apache uses
the file "index.html". However, some sites may be more used to
using the file "welcome.html".
There are a number of other options that can be configured with
Apache, such as path aliases, masquerading as multiple hosts, server
child process parameters, and so forth. For more information on these,
consult the Apache man pages at http://www.apache.org.