Programmers / System Administrators Guide

Module listing

This section includes the modules used within the secure mailer system.

• Gpgprocessor.pm

Code

• Mail.pm

Code

• MailerMisc.pm

Code

• Pop3.pm

Code

Script listing

This section includes the scripts used within the secure mailer system.

• Address.plx

Code

• Auth.plx

Code

• Composer.plx

Code

• Dbsetup.plx

Code

• Errorconfig.plx

Code

• Handler.plx

Code

• Htmlconfig.plx

Code

• Logout.plx

Code

• Mailerconfig.plx

Code

• Mover.plx

Code

• Pgpencrypt.plx

Code

• Pop3handler.plx

Code

• Primary.plx

Code

• Sender.plx

Code

• Userconfig.plx

Code

• Viewer.plx

Code

Installation

This section includes installation instructions.

• Copy the contents of ./webmail so to that it can be found by perl when it searches for modules.  In the authors case the location was:  /usr/lib/perl5/site_perl/5.005/Webmail/ for which the Webmail directory is to complete the names of the modules which are called Webmail::NAME.
• Copy the structure of scripts except for ./webmail, dbsetup.plx and ./server to a path on your webserver.  You will need to make sure that the directory chosen has the ExecCGI (in Apache) bit or is a script alias.  Otherwise the scripts will not be accessible and not yield much result.
• Configure and execute dbsetup.plx making sure that the docs folder is either under its path or correctly specified.   This will setup MySQL and create a default superuser account for the chat system.   You will need the following for this to happen:
• A working copy of MySQL (daemon active) which can be gotten here.
• Properly configured dbsetup.plx, which means looking though the first few sections under Data Members and modifying it to match your system.
• After which point you will need to create the DBM's:
• Modify Dbm.pm to make sure it points to the proper location.   Currently set for /usr/share/webmail
• Create a webmail.webmail user and group and set the ownership and suid bits on the script and shared directly.
• Run the script dbsetup.plx a few times.  The first time should prompt you that the files were created, the second should display all of the keys and default values.
• Run the script mailerconfig.plx and fill in the necessary information.
• Change as needed.  Sections should be fairly straightforward.
• NOTE:  You may have problems with some version of perl.  It may be prudent to make a symbolic link with whatever DBM's were created to either the equivalent name with the addition .db or without the additional .db this should correct any problems of the DBM's not being found.
• Finally, all of the scripts including administrative scripts should be operational.   

NOTE: Future revisions may or may not include a Makefile.pl this has yet to be determined.  Also you may or may not be able to use Apache::Registry with the scripts, this feature is untested but should be possible.

Database Table Schema