This chapter describes the message store and the message store administration interface. This chapter contains the following sections:
OverviewMessage Store ArchitectureHow Messages Are Erased from the StoreSpecifying Administrator AccessConfiguring User Disk QuotasConfiguring Message Store PartitionsSpecifying Aging PoliciesPerforming Maintenance and Recovery ProceduresInterface Reference: Message Store Configuration
Table 5.1 Message store command-line utilities
Figure 5.1 Message store architecture
server-root/msg-instance/store/partition/primary/=user/53/53/=mack1/00
Table 5.2 Message store directories
Delete. An IMAP or POP client marks the message to be deleted. (IMAP clients use the /deleted flag; POP clients use the DELE command.) At this point, the client can restore the message by removing the "deleted" marking.
Expunge. A client, or the aging policies you have specified, expunges messages that have been marked deleted from the mailbox. (IMAP clients use the EXPUNGE command. POP clients use the QUIT command.) Once messages are expunged, the client can no longer restore them, but they are still stored on disk. (A second POP or IMAP client with an existing connection to the same mailbox may still be able to fetch the messages.)
Cleanup. The stored utility erases from the disk any messages that have been expunged for at least one hour.
In the Messaging Server console, select the Configuration tab.
Open the Message Store folder. The message store configuration tabs appear in the right pane.
The message store configuration tabs appear in the right pane.
Click Administrator. The Administrator form appears.
The Administrator form appears.
Adding an AdministratorModifying an Administrator EntryDeleting an Administrator Entry
To add an administrator entry:
Go to the Administrator form. The form contains a list of any existing administrator IDs.
The form contains a list of any existing administrator IDs.
Click the Add button beside the Administrator UID window.
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.
The user ID you type must be known to the Netscape Directory Server.
Click OK to add the administrator ID to the list displayed on the Administrator form.
Click Save on the Administrator form to save the newly modified Administrator list.
To modify an existing entry in the message store Administrator UID list:
Go to the Administrator form.
Click the Edit button beside the Administrator UID window.
Enter your changes to the Administrator UID field.
Click OK to submit your changes and dismiss the Edit Administrator window.
Click Save on the Administrator form to submit and preserve the modified Administrator list.
To delete an entry from the message store Administrator UID list:
Select an item in the Administrator UID list.
Click Delete to delete the item.
Click Save to submit and preserve your changes to the Administrator list.
Click Quota. The Quota form appears.
The Quota form appears.
Specifying a Default User Disk QuotaSpecifying a Quota ThresholdDefining a Quota Warning MessageSetting a Grace Period
The default disk quota applies to all users who do not already have individual disk quotas set for them. A quota set for an individual user overrides the default quota.
Go to the Message Store Quota form.
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 pulldown menu, choose Mbytes or Kbytes.
Click Save.
You can send a warning message to 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.
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%.
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%.
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.
From the pull-down menu, choose the language you want to use.
Type the message you want to send in the message text field below the Threshold field.
If a user mailbox exceeds the disk quota, the grace period you specify determines how long messages will be held in the SMTP queue before the server starts bouncing the messages. Messages will remain in the queue until one of the following occurs: (1) The mailbox no longer exceeds the quota, at which time the server will deliver the message to the mailbox; (2) The message has remained in the queue longer than the specified grace period, at which time the server will bounce the message.
In the "Over quota grace period" field, enter a number.
From the pulldown menu, specify Day(s) or Hour(s).
/partition/mkting//partition/eng//partition/sales/
Click Partition. The Message Store Partition form appears.
Click the Add button.
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.
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.
Enter the Partition path. This is the absolute pathname 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.
This is the absolute pathname 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.
To specify this as the default partition, click the selection box labeled Make This the Default Partition.
Click OK to submit this partition configuration entry and dismiss the window.
Click Save to submit and preserve the current Partition list.
Number of messages in the mailboxTotal size of the mailboxNumber of days that messages remain in the mailboxNumber of days that messages exceeding a given size remain in the mailbox
Click Aging. The Message Store Aging form appears.
Click Add to go to the Add Rule window.
Enter a name for the new rule.
Specify the target folders for which this rule applies. You can enter a pathname, 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.
You can enter a pathname, 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.
If this rule is to be the only rule applied to the target folders, click the Exclusive selection box.
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 which will be retained in a folder before the oldest messages are removed.
In the "Folder size" field, specify a number for the folder size and choose Mbyte(s) or KByte(s) from the pull-down menu.
When the specified folder size is exceeded, the server removes the oldest messages until this size is no longer exceeded.
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.
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 and choose Mbytes or Kbytes from the pulldown menu.
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.
Click OK to add the new rule to the Aging Rule list and dismiss the Add window.
Click Save to submit and preserve the current Aging Rule list.
The stored utility performs the following monitoring and maintenance tasks for the server. This utility automatically performs cleanup and expiration operations once a day.
background and daily messaging taskslow-level database consistency check and repairdeadlock detection and rollback of deadlocked database transactionscleanupexpiration, expunging, and erasing messages stored on diskalarm setting
Table 5.3 stored syntax options
stored -d -h 21
/etc/NscpMsg stop store/etc/NscpMsg start store
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 mailboxescreate mailboxesdelete mailboxesrename mailboxesmove mailboxes
Table 5.4 mboxutil options
mboxutil -c user/crowe/INBOX
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. Table 5.5 lists the syntax options for the reconstruct utility. For more information about using the reconstruct command, see Appendix A, Command-line Utilities.
Table 5.5 reconstruct options
reconstruct -m
One or more directories were removed from the message store, so the mailbox database entries need to be removed.
One or more directories were restored to the message store, so the mailbox database entries need to be added.
If the low-level database check and repair performed the stored process are not sufficient.
reconstruct -r user/daphne
reconstruct -p subpartition
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 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 QuotasConfiguring 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 pulldown menu, MBytes and 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.