Messaging Server 4: mboxutil - supplemental comments

Question

This article contains additional information on the Unix version of the
mboxutil utility for Netscape
Messaging Server versions 4.0 and 4.1 and supplements the following
documents:<BR>
<P>
Netscape Messaging Server 4.0 Administrator's Guide<BR>
<P>
Netscape Messaging Server 4.1 Administrator's Guide<BR>
<P>
The mboxutil utility
lists, creates, deletes, renames, or moves mailboxes (folders) in the
Messaging Server. The following is a list of topics related to usage issues
for the mboxutil utility.
<BR><P>
<OL>
<LI>Users need to set CONFIGROOT
for mboxutil
.<BR>
<P>
You can copy over the settings from the top lines of
<ServerRoot>/msg-<instance>/configutil
.<BR>
<P>
Usage Example:<BR>
#!/bin/sh
# Run config_util on the Messaging Server instance database
PATH=/bin:/usr/bin:/usr/sbin:/sbin:/usr/etc:${PATH}
SERVERROOT=/usr/netscape/server4
MSGADMINBIN=${SERVERROOT}/bin/msg/admin/bin
INSTANCE=ms4-sun
INSTANCEDIR=/usr/netscape/server4/msg-ms4-sun
CONFIGROOT=${INSTANCEDIR}/config
export SERVERROOT INSTANCE INSTANCEDIR CONFIGROOT PATH
<P>
<LI>mboxutil needs to
run as the Unix user of the mailserver.<BR>
<P>
The error messages from mboxutil
may imply that "mailserv" is the user
that runs the utility. However, in actuality, the user who is the owner must
run the utility.
<P>
Note: Changing the ownership from the installed user is not
supported.<BR>
<P>
For example,<BR>
# ./mboxutil
must run as the mailsrv user
# su mailsrv
su: Unknown id: mailsrv
<P>
<LI>Usage and errors for mboxutil
are logged as administrative activity
by the Messaging Server.<BR>
<P>
The logs are located in the following directory:<BR>
<P>
<ServerRoot>/msg-<instance>/logs/admin
<P>
You can check this log to find explanations of potential problems. For
example, the following log entry provides details on incorrect permisisons on
the store partition directory.<BR>
# ./mboxutil -r user/pbear/INBOX user/pbear/INBOX test
System I/O error. Administrator, check server log for details.
<P>
<LI>"Mailbox does not exist" error occurs when a user tries to create a
mailbox with an illegal path.<BR>
<P>
For example,<BR>
# ./mboxutil -r user/pbear/INBOX usr/pbear/INBOX test
Mailbox does not exist
Note: This particular problem is not logged as an error in the admin logs.<BR>
<P>
<LI>mboxutil -c creates new mailboxes in default partition.<BR>
<P>
mboxutil ignores the user's mailmessagestore attribute.
<P>
To find the default partition type:
# ./configutil -o store.defaultpartition
primary
<P>
<LI>Messaging Server 4.1 has two additional flags, the -u
flag and the -k
flag. For more details, please see
the Messaging Server 4.1 documentation
</OL>

Answer 1

This article contains additional information on the Unix version of the
mboxutil utility for Netscape
Messaging Server versions 4.0 and 4.1 and supplements the following
documents:<BR>
<P>
Netscape Messaging Server 4.0 Administrator's Guide<BR>
<P>
Netscape Messaging Server 4.1 Administrator's Guide<BR>
<P>
The mboxutil utility
lists, creates, deletes, renames, or moves mailboxes (folders) in the
Messaging Server. The following is a list of topics related to usage issues
for the mboxutil utility.
<BR><P>
<OL>
<LI>Users need to set CONFIGROOT
for mboxutil
.<BR>
<P>
You can copy over the settings from the top lines of
<ServerRoot>/msg-<instance>/configutil
.<BR>
<P>
Usage Example:<BR>
#!/bin/sh
# Run config_util on the Messaging Server instance database
PATH=/bin:/usr/bin:/usr/sbin:/sbin:/usr/etc:${PATH}
SERVERROOT=/usr/netscape/server4
MSGADMINBIN=${SERVERROOT}/bin/msg/admin/bin
INSTANCE=ms4-sun
INSTANCEDIR=/usr/netscape/server4/msg-ms4-sun
CONFIGROOT=${INSTANCEDIR}/config
export SERVERROOT INSTANCE INSTANCEDIR CONFIGROOT PATH
<P>
<LI>mboxutil needs to
run as the Unix user of the mailserver.<BR>
<P>
The error messages from mboxutil
may imply that "mailserv" is the user
that runs the utility. However, in actuality, the user who is the owner must
run the utility.
<P>
Note: Changing the ownership from the installed user is not
supported.<BR>
<P>
For example,<BR>
# ./mboxutil
must run as the mailsrv user
# su mailsrv
su: Unknown id: mailsrv
<P>
<LI>Usage and errors for mboxutil
are logged as administrative activity
by the Messaging Server.<BR>
<P>
The logs are located in the following directory:<BR>
<P>
<ServerRoot>/msg-<instance>/logs/admin
<P>
You can check this log to find explanations of potential problems. For
example, the following log entry provides details on incorrect permisisons on
the store partition directory.<BR>
# ./mboxutil -r user/pbear/INBOX user/pbear/INBOX test
System I/O error. Administrator, check server log for details.
<P>
<LI>"Mailbox does not exist" error occurs when a user tries to create a
mailbox with an illegal path.<BR>
<P>
For example,<BR>
# ./mboxutil -r user/pbear/INBOX usr/pbear/INBOX test
Mailbox does not exist
Note: This particular problem is not logged as an error in the admin logs.<BR>
<P>
<LI>mboxutil -c creates new mailboxes in default partition.<BR>
<P>
mboxutil ignores the user's mailmessagestore attribute.
<P>
To find the default partition type:
# ./configutil -o store.defaultpartition
primary
<P>
<LI>Messaging Server 4.1 has two additional flags, the -u
flag and the -k
flag. For more details, please see
the Messaging Server 4.1 documentation
</OL>