apache2zeus
Migration from Apache installations to Zeus
Overview
apache2zeus is a tool that can help you migrate from Apache web servers to Zeus, by automatically generating Zeus configuration files based on a running Apache server configuration. The program can automatically detect and configure many Apache configuration directives, making the migration work easier.Usage
The apache2zeus program can be found on the Administration server machine at $ZEUSHOME/webadmin/bin/apache2zeus.To run the tool, you need read access to the Apache httpd.conf and associated files, and write access to the Zeus installation directory. The simplest way to do this is to run the script as the user that owns the Zeus Web Server installation (usually 'root').
To run apache2zeus simply specify the Apache configuration directory, a directory for apache2zeus to put global htaccess files into and an optional regular expression to match the Virtual Servers that you wish to convert. For example:
$ apache2zeus convert /etc/httpd/conf/ /etc/httpd/globalhtaccess/ ^www
The above command translates the Apache configuration from /etc/httpd/conf/ and puts the global htaccess files created into /etc/httpd/globalhtaccess/. The ^www means that apache2zeus only converts Virtual Servers whose names begin with 'www'.
Use the --verbose option to see a list of directives that apache2zeus was not able to convert.
For Example:$ apache2zeus --verbose convert /etc/httpd/conf/ /etc/httpd/globalhtaccess ^www Processing: `ServerSignature On` WARN: Zeus always passes the signature Processing: `IndexOptions FancyIndexing` WARN: Zeus only has one form of dirlist Creating /usr/local/zeus/webadmin/conf/sites/www.mysite.co.uk NOTE:) These will not necessarly provide all the functionality of your old servers. The Virtual Servers should be tested and not used as drop-in replacements for live sites. $Once the script is finished, you can review the generated configuration using the Administration server. Then start each converted Virtual Server to check its configuration is correct.Migration Capabilities
apache2zeus can migrate most simple Apache configurations. Some of the more important directives supported are listed below:
- Virtual Server definition and configuration.
- Virtual Server port number/name.
- Error log configuration.
- Access log configuration.
- MIME types configuration.
- CGI configuration.
- Index file configuration.
- Directory mappings.
- Many HTAccess directives, including the 'ErrorDocument' and 'Options' directives