User manual

Table Of Contents
Chapter 6 Working With Open-Source Applications 51
Starting and Stopping Web Service Using the apachectl
Script
The default way to start and stop Apache on Mac OS X Server is to use the web module
of Server Admin.
If you want to use the apachectl script to start and stop web service instead of using
Server Admin, be aware of the following behaviors:
The web performance cache is enabled by default. When web service starts, both the
main web service process (httpd) and a webperfcache process start. (The
webperfcache process serves static content from a memory cache and relays
requests to httpd when necessary.) The apachectl script that comes with Mac OS X
Server is unaware of webperfcache. So if you have not disabled the performance
cache, you also need to use the webperfcachectl script to start and stop
webperfcache.
The apachectl script does not increase the soft process limit beyond the default of
100. Server Admin raises this limit when it starts Apache. If your web server receives a
lot of traffic and relies on CGI scripts, web service may fail to run when it reaches the
soft process limit.
The apachectl script does not start Apache automatically when the server restarts.
Understanding apachectl and the Web Service Soft Process Limit
When Apache is started using the apachectl script, the soft process limit is 100, the
default limit.
When you use CGI scripts, this limit may not be high enough. In this case, you can start
web service using Server Admin, which sets the soft process limit to 2048. Alternatively,
you can type “ulimit -u 2048” before using apachectl.
Enabling Apache Rendezvous Registration
Starting with version 10.2.4 of Mac OS X and Mac OS X Server, the preinstalled Apache
1.3 web service has the capability to register sites with Rendezvous. This feature, which
allows Rendezvous-enabled browsers such as Safari to find sites by name, is
implemented using a new Apache module, mod_rendezvous_apple. This module is
different from the mod_rendezvous available from a third party. (Apache Rendezvous is
not supported on the preinstalled Apache 2 web service.)
The module mod-rendezvous_apple allows administrators to control how websites are
registered with Rendezvous. Mod_rendezvous_apple is disabled by default on
Mac OS X Server.
LL2350.book Page 51 Friday, August 22, 2003 2:32 PM