We have numerous instances of Apache running on each server. Apache is installed only once. A directory structure is created for each instance of Apache which contains the bin, cgi-bin, conf, and htdocs directories. The bin directory contains a modified version of apachectl as well as an envvars file. The modified version of apachectl (included herein) determines the root directory of the instance and invokes httpd with the apropriate arguments. To start a particular server instance, you only need to run apachectl in the bin directory of the instance. The main difference between the configurations is the ServerRoot since most paths are relative to this. | /usr/local/apache |--------------| | apache01 apache02 -------------------- | | | ----------------------------- bin modules ... | | | | | conf bin htdocs cgi-bin logs -ascs [ apachectl.in ] # Copyright (c) 2000-2002 The Apache Software Foundation. # See license at the end of this file. # # Apache control script designed to allow an easy command line interface # to controlling Apache. Written by Marc Slemko, 1997/08/23 # # The exit codes returned are: # XXX this doc is no longer correct now that the interesting # XXX functions are handled by httpd # 0 - operation completed successfully # 1 - # 2 - usage error # 3 - httpd could not be started # 4 - httpd could not be stopped # 5 - httpd could not be started during a restart # 6 - httpd could not be restarted during a restart # 7 - httpd could not be restarted during a graceful restart # 8 - configuration syntax error # # When multiple arguments are given, only the error from the _last_ # one is reported. Run "apachectl help" for usage info # ARGV="$@" # invocationname="$0" [ "`basename \"$invocationname\"`" = "$invocationname" ] && script=`which "$invocationname"` [ "`echo $invocationname | sed 's/^\(\/\).*/\1/'`" = "/" ] && script="$invocationname" [ "`echo $invocationname | sed 's/^\([^\/]\).*/\1/'`" != "/" ] && script=`( cd \`dirname "$invocationname"\` ; echo "\`pwd\`/\`basename $invocationname\`" )` APACHEINST="`cd \`dirname $script\`/.. ; pwd `" # |||||||||||||||||||| START CONFIGURATION SECTION |||||||||||||||||||| # -------------------- -------------------- # # the path to your httpd binary, including options if necessary HTTPD="@exp_sbindir@/@progname@ -f $APACHEINST/conf/httpd.conf" EXTRAFLAGS="" # # pick up any necessary environment variables if test -f @exp_bindir@/envvars; then . @exp_bindir@/envvars fi if test -f "$APACHEINST"/bin/envvars; then . "$APACHEINST"/bin/envvars fi # # a command that outputs a formatted text version of the HTML at the # url given on the command line. Designed for lynx, however other # programs may work. LYNX="lynx -dump" # # the URL to your server's mod_status status page. If you do not # have one, then status and fullstatus will not work. STATUSURL="http://localhost:@PORT@/server-status" # # Set this variable to a command that increases the maximum # number of file descriptors allowed per child process. This is # critical for configurations that use many file descriptors, # such as mass vhosting, or a multithreaded server. ULIMIT_MAX_FILES="@APACHECTL_ULIMIT@" # -------------------- -------------------- # |||||||||||||||||||| END CONFIGURATION SECTION |||||||||||||||||||| # Set the maximum number of file descriptors allowed per child process. if [ "x$ULIMIT_MAX_FILES" != "x" ] ; then $ULIMIT_MAX_FILES fi ERROR=0 if [ "x$ARGV" = "x" ] ; then ARGV="-h" fi case $ARGV in start|stop|restart|graceful) $HTTPD -k $ARGV $EXTRAFLAGS ERROR=$? ;; startssl|sslstart|start-SSL) $HTTPD -k start -DSSL $EXTRAFLAGS ERROR=$? ;; configtest) $HTTPD -t -D DUMP_VHOSTS $EXTRAFLAGS ERROR=$? ;; version) $HTTPD -version ERROR=$? ;; status) if [ -f "$APACHEINST"/logs/httpd.pid -a -r "$APACHEINST"/logs/httpd.pid ] ; then case "`uname`" in Linux) kill -0 `cat "$APACHEINST"/logs/httpd.pid` \ && echo RUNNING \ && cat "$APACHEINST"/logs/httpd.pid ;; SunOS) /usr/bin/ptree `cat "$APACHEINST"/logs/httpd.pid` ;; *) echo Unknown OS \(`uname`\) ERROR=1 esac fi ;; fullstatus) $LYNX $STATUSURL ;; *) $HTTPD $ARGV $EXTRAFLAGS ERROR=$? esac exit $ERROR # ==================================================================== # The Apache Software License, Version 1.1 # # Copyright (c) 2000-2003 The Apache Software Foundation. All rights # reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in # the documentation and/or other materials provided with the # distribution. # # 3. The end-user documentation included with the redistribution, # if any, must include the following acknowledgment: # "This product includes software developed by the # Apache Software Foundation (http://www.apache.org/)." # Alternately, this acknowledgment may appear in the software itself, # if and wherever such third-party acknowledgments normally appear. # # 4. The names "Apache" and "Apache Software Foundation" must # not be used to endorse or promote products derived from this # software without prior written permission. For written # permission, please contact apache@xxxxxxxxxxx # # 5. Products derived from this software may not be called "Apache", # nor may "Apache" appear in their name, without prior written # permission of the Apache Software Foundation. # # THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED # WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES # OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE # DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR # ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF # USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, # OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT # OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # SUCH DAMAGE. # ==================================================================== # # This software consists of voluntary contributions made by many # individuals on behalf of the Apache Software Foundation. For more # information on the Apache Software Foundation, please see # <http://www.apache.org/>. # # Portions of this software are based upon public domain software # originally written at the National Center for Supercomputing Applications, # University of Illinois, Urbana-Champaign. # --------------------------------------------------------------------- The official User-To-User support forum of the Apache HTTP Server Project. See <URL:http://httpd.apache.org/userslist.html> for more info. To unsubscribe, e-mail: users-unsubscribe@xxxxxxxxxxxxxxxx " from the digest: users-digest-unsubscribe@xxxxxxxxxxxxxxxx For additional commands, e-mail: users-help@xxxxxxxxxxxxxxxx