XHier Package =odyssey-3_apache

The odyssey-3_apache carries configuration and data for our Apache 2 installations.

Configuration (…/config)

This contains configuration information for Apache 2. There is some shared configuration, with extensive regional configuration and a space for admin configuration. Details at OdysseyApplications3ApacheConfig.

Data (…/data)

This contains the document roots and shared files for the UW CLF implementation. Details at OdysseyApplications3ApacheData.

Export (…/export)

This contains a passwd and a group file defining users www-data and www-logs and their associated user groups. The uids and gids are registered in the idregistry.

Logs (…/logs)

Apache logs go in here (rather than the usual /var/log/apache2). We use Apache's reliable piped logging feature (http://httpd.apache.org/docs/2.2/logs.html#piped). This is a regional directory in order to allow logs to be seen from any host within the region. All logs are placed in a directory named using hostname to avoid conflicts in the event of multiple servers within the region serving the same virtual hostnames. The access log and the error log for errors not associated with a specific virtual host go directly in the per-hostname directory. Errors associated with a specific virtual host go in a subdirectory named for the virtual hostname.

Maintenance Commands (=…/maintenance)

At present there are just two maintenance commands:

• usefake — Switches the CLF menu to use "fake" menus, a fixed menu per virtual hostname.
• usereal — Switch back to using the menu application to generate the menus.

Manual Maintenance

A recipe for enabling a new Apache module in odyssey-3_apache may be found at OdysseyApplications3ApacheMod.

Server Commands (…/servers)

At present the only server command is:

• rotatelogs — Wrapper for the Apache rotatelogs command. This wrapper ensures the proper directory exists, expands the short version of the log file name used in the server config to the complete filename, and changes user to www-logs before passing to Apache rotatelogs with appropriate parameters.

In addition, the file source is meant to be sourced by shell scripts in this package in order to set variables appropriately.

-- IsaacMorland - 08 Oct 2008