<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>DomTool/AdditionalClients</title><revhistory><revision><revnumber>4</revnumber><date>2012-12-20 22:21:24</date><authorinitials>ClintonEbadi</authorinitials><revremark>fwtool</revremark></revision><revision><revnumber>3</revnumber><date>2008-07-07 04:28:15</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>2</revnumber><date>2007-10-27 18:49:19</date><authorinitials>AdamChlipala</authorinitials><revremark>mysql-fixperms</revremark></revision><revision><revnumber>1</revnumber><date>2006-12-24 03:56:42</date><authorinitials>AdamChlipala</authorinitials></revision></revhistory></articleinfo><para>This page documents command-line tools besides the <code>domtool*</code> family that act as <ulink url="https://wiki.hcoop.net/DomTool/AdditionalClients/DomTool#">DomTool</ulink> clients. It's aimed at admins. Most members will probably find the most useful documentation on these tools in other places scattered throughout this wiki. </para><section><title>dbtool</title><para><code>dbtool</code> handles DBMS user and database creation. See the <ulink url="https://wiki.hcoop.net/DomTool/AdditionalClients/DomTool#">DomTool</ulink> <code>Dbms</code> module for the hooks used to add handling for a new database server. </para><para><emphasis>More detail should follow as we figure out how we'll be storing databases.</emphasis> </para></section><section><title>vmail</title><para><code>vmail</code> manages mappings from virtual mailbox e-mail addresses to the locations of their Maildir mailboxes and their IMAP/POP passwords. Data goes into <code>/etc/courier/userdb</code>, which must be owned by the <code>domtool</code> user for <code>vmail</code> to work properly. <code>/etc/courier/exim</code> (text version of mapping database) and <code>/etc/courier/exim.dat</code> (compiled DBM version) are root-owned, and <ulink url="https://wiki.hcoop.net/DomTool/AdditionalClients/DomTool#">DomTool</ulink> uses <code>domtool-publish</code> with <code>sudo</code> to manipulate them. </para></section><section><title>setsa</title><para><code>setsa</code> sets <ulink url="https://wiki.hcoop.net/DomTool/AdditionalClients/SpamAssassin#">SpamAssassin</ulink> analysis preferences for different e-mail addresses. The set of addresses to filter is those who have files named after them in <code>/etc/spamassassin/addrs</code>, which should be owned by <code>domtool</code>. </para></section><section><title>smtplog</title><para><code>smtplog</code> (previously called <code>rlog</code>) returns lines from the current SMTP log (in <code>/var/log/exim4/mainlog</code>) that contain a domain name. <code>sudo domtool-publish</code> is used to read this root-only file with <code>grep</code>. </para></section><section><title>mysql-fixperms</title><para>Runs <code>/usr/bin/sudo -H /afs/hcoop.net/common/etc/scripts/mysql-grant-table-drop</code> to grant users drop permissions on their MySQL tables. </para></section><section><title>fwtool</title><para>Documented on <ulink url="https://wiki.hcoop.net/DomTool/AdditionalClients/FirewallRules#">FirewallRules</ulink>. <code>fwtool regen $node</code> regenerates the firewall on a given node. </para></section></article>