install-admin-mb.html [plain text]
<!-- $Id: install-admin-mb.html,v 1.5 2006/11/30 17:11:16 murch Exp $ -->
<HTML>
<HEAD>
<TITLE>Administering Mailboxes
</title>
</head>
<h1>Administering Mailboxes</h1>
<body>
The "<tt>cyradm</tt>" command (see the <tt>cyradm</tt>(1) man page for
complete documentation) manages the creation of, deletion of, ACLs on,
and quotas on mailboxes. To get an overview of the command, type
"<kbd>cyradm <var><host></var></kbd>". Once "<tt>cyradm</tt>" has started,
the user prompt is replaced with the name of the host followed by a
"<tt>></tt>". Type "<kbd>help</kbd>" at the new prompt. The
following information is displayed:
<pre>
createmailbox, cm create a mailbox
deleteaclmailbox, dam delete an ACL on a mailbox
deletemailbox, dm delete a mailbox
help get help on commands
listaclmailbox, lam list the ACL on a mailbox
listmailbox, lm list mailboxes
listquota, lq list quota on root
listquotaroot, lqr, lqm list quota roots on mailbox
quit exit program
renamemailbox, renm rename a mailbox
setaclmailbox, sam set an ACL on a mailbox
setquota, sq set quota limits
</pre>
<b>Note:</b>It's not necessary to run "<tt>cyradm</tt>" on the same
system as the IMAP server.
<p><b>Note:</b>If you run "<tt>cyradm</tt>" on a system not using
Kerberos for authentication, you will be prompted for your user name
and password before you can issue any "<tt>cyradm</tt>" commands. Use
the "<tt>-u</tt>" option to specify a particular user.
<p>The mailbox naming convention requires that the primary mailbox (inbox)
for anyone must be named "<tt>user.<var><userid></var></tt>".
To create a mailbox, type:
<pre>
<kbd> createmailbox user.<var><userid></var>
</kbd></pre>
For example, to create a mailbox for the userid "<tt>smith</tt>", type:
<pre>
<kbd> createmailbox user.smith
</kbd></pre>
To limit "<tt>smith</tt>" to 10,000 kilobytes of mail, type:
<pre>
<kbd> setquota user.smith 10000
</kbd></pre>
Once the inbox is created, users can create their own additional mailboxes
from a mail program. If Smith created a work mailbox and a play mailbox,
the full names of the mailboxes would be:
<pre>
user.smith.work
user.smith.play
</pre>
<p>Access rights are discussed in detail in the <tt>cyradm</tt>(1) man pages.
Note that the administrator must grant herself create/delete access
explicitly before she can delete a mailbox:
<pre>
<kbd> setaclmailbox <var><mail_box></var> <var><admin_userid></var> c
deletemailbox <var><mail_box></var>
</kbd></pre>
Once you have created mailboxes, your IMAP server installation is
done. You must then configure a mail interface, such as <a
href="http://www.washington.edu/pine/">Pine</a> or <a
href="http://www.cyrusoft.com/mulberry/">Mulberry</a>, to work with the
IMAP server.
<P><HR>
last modified: $Date: 2006/11/30 17:11:16 $
</BODY></HTML>