1/83
Contents
Title and Copyright Information
Preface
Audience
Related Documents
Document Revision History
Documentation Accessibility
Part I Monitoring and Managing Messaging Server
1
Messaging Server System Administration Overview
About Messaging Server
Messaging Server Configuration Methods
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
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
Starting and Stopping Services
To Start and Stop Messaging Server Services in an HA Environment
To Start and Stop Messaging Server Services in a non-HA Environment
To Start Up, Shut Down, or View the Status of Messaging Services
Starting and Stopping a Messaging Server Running in MTA-only Mode
Automatic Restart of Failed or Unresponsive Services
Overview of Messaging Server Monitoring Processes
Automatic Restart in High Availability Deployments
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
4
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
5
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
6
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
7
About MTA Services
MTA Configuration Overview
Compiling the MTA Configuration
Changes for Compiled MTA Configurations
Recompiling the MTA Configuration
8
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
9
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
10
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
11
LMTP Delivery
Overview of LMTP
LMTP Delivery Features
Support for LMTP Client and Server to Detect and Respond to Certain Conditions
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
12
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
13
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
14
Using and Configuring MeterMaid for Access Control
Technical Overview
Theory of Operations
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
15
Implementing Greylisting by Using MeterMaid
What is Greylisting and How Does It Work?
Basic Greylisting Implementation
Using Greylisting with Messaging Server
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
16
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
17
Message Tracking and Recall
18
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
19
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
20
Event Notification Service C API Reference
API Overview
API Basic Usage
New Client API ens_sopen
API Usage Notes
21
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
22
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
23
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
24
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
25
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
26
SNMP Support
SNMP Implementation
SNMP Operation in the 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
27
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
28
Configuring Messaging Server for One-Way SMS
29
Configuring Messaging Server for Two-Way SMS
30
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
31
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
32
Handling Forged Email by Using the Sender Policy Framework
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)
33
Message Store Directory Layout
Message Store Directory Layout
34
Shared Folders Overview
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
stored
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
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
ZFS Reference
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 Java Message Queue Notifications
47
Java Message Queue Notification
Two Notification Messaging Services
Notification Plug-ins
Benefits of Using JMQ Notification
Publishing to a Topic or a Queue
Using Multiple JMQ Notification Plug-ins
Configuring Options for a Notification Plug-in
Configuring Conditional Notifications for Specified Users
Sending Conditional Notifications to Distributed Message Queue Destinations
JMQ Notification
Setting JMQ Notifications in Unified Configuration
Where to Go for More Information
48
Java Message Queue Notification Messages and Properties
Notification Messages
Rules and Guidelines for Notification Messages
Notifications for Particular Message Types
Setting Different Options on a per-messagetype Basis
Default Values of the
notifytarget
Options
Notification Message Properties
Standard Notification Message Properties
Properties Specific to Particular Notification Messages
Syntax for newflags and oldflags Properties
Properties Carried with Each Notification Message
49
Configuring a JMQ Notification Service (Tasks and Examples)
Planning for Your JMQ Notification Service
To Configure an Instance of the JMQ Notification Plug-in
Before You Begin
Specifying Notification Messages that Use More Than One
msconfig
Option
To Configure New-Message and Updated-Message Notifications with Message Headers and Message Bodies
To Configure Deleted-Message Notifications with Message Headers
Configuring Notifications for Changes in Message Status
To Enable Notifications When Message-Flags Have Changed
To Enable Conditional Notifications for Specified Users
To Configure Conditional Notifications to Be Sent to Different Message Queue Destinations
50
Enabling JMQ Event Notification (Example)
Event Notifications in Messaging Server Overview
Enable Java Message Queue (JMQ)
Configure and Enable the Messaging Server jmqnotify Plugin
Verify the JMQ Broker
Related Information
Part V Managing the Message Store and Mailboxes
51
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
52
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
53
Administering Very Large Mailboxes
Very Large Mailboxes Overview
The Structure of a Mailbox
Mailbox Size Limit
Mailbox Migration
Pre-Deployment Preparations
Checking Mailbox Data
54
Message Store Message Expiration
imexpire Theory of Operation
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
55
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
56
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
57
Handling Message Store Overload
Overview of Managing Message Store Load
Message Store Load Throttling
Job Controller Stress Handling
Default Job Controller Configuration
58
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
59
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
60
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
61
Managing Shared Folders
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
62
Upgrading the Message Store
Architecture and Components
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 Message Store Between Versions
Changes from Messaging Server 6.3 to Messaging Server 7.0
Changes to
store.idx
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
63
Message Store Automatic Recovery On Startup
Overview of Automatic Recovery on Startup
Automatic Startup and Recovery Theory of Operations
Error Messages Signifying that reconstruct is Needed
Message Store Database Snapshot Theory of Operations
Message Store Database Snapshot Interval and Location
Message Store Database Snapshot Options
64
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
65
Message Store Message Type Overview
About Message Type
Planning the Message-Type Configuration
Defining and Using Message Types
Message Types in IMAP Commands
66
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
67
Monitoring Disk Space
Overview
Symptoms of Insufficient Disk Space
Monitoring Disk Space
Monitoring the Message Store
Monitoring Message Store Partitions
68
Protecting Mailboxes from Deletion or Renaming
69
Reducing Message Store Size Due to Duplicate Storage
Relinker Theory of Operations
Using relinker in the Command Line Mode
Using Relinker in the Realtime Mode
Configuring Relinker
70
Specifying Administrator Access to the Message Store
Overview
Adding an Administrator Entry
Modifying or Deleting an Administrator Entry
71
Valid Message Store UIDs and Folder Names
Message Store User ID
Message Store Mailbox Name for Commands
Valid UIDs
72
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
73
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
74
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
75
Message Store Command Reference
configutil
counterutil
deliver
hashdir
imarchive
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
Scripting on this page enhances content navigation, but does not change the content in any way.