24-AUG-1999 The APACHEDEV kit is a self-extracting achive that produces this readme file and an OpenvVMS PSCI install kit. To install the kit: 1. Create a top-level directory to hold the unpacked files, e.g.: $ create dka100:[apache] The destination disk should have at least 40,000 free blocks. The directory should also be owned by the account that you will run the apache daemon as (user directive in httpd.conf). 2. Use the product command to install the kit, specifying the directory created in step 1 as the desitionation, e.g.: $ product install apachedev/destination=dka100:[apache] Note: If you omit the /destination qualifier, sys$common:[000000] will be used as the destination. After installation, the destination directory will contain the following files: unpack_dist.log Log file of upack operations performed during the installation process. Check this files for error messages. [.apache_1_3_9] Top level directory for apache 1.3.9. This directory equates to apache_root:[000000]. [.apache_1_3_9]apache_daemon.com Main command procedure for running the apache server image. See below for usage. [.apache_1_3_9]apache_httpd.exe_alpha Server executable. [.apache_1_3_9]apache_privileged.exe_alpha User system service that apache_httpd calls to create privileged sockets and lookup username login directories. This image will be installed with the /protected qualifier. [.apache_1_3_9.conf]*.* Configuration files read by server. [.apache_1_3_9.logs] Directory to hold log files. [.apache_1_3_9.src...]*.* Program source files. [.apache_1_3_9.src.os.openvms]setup.com Defines process environment so you can re-build apache from the MMS description file or build_apache_httpd.com. [.apache_1_3_9.src.os.openvms]descrip.mms MMS description file for building apache images. File assumes process has invoked setup.com. [.apache_1_3_9.src.os.openvms]build_apache_httpd.com Alternative procedure for building apache if MMS not available. The primary interface for running the server is the APACHE_DAEMON.COM command procedure. It performs 1 of 4 major functions, determined by the value of parameter P1. Some functions take additional arguments. RUN [options...] Runs the apache_httpd program interactively, used primarily for testing the server. Parameters P2 through P8 can specify command line options that will be given to apache_httpd: -f file : specify an alternate ServerConfigFile -C "directive" : process directive before reading config files -c "directive" : process directive after reading config files -v : show version number -V : show compile settings -h : list available command line options (this page) -l : list compiled-in modules -L : list available configuration directives -S : show parsed settings (currently only vhost settings) -t : run syntax check for config files -T : run syntax check for config files Note: The procedure quotes the parameters, so flags will be upper cased unless surrounded by double quotes (i.e. -v will show compile setting and "-v" will show version number). STARTUP [SYSTEM [quota-overrides]] Runs the apache_httpd program in a detached process. If P2 is SYSTEM, images will be installed and system-wide logicals for APACHE_ROOT and APACHE_PLV_ENABLE will be defined. The UIC of the created process is determined by the user directive in the apache_root:[conf]httpd.conf configuration (username specified must have a matching rights identifier). The process quotas for the created process are copied from the current process (not the SYSUAF). P3 may specify a comma-separated list of keyword=value pairs for overriding quota settings: ast_limit, buffer_limit, enqueue_limit, wsetent, wslimit, wsquota, file_limit, bufio, dirio, page_file, queue_limit. subprocess_limit SHUTDOWN RESTART Runs the apache_kill program to send either a shutdown (sigterm) or restart (sighup) signal to the detached process. The process ID signalled is determined by reading apache_root:[logs]httpd.pid. Apache_kill performs a sanity check and only signals the process if the image it is running is apache_httpd. --------------------------------------------------------------------------------