wiki:ReportingErrors

Reporting Errors

Before you do anything else, be sure to check the growing FAQ.

There are several mechanisms to report problems to the Maia Mailguard development team. First, check with the various mailing lists for general support issues. There are many peers on the list that can assist with configuration issues and getting started.

If you have found a real bug, create a trouble ticket here on this website ( https://secure.renaissoft.com/maia/report ). Before you do, please take some time to search existing tickets to see if it has already been reported, and add your report to an already existing ticket if an appropriate one exists. Don't be shy!

We like patches even more! If you have a patch to fix the problem, create a ticket with a subject that begins with [PATCH] so we can see it easily, and check the "Patch supplied?" box. Then attach your patch to the ticket.

When reporting errors, it would help us out if you could provide as many details as possible. A report like "nothing happens" is not very helpful, and probably not exactly true either. Something is happening, though it may be hard to figure out what.

One thing that may be very helpfull is to find out what, if any, errors are being logged to the screen or log files. Sometimes this may not be activated, so you may need to activate php's logging. Look in your php.ini file, here's what I have set:

error_reporting  =  E_ALL
display_errors = Off
log_errors = On

This lets it log all errors to the apache error log file, and doesn't bother the end user's screen. Of particular note, I removed the default ~E_NOTICE from the error_reporting directive, to get more detailed messages.

Please report any relevant errors along with your error report, as it will help us track down the problem more quickly.


Back to FAQ

Last modified 14 years ago Last modified on Apr 25, 2006, 7:57:33 PM