This manual page is for Mac OS X Server version 10.6

Reading manual pages

apache1_config_helper(8)                 BSD System Manager's Manual                apache1_config_helper(8)

NAME
     apache1_config_helper -- Mac OS X Server Apache 1.3 -> 2.2 config translation tool

SYNOPSIS
     apache1_config_helper [apache1-source-dir] apache2-destination-dir


DESCRIPTION
     apache1_config_helper is a script that assists conversion from Apache 1.3 to Apache 2.2 by translating
     Tiger Server or Leopard Server Apache 1.3 config files into SnowLeopard Server Apache 2.2 config files.

     apache1-source-dir is an optional argument; in the two-argument form this first argument specifies the
     path to an existing directory containing the Apache 1.3 config files. In the one-argument form, the
     script uses /etc/httpd/ as the apache1-source-dir.

     apache2-destination-dir is a required argument that specifies the path to a new directory that will
     contain the Apache 2.2 config files.

     The script cannot successfully translate all Apache 1.3 config files, but should at least result in a
     partially-translated Apache 2.2 configuration that can be completed manually. Even if the files are
     translated successfully, it will be necessary for the administrator to merge files from the translated
     directory into the active Apache 2.2 directory /etc/apache2.

     In addition to translating the Apache directives to the 2.2 syntax, the script makes other changes to
     config file directives for compatibility with SnowLeopard Server, including:

           •   Removing references to obsolete modules

           •   Adding directives for new modules

           •   Updating the set of mime types directives

           •   Revising the set of Include directives for wiki-related services

           •   Increasing the security level of SSL directives

           •   Recognizing Apache 1 config files that have never been customized, and substituting the
               equivalent default SnowLeopard files

EXAMPLES
     apache1_config_helper /etc/httpd/ /tmp/apache2/

           This is a common scenario after an upgrade install where Leopard Server or Tiger Server Apache
           1.3 config files are read from /etc/httpd/ and the translated files are created in /tmp/apache2

     apache1_config_helper /Volumes/Migration/private/etc/httpd/ /tmp/apache2/

           This might be the scenario when migration settings are saved on a separate volume

     apache1_config_helper /tmp/apache2/

           This is equivalent to the first example

     diff -ubr /etc/httpd/ /tmp/apache2/

           This use of a recursive diff command is recommended after running the script, to allow administa-tor administator
           tor review of the changes on a line-by-line basis.

FILES and FOLDERS
     /etc/apache2/

           main Apache 2.2 config directory for SnowLeopard

     /etc/httpd/

           Apache 1.3 config directory, only present in SnowLeopard Server if upgraded from Tiger Server or
           Leopard Server

SEE ALSO
     /etc/apache2/ReadMe.txt

Mac OS X Server                                  15 May 2009                                 Mac OS X Server