NAME

apache2zeus - Apache configuration parser and convertor


SYNOPSIS

apache2zeus [ --verbose ] [ --ignore-missing ] {command} {apache-dir} {htaccess-dir} [ vserver-regex ]


DESCRIPTION

Zeus Technology provide the apache2zeus tool to help you convert legacy apache configurations to Zeus configurations. It can convert many of the commonly used Apache directives, and can parse most apache configurations

Note that because apache modules can add their own directives to the apache configuration parser, the apache2zeus tool cannot translate all configurations. In addition, Zeus does not support all apache directives. Specify the --verbose option to see which directives the apache2zeus tool has not converted for this reason.


ACTIONS

apache2zeus has several actions, listed below:

help

The help action takes another action as its only argument, and tells you what the specified action does.

list

The list action takes an optional regular expression. It lists all the Virtual Server names that match the regular expression (or lists all the Virtual Servers by default).

process

The process action performs all processing, but does not write out the final Virtual Server configuration files.

convert

The convert action processes the configurations, and writes them out.


OPTIONS

--verbose

Specify this to see a list of all directives apache2zeus does not convert because Zeus does not support them. These include the AddIcon and AddIconByType directives.

--ignore-missing

Whilst apache2zeus is parsing your configuration files, it may come across a directive which causes it to load another file in from the disk. Under some circumstances, apache2zeus may be unable to find those files. This will cause the tool to prompt you for input. If you specify a blank line for the input form, then the tool will stop prompting you for that file.

Specify --ignore-missing to skip include-type directives for which the file cannot be found.

apache-dir

When you run apache2zeus you must specify the location of the httpd.conf, srm.conf and access.conf files. apache2zeus assumes that they are all in the same directory and so requires the name of this directory as its first mandatory argument.

htaccess-dir

apache2zeus creates configuration files for the virtual servers in $ZEUSHOME/webadmin/conf/sites/ however the global htaccess files it creates, should be located outside the docroots of the sites being served. apache2zeus therefore requires its second mandatory argument to be a directory into which it can write the global htaccess files for the Virtual Servers it generates.

vserver-regex

apache2zeus can optionally take a regular expression which it matches against all the names of the Virtual Servers in the apache configuration. If the regular expression matches, then the specified command is only performed on that Virtual Server.

For Example:

apache2zeus list . . ^www

This lists all sites, starting with the string 'www' from the apache configuration files stored in the current directory.


SEE ALSO

netscape2zeus(8)


COPYRIGHT

Copyright (C) 2000-2001 Zeus Technology Limited. All rights reserved.