Administration

qtp-backup, qtp-restore

This is a pair of scripts for backing up and restoring QmailToaster's configuration and user data files. They can be run only from the CLI. See  Backup and Restore for details.

qtp-newmodel

This a set of scripts that install/upgrade the QmailToaster family of packages. It can be run from qtp-menu or the CLI. Details are here.

qtp-install-rpmforge

This script is one of many used by qtp-newmodel, although it can be run independently. It installs the rpmforge repository into yum but in a disabled state, so you need to manually activate it with the yum --enablerepo=rpmforge option.

qtp-install-gnome

Installs the Gnome Desktop and XWindows onto your system. Be sure you have adequate RAM available before running this one.

qtp-maildrop

This script puts maildrop into the logrotate rotation so that it doesn't become unweildly.


Enhancing Anti-Spam

qtp-clean-spam

This script looks for spam messages in a user's Spam folder (see  wiki), runs sa-learn with them and then removes them if they are more than 15 days old. The 15-day old option can be tailored in the script.

qtp-install-sanesecurity

 SaneSecurity signatures help to block various phishing and scam emails. This script installs the latest package from Bill Landry <bill at inetmsg dot com> that downloads  SaneSecurity signatures via Rsync and verifies them via GnuPG. It is configured to download the Third Party databases from  MSRBL,  SecuriteInfo,  MalwarePatrol,  OITC and  INetMsg as well as those from  SaneSecurity. Bill's download/update script runs regularly at 25 minutes past the hour, plus from 30 to 600 seconds to keep from hammering the servers. When it is done updating, it restarts the clamav daemon using the qmail-clam script.

qtp-install-spamdyke

This script installs/upgrades  spamdyke on your toaster. Note, when upgrading from version 3.x to 4.x, previous configuration settings are replaced with the default configuration, however 3.x settings are kept for reference. See the  wiki spamdyke page for details.

qtp-sa-update

This is a script and configuration for adding/updating additional SpamAssassin rule sets from various web sites, primarily  Rules Emporium. It has been preconfigured for QmailToaster by Jake. It can be run from qtp-menu or the CLI. In order to run it as a daily cron job, you can do the following:

# cp -p /opt/qmailtoaster-plus/etc/cron.daily/qtp-sa-update /etc/cron.daily/.

qtp-set-rbls

This script sets the  /var/qmail/control/blacklists file to one of three sets of blacklist configurations:

The selected configuration takes effect immediately. The preconfigured files are named /opt/qmailtoaster-plus/etc/blacklists*. See the links above for details of each configuration. The script can be run from qtp-menu or the CLI. CLI usage:

# qtp-set-rbls {-default|-loose|-moderate|-tight}

Note, spamdyke uses its own RBL mechanism, so this script is ineffective when spamdyke is installed.


Queue Management

qmHandle

This is a simple script that allows you to view and manage (within limits) qmail remote and local queues. This is a special version (1.2.0-bovine) of qmHandle that includes some extended parameters. It can be run only from the CLI. See doc/qmHandle.doc.txt for details.

qmqtool

This is a queue manipulation program for viewing and modifying the contents of a qmail queue. It can be run only from the CLI. See doc/qmqtool.doc.txt and doc/qmqtool.faq.txt for details.

queue_repair.py

This is a qmail queue repair tool with many nice features. It can be run only from the CLI. See doc/queue_repair.doc.txt for details.


Utility

mansfor

Having trouble finding man pages for a particular package? This script was made for you (and me)! It finds all of the man pages for a particular set of packages (or just a specific package) and lets you browse through them using the same dialog software that qtp-menu uses. If the dialog package is not installed, mansfor will offer to install it for you automatically.

The dialog window automatically sizes itself to the size of the terminal. You might need to

# export LINES COLUMNS

to get this feature to work. Otherwise, it defaults to the standard 24x80 terminal size. If there are fewer man pages to display than the terminal size allows, the window automatically shrinks to fit the list of man pages.

Need to find the daemontools man pages? Simply:

# mansfor daemontools-toaster

You can specify more than one package, or you can search packages using the -s flag with a regex. For example, to see all of the man pages included in QmailToaster, you can:

# mansfor -s toaster

Please be patient when using the -s flag. The script needs to look through all of the installed packages to find the right ones, which takes several seconds. In addition, the script uses the 'whatis' command for each man page found to get the description, which takes a little time too.

mansfor can be run only from the CLI. CLI usage:

mansfor [section] ... {-s regex} | package_name} [package_name] ...

qmail-clam

This script controls the clamd daemon. It can be run only from the CLI. CLI usage:

# qmail-clam {start|stop|restart|stat|pause|cont|status|help}

qtp-clean-trash

This script deletes files in the Trash folders that are more than 5 days old. The age can be specified in a /var/qmail/control/deltrash file.

qmail-spam

This script controls the spamd daemon. It can be run only from the CLI. CLI usage:

# qmail-spam {start|stop|restart|stat|pause|cont|status|help}

qmlog

This script assists in viewing the various qmail logs. It can be run only from the CLI. It is handy for the newly initiated as well as seasoned administrators. It was originally written by Fabio Olaechea and sent to Jake to be posted. Jake translated it to English and tidied it up a bit. Eric later refactored it, adding numerous options and capabilities.

qmlog uses the tai64nlocal program to convert qmail's internal (TAI64N) time stamps into human readable localized form.

qmlog uses the etc/qmlog-trim.sed file for trimming the displayed messages. The existing file shortens the date and time stamps. Any sed commands may be included in this file for tailoring to your personal taste. The -s option augments the etc/qmlog-trim.sed file. Any number of -s options may be included. The -nt option turns trimming off.

qmlog's help is shown when you run it with no parameters:

# qmlog
qmlog v0.2.1 -  show current log of service 'service'
usage: qmlog service [option] ...
services: authlib clamd imap4 imap4-ssl pop3 pop3-ssl send smtp spamd submission
options:
  -h[elp]      this help
  -l[ist]      list saved logs of service
  -f           follow as it grows, using 'tail -f'
  -t N         show (tail) last N lines
  -nl          show without using less
  -nt          show with no trimming
  -d mmdd[:hhmm][-mmdd[:hhmm]]
               show logs that contain the date 'mmdd' [thru -'mmdd']
  -lc regex    show logs that contain a string that matches 'regex'
  -ln pattern  show logs with file name containing 'pattern'
  -s command   pipe output through sed 'command'
  -g regex     show only lines that match the string 'regex'
#

Any number of options may be combined in a logical fashion.

The service parameter may be specified anywhere in the option list (it doesn't necessarily have to be the first parameter).

qtp-ami-up2date

This script checks your QmailToaster packages to see if there are any updates available. It can be run from qtp-menu or the CLI. CLI usage:

# qtp-ami-up2date [-d] [EMAIL_ADDRESS]

The optional "-d" flag will include checking development packages. The last parameter (optional) is an email address where the output should be sent.

To have it run as a daily cron job with output emailed to the postmaster, you can

# cp -p /opt/qmailtoaster-plus/etc/cron.daily/qtp-ami-up2date /etc/cron.daily/.

qtp-install-watchall

This script installs the watchall and cwatchall scripts, which you to view your mail system logs in realtime by displaying several logs on the screen at once. cwatchall is a colorized version.

qtp-menu

This is a menu program to assist with running commands in the QmailToaster-Plus package.

sa-stats

This script generates statistics for top spam/ham rules fired for SpamAssassin. It can be run from qtp-menu or the CLI. CLI usage:

# sa-stats [-r {USER|@DOMAIN}]

IMAP tools

There is a collection of IMAP tools  here that you might find useful if you're needing to migrate or otherwise manage mailboxes. The tools use the IMAP protocol. You might also find  fetchmail useful. See  the wiki fetchmail page for more.