Name

aegis.cgi — Aegis web interface script

Synopsis

aegis.cgi

DESCRIPTION

The aegis.cgi command is used to interface between a web server and Aegis.

Installation

If you have a Web server, you may like to install the Aegis web interface. You do this by copying the aegis.cgi script from /opt/aegis/bin/aegis.cgi into your web server's cgi-bin directory. There is an aegis.cgi.i helper script, if you don't know where your web server's cgi-bin directory is.

You may prefer to use a symbolic link, as this will be more stable across Aegis upgrades. However, this requires a corresponding follow-symlinks setting in your web server's configuration file. (Use the aegis.cgi.i -s option.)

Within the aegis.cgi script, you may set the AEGIS_PATH environment variable, if you want it to be able to see more projects than just the global projects. You do this by creating a /usr/local/lib/aegis.cgi.conf file (there isn't one, by default) and setting the AEGIS_PATH environment variable in it. This is a fragment of Bourne shell script, not just the name.

Usage

Once installed, it should be possible to see the project list by following this URL:

You may need to replace localhost with the machine's exact name.

Cascading Style Sheets

The web interface uses Cascading Style Sheets. You can give the web interface a personalised look and feel, by creating stylesheets in the web server's Document Root directory. The interface will use it's default styles, then styles from a global style sheet called aedefault.css, and then styles from a project stylesheet called projectname.css (replace projectname with the name of the project).

There is an example style sheet in /opt/aegis/bin/aedefault.css which demonstrates the style elements used. This particular stylesheet is not designed to be aesthetically pleasing, but to exercise all of the elements. Using this stylesheet unmodified will give psychedelic results. Use it as a template.

COPYRIGHT

aegis version 4.22 Copyright (C) 1991-2006 Peter Miller; All rights reserved.

The aegis program comes with ABSOLUTELY NO WARRANTY; for details use the 'aegis -VERSion License' command. This is free software and you are welcome to redistribute it under certain conditions; for details use the 'aegis -VERSion License' command.

AUTHOR

Peter MillerE-Mail:millerp@canb.auug.org.au
/\/\*WWW:http://www.canb.auug.org.au/~millerp/