CGI Programming by Collin Forbes
  Installing Calendar   Updated: Thur, 20 Apr 2000  

Download and install the CPAN perl module
It's best if you can have your system administrator install them on the main system (that way everybody can use it), but you can put the modules and their directories in one of your own directories and tell the programs where to find them.

CGI::Minimal
http://www.cpan.org/authors/id/S/SN/SNOWHARE/CGI-Minimal-1.06.tar.gz

Install the custom module
Template.pm is a custom module included with the calendar distribution. Either have your system administrator install it along with the other perl modules, or put it in one of your own directories.

Edit the calendar.cgi file
Make sure the first line of the file points to the Perl 5 executable on your web server. This is usually /usr/bin/perl or /usr/local/bin/perl, but it might be /usr/local/bin/perl5 or something else.

If you had to put the CPAN or custom modules somewhere else, edit and uncomment the 'use lib' line which tells the program where to start looking.

Set the "$default_file" variable to a filename on your system which will work as a default configuration file. Be sure to include enough of the path for the program to find the file. On some systems, you may be able to use relative paths (beginning with "../"), but you may need to use a full path starting with the root directory. This file will be used when you didn't ask for an explicit file as part of the URL.

Install calendar.cgi on your web server
Put it in a directory where you are allowed to run CGI scripts. Usually it's called cgi-bin/ but it may be different on your system. Make sure your web server knows how to run it.

On a unix server, this means setting the execute permissions on the file or associating the file extension with the perl interpreter on your Windows server. Set the execute permissions on a unix server by running "chmod 755 calendar.cgi."