Chapter 5 Managing the Message Store

This chapter describes the message store and the message store administration interface. This chapter contains the following sections:

• Overview
• Message Store Directory Layout


• How Messages Are Erased from the Store


• Specifying Administrator Access to the Store


• Configuring User Disk Quotas


• Configuring Message Store Partitions


• Specifying Aging Policies


• Performing Maintenance and Recovery Procedures


• Interface Reference: Message Store Configuration

server-root/msg-instance/store/partition/primary/=user/53/53/=mack1

1. Delete. A client marks the message to be deleted. At this point, the client can restore the message by removing the "deleted" marking.
2. Expunge. A client, or the aging policies you have specified, expunges messages that have been marked deleted from the mailbox. Once messages are expunged, the client can no longer restore them, but they are still stored on disk. (A second client with an existing connection to the same mailbox may still be able to fetch the messages.)
3. Cleanup. The stored utility erases from the disk any messages that have been expunged for at least one hour.

1. From Netscape Console, open the Messaging Server you want to configure.
2. Click the Configuration tab and select Message Store in the left pane.
3. Click the Administrator tab in the right pane.

• Adding an Administrator
• Modifying an Administrator Entry


• Deleting an Administrator Entry

To add an administrator entry:

1. Click the Administrator tab.

The tab contains a list of existing administrator IDs.

2. Click the Add button beside the Administrator UID window.
3. In the Administrator UID field, type the user ID of the administrator you want to add.

The user ID you type must be known to the Netscape Directory Server.

4. Click OK to add the administrator ID to the list displayed in the Administrator tab.
5. Click Save in the Administrator tab to save the newly modified Administrator list.

You can also add store administrators at the command line as follows:

configutil -o store.admins -v "adminlist"

To modify an existing entry in the message store Administrator UID list:

1. Click the Administrator tab.
2. Click the Edit button beside the Administrator UID window.
3. Enter your changes to the Administrator UID field.
4. Click OK to submit your changes and dismiss the Edit Administrator window.
5. Click Save in the Administrator tab to submit and preserve the modified Administrator list.

You can also modify the store administrator list at the command line as follows:

configutil -o store.admins -v "adminlist"

To delete an entry from the message store Administrator UID list:

1. Click the Administrator tab.
2. Select an item in the Administrator UID list.
3. Click Delete to delete the item.
4. Click Save to submit and preserve your changes to the Administrator list.

You can also delete store administrators at the command line by editing the store administrator list as follows:

configutil -o store.admins -v "adminlist"

1. From Netscape Console, open the Messaging Server you want to configure.
2. Click the Configuration tab and select Message Store in the left pane.
3. Click the Quota tab in the right pane.

• Specifying a Default User Disk Quota
• Specifying a Quota Threshold


• Defining a Quota Warning Message


• Setting a Grace Period

The default disk quota applies to users who do not already have individual disk quotas set for them. A quota set for an individual user overrides the default quota.

1. Click the Quota tab.
2. Select one of the following options:

• Unlimited. Select this option if you do not want to set a default disk quota.
• Size specification. Select this option if you want to restrict the default user disk quota to a specific size. In the field beside the button, type a number, and from the drop-down list, choose Mbytes or Kbytes.
3. Click Save.

You can also specify a default user disk quota at the command line as follows:

configutil -o store.defaultmailboxquota -v [ -1 | number ]

You can send a warning message to IMAP users before they reach their disk quota by specifying a quota threshold. When a user's disk usage exceeds the specified threshold, the server sends a warning message to the user.

1. Click the Quota tab.
2. In the "Quota warning threshold" field, enter a number for the warning threshold.

This number represents a percentage of the allowed quota. For example, if you specify 90%, the user is warned after using 90% of the allowed disk quota. The default is 90%. To turn off this feature, enter 100%.

3. Click Save.

You can also specify a quota threshold at the command line as follows:

configutil -o store.quotawarn -v number

You can define the message that will be sent to users who have exceeded their disk quota as follows. Messages are sent to the user's mailbox.

1. Click the Quota tab.
2. From the drop-down list, choose the language you want to use.
3. Type the message you want to send in the message text field below the Threshold field.
4. Click Save.

You can also define a quota warning message at the command line as follows:

configutil -o store.quotaexceededmsg -v message

If a user mailbox exceeds the disk quota, the grace period you specify determines how long messages will be held in the message queue before the server starts bouncing the messages. Messages will remain in the queue until one of the following occurs:

• The mailbox no longer exceeds the quota, at which time the server will deliver the message to the mailbox.
• The user has remained over quota longer than the specified grace period, at which time the server will bounce the message.
• The message has remained in the queue longer than the maximum message queue time. (For information on setting the maximum message queue time, see Specifying Message Handling for Deferred Queues.)

1. Click the Quota tab.
2. In the "Over quota grace period" field, enter a number.
3. From the drop-down list, specify Day(s) or Hour(s).
4. Click Save.

You can also specify a quota grace period at the command line as follows:

configutil -o store.quotagraceperiod -v number

/partition/mkting/
/partition/eng/
/partition/sales/

1. From Netscape Console, open the Messaging Server you want to configure.
2. Click the Configuration tab and select Message Store in the left pane.
3. Click the Partition tab in the right pane.
4. Click the Add button.
5. Enter the Partition nickname.

The name you enter must be an alphanumeric name and must use lowercase letters.

The partition nickname allows you to map users to a logical partition name regardless of the physical path. When setting up user accounts and specifying the message store for a user, you can use the partition nickname.

6. Enter the Partition path.

This is the absolute path name for the specified partition. The partition will be created at this location. The user ID used to run the server must have permission to write to this location, in order to create and manage the partition.

7. To specify this as the default partition, click the selection box labeled Make This the Default Partition.
8. Click OK to submit this partition configuration entry and dismiss the window.
9. Click Save to submit and preserve the current Partition list.

You can also add a partition to the store at the command line as follows:

configutil -o store.partition.nickname.path -v path

• Number of messages in the mailbox
• Total size of the mailbox


• Number of days that messages remain in the mailbox


• Number of days that messages exceeding a given size remain in the mailbox

1. From Netscape Console, open the Messaging Server you want to configure.
2. Click the Configuration tab and select Message Store in the left pane.
3. Click the Aging tab in the right pane.
4. Click Add to go to the Add Rule window.
5. Enter a name for the new rule.
6. Specify the target folders for which this rule applies.

You can enter a path name, filename, or partial string. You can use IMAP wildcards as follows:

* - Match any character.
% - Match any character except a slash character.

The new rule applies only to folders matching the pattern you specify.

7. If this rule is to be the only rule applied to the target folders, click the Exclusive selection box.
8. If you want to create a rule based on folder size, do the following:

• In the "Message count" field, specify the maximum number of messages that will be retained in a folder before the oldest messages are removed.
• In the "Folder size" field, specify a number for the folder size; from the associated drop-down list, choose Mbyte(s) or KByte(s).

When the specified folder size is exceeded, the server removes the oldest messages until this size is no longer exceeded.

9. If you want to create a rule based on message age, in the "Number of days" field, specify a number to indicate how long messages should remain in the folder.
10. If you want to create a rule based on message size:

• In the "Message size limit" field, enter a number to indicate the maximum size message allowed in the folder; from the associated drop-down list, choose Mbytes or Kbytes.
• In the "Grace period" field, enter a number to indicate how long over-sized messages should remain in the folder.

After the grace period, the server deletes messages that exceed the maximum size.

11. Click OK to add the new rule to the Aging Rule list and dismiss the Add window.
12. Click Save to submit and preserve the current Aging Rule list.

You can also specify aging rules at the command line as follows. In the examples, name represents the name you give the rule.

configutil -o store.expirerule.name.folderpattern -v pattern

configutil -o store.expirerule.name.exclusive -v [ yes | no ]

configutil -o store.expirerule.name.messagecount -v number

configutil -o store.expirerule.name.foldersizebytes -v number

configutil -o store.expirerule.name.messagedays -v number

configutil -o store.expirerule.name.messagesize -v number

configutil -o store.expirerule.name.messagesizedays -v number

The stored utility performs the following monitoring and maintenance tasks for the server:

• Background and daily messaging tasks
• Deadlock detection and rollback of deadlocked database transactions


• Cleanup


• Implementation of aging policies


• Monitoring server state and issuing alarms as necessary

The mailboxes in the message store are stored in a hash structure for fast searching. Consequently, to find the directory that contains a particular user's mailbox, use the hashdir utility as follows:

hashdir userid

• List mailboxes
• Create mailboxes


• Delete mailboxes


• Rename mailboxes


• Move mailboxes

If one or more mailboxes becomes corrupt, you can use the reconstruct utility to rebuild the mailboxes or the mailboxes database, and repair any inconsistencies. For more information about using the reconstruct command, see Appendix A, Command-line Utilities.

You can monitor disk space by configuring the following alarm attributes. You configure these attributes by using the configutil utility. You can specify how often the system should monitor disk space and under what circumstances the system should send a warning.

alarm.diskavailmsgalarmstatinterval

alarm.diskavail.msgalarmthreshold

alarm.diskavail.msgalarmwarninginterval

configutil -o alarm.diskavail.msgalarmstatinterval -v 600

configutil -o alarm.diskavail.msgalarmthreshold -v 20

You can monitor disk quota usage by using the quota utility. The quota utility generates a report that lists defined quotas and limits, and provides information on quota usage. For more information on the quota utility, see Appendix A, Command-line Utilities.

For information about backing up the message store and restoring the message store, contact your Netscape technical support person.

• Configuring User Disk Quotas
• Configuring Message Store Partitions

• Unlimited -- Select this option if the default disk quota for users is to be unrestricted.
• Size specification -- Enter a number in this field to limit user disk quotas. From the associated drop-down list, choose MBytes or KBytes.

• Default. This field indicates whether this partition is the default partition for the message store. This is the partition assigned for a user if no partition is specified for that user in the LDAP entry.
• Nickname. This field indicates the nickname for the partition. You can use the nickname when configuring user account information.
• Path. This field indicates the full physical path for the partition.

• Exclusive. This field indicates whether this rule is the exclusive rule for folders matching a specified pattern.
• Name. This field is a name you can assign to the rule for convenience purposes. The name is not used by Messaging Server.
• Target. This a pathname, filename, or partial string to be used as the criteria for determining rule targets.
• Foldersize. This indicates folder size restrictions to be applied to the target folders. Size can be specified by message count or disk usage (in megabytes or kilobytes). When the folder size is exceeded, the oldest messages are removed until this size is no longer exceeded.
• Count. This is the number of messages that will be retained in the target folder(s) before the oldest messages are deleted.
• Age. This field indicates the message age constraint for target folders. Messages which have been retained in the target folder(s) longer than the specified number of days are removed.
• MsgSize. This field indicates the message size constraint for target folders.
• Grace Period. This field indicates how long over-sized messages will remain in the folder before being deleted.