Installation Instructions for CVS Monitor 0.6.3
-----------------------------------------------

1. Download into cgi-bin directory
2. Untar the tarball
3. Execute the setup.pl script in a web browser

setup.pl will guide you through the rest of the install.

See http://ali.as/devel/cvsmonitor/installing.html for more information.





Platform Specific Issues
------------------------

- SOLARIS

  Some installations of Solaris use an uncommon path to perl. That is, they
  DON'T use the standard /usr/bin/perl location.
  
  When installing on Solaris, please check ( and fix if required ) the paths
  of the first line ( "shebang line" ) of the three .pl files in the 
  cvsmonitor directory. This includes setup.pl, and this fix should be made
  BEFORE you run the setup.pl script to set up the remainder of the 
  application.

- DEBIAN LINUX ( AND SOME OTHER UNIXES )

  Unless you have the cache directories /var/cache/httpd or /var/cache/apache,
  CVS Monitor will use /tmp by default as the base path to create it's 
  working directory.
  
  Debian and some other *NIX type operating systems erase /tmp on boot. You 
  will need to create a directory somewhere that CVS Monitor can use as a 
  working directory. It needs to be writable by the web user.





Upgrading from CVS Monitor 0.6.2
--------------------------------

CVS Monitor 0.6.3 breaks compatibility for all files contained within the
cvsmonitor directory. Remove the cvsmonitor directory completely before
untarring the new version.

It is recommended, but not required, that you remove the working directory
as well. The majority of the working directory structure is compatible
between 0.6.2 and 0.6.3, but unknown errors may occur. Unless checking 
a repository out fresh will cause you a significant problem, just remove
it and install again.

If checkout out again would create a significant hassle, you should use the
same working directory, but do a full "Repository Update" on each repository,
to ensure that any minor changes are populated into the metadata structure.
