Troubleshooting QMail toaster installation

QmailToaster is a quick and easy way to install QMail on your server. However when things go wrong there are a few files and techniques you need to know about to track problems down. this post is a simple way for me to document some of the most useful bits of information. Hopefully they will help someone. My system is Fedora 6, different systems may have slightly different  locations. First step is to examine the SMTP log...

# cat /var/log/qmail/smtp/current | more

If you just want to monitor the log in real time, login as admin, note the use of tai64nlocal that converts the timestamps into a readable format ...

tail -f  /var/log/qmail/smtp/current | tai64nlocal

Incoming SMTP traffic is handled by:

/var/qmail/supervise/smtp/run

This script runs the qmail-smtp service against the incoming email. The script receives various environment variables set up by rules in the tcp.smtp file. For changes in the tcp.smtp file to take effect you need to rebuild the cdb files ...

 qmailctl cdb

These files and programs are a great place to start when tracking down a qmail problem