test
[hcoop/zz_old/ikiwiki] / DomTool / AdditionalClients.mdwn
diff --git a/DomTool/AdditionalClients.mdwn b/DomTool/AdditionalClients.mdwn
new file mode 100755 (executable)
index 0000000..27d89ce
--- /dev/null
@@ -0,0 +1,25 @@
+This page documents command-line tools besides the `domtool*` family that act as DomTool 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.\r
+\r
+[[TableOfContents()]]\r
+\r
+= dbtool =\r
+\r
+`dbtool` handles DBMS user and database creation. See the DomTool `Dbms` module for the hooks used to add handling for a new database server.\r
+\r
+''More detail should follow as we figure out how we'll be storing databases.''\r
+\r
+= vmail =\r
+\r
+`vmail` manages mappings from virtual mailbox e-mail addresses to the locations of their Maildir mailboxes and their IMAP/POP passwords. Data goes into `/etc/courier/userdb`, which must be owned by the `domtool` user for `vmail` to work properly. `/etc/courier/exim` (text version of mapping database) and `/etc/courier/exim.dat` (compiled DBM version) are root-owned, and DomTool uses `domtool-publish` with `sudo` to manipulate them.\r
+\r
+= setsa =\r
+\r
+`setsa` sets SpamAssassin analysis preferences for different e-mail addresses. The set of addresses to filter is those who have files named after them in `/etc/spamassassin/addrs`, which should be owned by `domtool`.\r
+\r
+= smtplog =\r
+\r
+`smtplog` (previously called `rlog`) returns lines from the current SMTP log (in `/var/log/exim4/mainlog`) that contain a domain name. `sudo domtool-publish` is used to read this root-only file with `grep`.\r
+\r
+= mysql-fixperms =\r
+\r
+Runs `/usr/bin/sudo -H /afs/hcoop.net/common/etc/scripts/mysql-grant-table-drop` to grant users drop permissions on their MySQL tables.\r