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 trans-
lation 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 success-
fully, 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:
o Removing references to obsolete modules
o Adding directives for new modules
o Updating the set of mime types directives
o Revising the set of Include directives for wiki-related ser-
vices
o Increasing the security level of SSL directives
o Recognizing Apache 1 config files that have never been cus-
tomized, 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 administator 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
Mac OS X 10.6Server - Generated Thu Apr 15 07:12:57 CDT 2010