cgi-mailer: download & installation

Requirements

cgi-mailer requires perl 5.001 or later and the LWP module. See the Perl Home Page for information on how to get perl and/or how to get the LWP module.

If you want to use Mail::Send or Net::SMTP instead of sendmail to deliver the email, then you will need to get the MailTools or libnet modules, respectively.

cgi-mailer has been tested under Unix and Windows NT. Please email me with any information on changes needed to get cgi-mailer running on other systems.

Obtaining cgi-mailer

The cgi-mailer source distribution is available in the following formats:

unix tar, compressed (31k):

FTP from Australia or HTTP from North America

unix tar, GNU zipped (15k):

FTP from Australia or HTTP from North America

pkzip (24k):

FTP from Australia or HTTP from North America

Installation & Configuration

After you obtain the source, open cgi-mailer.pl in your text editor. You'll need to set the variables for the location of sendmail (unless you have the libnet module or MailTools module installed), the location of your logfile and your local domain if you wish to restrict use of cgi-mailer to those within your organisation. You may need to change the invocation line (the first line in the file) to reflect the location of perl on your system.

Once you've set the configuration variables, copy cgi-mailer.pl into your cgi-bin (or similar) directory. Make sure the permissions are set to read and execute (chmod a+rx cgi-mailer.pl). You should be ready to go. There is a sample HTML form in the test directory of the distribution that you can use to check that everything is working. Be sure to put your email address in the appropriate place in the form before using it.

Note: If you are using Windows 95 or NT, Apply the instructions above to the file cgi-mailer.bat in the Win32 subdirectory of the distribution.

You should make a local copy of user-doc.html from the distribution, and change all instances of your-local-host to the hostname where you have cgi-mailer.pl installed (and remove the <i> tags). You can then give your users the URL of the local copy of the user documentation.

Please report any bugs, suggestions or corrections to martin@gleeson.com.