Go to main content
1/81
Contents
Title and Copyright Information
Preface
Audience
Related Documents
Documentation Accessibility
Part I Monitoring and Managing Messaging Server
1
Messaging Server System Administration Overview
About Messaging Server
About Messaging Server Configuration
Overview of Messaging Server Administration Tasks
About Messaging Server Administration Tools
Directory Placeholders Used in This Guide
2
Overview of Messaging Server Unified Configuration
What Is Messaging Server Unified Configuration?
Unified Configuration Files
Enabling Unified Configuration in Messaging Server
To Determine if Unified Configuration Is Deployed
Understanding Unified Configuration Limitations
Using the Repository of Previous Configurations
To List Configurations
To Compare Configurations
Using Legacy Configuration Tools with Unified Configuration
Separating Roles and Instances
More About Unified Configuration Options
Options That Have Passwords
Restricted Options
Obsolete Options
Option Relationships
Unified Configuration Option Names
Example of Legacy Configuration and Unified Configuration
Using Recipes
To Run a Recipe
Helpful Commands
To Show Settings
To Get Help
3
Stopping and Starting Messaging Server
Starting and Stopping Services
To Start and Stop Messaging Server Services
To Start Up, Shut Down, or View the Status of Messaging Services
To Specify What Services Can Be Started
Starting and Stopping a Messaging Server Running in MTA-only Mode
Stopping and Starting Messaging Services in an HA Environment
Automatic Restart of Failed or Unresponsive Services
Overview of Messaging Server Monitoring Processes
Automatic Restart in High Availability Deployments
4
Configuring General Messaging Capabilities
Modifying Your Passwords
Managing Mail Users, Mailing Lists and Domains
Overview of Messaging Server and LDAP
To Remove a User from Messaging Server by Using Delegated Administrator
To Remove a Domain from Messaging Server using Delegated Administrator
Scheduling Automatic Tasks
Overview of Scheduling Automatic Tasks
Scheduler Examples
Pre-defined Automatic Tasks
Configuring a Greeting Message
To Create a New User Greeting
To Set a Per-Domain Greeting Message
Setting a User-Preferred Language
Overview of Setting a User-Preferred Language
To Set a Domain Preferred Language
To Specify a Site Language
Encryption Settings
Setting a Failover LDAP Server
5
Configuring and Administering Multiplexor Services
Multiplexor Services in Unified Configuration Overview
Multiplexor Services
Multiplexor Benefits
About Messaging Multiplexor
How the Messaging Multiplexor Works
Encryption (SSL) Option
Certificate-Based Client Authentication
To Enable Certificate-based Authentication for Your IMAP or POP Service
User Pre-Authentication
MMP Virtual Domains
About SMTP Proxy
Setting Up the Messaging Multiplexor
Before You Configure MMP
Multiplexor Configuration
To Configure the MMP
Multiplexor Configuration Options
Starting the Multiplexor
Modifying an Existing MMP
Configuring MMP with SSL or Client Certificate-Based Login
To Configure MMP with SSL
To Configure MMP with Client Certificate-based Login
A Sample Topology
MMP Tasks
To Configure Mail Access with MMP
To Set a Failover MMP LDAP Server
6
MTA Concepts
The MTA Functionality
MTA Architecture and Message Flow Overview
Dispatcher and SMTP Server (Slave Program)
The Dispatcher
Creation and Expiration of Server Processes
To Start and Stop the Dispatcher
Rewrite Rules
Channels
Master and Slave Programs
Channel Message Queues
Channel Definitions
The MTA Directory Information
The Job Controller
To Start and Stop the Job Controller
On Demand Mail Relay
Priority Message Handling
7
MTA Address Translation and Routing
The Direct LDAP Algorithm and Implementation
Domain Locality Determination
Rewrite Rule Machinery
Domain Map Determination of Domain Locality
Caching of Domain Locality Information
Error Handling
Pattern for Domain Check Rewrite Rule
Putting It All Together
Alias Expansion of Local Addresses
Alias Checking with LDAP URLs
The $V Metacharacter
Calling a Mapping from a URL
The $R Metacharacter
Determining the Attributes to Fetch
Handling LDAP Errors
Sanity Checks on the LDAP Result
Support for Vanity Domains
Support for Catchall Addresses
Processing the LDAP Result
Object Class Check
Entry Status Checks
UID Check
Message Capture
Seeding the Reversal Cache
Mail Host and Routing Address
Miscellaneous Attribute Support
Delivery Options Processing
Additional Metacharacters for Use in Delivery Options
Delivery Option Defaults
Start and End Date Checks
Optin and Presence Attributes
Sieve Filter Handling
Deferred Processing Control
Group Expansion Attributes
To Modify Group Membership Attribute Syntax
Address Reversal
Asynchronous LDAP Operations
Settings Summary
Processing Multiple Different LDAP Attributes with the Same Semantics
8
About MTA Services
MTA Configuration Overview
Compiling the MTA Configuration
Notes for Compiled MTA Configurations
Recompiling the MTA Configuration
9
Message Transfer Agent Command-line Utilities
MTA Commands
Command Descriptions
imsimta cache
imsimta chbuild
imsimta cnbuild
imsimta counters
imsimta crdb
imsimta find
imsimta kill
imsimta process
imsimta program
imsimta purge
imsimta qclean
imsimta qm
imsimta qm Options
imsimta qtop
imsimta refresh
imsimta reload
imsimta renamedb
imsimta restart
imsimta return
imsimta run
imsimta shutdown
imsimta start
imsimta stop
imsimta submit
imsimta test
imsimta test -domain
imsimta version
imsimta view
10
Configuring Rewrite Rules
Before You Begin
Editing Rewrite Rules in Unified Configuration
Rewrite Rule Structure
Rewrite Rule Patterns and Tags
A Rule to Match Percent Hacks
A Rule to Match Bang-Style (UUCP) Addresses
A Rule to Match Any Address
Tagged Rewrite Rule Sets
Rewrite Rule Templates
Ordinary Rewriting Templates, A%B@C or A@B
Repeated Rewrites Template, A%B
Specified Route Rewriting Templates, A (B)C@D or A (B)C
Case Sensitivity in Rewrite Rule Templates
How the MTA Applies Rewrite Rules to an Address
Step 1. Extract the First Host or Domain Specification
Step 2. Scan the Rewrite Rules
Step 3. Rewrite Address According to Template
Step 4. Finish the Rewrite Process
Rewrite Rule Failure
Syntax Checks After Rewrite
Handling Domain Literals
Template Substitutions and Rewrite Rule Control Sequences
Username and Subaddress Substitution, $U, $0U, $1U
Host/Domain and IP Literal Substitutions, $D, $H, $nD, $nH, $L
Literal Character Substitutions, $$, $%, $@
LDAP Query URL Substitutions, $]...[
General Database Substitutions, $(...)
Apply Specified Mapping, ${...}
Customer-supplied Routine Substitutions, $[...]
Single Field Substitutions, $&, $!, $*, $#
Unique String Substitutions
Source-Channel-Specific Rewrite Rules ($M, $N)
Destination-Channel-Specific Rewrite Rules ($C, $Q)
Direction-and-Location-Specific Rewrite Rules ($B, $E, $F, $R)
Host-Location-Specific Rewrites ($A, $P, $S, $X)
Changing the Current Tag Value, $T
Controlling Error Messages Associated with Rewriting ($?)
Handling Large Numbers of Rewrite Rules
Testing Rewrite Rules
Rewrite Rules Example
11
Using Predefined Channels
Predefined Channels
To Deliver Messages to Programs Using the Pipe Channel
To Configure the Native (/var/mail) Channel
To Temporarily Hold Messages Using the Hold Channel
The Conversion Channel
MIME Overview
Message Construction
MIME Headers
Selecting Traffic for Conversion Processing
To Control Conversion Processing
Conversion Channel Information Flow
To Use Conversion Channel Environmental Variables
To Use Conversion Channel Output Options
Headers in an Enclosing MESSAGE/RFC822 Part
To Call Out to a Mapping Table from a Conversion Entry
To Bounce, Delete, Hold, Retry Messages Using the Conversion Channel Output
To Bounce Messages
To Conditionally Delete a Message or Its Parts
To Hold a Message
To Cause Messages to Be Reprocessed
Conversion Channel Example
Automatic Arabic Character Set Detection
To Automatically Detect Arabic Character Sets
Character Set Conversion and Message Reformatting
Character Set Conversion
Message Reformatting
Service Conversions
12
LMTP Delivery
Overview of LMTP
LMTP Delivery Features
LMTP Client and Server to Detect and Respond to Certain Conditions
Support for LMTP Client and Server to Use UID Extension
Messaging Processing in a Two-Tiered Deployment Without LMTP
Messaging Processing in a Two-Tiered Deployment With LMTP
LMTP Architecture
Configuring LMTP
Before You Begin
To Configure the Front-end MTA Relay with LMTP
To Configure Back-End Stores with LMTP and a Minimal MTA
LMTP Protocol as Implemented
13
Vacation Automatic Message Reply
Vacation Autoreply Overview
Configuring Autoreply
To Configure Autoreply on the Back-end Store System
To Configure Autoreply on a Relay
To Share Autoreply Information Between Relays
Vacation Autoreply Theory of Operation
Vacation Autoreply Attributes
Other Auto Reply Tasks and Issues
To Send Autoreply Messages for Email That Have Been Automatically Forwarded from Another Mail Server
14
Mail Filtering and Access Control
PART 1. MAPPING TABLES
Controlling Access with Mapping Tables
Access Control Mapping Tables - Operation
Access Control Mapping Table Flags
Input vs Output Flags
Output Flag Argument Order
Send Access and Mail Access Mapping Tables
SEND_ACCESS and ORIG_SEND_ACCESS Mapping Tables
MAIL_ACCESS and ORIG_MAIL_ACCESS Mapping Tables
FROM_ACCESS Mapping Table
PORT_ACCESS Mapping Table
IP_ACCESS Mapping Table
When Access Controls Are Applied
To Test Access Control Mappings
To Limit Specified IP Address Connections to the MTA
To Add SMTP Relaying
Allowing SMTP Relaying for External Sites
Configuring SMTP Relay Blocking
Differentiate Between Internal and External Mail
Differentiate Authenticated Users' Mail
To Add Distinguishing Authenticated Submissions
Prevent Mail Relay
To Use DNS Lookups Including RBL Checking for SMTP Relay Blocking
Handling Large Numbers of Access Entries
Controlling the Envelope From: Address in Mappings Strings and Mailing List Named Options and LDAP Attributes
PART 2. MAILBOX FILTERS
Sieve Filter Support
Sieve Filtering Overview
To Create User-level Filters
To Create Channel-level Filters
To Create a Channel-level Filter
Managing Sieve Scripts
Location of Managed Sieves
Script Name Storage
Stored Script Semantics
ManageSieve Service Configuration
Configuring the ManageSieve Service
Supported Channel Options
Supported ManageSieve-Channel-Specific Options
ManageSieve Server Use of PORT_ACCESS Mapping
Basic Command/Response Test Script
To Create MTA-Wide Filters
Routing Discarded Messages Out the FILTER_DISCARD Channel
To Debug User-level Filters
imsimta test -exp
Output
imsimta test -exp
Syntax
15
Using and Configuring MeterMaid for Access Control
Overview of MeterMaid
How MeterMaid Works
Options for MeterMaid
Limit Excessive IP Address Connections Using Metermaid – Example
Configuring check_metermaid.so Clients to Access Multiple MeterMaid Servers
Considerations for Distributing Load Across Multiple MeterMaid Servers
Configuring check_metermaid.so to Access Multiple MeterMaid Servers
16
Implementing Greylisting by Using MeterMaid
About Greylisting
Basic Greylisting Implementation
Enhancing Greylisting Functionality
Preloading the Greylisting Table with Outbound Transactions
Matching a Range of IP Addresses
Simplifying the Sender Address
Providing an Opt-In Mechanism
Whitelisting Based on User's Addressbook
Combining Functionality: A Complex Example
Mapping Table Notes
17
MeterMaid Reference
configutil Options
Table Types
greylisting Tables
simple Tables
throttle Tables
check_metermaid.so Reference
adjust Routine
adjust_and_test Routine
fetch Routine
greylisting Routine
remove Routine
store Routine
test Routine
throttle Routine
18
Message Tracking and Recall
Tracking and Recall MTA and Channel Options
19
Administering Event Notification Service
ENS Publisher in Messaging Server
Configuring the ENS Publisher in Unified Configuration
Administering Event Notification Service
Starting and Stopping ENS
Event Notification Service Configuration Options
ENS SSL Support
ENS Support for Password Based Authentication
20
Messaging Server Specific Event Notification Service Information
Event Notification Types and Options
Event Types
Options
Mandatory Event Reference Options
Optional Event Reference Options
Available Options for Each Event Type
Payload
Payload Configuration Options
Examples
Implementation Notes
21
Event Notification Service C API Reference
API Overview
API Basic Usage
Client API ens_sopen
API Usage Notes
22
Configuring IMAP IDLE
Benefits of Using IMAP IDLE
Configuring IMAP IDLE with ENS in Unified Configuration
Prerequisites for Configuring IMAP IDLE with ENS
To Configure IMAP IDLE with ENS
To Disable IMAP IDLE
23
Lemonade Profile 1 Support
Introduction to Lemonade
Lemonade Features
Support for BURL
IMAP URLAUTH Support
IMAP CATENATE Support
IMAP Conditional Store Operation Support
IMAP ANNOTATE Support
Controlling IMAP CAPABILITIES Vector
Support for SMTP Submission Service Extension for Future Message Release
24
Managing Logging
Overview of Logging
What Is Logging and How Do You Use it?
Types of Logging Data
Types of Messaging Server Log Files
Tools for Managing Logging
Tracking a Message Across the Various Log Files
Managing MTA Message and Connection Logs
Understanding the MTA Log Entry Format
Enabling MTA Logging
Specifying Additional MTA Logging Options
MTA Message Logging Examples
Enabling Dispatcher Debugging
Managing Message Store, Admin, and Default Service Logs
msconfig Logging Options
Understanding Service Log Characteristics
Understanding Service Log File Format
Defining and Setting Service Logging Options
Searching and Viewing Service Logs
Working With Service Logs
Implementing and Configuring Message Store Transaction Logging
Overview of Message Store Transaction Logging
Message Store Transaction Logging Log Entries
Configuring Message Store Transaction Logging
Message Store Transaction Log Examples
Other Message Store Logging Features
Message Store Logging Examples
Using Message Store Log Messages
MMP Logging
25
Monitoring Messaging Server
Automatic Monitoring and Restart
Daily Monitoring Tasks
Checking Postmaster Mail
Monitoring and Maintaining the Log Files
Setting Up the msprobe Utility
Utilities and Tools for Monitoring
26
Monitoring the MTA
Monitoring the Size of the Message Queues
Symptoms of Message Queue Problems
To Monitor the Size of the Message Queues
Checking for Held messages
Monitoring Rate of Delivery Failure
Symptoms of Rate of Delivery
To Monitor the Rate of Delivery Failure
Monitoring Inbound SMTP Connections
Symptoms of Unauthorized SMTP Connections
To Monitor Inbound SMTP Connections
Monitoring the Dispatcher and Job Controller Processes
Symptoms of Dispatcher and Job Controller Processes Down
To Monitor Dispatcher and Job Controller Processes
27
SNMP Support
SNMP Implementation
SNMP Operation in Messaging Server
Configuring SNMP Support for Oracle Solaris 10
Net-SNMP Configuration
Messaging Server Subagent Configuration
Running as a Standalone SNMP Agent
Monitoring Multiple Instances of Messaging Server
Using Standalone Agents for High-availability Failover
Distinguishing Multiple Instances Through SNMP v3 Context Names
Messaging Server's Net-SNMP-based SNMP Subagent Options
Monitoring from an SNMP Client
SNMP Information from the Messaging Server
applTable
assocTable
mtaTable
mtaGroupTable
mtaGroupAssociationTable
mtaGroupErrorTable
28
Short Message Service (SMS)
Introduction
One-Way SMS
Two-Way SMS
Requirements
SMS Channel Theory of Operation
Directing Email to the Channel
The Email to SMS Conversion Process
Sample Email Message Processing
The SMS Message Submission Process
Site-defined Address Validity Checks and Translations
Site-defined Text Conversions
Message Header Entries
Message Body Entries
Example SMS Mapping Table
SMS Channel Configuration
Adding an SMS Channel
Adding the Channel Definition and Rewrite Rules
To Add Channel Definition and Rewrite Rules
Controlling the Number of Simultaneous Connections
Setting SMS Channel Options
Available Options
Email to SMS Conversion Options
SMS Gateway Server Option
SMS Options
SMPP Options
Localization Options
Formatting Templates
Adding Additional SMS Channels
Adjusting the Frequency of Delivery Retries
Sample One-Way Configuration (MobileWay)
Debugging
Configuring the SMS Channel for Two-Way SMS
SMS Gateway Server Theory of Operation
Function of the SMS Gateway Server
Behavior of the SMPP Relay and Server
Remote SMPP to Gateway SMPP Communication
SMS Reply and Notification Handling
Routing Process for SMS Replies
SMS Gateway Server Configuration
Setting Up Bidirectional SMS Routing
Set the SMS Address Prefix
Set the Gateway Profile
Configure the SMSC
Enabling and Disabling the SMS Gateway Server
Starting and Stopping the SMS Gateway Server
SMS Gateway Server Configuration File
Configuring Email-To-Mobile on the Gateway Server
A Gateway Profile
An SMPP Relay
An SMPP Server
Configuring Mobile-to-Email Operation
Configure a Mobile-to-Email Gateway Profile
Configure a Mobile-Email SMPP Server
Configuration Options
Global Options
Thread Tuning Options
Historical Data Tuning
Miscellaneous
SMPP Relay Options
SMPP Server Options
Gateway Profile Options
Configuration Example for Two-Way SMS
SMS Gateway Server Storage Requirements
SMS Configuration Examples
29
Configuring Messaging Server for One-Way SMS
30
Configuring Messaging Server for Two-Way SMS
31
Using the iSchedule Channel to Handle iMIP Messages
Inviting Users on Internal and External Calendar Systems Background
Manually Accepting External Invitations
Automatically Accepting External Invitations
Message Server iMIP Configuration Overview
Configuring the iSchedule Channel for iMIP Messages in Unified Configuration
Using the iSchedule Recipe to Automate Configuring the iSchedule Channel in Unified Configuration
Manually Configuring the iSchedule Channel in Unified Configuration
Verifying the Calendar Server Configuration
Modifying iSchedule Channel Options
To Enable or Disable iMIP Message Processing
To Modify the iSchedule Service URL
Configuring the iSchedule Channel in Legacy Configuration
Troubleshooting the iSchedule Configuration
32
Handling sendmail Clients
To Create the sendmail Configuration File on Oracle Solaris 8 Platforms
To Create the sendmail Configuration File on Oracle Solaris 9 Platforms
33
Handling Forged Email by Using the Sender Policy Framework
About Sender Policy Framework
SPF Theory of Operations
SPF Limitations
SPF Pre-Deployment Considerations
Setting up the Technology
Reference Information
Testing SPF by Using spfquery
Syntax
Example with Debugging Enabled
Handling Forwarded Mail in SPF by Using the Sender Rewriting Scheme (SRS)
34
Classic Message Store Directory Layout
About the Classic Message Store Directory Layout
35
Monitoring LDAP Directory Server
Symptoms of slapd Problems
To Monitor slapd
36
Monitoring System Performance
Monitoring End-to-end Message Delivery Times
Monitoring CPU Usage
37
Monitoring the Message Store
General Message Store Monitoring Procedures
Checking Hardware Space
Checking Log Files
Checking User IMAP/POP/Webmail Session by Using Telemetry
Checking stored Processes
Checking Database Log Files
Checking User Folders
Checking for Core Files
Monitoring imapd, popd and httpd
Symptoms of imapd, popd and httpd Problems
To Monitor imapd, popd and httpd
Monitoring the stored Process
Symptoms of stored Problems
To Monitor stored
Monitoring the State of Message Store Database Locks
Symptoms of Message Store Database Lock Problems
To Monitor Message Store Database Locks
To Monitor Mailbox Quotas and Usage
To Monitor Message Store Database Statistics with imcheck
Gathering Message Store Counter Statistics by Using counterutil
To Get a Current List of Available Counter Objects
counterutil Output
Gathering Alarm Statistics by Using counterutil
IMAP, POP, HTTP, and MMP Connection Statistics by Using counterutil
Disk Usage Statistics by Using counterutil
Server Response Statistics
38
Monitoring User Access to the Message Store
39
Message Archiving
Microsoft Exchange Envelope Journaling
Archiving Overview
Message Archiving Systems: Compliance and Operational
40
Unified Messaging
Using Messaging Server to Manage Unified Messaging
What Is the Challenge?
The Oracle Solution
Open Standards and Regulatory Requirements
Architectural Overview of a Unified Messaging Application
Message Deposit
Message Retrieval via Telephone User Interface
Message Retrieval via PC
Message Retrieval Through an IMAP Client
Message Retrieval Through Convergence
Designing and Coding Your Unified Messaging Application
Planning the Message-Type Configuration
Coding and Configuring Your UM System
Mailbox Administration and Operations
Sample IMAP Sessions Using Message-Type Flags
Administering Quotas for Message Types
Expiring Messages by Message Type
Delivering Notifications for Message Types
Notifications for Particular Message States
How Do You Implement Notifications for Message Types?
Notification Properties for Message Types
Additional Unified Messaging Support Features
Set IMAP Flag Based on Header Value at Delivery
Modifications to IMAP Commands to Provide Message Counts
IMAP Unauthenticate
Modify IMAP APPEND to bypass quotas
SMTP Future Release
41
Messaging Server Command-Line Reference
configure Command
Syntax
Options
Examples
configtoxml Command
Syntax
Options
Example
Notes on the configtoxml Command
msconfig Command
Syntax
Options
Notes on the msconfig Command
Option Name Changes in Unified Configuration
Using the msconfig Command in Edit Mode
Part II Improving Performance
42
Messaging Server Tuning and Best Practices
Log Files Tips
LMTP Tips
Message Store Tips
MTA Tips
Performance Tuning Tips
43
Tuning the mboxlist Database Cache in Unified Configuration
Setting the Mailbox Database Cache Size
To Adjust the Mailbox Database Cache Size
To Monitor the Mailbox Database Cache Size
44
Best Practices for Messaging Server and ZFS
Before You Begin
Configuration Recommendations for ZFS and Messaging Server
mboxlist Database, Message File and Index Cache Files Overview
Index Cache Record File System
Access Time Record
ZFS Pool Space Utilization
To Configure ZFS and Messaging Server
ZFS Administration Recommendations
Part III Troubleshooting
45
Troubleshooting the MTA
Troubleshooting Overview
Standard MTA Troubleshooting Procedures
Check the MTA Configuration
Check the Message Queue Directories
Check the Ownership of Critical Files
Check that the Job Controller and Dispatcher Are Running
Check the Log Files
Running a Channel Program Manually
Starting and Stopping Individual Channels
To Stop Outbound Processing (dequeueing) for a Specific Channel
To Stop Inbound Processing from a Specific Domain or IP Address (Enqueuing to a Channel)
An MTA Troubleshooting Example
Identify the Channels in the Message Path
Manually Start and Stop Channels to Gather Data
Common MTA Problems and Solutions
TLS Problems
Changes to Configuration Files or MTA Databases Do Not Take Effect
The MTA Sends Outgoing Mail but Does Not Receive Incoming Mail
Dispatcher (SMTP Server) Won't Start Up
Timeouts on Incoming SMTP Connections
To Identify the Causes of Timeouts on Incoming SMTP Connections
Messages Are Not Dequeued
Creating a New Channel
MTA Messages Are Not Delivered
Messages are Looping
Diagnosing and Cleaning up .HELD Messages
Received Message is Encoded
Server-Side Rules (SSR) Are Not Working
Testing Your SSR Rules
Common Syntax Problems
Slow Response After Users Press Send Email Button
Asterisks in the Local Parts of Addresses or Received Fields
Abnormal Job Controller Terminations Seen in
job_controller
Logs
General Error Messages
Errors in mm_init
Compiled Configuration Version Mismatch
Swap Space Errors
File Open or Create Errors
Illegal Host/Domain Errors
Errors in SMTP channels, os_smtp_* errors
46
Troubleshooting the Message Store
Repairing Mailboxes and the Mailboxes Database (reconstruct Command)
Reduced Message Store Performance
Convergence Not Loading Mail Page
Command Using Wildcard Pattern Does Not Work
Unknown/invalid Partition
User Mailbox Directory Problems
Store Daemon Not Starting
User Mail Not Delivered Due to Mailbox Overflow
IMAP Events Become Slow
Part IV Managing the Message Store and Mailboxes
47
Managing Mailboxes
To Manage Mailboxes with mboxutil
Examples
To Move Mailboxes to a Different Disk Partition
To Remove Orphan Accounts
To Find a Mailbox's Directory Using hashdir
To Find Out How Many Users Have Read Messages in a Shared Folder
48
Backing Up and Restoring the Message Store
Mailbox Backup and Restore Overview
To Create a Mailbox Backup Policy
Peak Business Loads
Full and Incremental Backups
Parallel or Serial Backups
To Create Backup Groups
Pre-defined Backup Group
To Run the imsbackup Utility
Running the imsbackup Utility
Incremental Backup
Excluding Bulk Mail When You Perform Backups
To Restore Mailboxes and Messages
Considerations for Partial Restore
To Restore Messages from a Mailbox that Has Been Incrementally Backed-up
To Use StorageTek Enterprise Backup Software
To Back Up Data By Using StorageTek Enterprise Backup Software
Restoring Data Using StorageTek Enterprise Backup Software
To Use a Third Party Backup Software (Besides StorageTek Enterprise Backup Software)
Troubleshooting Backup and Restore Problems
Message Store Disaster Backup and Recovery
49
Administering Very Large Mailboxes
Very Large Mailboxes Overview
The Structure of a Mailbox
Mailbox Size Limit
Mailbox Migration
Pre-Deployment Preparations
Checking Mailbox Data
50
Message Store Message Expiration
imexpire Overview
To Deploy the Message Expiration Feature
To Define Message Expiration Policy
Examples of Message Expiration Policy
To Set Rules Implementing Message Expiration Policy
Expiration Rules Guidelines
Localized Mailbox Names in imexpire
Setting imexpire Rules Textually
Example imexpire Rules
Setting imexpire Folder Patterns
51
Configuring Message Expiration (Tasks)
To Set imexpire Rules Textually
To Set Expiration Rules by Using the msconfig Command
To Set imexpire Folder Patterns
To Schedule Message Expiration and Logging Level
Expire and Purge Log and Scheduling Options
To Set imexpire Logging Levels
To Exclude Specified Users from Message Expiration
52
Configuring POP, IMAP, and HTTP Services
General Configuration
Enabling and Disabling Services
Specifying Port Numbers
Ports for Encrypted Communications
IMAP Over SSL
POP Over SSL
HTTP Over SSL
Service Banner
Login Requirements
To Set the Separator for POP Clients
To Allow Log In without Using the Domain Name
Password-Based Login
Certificate-Based Login
Performance Options
Number of Processes
Number of Connections per Process
Number of Threads per Process
Dropping Idle Connections
Logging Out HTTP Clients
Client Access Controls
To Configure POP Services
To Configure IMAP Services
Configuring IMAP IDLE
To Configure the mshttpd Process for Use by Convergence
Configuring Your HTTP Service
53
Handling Message Store Overload
Overview of Managing Message Store Load
Message Store Load Throttling
Job Controller Stress Handling
Default Job Controller Configuration
54
Managing Message Store Partitions and Adding Storage
Message Store Partition Overview
To Add a Message Store Partition
To Change the Default Message Store Partition
Adding More Physical Disks to the Message Store
55
Managing Message Store Quotas
Message Store Quota Overview
Quota Overview
Quota Theory of Operations
Message Store Quota Attributes and Options
To Specify a Default User Quota
To Specify Individual User Quotas
To Specify Domain Quotas
To Set Up Quota Notification
To Disable Quota Notification
To Enable or Disable Quota Enforcement
To Enable Quota Enforcement at the User level
To Perform Quota Enforcement at the Domain Level
Disabling Quota Enforcement
To Set a Grace Period
Netscape Messaging Server Quota Compatibility Mode
56
Managing Message Types in the Message Store
To Configure Message Types
Sending Notification Messages for Message Types
Administering Quotas by Message Type
Before You Set Message-Type Quotas
Methods of Setting Message-Type Quotas
Example of a Message-Type Quota Root
Expiring Messages by Message Type
Example: Sample Rules for Expiring Different Message Types
57
Managing Shared Folders
Shared Folders Overview
Specifying Sharing Attributes for Private Shared Folders
To Create a Public Shared Folder
To Grant Folder Access Rights Based on Group Membership
To Set or Change a Shared Folder's Access Control Rights
Shared Folder Examples
Enabling or Disabling Listing of Shared Folders
Setting Up Distributed Shared Folders
Setting Up Distributed Shared Folders-Example
Monitoring and Maintaining Shared Folder Data
To Monitor Shared Folder Usage
To List Users and Their Shared Folders
To Remove Inactive Users
To Set Access Rights
58
Upgrading the Classic Message Store
Architecture and Components
Classic Message Store Component Version Compatibilities
Upgrading the Mailboxes
Upgrading and Downgrading the Berkeley Database (BDB)
Database BTREE File
Database Log Files
IMAPD, MSHTTPD and Convergence
Upgrading from Messaging Server 32-bit to 64-bit
Migrating from x86 to SPARC
stored -r
ims_db_upgrade
Downgrading
Significant Changes in the Classic Message Store Between Versions
Changes from Messaging Server 6.3 to Messaging Server 7.0
Changes to
store.idx
Classic Message Store Maintenance Queue and
impurge
Mailbox Self-Healing (Auto-Repair)
Changes from Messaging Server 7 to Messaging Server 7 Update 1
Berkeley Database Upgrade
Changes from Messaging Server 7 Update 1 to Messaging Server 7 Update 5
Changes to the Owner's Seen and Deleted Flags
Immediate flag update and state sharing
Change to the
service.imap.capability.condstore
option
Changes to the Berkeley Database
Changes to
mboxlist
and
lockdir
BDB environments
59
Message Store Automatic Recovery On Startup
Overview of Automatic Recovery on Startup
Automatic Startup and Recovery Theory of Operations
Error Messages Signifying reconstruct Is Needed
Message Store Database Snapshot Theory of Operations
Message Store Database Snapshot Interval and Location
Message Store Database Snapshot Options
60
Message Store Maintenance Queue
Message Store Maintenance Queue Overview
Displaying the Maintenance Queue
Deleting, Expunging, Purging, and Cleaning Up Messages
Mailbox Self Healing (Auto Repair)
Maintenance Queue Configuration Options
The impurge Command
61
Message Store Message Type Overview
About Message Type
Planning the Message-Type Configuration
Defining and Using Message Types
Message Types in IMAP Commands
62
Migrating Mailboxes to a New System
Tools Summary for Relocating Messaging Server Users to a New Mailhost
Migrating Mailboxes from an x86 Host to a SPARC Host
Moving Mailboxes to Another Messaging Server While Online
Advantages
Disadvantages
Incremental Mailbox Migration While Online
Online Migration Overview
To Migrate User Mailboxes from One Messaging Server to Another While Online
To Move Mailboxes Using an IMAP Client
To Move Mailboxes by Using the imsimport Command
63
Monitoring Disk Space
Disk Space Overview
Symptoms of Insufficient Disk Space
Monitoring Disk Space
Monitoring the Message Store
Monitoring Message Store Partitions
64
Protecting Mailboxes from Deletion or Renaming
65
Reducing Message Store Size Due to Duplicate Storage
Relinker Overview
Using relinker in the Command Line Mode
Using Relinker in the Realtime Mode
Configuring Relinker
66
Specifying Administrator Access to the Message Store
Overview of Message Store Administrators
Adding an Administrator Entry
Modifying or Deleting an Administrator Entry
67
Constructing Valid Message Store UIDs and Folder Names
Message Store User ID
Message Store Mailbox Name for Commands
Valid UIDs
68
Message Store Automatic Failover with Database Replication
Overview of Message Store Database Replication
Configuration Options
Configuration Options
Command-line Utilities
Configuring Message Store Database Replication
To Configure a Three Node Cluster for HA
To Change the DB Replication Local Instance Port
Message Store Automatic Failover
Basic Requirements
Overview of Message Store Automatic Failover
Configuring Message Store Automatic Failover
To Configure the LMTP Server
To Configure the Client
69
Administering Message Store Database Snapshots (Backups)
To Specify Message Store Database Snapshot Interval and Location
Message Store Database Snapshot Recovery and Verification
Message Store Database Snapshot Rolling Backup
Message Store Database Recovery
70
Classic Messaging Server and Tiered Storage Overview
Overview of Messaging Server Storage
Message Store and ZFS
How the Message Store Works
Messaging Server Disk Throughput
Messaging Server Disk Capacity
Disk Sizing for MTA Message Queues
MTA Message Queue Performance
MTA Message Queue Availability
MTA Message Queue Available Disk Sizing
Performance Considerations for a Message Store Architecture
Messaging Server Directories (General Recommendations for Storage)
MTA Queue Directory
Messaging Server Log Directory
Mailbox Database Files
Message Store Index Files
Message Files
Mailbox List Database Temporary Directory
Multiple Store Partitions
Setting Disk Stripe Width
MTA Performance Considerations
MTA and RAID Trade-offs
Background: Communication Services Logical Architectures Overview
Two-tiered Logical Architecture
Benefits of a Two-tiered Architecture
Horizontal Scalability Strategy
Scaling Front-end and Back-end Services
Implementing Local Message Transfer Protocol (LMTP) for Messaging Server
Background: "How Email Works" Introduction to Messaging Server
What Does Messaging Server Enable Users to Do?
A User Decides to Send an Email
User Receives an Email
User Access Mailbox
71
Message Store Command Reference
configutil
counterutil
deliver
hashdir
imcheck
imdbverify
imexpire
iminitquota
immonitor-access
impurge
imquotacheck
imsasm
imsbackup
imsconnutil
imscripter
imsexport
imsimport
imsrestore
mboxutil
mkbackupdir
msprobe
msuserpurge
readership
reconstruct
refresh
rehostuser
relinker
start-msg
stop-msg
stored
Part V Managing the Cassandra Message Store
72
Overview of Cassandra Message Store and Solr
About the Cassandra Message Store and Solr Indexing and Search
Differences in Cassandra Message Store and Classic Message Store
Differences Between Solr and Indexing and Search Service
Differences in Index and Search Features
Differences Between Cassandra and Classic Store IMAP Searching
Wildcard Search
Special Characters and Searching
Words Not Indexed by Solr
73
Managing Cassandra Message Store
Restarting a Cassandra Message Store Cluster
Scaling Your Cassandra Message Store Deployment Horizontally
Adding an Access-Tier Node (IMAP/LMTP Server/enpd)
Managing Your Cassandra Message Store Availability
Removing an Access-Tier Node (IMAP/LMTP Server/enpd)
Scripting on this page enhances content navigation, but does not change the content in any way.