Cal Poly Pomona

Master Calendar - Setup Instructions

To set up your calendar for the first time, follow the instructions below:

Perl 5.001 or higher is required and is assumed to be in /usr/local/bin/perl.
Create a directory in your web server's document root (/www/calendar is one obvious choice) with two subdirectories under it called /public and /private. Your directory structure should look something like this:
```
	/www/calendar/private
	/www/calendar/public
```
Set directory permissions for /www/calendar to 755 (rwxr-xr-x) by entering:
```
	chmod 755 calendar
```
from the /www directory.
Set directory permissions for /www/calendar/public to 777 (rwxrwxrwx) by entering:
```
	chmod 777 public
```
from the /www/calendar directory.
Set directory permissions for /www/calendar/private to 755 (rwxr-xr-x) by entering:
```
	chmod 755 private
```
from the /www/calendar directory.
Edit sub GlobalVars() in cgi.pl as follows:
- $html_path is the path to your calendar-related html documents and gifs. If your web server is using an alias to point to this path, use the alias.
- $cgi_path is the path to the perl scripts in /www/calendar. (The script will automatically append /private to $cgi_path as needed.) If your web server is using an alias to point to this path, use the alias.
- $data_path is the path to the data files (filter.txt and all the monthly calendar files). In our example, this would be /www/calendar/public. Use the literal path, not an alias.
- $filename is set to $data_path/Xxx9999.txt. These are the actual calendar files that contain the events for each month. The files are named with the first three letters of the month concatenated with the appropriate four-digit year, and an extension of .txt. Do not change this variable, or your calendar will not work.
- $lockfile is set to $data_path/Xxx9999.tmp. These are temporary files created when the similarly-named calendar files are open for writing. When a calendar file is closed, the corresponding temporary file is deleted. You should never see these .tmp files in your $data_path directory, except for very short periods of time and only if someone is adding, changing, or deleting an event. Do not change this variable.
- $tempfile is the name of the temporary file used to write the calendar events (so that $filename can be used as a backup, just in case). It uses the current process id to generate a random filename, and is renamed to $filename at the end of the add/change/delete process. Do not change this variable.
- $recipient is the name of the person or office where calendar submissions are e-mailed. This variable is used in the thank-you message returned when someone submits an event, as well as on the main menu of the calendar. For example, if
```
	$recipient = "the Public Affairs Office";
```
  then the message will read "...e-mail the Public Affairs Office for assistance."
- $recipient_email is the actual e-mail address of the person who should receive the e-mailed calendar submissions. Perl 5 requires the @ sign to be escaped, so be sure to put a backslash in front of it, like this:
```
	$recipient_email = "icallaci\@csupomona.edu";
```

Copy the following files to $html_path:

	cp_logo2.gif
	readme.htm
	small_left.gif
	small_right.gif
	stopsign.gif

Copy the following files to $cgi_path:
	calendar.pl
	cgi.pl
	daily.pl
	date.pl
	maileven.pl
	mailnote.pl
	monthly.pl
	search.pl
	weekly.pl

Copy the following files to $cgi_path/private:
	addevent.pl
	addnote.pl
	filter.pl
	mvevent.pl
	mvnote.pl
	purge.pl

Set the permissions for the perl scripts in /www/calendar and /www/calendar/private to 755 (rwxr-xr-x) by entering the following command:
	chmod 755 *.pl

from within the /www/calendar and /www/calendar/private subdirectories.
Create two symlinks in /www/calendar/private that point to cgi.pl and date.pl in /www/calendar. In other words, chdir to /www/calendar/private and enter:
	ln -s /www/calendar/public/cgi.pl cgi.pl
	ln -s /www/calendar/public/date.pl date.pl

If you don't want the world to see your calendar, then set up password authentication for /www/calendar. Each web server is different, so follow the instructions for your particular server to password-protect this directory. If you don't care who sees the events and notes on the calendar, then do not restrict access to this directory.
If you want to restrict the ability to add, change, or delete events, then you must set up password authentication for /www/calendar/private. Each web server is different, so follow the instructions for your particular server to pasword-protect this directory. If you don't care who adds, changes, or deletes events, then do not restrict access to this directory.
Point your browser (preferably Netscape 2.0 or above) to:
	http://www.domain.edu/calendar/calendar.pl
 
and away you go! (Note: Netscape browser versions less than 2.0 do not display the monthly select menu correctly.) Also, your browser must be able to display tables, or the calendar will appear as a single string of numbers, like this:
	123456789101112131415161718192021222324252627282930

Cal Poly Pomona home page