TracNav
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}]
