• NAME
• Installing the new mail
• Install the following perl modules
• Installing the bugzilla files
• Configuring the new mail
• Test your new mail configuration
• Author

NAME

Bugzilla::Send::Mail - is a module to extend the mail on bugzilla-2.17.7 (possibly other version that are based on 2.17.7) to use SMTP, SMTP_auth and the sntandard SENDMAIL. This will make WIN32 installtions a little easier. I have tested the mail setup on WIN32 but have not tested it on Unix. The send mail shoud work. you might have to tweak the ``undef'' to ``'' if you have problems with it.

Installing the new mail

Install the following perl modules

The following modules can be installed from CPAN or ASPN

  Net-SMTP_auth
  Net-SMTP

ASPN example

  ppm3 install Net-SMTP_auth
  ppm3 install Net-SMTP

Installing the bugzilla files

These two files are new:

  Send.pm   <-- new mail module
  check_mail.pl  <- a simple script to test your configuration by sendin a test
                    email

The following files are modified to direct the mail requests to the new Send.pm module.

  BugMail.pm
  CGI.pm
  move.pl
  globals.pl
  whineatnews.pl
  CGI.pl
  Token.pm
  importxml.pl

Copy the Send.pm and BugMail.pm to the ``bugzilla installation directory''/Bugzilla.

Copy check_mail.pl, CGI.pm, move.pl, globals.pl, whineatnews.pl, CGI.pl, Token.pm, importxml.pl to the ``bugzilla installation directory'' directory.

Configuring the new mail

I have not had time to workout the configuration scheme. Since I am pressed for time, I decided to edit the Send.pm for configuring the mail.

$from = '<email address for From:...>'

This is the email adress the appears in the ``From:..'' in the e-mail. Bugzilla, will modify this when necessary.

$server_type = '<server type>'

Server tyes are SMTP, SMTP_AUTH, SENDMAIL. usually if you your mail server is in an ISP (usually need authentication) set to SMTP_AUTH. If you are using a in-house SMTP server that does not require authentication then use SMTP. If you want to use the default sendmail then set to SENDMAIL.

$athu_protocol = '<authentication protocol>'

The protocols names are LOGIN, DIGEST-MD5, CRAM-MD5, PLAIN. Most ISPs use PLAIN or LOGIN. If you do not need authentication (if you are using SMTP or SENDMAIL) the set this to undef (the value is irrelevant).

$server_name = '<mail server name (mailhost)'

This is the name of the SMT server or(mailhost).

$account_name = '<account name>'

This is the name of the email SMTP account. If using the SENDMAIL then set to undef.

$account_passwrod = '<password for the account>'

The mail account password. This is need ONLY if your server type is a SMTP_AUTH otherwise should be set to undef (when server type is SMTP or SENDMAIL)

$debug_file = '<full path to a file for keeping copy of the entire mail taction>'

Full path to a file that will caputre the entire mail transaction. It is very usefull when debugging the mail.

$debug = <1 or undef>

      1: debug mode
  undef: NO debug

Configuration table

X: Info is need

-: set to undef

             $from   $server_type   $athu_protocol  $server_name  $account_name   $account_passwrod

       SMTP    X         X                 -            X              X                 -

  SMTP_AUTH    X         X                 X            X              X                 X

    SNDMAIL    -         X                 -            -              -                 -

Test your new mail configuration

check_mail.pl is a simple perl program you can test the email configuration you just finished it is lot easier to see it the setup is correct this program. Just edit and replace the sender and recepient email addresses. and run the program

  perl  check_mail.pl

you shoud receive the email which will verify you configuration.

Author

Shahriar Mokhtarzad

contact_smt@pacbell.net