Documentation Home
> Sun Java System Messaging Server 6.3 Administration Guide
Sun Java System Messaging Server 6.3 Administration Guide
Book Information
Index
Numbers and Symbols
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Preface
Chapter 1 Post-install Tasks and Layout
1.1 Creating UNIX System Users and Groups
To Create UNIX System Users and Groups
1.2 To Prepare Directory Server for Messaging Server Configuration
1.3 Creating the Initial Messaging Server Runtime Configuration
1.3.1 Messaging Server Prerequisites
1.3.2 Messaging Server Configuration Checklist
To Run the Configure Program
To Perform a Silent Installation
1.4 Installing Messaging Server Against a Directory Server Replica
To Install Messaging Server Against a Directory Server Replica
1.5 Installing Messaging Server Provisioning Tools
1.5.1 Schema 1 Delegated Administrator for Messaging
To Install iPlanet Delegated Administrator
1.5.2 LDAP Provisioning Tools
To Install Schema 1 LDAP Provisioning Tools
1.6 SMTP Relay Blocking
1.7 Enabling Startup After a Reboot
To Enable Messaging Server After a Reboot
1.8 Handling sendmail Clients
To Obtain the Proper Version of the /usr/lib/sendmail on Solaris 8
To Create the sendmail Configuration File on Solaris 9 Platforms
1.9 Configuring Messenger Express and Communications Express Mail Filters
1.10 Performance and Tuning
1.10.1 Java Message Queue (JMQ) Tuning
1.11 Post-Installation Directory Layout
1.12 Post-Installation Port Numbers
To Change Port Numbers
Chapter 2 Upgrading from Messaging Server 5.2 to Sun Java System Messaging Server
2.1 Information Moved
Chapter 3 Configuring High Availability
3.1 Supported Versions
3.2 High Availability Models
3.2.1 Asymmetric
3.2.2 Symmetric
3.2.3 N+1 (N Over 1)
3.2.4 Choosing a High Availability Model
3.2.5 System Down Time Calculations
3.3 Installing Messaging Server High Availability—Overview
3.3.1 Cluster Agent Installation
3.3.2 Messaging Server and High Availability Notes
3.3.3 Using the useconfig Utility
3.4 Sun Cluster Installation
3.4.1 Sun Cluster Requirements
3.4.2 About HAStoragePlus
3.4.3 Configuring Messaging Server with Sun Cluster HAStorage or HAStoragePlus
To Configure Messaging Server with Sun Cluster HAStorage or HAStoragePlus—Generic Example
To Unconfigure Messaging Server HA Support for Sun Cluster 3.x—Generic Example
To Configure a Two-node Symmetric Messaging Server—Example
To Unconfigure an HA Symmetric Deployment
To Configure a Two-node HA Asymmetric Messaging Server—Example
3.4.3.1 How to Enable Debugging on Sun Cluster
3.4.4 Binding IP Addresses on a Server
To Bind IP Addresses on a Server
3.4.5 Helpful Sun Cluster Commands to Manage Messaging HA
3.5 Veritas Cluster Server Agent Installation
3.5.1 Veritas Cluster Server Requirements
3.5.2 VCS Installation and Configuration Notes
To Configure Messaging Server as an HA Service by Using Veritas Cluster Server
3.5.3 MsgSrv Attributes and Arguments
3.6 Unconfiguring High Availability
To Unconfigure the Veritas Cluster Server
Chapter 4 Configuring General Messaging Capabilities
4.1 To Modify Your Passwords
4.2 Managing Mail Users, Mailing Lists and Domains
To Remove a User from Messaging Server
To Remove a Domain from Messaging Server
4.3 Managing Messaging Server with Sun ONE Console
4.4 Starting and Stopping Services
4.4.1 To Start and Stop Services in an HA Environment
4.4.2 To Start and Stop Services in a non-HA Environment
To Start Up, Shut Down, or View the Status of Any Messaging Services
4.4.2.1 To Specify What Services Can Be Started
4.4.3 Starting and Stopping a Messaging Server Running in MTA-only Mode
4.5 Automatic Restart of Failed or Unresponsive Services
4.5.1 Automatic Restart in High Availability Deployments
4.6 To Schedule Automatic Tasks
4.6.1 Scheduler Examples
4.6.2 Pre-defined Automatic Tasks
4.7 To Configure a Greeting Message
To Create a New User Greeting
4.7.1 To Set a Per-Domain Greeting Message
4.7.1.1 Greeting Message Theory of Operations
4.8 To Set a User-Preferred Language
4.8.1 To Set a Domain Preferred Language
To Specify a Site Language
4.9 To Customize Directory Lookups
To Modify the Messaging Server LDAP User-lookup Settings
4.10 Encryption Settings
4.11 Setting a Failover LDAP Server
To Set a Failover LDAP Server
4.12 Email Security Concerns
Chapter 5 Configuring POP, IMAP, and HTTP Services
5.1 General Configuration
5.1.1 Enabling and Disabling Services
5.1.2 Specifying Port Numbers
5.1.3 Ports for Encrypted Communications
5.1.3.1 IMAP Over SSL
5.1.3.2 POP Over SSL
5.1.3.3 HTTP Over SSL
5.1.4 Service Banner
5.2 Login Requirements
To Set the Login Separator for POP Clients
5.2.1 To Allow Log In without Using the Domain Name
5.2.2 Password-Based Login
5.2.3 Certificate-Based Login
5.3 Performance Parameters
5.3.1 Number of Processes
5.3.2 Number of Connections per Process
5.3.3 Number of Threads per Process
5.3.4 Dropping Idle Connections
5.3.5 Logging Out HTTP Clients
5.4 Client Access Controls
5.5 To Configure POP Services
5.6 To Configure IMAP Services
5.6.1 Configuring IMAP IDLE
5.6.1.1 Prerequisites
To Configure IMAP IDLE
5.7 To Configure HTTP Services
5.7.1 Configuring Your HTTP Service
Chapter 6 Enabling Single Sign-On (SSO)
6.1 Access Manager SSO for Sun Java System Servers
6.1.1 SSO Limitations and Notices
6.1.2 Configuring Messaging Server to Support SSO
6.1.3 Troubleshooting SSO
6.2 Trusted Circle SSO (Legacy)
6.2.1 Trusted Circle SSO Overview and Definitions
6.2.2 Trusted Circle SSO Applications
6.2.3 Trusted Circle SSO Limitations
6.2.4 Example Trusted Circle SSO Deployment Scenarios
6.2.5 Setting Up Trusted Circle SSO
To Set Up SSO for Messenger Express, Delegated Administrator, and Calendar Manager
6.2.6 Messenger Express Trusted SSO Configuration Parameters
Chapter 7 Configuring and Administering Multiplexor Services
7.1 Multiplexor Services
7.1.1 Multiplexor Benefits
7.2 About Messaging Multiplexor
7.2.1 How the Messaging Multiplexor Works
7.2.2 Encryption (SSL) Option
7.2.3 Certificate-Based Client Authentication
To Enable Certificate-based Authentication for Your IMAP or POP Service
7.2.4 User Pre-Authentication
7.2.5 MMP Virtual Domains
7.2.6 About SMTP Proxy
7.3 Setting Up the Messaging Multiplexor
7.3.1 Before You Configure MMP
7.3.2 Multiplexor Configuration
To Configure the MMP
7.3.3 Multiplexor Files
7.3.4 Starting the Multiplexor
7.3.5 Modifying an Existing MMP
7.4 Configuring MMP with SSL
To Configure MMP with SSL
To Configure MMP with Client Certificate-based Login
7.4.1 A Sample Topology
7.4.1.1 IMAP Configuration Example
7.4.1.2 POP Configuration Example
7.5 MMP Tasks
7.5.1 To Configure Mail Access with MMP
7.5.2 To Set a Failover MMP LDAP Server
Chapter 8 MTA Concepts
8.1 The MTA Functionality
8.2 MTA Architecture and Message Flow Overview
8.2.1 Dispatcher and SMTP Server (Slave Program)
8.2.1.1 Routing and Address Rewriting
Channels
Message Delivery
8.3 The Dispatcher
8.3.1 Creation and Expiration of Server Processes
8.3.2 To Start and Stop the Dispatcher
8.4 Rewrite Rules
8.5 Channels
8.5.1 Master and Slave Programs
8.5.2 Channel Message Queues
8.5.3 Channel Definitions
8.6 The MTA Directory Information
8.7 The Job Controller
8.7.1 To Start and Stop the Job Controller
Chapter 9 MTA Address Translation and Routing
9.1 The Direct LDAP Algorithm and Implementation
9.1.1 Domain Locality Determination
9.1.1.1 Rewrite Rule Machinery
9.1.1.2 Domain Map Determination of Domain Locality
9.1.1.3 Caching Of Domain Locality Information
9.1.1.4 Error Handling
9.1.1.5 Pattern for Domain Check Rewrite Rule
9.1.1.6 Putting It All Together
9.1.2 Alias expansion of local addresses
9.1.2.1 Alias Checking with LDAP URLs
9.1.2.2 The $V Metacharacter
9.1.2.3 Calling a Mapping from a URL
9.1.2.4 The $R Metacharacter
9.1.2.5 Determining the Attributes to Fetch
9.1.2.6 Handling LDAP Errors
9.1.2.7 Sanity Checks on the LDAP Result
9.1.2.8 Support for Vanity Domains
9.1.2.9 Support for Catchall Addresses
9.1.3 Processing the LDAP Result
9.1.3.1 Object Class Check
9.1.3.2 Entry Status Checks
9.1.3.3 UID Check
9.1.3.4 Message Capture
9.1.3.5 Seeding the Reversal Cache
9.1.3.6 Mail Host and Routing Address
9.1.3.7 Miscellaneous Attribute Support
9.1.3.8 Delivery Options Processing
9.1.3.9 Additional Metacharacters for Use in Delivery Options
9.1.3.10 Delivery Option Defaults
9.1.3.11 Start and End Date Checks
9.1.3.12 Optin and Presence Attributes
9.1.3.13 Sieve Filter Handling
9.1.3.14 Deferred Processing Control
9.1.3.15 Group Expansion Attributes
9.1.4 To Modify Group Membership Attribute Syntax
9.2 Address Reversal
9.3 Asynchronous LDAP Operations
9.4 Settings Summary
9.5 Processing Multiple Different LDAP Attributes with the Same Semantics
Chapter 10 About MTA Services and Configuration
10.1 Compiling the MTA Configuration
10.2 The MTA Configuration File
10.3 Mappings File
10.3.1 File Format in the Mappings File
10.3.1.1 Including Other Files in the Mappings File
10.3.2 Mapping Operations
10.3.2.1 Mapping Entry Patterns
10.3.2.2 IP Matching
10.3.2.3 Mapping Entry Templates
Wildcard Field Substitutions ($n)
Controlling Text Case ($\, $^, $_)
Processing Control ($C, $L, $R, $E)
Check for Special Flags
Entry Randomly Succeeds or Fails ($?x?)
Sequence Number Substitutions ($#...#)
URL substitutions, $]...[
Mapping Table Substitutions ($|...|)
General Lookup Table or Database Substitutions (${...})
Site-Supplied Routine Substitutions ($[...])
Generate UTF-8 Strings
10.4 Other MTA Configuration Files
10.4.1 Alias File
10.4.2 TCP/IP (SMTP) Channel Option Files
10.4.3 Conversion File
10.4.4 Dispatcher Configuration File
10.4.5 Mappings File
10.4.6 Option File
10.4.7 Tailor File
10.4.8 Job Controller File
10.4.8.1 Examples of Use
Example of Adding Additional Pools
10.5 Aliases
10.5.1 The Alias Database
10.5.2 The Alias File
10.5.3 Including Other Files in the Alias File
10.6 Command Line Utilities
10.7 SMTP Security and Access Control
10.8 Log Files
10.9 To Convert Addresses from an Internal Form to a Public Form
10.9.1 MTA Text Databases
10.9.2 To Set Address Reversal Controls
10.9.2.1 General Reverse Mapping Example
10.9.2.2 Channel-Specific Reverse Mapping Example
10.9.3 The Forward Lookup Table and FORWARD Address Mapping
10.9.3.1 The FORWARD Mapping Table
10.9.3.2 The Forward Lookup Table
10.10 Controlling Delivery Status Notification Messages
10.10.1 To Construct and Modify Status Notifications
10.10.2 To Customize and Localize Delivery Status Notification Messages
10.10.3 Internationalization of Generated Notices
10.10.4 Additional Status Notification Message Features
10.10.4.1 To Block Content Return on Large Messages
10.10.4.2 To Remove non-US-ASCII Characters from Included Headers in the Status Notification Messages
10.10.4.3 To Set Notification Message Delivery Intervals
10.10.4.4 To Include Altered Addresses in Status Notification Messages
10.10.4.5 To Send, Block and Specify Status Notification Messages to the Postmaster
Returned Failed Messages
Warning Messages
Blank Envelope Return Addresses
Postmaster Returned Message Content
Setting Per Channel Postmaster Addresses
10.11 Controlling Message Disposition Notifications
10.11.1 To Customize and Localize Message Disposition Notification Messages
10.12 Optimizing MTA Performance
10.12.1 Optimizing Authorization Checks to the LDAP Directory for Messages Addressed to Mailing Lists
Chapter 11 Configuring Rewrite Rules
11.1 Before You Begin
11.2 Rewrite Rule Structure
11.3 Rewrite Rule Patterns and Tags
11.3.1 A Rule to Match Percent Hacks
11.3.2 A Rule to Match Bang-Style (UUCP) Addresses
11.3.3 A Rule to Match Any Address
11.3.4 Tagged Rewrite Rule Sets
11.4 Rewrite Rule Templates
11.4.1 Ordinary Rewriting Templates, A%B@C or A@B
11.4.2 Repeated Rewrites Template, A%B
11.4.3 Specified Route Rewriting Templates, A@B@C@D or A@B@C
11.4.4 Case Sensitivity in Rewrite Rule Templates
11.5 How the MTA Applies Rewrite Rules to an Address
11.5.1 Step 1. Extract the First Host or Domain Specification
11.5.2 Step 2. Scan the Rewrite Rules
11.5.3 Step 3. Rewrite Address According to Template
11.5.4 Step 4. Finish the Rewrite Process
11.5.5 Rewrite Rule Failure
11.5.6 Syntax Checks After Rewrite
11.5.7 Handling Domain Literals
11.6 Template Substitutions and Rewrite Rule Control Sequences
11.6.1 Username and Subaddress Substitution, $U, $0U, $1U
11.6.2 Host/Domain and IP Literal Substitutions, $D, $H, $nD, $nH, $L
11.6.3 Literal Character Substitutions, $$, $%, $@
11.6.4 LDAP Query URL Substitutions, $]...[
11.6.5 General Database Substitutions, $(...)
11.6.6 Apply Specified Mapping, ${...}
11.6.7 Customer-supplied Routine Substitutions, $[...]
11.6.8 Single Field Substitutions, $&, $!, $*, $#
11.6.9 Unique String Substitutions
11.6.10 Source-Channel-Specific Rewrite Rules ($M, $N)
11.6.11 Destination-Channel-Specific Rewrite Rules ($C, $Q)
11.6.12 Direction-and-Location-Specific Rewrite Rules ($B, $E, $F, $R)
11.6.13 Host-Location-Specific Rewrites ($A, $P, $S, $X)
11.6.14 Changing the Current Tag Value, $T
11.6.15 Controlling Error Messages Associated with Rewriting ($?)
11.7 Handling Large Numbers of Rewrite Rules
11.8 Testing Rewrite Rules
11.9 Rewrite Rules Example
Chapter 12 Configuring Channel Definitions
12.1 Configuring Channel Defaults
12.2 Channel Keywords Listed Alphabetically
12.3 Channel Keywords Categorized by Function
12.4 Configuring SMTP Channels
12.4.1 Configuring SMTP Channel Options
12.4.2 SMTP Command and Protocol Support
12.4.2.1 Channel Protocol Selection and Line Terminators
12.4.2.2 EHLO Command Support
12.4.2.3 ETRN Command Support
Responding to ETRN Commands
Sending ETRN Commands
12.4.2.4 VRFY Command Support
Sending a VRFY Command
Responding to a VRFY Command
12.4.2.5 EXPN Support
12.4.2.6 DNS Domain Verification
12.4.2.7 Character Set Labeling and Eight-Bit Data
Character Set Labeling
Eight-Bit Data
12.4.2.8 Protocol Streaming
12.4.3 TCP/IP Connection and DNS Lookup Support
12.4.3.1 TCP/IP Port Number and Interface Address
12.4.3.2 Caching for Channel Connection Information
12.4.3.3 Reverse DNS Lookups
12.4.3.4 IDENT Lookups
12.4.3.5 TCP/IP MX Record Support
12.4.3.6 Nameserver Lookups
12.4.3.7 Last Resort Host
12.4.3.8 Alternate Channels for Incoming Mail (Switch Channels)
12.4.3.9 Source Channel Switching Based on User or Domain Settings
12.4.3.10 Target Host Choice
12.4.4 SMTP Authentication, SASL, and TLS
12.4.5 Using Authenticated Addresses from SMTP AUTH in Header
12.4.6 Support for SMTP Chunking
12.4.7 Specifying Microsoft Exchange Gateway Channels
12.4.8 Transport Layer Security
12.5 Configuring Message Processing and Delivery
12.5.1 Setting Channel Directionality
12.5.2 Implementing Deferred Delivery Dates
12.5.3 Specifying the Retry Frequency for Messages that Failed Delivery
12.5.4 Processing Pools for Channel Execution Jobs
12.5.5 Service Job Limits
12.5.6 Setting Connection Transaction Limits
12.5.7 Message Priority Based on Size
12.5.8 SMTP Channel Threads
12.5.9 Expansion of Multiple Addresses
12.5.10 Enable Service Conversions
12.6 Configuring Address Handling
12.6.1 Address Types and Conventions
12.6.1.1 822 (sourceroute)
12.6.1.2 733 (percents)
12.6.1.3 uucp (bangstyle)
12.6.1.4 header_822
12.6.1.5 header_733
12.6.1.6 header_uucp
12.6.2 Interpreting Addresses that Use ! and %
12.6.3 Adding Routing Information in Addresses
12.6.4 Disabling Rewriting of Explicit Routing Addresses
12.6.5 Address Rewriting Upon Message Dequeue
12.6.6 Specifying a Host Name to Use When Correcting Incomplete Addresses
12.6.7 Legalizing Messages Without Recipient Header Lines
12.6.8 Stripping Illegal Blank Recipient Headers
12.6.9 Enabling Channel-Specific Use of the Reverse Database
12.6.10 Enabling Restricted Mailbox Encoding
12.6.11 Generating of Return-path Header Lines
12.6.12 Constructing Received Header Lines from Envelope To and From Addresses
12.6.13 Handling Comments in Address Header Lines
12.6.14 Handling Personal Names in Address Header Lines
12.6.15 Specifying Alias File and Alias Database Probes
12.6.16 Subaddress Handling
12.6.17 Enabling Channel-specific Rewrite Rules Checks
12.6.18 Removing Source Routes
12.6.19 Specifying Address Must be from an Alias
12.6.20 Recipient Address Handling
12.7 Configuring Header Handling
12.7.1 Rewriting Embedded Headers
12.7.2 Removing Selected Message Header Lines
12.7.3 Generating/Removing X-Envelope-to Header Lines
12.7.4 Converting Date to Two- or Four-Digits
12.7.5 Specifying Day of Week in Date
12.7.6 Automatic Splitting of Long Header Lines
12.7.7 Header Alignment and Folding
12.7.8 Specifying Maximum Length Header
12.7.9 Sensitivity Checking
12.7.10 Setting Default Language in Headers
12.7.11 Controlling Message-hash: Headers
12.8 Attachments and MIME Processing
12.8.1 Ignoring the Encoding Header Line
12.8.2 Automatic Defragmentation of Message/Partial Messages
12.8.2.1 Defragmentation Channel
12.8.2.2 Defragmentation Channel Retention Time
12.8.2.3 Using NFS-based File Systems for Defragmentation and Vacation Caching
12.8.3 Automatic Fragmentation of Large Messages
12.8.4 Imposing Message Line Length Restrictions
12.8.5 Interpreting Content-transfer-encoding Fields on Multiparts and Message/RFC822 Parts
12.9 Limits on Messages, Quotas, Recipients, and Authentication Attempts
12.9.1 Limits on Unsuccessful Authentication Attempts
12.9.2 Specifying Absolute Message Size Limits
12.9.3 Retargeting Messages Exceeding Limit on Size or Recipients
12.9.4 Handling Mail Delivery to Over Quota Users
12.9.5 Handling SMTP Mail with Lines Exceeding 1000 Characters
12.9.6 Controlling the Length of General and Filename Content-type and Content-disposition Parameters
12.9.7 Limiting Message Recipients
12.9.8 Limiting Header Size
12.10 File Creation in the MTA Queue
12.10.1 Controlling How Multiple Addresses on a Message are Handled
12.10.2 Spreading a Channel Message Queue Across Multiple Subdirectories
12.10.3 Setting Session Limits
12.11 Configuring Logging and Debugging
12.11.1 Logging Keywords
12.11.2 Debugging Keywords
12.11.3 Setting Loopcheck
12.12 Miscellaneous Keywords
12.12.1 Process Channel Overrides
12.12.2 Channel Operation Type
12.12.3 Pipe Channel
12.12.4 Specifying Mailbox Filter File Location
12.12.5 Spam Filter Keywords
12.12.6 Routing After Address Validation But Before Expansion
12.12.6.1 aliasoptindetourhost
12.12.7 NO-SOLICIT SMTP Extension Support
12.12.8 Setting Limits on Bad RCPT TO Addresses
12.12.9 Set Channel Displays for Monitoring Framework
Chapter 13 Using Predefined Channels
13.1 Predefined Channels
13.2 To Deliver Messages to Programs Using the Pipe Channel
13.3 To Configure the Native (/var/mail) Channel
13.4 To Temporarily Hold Messages Using the Hold Channel
13.5 The Conversion Channel
13.5.1 MIME Overview
13.5.1.1 Message Construction
13.5.1.2 MIME Headers
Content-type Header
Content-disposition Header
13.5.2 Selecting Traffic for Conversion Processing
13.5.3 To Control Conversion Processing
13.5.3.1 Conversion Channel Information Flow
13.5.3.2 To Use Conversion Channel Environmental Variables
Mail Conversion Tags
Including Conversion Tag Information in Various Mapping Probes
13.5.3.3 To Use Conversion Channel Output Options
13.5.3.4 Headers in an Enclosing MESSAGE/RFC822 Part
13.5.3.5 To Call Out to a Mapping Table from a Conversion Entry
13.5.4 To Bounce, Delete, Hold, Retry Messages Using the Conversion Channel Output
13.5.4.1 To Bounce Messages
13.5.4.2 To Conditionally Delete a Message or Its Parts
13.5.4.3 To Hold a Message
13.5.4.4 To Cause Messages to Be Reprocessed
13.5.5 Conversion Channel Example
13.5.6 Automatic Arabic Character Set Detection
To Automatically Detect Arabic Character Sets
13.6 Character Set Conversion and Message Reformatting
13.6.1 Character Set Conversion
13.6.2 Message Reformatting
13.6.2.1 Non-MIME Binary Attachment Conversion
13.6.2.2 Relabelling MIME Headers
13.6.2.3 MacMIME Format Conversions
13.6.3 Service Conversions
Chapter 14 Integrating Spam and Virus Filtering Programs Into Messaging Server
14.1 Integrating Spam Filtering Programs Into Messaging Server—Theory of Operations
14.2 Deploying and Configuring Third Party Spam Filtering Programs
14.2.1 Loading and Configuring the Spam Filtering Software Client Library
14.2.1.1 Specifying the Spam Filtering Software Library Paths
14.2.2 Specifying the Messages to Be Filtered
To Specify User-level Filtering
14.2.2.1 User-level Filtering Example
To Specify Domain-level Filtering
Domain-level Filtering Example
To Specify Channel-level Filtering
Channel-level Filtering Examples
To Filter from an MTA Relay to a Backend Message Store
14.2.3 Specifying Actions to Perform on Spam Messages
14.3 Using Symantec Brightmail Anti-Spam
14.3.1 How Brightmail Works
14.3.1.1 Brightmail Architecture
14.3.2 Brightmail Requirements and Performance Considerations
14.3.3 Deploying Brightmail
14.3.4 Brightmail Configuration Options
14.4 Using SpamAssassin
14.4.1 SpamAssassin Overview
14.4.2 SpamAssassin/Messaging Server Theory of Operations
14.4.3 SpamAssassin Requirements and Usage Considerations
14.4.3.1 Where Should You Run SpamAssassin?
14.4.4 Deploying SpamAssassin
14.4.5 SpamAssassin Configuration Examples
To File Spam to a Separate Folder
To Add a Header Containing SpamAssassin Score to Spam Messages
To Add the SpamAssassin Result String to the Subject Line
To Filter Messages Based on SpamAssassin Score
14.4.6 Testing SpamAssassin
14.4.7 SpamAssassin Options
14.4.7.1 The SpamAssassin mode Option
14.5 Using Symantec Anti-Virus Scanning Engine (SAVSE)
14.5.1 SAVSE Overview
14.5.2 SAVSE Requirements and Usage Considerations
14.5.2.1 Where Should You Run SAVSE?
14.5.3 Deploying SAVSE
14.5.4 SAVSE Configuration Example
To Configure SAVSE
14.5.4.1 Other Possible Configurations
14.5.5 SAVSE Options
14.5.5.1 The ICAP mode Option
14.6 Using ClamAV
14.6.1 ClamAV/Messaging Server Theory of Operations
14.6.2 ClamAV Requirements and Usage Considerations
14.6.3 Deploying ClamAV
To Jettison Virus– or Trojan Horse– Infected Email Using ClamAV
14.6.4 Testing ClamAV
14.6.5 ClamAV Options
14.7 Support for Sieve Extensions
14.8 Using Milter
14.8.1 Milter Overview
14.8.2 Milter/Messaging Server Theory of Operations
14.8.3 Milter Requirements and Usage Considerations
14.8.3.1 Supported Milter Message Modification Actions
14.8.3.2 Macros Provided by the Milter Interface
To Deploy Milter
14.9 Cloudmark Anti-Abuse Client
14.10 Other Anti-Spam and Denial-of-Service Technologies
14.10.1 Anti-Spam Technique: Delay Sending the SMTP Banner
Chapter 15 Handling Forged Email Using the Sender Policy Framework
15.1 Theory of Operations
15.2 Limitations
15.3 Pre-Deployment Considerations
15.4 Setting up the Technology
15.5 Reference Information
15.6 Testing SPF using spfquery
15.6.1 Syntax
15.6.2 Example with Debugging Enabled
15.7 Handling Forwarded Mail in SPF Using the Sender Rewriting Scheme (SRS)
Chapter 16 LMTP Delivery
16.1 LMTP Delivery Features
16.2 Messaging Processing in a Two-Tier Deployment Without LMTP
16.3 Messaging Processing in a Two-Tier Deployment With LMTP
16.4 LMTP Overview
16.5 To Configure LMTP Delivery
To Configure the Inbound MTA Relays with LMTP
16.5.1 To Configure Back End Stores with LMTP and a Minimal MTA
16.5.2 Configuring Relays for Sending Messages Via LMTP to Back End Systems with Message Stores and Full MTAs
16.5.3 Configuring LMTP on Back End Message Store Systems Having Full MTAs
16.5.4 Handling 4.2.1 Mailbox Busy Error in Response to LMTP Message Data
16.6 LMTP Protocol as Implemented
Chapter 17 Vacation Automatic Message Reply
17.1 Vacation Autoreply Overview
17.2 Configuring Autoreply
17.2.1 Configuring Autoreply on the Back-end Store System
To Configure Autoreply on a Relay
17.3 Vacation Autoreply Theory of Operation
17.4 Vacation Autoreply Attributes
17.5 Other Auto Reply Tasks and Issues
17.5.1 To Send Autoreply Messages for Email That Have Been Automatically Forwarded from Another Mail Server
Chapter 18 Mail Filtering and Access Control
18.1 PART 1. MAPPING TABLES
18.2 Controlling Access with Mapping Tables
18.2.1 Access Control Mapping Tables—Operation
18.3 Access Control Mapping Table Flags
18.3.1 SEND_ACCESS and ORIG_SEND_ACCESS Tables
18.3.2 MAIL_ACCESS and ORIG_MAIL_ACCESS Mapping Tables
18.3.3 FROM_ACCESS Mapping Table
18.3.4 PORT_ACCESS Mapping Table
18.3.5 IP_ACCESS Mapping Table
18.3.6 To Limit Specified IP Address Connections to the MTA
18.4 When Access Controls Are Applied
18.5 To Test Access Control Mappings
18.6 To Add SMTP Relaying
18.6.1 Allowing SMTP Relaying for External Sites
18.7 Configuring SMTP Relay Blocking
18.7.1 How the MTA Differentiates Between Internal and External Mail
18.7.2 Differentiate Authenticated Users' Mail
To Add Distinguishing Authenticated Submissions
18.7.3 Prevent Mail Relay
18.7.4 To Use DNS Lookups Including RBL Checking for SMTP Relay Blocking
18.7.4.1 Support for DNS-based Databases
18.8 Handling Large Numbers of Access Entries
18.9 PART 2. MAILBOX FILTERS
18.10 Sieve Filter Support
18.11 Sieve Filtering Overview
18.12 To Create User-level Filters
18.13 To Create Channel-level Filters
To Create a Channel-level Filter
18.14 To Create MTA-Wide Filters
To Create MTA-Wide Filters
18.14.1 Routing Discarded Messages Out the FILTER_DISCARD Channel
18.15 To Debug User-level Filters
To Debug User-level Filters
18.15.1 imsimta test -exp Output
18.15.2 imsimta test -exp Syntax
Chapter 19 Throttling Incoming Connections Using MeterMaid
19.1 Technical Overview
19.2 Theory of Operations
19.3 Configutil Parameters for MeterMaid
19.4 Limit Excessive IP Address Connections Using Metermaid—Example
19.4.1 Additional Useful MeterMaid Options
Chapter 20 Managing the Message Store
20.1 Overview
20.2 Message Store Directory Layout
20.2.1 Valid UIDs and Folder Names
20.3 How the Message Store Removes Messages
20.4 Specifying Administrator Access to the Store
To Add an Administrator Entry
To Modify an Administrator Entry
To Delete an Administrator Entry
20.4.1 To Protect Mailboxes from Deletion or Renaming Except by an Administrator
20.5 About Shared Folders
20.6 Shared Folder Tasks
To Specify Sharing Attributes for Private Shared Folders
To Create a Public Shared Folder
20.6.1 To Add Shared Folders with an Email Group
To Add an Email Group to a Shared Folder
20.6.2 To Set or Change a Shared Folder’s Access Control Rights
20.6.2.1 Examples
20.6.3 To Enable or Disable Listing of Shared Folders
20.6.4 To Set Up Distributed Shared Folders
20.6.4.1 Setting Up Distributed Shared Folders—Example
20.6.5 To Monitor and Maintain Shared Folder Data
20.6.5.1 To Monitor Shared Folder Usage
20.6.5.2 To List Users and Their Shared Folders
20.6.5.3 To Remove Inactive Users
20.6.5.4 To Set Access Rights
20.7 Managing Message Types
20.7.1 Message Type Overview
20.7.1.1 Planning the Message-Type Configuration
20.7.1.2 Defining and Using Message Types
To Configure Message Types
20.7.2 Message Types in IMAP Commands
20.7.3 Sending Notification Messages for Message Types
20.7.4 Administering Quotas by Message Type
20.7.4.1 Before You Set Message-Type Quotas
20.7.4.2 Methods of Setting Message-Type Quotas
20.7.4.3 Example of a Message-Type Quota Root
20.7.5 Expiring Messages by Message Type
20.8 About Message Store Quotas
20.8.1 Quota Overview
20.8.1.1 Exceptions for Telephony Application Servers
20.8.2 Quota Theory of Operations
20.8.3 Message Store Quota Attributes and Parameters
20.8.4 Configuring Message Store Quotas
20.8.4.1 To Specify a Default User Quota
20.8.4.2 To Specify Individual User Quotas
20.8.4.3 To Specify Domain Quotas
To Setup Quota Notification
20.8.4.4 To Enable or Disable Quota Enforcement
20.8.4.5 To Set a Grace Period
20.8.4.6 Netscape Messaging Server Quota Compatibility Mode
20.9 To Set the Automatic Message Removal (Expire and Purge) Feature
20.9.1 imexpire Theory of Operation
20.9.2 To Deploy the Automatic Message Removal Feature
20.9.2.1 To Define Automatic Message Removal Policy
Examples of Automatic Message Removal Policy
20.9.2.2 To Set Rules Implementing Automatic Message Removal Policy
Expiration Rules Guidelines
Localized Mailbox Names
Setting imexpire Rules Textually
Setting imexpire Folder Patterns
20.9.2.3 To Schedule Automatic Message Removal and Logging Level
Setting imexpire Logging Levels
Excluding Specified Users from Automatic Message Remove
20.10 Configuring Message Store Partitions
20.10.1 To Add a Partition
To Add a Message Store Partition
20.10.2 To Move Mailboxes to a Different Disk Partition
To Move Mailboxes to a Different Disk Partition
20.10.3 Changing the Default Message Store Partition Definition
20.11 Performing Message Store Maintenance Procedures
20.11.1 Adding More Physical Disks to the Message Store
20.11.2 To Manage Mailboxes
20.11.2.1 The mboxutil Utility
Examples
20.11.2.2 To Remove Orphan Accounts
20.11.2.3 The hashdir Utility
20.11.2.4 The readership Utility
20.11.3 Maximum Mailbox Size
20.11.4 To Monitor Quota Limits
20.11.5 To Monitor Disk Space
20.11.6 The stored Daemon
20.11.7 Reducing Message Store Size Due to Duplicate Storage of Identical Messages
20.11.7.1 Relinker Theory of Operations
20.11.7.2 Using Relinker in the Command Line Mode
20.11.7.3 Using Relinker in the Realtime Mode
20.11.7.4 Configuring Relinker
20.12 Backing Up and Restoring the Message Store
20.12.1 Creating a Mailbox Backup Policy
20.12.1.1 Peak Business Loads
20.12.1.2 Full and Incremental Backups
20.12.1.3 Parallel or Serial Backups
20.12.2 To Create Backup Groups
20.12.2.1 Pre-defined Backup Group
20.12.3 Messaging Server Backup and Restore Utilities
20.12.3.1 The imsbackup Utility
Incremental Backup
20.12.3.2 The imsrestore Utility
20.12.4 Excluding Bulk Mail When You Perform Backups
20.12.5 Considerations for Partial Restore
20.12.5.1 To Restore Messages from a Mailbox that has Been Incrementally Backed-up
20.12.6 To Use Legato Networker
To Back Up Data Using Legato Networker
20.12.6.1 Restoring Data Using Legato Networker
20.12.7 To Use a Third Party Backup Software (Besides Legato)
To Use a Third Party Backup Software (Besides Legato)
20.12.8 Troubleshooting Backup and Restore Problems
20.12.9 Message Store Disaster Backup and Recovery
20.13 Monitoring User Access
20.14 Troubleshooting the Message Store
20.14.1 Standard Message Store Monitoring Procedures
20.14.1.1 Check Hardware Space
20.14.1.2 Check Log Files
20.14.1.3 Check User IMAP/POP/Webmail Session by Using Telemetry
20.14.1.4 Check stored Processes
20.14.1.5 Check Database Log Files
20.14.1.6 Check User Folders
20.14.1.7 Check for Core Files
20.14.2 Message Store Startup and Recovery
20.14.2.1 Automatic Startup and Recovery—Theory of Operations
Error Messages Signifying that reconstruct is Needed
Database Snapshots
Message Store Database Snapshot—Theory of Operations
To Specify Message Store Database Snapshot Interval and Location
20.14.3 Repairing Mailboxes and the Mailboxes Database
20.14.3.1 To Rebuild Mailboxes
20.14.3.2 Checking and Repairing Mailboxes
20.14.3.3 reconstruct Performance
20.14.4 Common Problems and Solutions
20.14.4.1 Reduced Message Store Performance
20.14.4.2 Linux - Messaging Server Patch 120230-08 IMAP, POP and HTTP Servers Not Starting Due to Over Sessions Per Process
20.14.4.3 Messenger Express or Communications Express Not Loading Mail Page
20.14.4.4 Command Using Wildcard Pattern Doesn’t Work
20.14.4.5 Unknown/invalid Partition
20.14.4.6 User Mailbox Directory Problems
20.14.4.7 Store Daemon Not Starting
20.14.4.8 User Mail Not Delivered Due to Mailbox Overflow
20.14.4.9 IMAP Events Become Slow
20.15 Migrating or Moving Mailboxes to a New System
20.15.1 Migrating User Mailboxes to Another Messaging Server While Online
20.15.1.1 Incremental Mailbox Migration
20.15.1.2 On-line Migration Overview
To Migrate User Mailboxes from One Messaging Server to Another While Online
To Move Mailboxes Using an IMAP client
To Move Mailboxes Using the MoveUser Command
To Move Mailboxes Using the imsimport Command
Chapter 21 Message Archiving
21.1 Archiving Overview
21.1.1 Message Archiving Systems: Compliance and Operational
Chapter 22 Configuring the JMQ Notification Plug-in to Produce Messages for Message Queue
22.1 JMQ Notification Overview
22.1.1 Two Notification Messaging Services
22.1.2 Notification Plug-ins
22.1.3 Benefits of Using JMQ Notification
22.1.3.1 Publishing to a Topic or a Queue
22.1.3.2 Using Multiple JMQ Notification Plug-ins
22.1.3.3 Configuring Parameters for a Notification Plug-in
22.2 Configuring a JMQ Notification Service
22.2.1 Planning for Your JMQ Notification Service
To Configure a JMQ Notification Plug-in
To Configure Multiple Plug-ins
22.2.2 Specifying Notification Messages that Use More Than One configutil Parameter
To Configure New-Message and Updated-Message Notifications with Message Headers and Message Bodies
To Configure Deleted-Message Notifications with Message Headers
22.2.2.1 Configuring Notifications for Changes in Message Status
Information Delivered in Message-Flag Notifications
Configutil Parameters Needed for Message-Flag Notifications
To Enable Notifications When Message-Status Flags Have Changed
22.3 JMQ Notification Messages and Properties
22.3.1 Notification Messages
22.3.2 Rules and Guidelines for Notification Messages
22.3.3 Notifications for Particular Message Types
22.3.4 Default Values of the configutil Parameters
22.3.5 Notification Message Properties
22.3.5.1 Standard Notification Message Properties
22.3.5.2 Properties Specific to Particular Notification Messages
Syntax for newflags and oldflags Properties
22.3.5.3 Properties Carried with Each Notification Message
Chapter 23 Configuring Security and Access Control
23.1 About Server Security
23.2 About HTTP Security
23.3 Configuring Authentication Mechanisms
23.3.1 To Configure Access to Plaintext Passwords
To Configure Directory Server to Store Cleartext Passwords
23.3.1.1 To Configure Messaging Server for Cleartext Passwords
23.3.2 To Transition Users
To Transition Users
23.4 User Password Login
23.4.1 IMAP, POP, and HTTP Password Login
23.4.2 SMTP Password Login
23.5 Configuring Encryption and Certificate-Based Authentication
23.5.1 Obtaining Certificates
23.5.1.1 To Manage Internal and External Modules
23.5.1.2 Creating a Password File
23.5.1.3 Obtaining and Managing Certificates
23.5.1.4 About msgcert
23.5.1.5 Managing Certificates
Configuring the Certificate Database Password
To Create a Messaging Server Certificate Database with a Default Self-signed Certificate
To Manage Self-Signed Certificates
23.5.1.6 To Install Certificates of Trusted CAs
To Request a CA-Signed Server Certificate
To Add the CA-Signed Server Certificate and Trusted CA Certificate
Renewing an Expired CA-Signed Server Certificate
To Export and Import a CA-Signed Server Certificate
23.5.2 To Enable SSL and Selecting Ciphers
23.5.2.1 About Ciphers
23.5.3 To Set Up Certificate-Based Login
To Set Up Certificate-Based Login
23.5.4 How to Optimize SSL Performance Using the SMTP Proxy
23.6 Configuring Administrator Access to Messaging Server
23.6.1 Hierarchy of Delegated Administration
To Provide Access to the Server as a Whole
23.6.2 To Restrict Access to Specific Tasks
To Restrict the Task Access of a User or Group
23.7 Configuring Client Access to POP, IMAP, and HTTP Services
23.7.1 How Client Access Filters Work
23.7.2 Filter Syntax
23.7.2.1 Wildcard Names
23.7.2.2 Wildcard Patterns
23.7.2.3 EXCEPT Operator
23.7.2.4 Server-Host Specification
23.7.2.5 Client User-Name Specification
23.7.3 Filter Examples
23.7.3.1 Mostly Denying
23.7.3.2 Mostly Allowing
23.7.3.3 Denying Access to Spoofed Domains
23.7.3.4 Controlling Access to Virtual Domains
23.7.3.5 Controlling IMAP Access While Permitting Access to Webmail
23.7.4 To Create Access Filters for Services
To Create Filters
23.7.5 To Create Access Filters for HTTP Proxy Authentication
To Create Access Filters for HTTP Proxy Authentication
23.8 Enabling POP Before SMTP
To Install the SMTP Proxy
23.9 Configuring Client Access to SMTP Services
23.10 User/Group Directory Lookups Over SSL
Chapter 24 Administering S/MIME for Communications Express Mail
24.1 What is S/MIME?
24.1.1 Concepts You Need to Know
24.2 Required Software and Hardware Components
24.3 Requirements for Using S/MIME
24.3.1 Private and Public Keys
24.3.2 Keys Stored on Smart Cards
24.3.3 Keys Stored on the Client Machine
24.3.4 Publish Public Keys in LDAP Directory
24.3.5 Give Mail Users Permission to Use S/MIME
24.3.6 Multi-language Support
24.4 Getting Started After Installing Messaging Server
24.4.1 The S/MIME Applet
24.4.1.1 Logging In for the First Time
24.4.1.2 Downloading the S/MIME Applet
To Enable Caching for Java 2 Runtime Environment, Version 1.4
24.4.2 A Basic S/MIME Configuration
To Configure the S/MIME
24.4.3 Accessing LDAP for Public Keys, CA certificates and CRLs Using Credentials
24.4.3.1 Setting Passwords for Specific URLs
24.4.3.2 Summary of Using LDAP credentials
24.5 Parameters of the smime.conf File
24.6 Messaging Server Options
To Set Messaging Server Options that Apply to S/MIME
24.7 Securing Internet Links With SSL
24.7.1 Securing the Link Between Messaging Server and Communications Express Mail
24.7.2 Securing the Link Between the Messaging Server and S/MIME Applet
To Secure the Communications Link with SSL
24.8 Key Access Libraries for the Client Machines
24.8.1 Example
24.9 Verifying Private and Public Keys
24.9.1 Finding a User’s Private or Public Key
24.9.2 When is a Certificate Checked Against a CRL?
24.9.3 Accessing a CRL
24.9.4 Proxy Server and CRL Checking
24.9.5 Using a Stale CRL
24.9.6 Determining Which Message Time to Use
24.9.7 Trouble Accessing a CRL
24.9.8 When a Certificate is Revoked
24.10 Granting Permission to Use S/MIME Features
24.10.1 S/MIME Permission Examples
24.11 Managing Certificates
24.11.1 CA Certificates in an LDAP Directory
24.11.2 Public Keys and Certificates in an LDAP Directory
24.11.3 Verifying That Keys and Certificates Exist in the LDAP Directory
24.11.3.1 Searching for One CA Certificate
Searching for a Several Public Keys
Searching for One Public Key
24.11.4 Network Security Services Certificates
24.12 Communications Express S/MIME End User Information
24.12.1 Logging In for the First Time
24.12.1.1 Prompts for Windows
24.12.2 Signature and Encryption Settings
24.12.3 Enabling the Java Console
Chapter 25 Managing Logging
25.1 Overview of Logging
25.1.1 Types of Logging Data
25.1.2 Types of Messaging Server Log Files
25.1.3 Tracking a Message Across the Various Log Files
25.2 Tools for Managing Logging
25.3 Managing MTA Message and Connection Logs
25.3.1 Understanding the MTA Log Entry Format
25.3.2 Enabling MTA Logging
To Enable MTA Logging on a Specific Channel
To Enable MTA Logging on All Channels
25.3.3 Specifying Additional MTA Logging Options
To Send MTA Logs to syslog
To Control Formatting of Log Entries
To Correlate Log Message Entries
To Log Amount of Time Messages Have Spent in the Queue
To Identify Message Delivery Retries
To Log TCP/IP Connections
To Write Entries to the connection.log File
To Correlate Log Messages by Process ID
To Save User Names Associated with a Process That Enqueues Mail to the mail.log File
25.3.4 MTA Message Logging Examples
25.3.4.1 MTA Logging Example: User Sends an Outgoing Message
25.3.4.2 MTA Logging Example: Including Optional Logging Fields
25.3.4.3 MTA Logging Example – Sending to a List
25.3.4.4 MTA Logging – Sending to a Nonexistent Domain
25.3.4.5 MTA Logging Example – Sending to a Nonexistent Remote User
25.3.4.6 MTA Logging Example – Rejecting a Remote Side's Attempt to Submit a Message
25.3.4.7 MTA Logging Example – Multiple Delivery Attempts
25.3.4.8 MTA Logging – Incoming SMTP Message Routed Through the Conversion Channel
25.3.4.9 MTA Logging Example: Outbound Connection Logging
25.3.4.10 MTA Logging Example: Inbound Connection Logging
25.3.5 Enabling Dispatcher Debugging
To Enable Dispatcher Error Debugging Output
To Set Dispatcher Parameters (Solaris)
25.4 Managing Message Store, Admin, and Default Service Logs
25.4.1 Understanding Service Log Characteristics
25.4.1.1 Logging Levels
25.4.1.2 Categories of Logged Events
25.4.1.3 Service Log File Directories
25.4.2 Understanding Service Log File Format
25.4.3 Defining and Setting Service Logging Options
25.4.3.1 Flexible Logging Architecture
25.4.3.2 Planning the Options You Want
25.4.3.3 Understanding Logging Options
25.4.4 Searching and Viewing Service Logs
25.4.4.1 Search Parameters
25.4.5 Working With Service Logs
To Send Service Logs to syslog
25.4.5.1 To Disable HTTP Logging
To Set the Server Log Level
To Specify a Directory Path for Server Log Files
To Specify a Maximum File Size for Each Service Log
To Specify a Service Log Rotation Schedule
To Specify a Maximum Number of Service Log Files Per Directory
To Specify a Storage Limit
To Specify the Minimum Amount of Free Disk Space to Reserve
25.4.5.2 To Specify an Age for Logs at Which They Expire
25.4.6 Using Message Tracing for Message Store Logging
To Enable Message Tracing
To Configure LMTP Logging
25.4.7 Other Message Store Logging Features
25.4.8 Message Store Logging Examples
25.4.8.1 Message Store Logging Example: Bad Password
25.4.8.2 Message Store Logging – Account Disabled
25.4.8.3 Message Store Logging Example: Message Appended
25.4.8.4 Message Store Logging Example: Message Retrieved by a Client
25.4.8.5 Message Store Logging Example: Message Removed from a Folder
25.4.8.6 Message Store Logging Example: Duplicate Login Messages
Chapter 26 Troubleshooting the MTA
26.1 Troubleshooting Overview
26.2 Standard MTA Troubleshooting Procedures
26.2.1 Check the MTA Configuration
26.2.2 Check the Message Queue Directories
26.2.3 Check the Ownership of Critical Files
26.2.4 Check that the Job Controller and Dispatcher are Running
26.2.5 Check the Log Files
26.2.6 Run a Channel Program Manually
26.2.7 Starting and Stopping Individual Channels
To Stop Outbound Processing (dequeueing) for a Specific Channel
26.2.7.1 To Stop Inbound Processing from a Specific Domain or IP Address (enqueuing to a channel)
26.2.8 An MTA Troubleshooting Example
26.2.8.1 Identify the Channels in the Message Path
26.2.8.2 Manually Start and Stop Channels to Gather Data
To Manually Start and Stop Channels
To Identify the Point of Message Breakdown
26.3 Common MTA Problems and Solutions
26.3.1 TLS Problems
26.3.2 Changes to Configuration Files or MTA Databases Do Not Take Effect
26.3.3 The MTA Sends Outgoing Mail but Does Not Receive Incoming Mail
26.3.4 Dispatcher (SMTP Server) Won’t Start Up
26.3.5 Timeouts on Incoming SMTP connections
To Identify the Causes of Timeouts on Incoming SMTP Connections
26.3.6 Messages are Not Dequeued
26.3.6.1 To Create a New Channel
To Create a New Channel
26.3.7 MTA Messages are Not Delivered
26.3.8 Messages are Looping
26.3.8.1 Diagnosing and Cleaning up .HELD Messages
Messages .HELD Due to Looping
Messages .HELD Due to User or Domain hold Status
Messages .HELD Due to a Suspicious Characteristic
26.3.9 Received Message is Encoded
26.3.10 Server-Side Rules (SSR) Are Not Working
26.3.10.1 Testing Your SSR Rules
26.3.10.2 Common Syntax Problems
26.3.11 Slow Response After Users Press Send Email Button
26.3.12 Asterisks in the Local Parts of Addresses or Received Fields
26.4 General Error Messages
26.4.1 Errors in mm_init
26.4.1.1 bad equivalence for alias. . .
26.4.1.2 cannot open alias include file. . .
26.4.1.3 duplicate aliases found. . .
26.4.1.4 duplicate host in channel table. . .
26.4.1.5 duplicate mapping name found. . .
26.4.1.6 mapping name is too long. . .
26.4.1.7 error initializing ch_ facility compiled character set version mismatch
26.4.1.8 error initializing ch_ facility no room in. . .
26.4.1.9 local host alias or proper name too long for system. . .
26.4.1.10 no equivalence addresses for alias. . .
26.4.1.11 no official host name for channel. . .
26.4.1.12 official host name is too long
26.4.2 Compiled Configuration Version Mismatch
26.4.3 Swap Space Errors
26.4.4 File open or create errors
26.4.5 Illegal Host/Domain Errors
26.4.6 Errors in SMTP channels, os_smtp_* errors
Chapter 27 Monitoring Messaging Server
27.1 Automatic Monitoring and Restart
27.2 Daily Monitoring Tasks
27.2.1 Checking postmaster Mail
27.2.2 Monitoring and Maintaining the Log Files
27.2.3 Setting Up the msprobe Utility
27.3 Monitoring System Performance
27.3.1 Monitoring End-to-end Message Delivery Times
27.3.1.1 Symptoms of Poor End-to-end Message Delivery Times
27.3.1.2 To Monitor End-to-end Message Delivery Times
27.3.2 Monitoring Disk Space
27.3.2.1 Symptoms of Disk Space Problems
27.3.2.2 To Monitor Disk Space
Monitoring the Message Store
Monitoring Message Store Partitions
Monitoring the MTA Queues and Logging Space
27.3.3 Monitoring CPU Usage
27.3.3.1 Symptoms of CPU Usage Problems
27.3.3.2 To Monitor CPU Usage
27.4 Monitoring the MTA
27.4.1 Monitoring the Size of the Message Queues
27.4.1.1 Symptoms of Message Queue Problems
27.4.1.2 To Monitor the Size of the Message Queues
27.4.2 Monitoring Rate of Delivery Failure
27.4.2.1 Symptoms of Rate of Delivery Failure
27.4.2.2 To Monitor the Rate of Delivery Failure
27.4.3 Monitoring Inbound SMTP Connections
27.4.3.1 Symptoms of Unauthorized SMTP Connections
27.4.3.2 To Monitor Inbound SMTP Connections
27.4.4 Monitoring the Dispatcher and Job Controller Processes
27.4.4.1 Symptoms of Dispatcher and Job Controller Processes Down
27.4.4.2 To Monitor Dispatcher and Job Controller Processes
27.5 Monitoring LDAP Directory Server
27.5.1 Monitoring slapd
27.5.1.1 Symptoms of slapd Problems
27.5.1.2 To Monitor slapd
27.6 Monitoring Message Access
27.6.1 Monitoring imapd, popd and httpd
27.6.1.1 Symptoms of imapd, popd and httpd Problems
27.6.1.2 To Monitor imapd, popd and httpd
27.7 Monitoring the Message Store
27.7.1 Monitoring stored
27.7.1.1 Symptoms of stored Problems
27.7.1.2 To Monitor stored
27.7.2 Monitoring the State of Message Store Database Locks
27.7.2.1 Symptoms of Message Store Database Lock Problems
27.7.2.2 To Monitor Message Store Database Locks
27.8 Utilities and Tools for Monitoring
27.8.1 immonitor-access
27.8.2 imcheck
27.8.3 counterutil
27.8.3.1 counterutil Output
27.8.3.2 Alarm Statistics Using counterutil
27.8.3.3 IMAP, POP, and HTTP Connection Statistics Using counterutil
27.8.3.4 Disk Usage Statistics Using counterutil
27.8.3.5 Server Response Statistics
27.8.4 Log Files
27.8.5 imsimta counters
27.8.5.1 Implementation on UNIX and NT
27.8.6 imsimta qm counters
27.8.7 MTA Monitoring Using SNMP
27.8.8 imquotacheck for Mailbox Quota Checking
27.8.9 Monitoring Using msprobe and watcher Functions
27.8.9.1 Alarm Messages
Appendix A SNMP Support
A.1 SNMP Implementation
A.1.1 SNMP Operation in the Messaging Server
A.2 Configuring SNMP Support for Messaging Server on Solaris 9
A.3 Configuring SNMP Support for Solaris 10 OS
A.3.1 Net-SNMP Configuration
A.3.2 Messaging Server Subagent Configuration
A.3.3 Running as a Standalone SNMP Agent
A.3.4 Monitoring Multiple Instances of Messaging Server
A.3.5 Using Standalone Agents for High-availability Failover
A.3.6 Distinguishing Multiple Instances Through SNMP v3 Context Names
A.3.7 Messaging Server's Net-SNMP-based SNMP Subagent Options
A.4 Monitoring from an SNMP Client
A.5 SNMP Information from the Messaging Server
A.5.1 applTable
A.5.1.1 applTable Usage
A.5.2 assocTable
A.5.2.1 assocTable Usage
A.5.3 mtaTable
A.5.3.1 mtaTable Usage
A.5.4 mtaGroupTable
A.5.4.1 mtaGroupTable Usage
A.5.5 mtaGroupAssociationTable
A.5.6 mtaGroupErrorTable
A.5.6.1 mtaGroupErrorTable Usage
Appendix B Administering Event Notification Service in Messaging Server
B.1 Loading the ENS Publisher in Messaging Server
To Load the ENS Publisher on Messaging Server
B.2 Running Sample Event Notification Service Programs
To Run the Sample ENS Programs
B.3 Administering Event Notification Service
B.3.1 Starting and Stopping ENS
To Start and Stop ENS
B.3.2 Event Notification Service Configuration Parameters
Appendix C Short Message Service (SMS)
C.1 Introduction
C.1.1 One-Way SMS
C.1.1.1 Two-Way SMS
C.1.2 Requirements
C.2 SMS Channel Theory of Operation
C.2.1 Directing Email to the Channel
C.2.2 The Email to SMS Conversion Process
C.2.2.1 Sample Email Message Processing
C.2.3 The SMS Message Submission Process
C.2.4 Site-defined Address Validity Checks and Translations
C.2.5 Site-defined Text Conversions
C.2.5.1 Message Header Entries
C.2.5.2 Message Body Entries
C.2.5.3 Example SMS Mapping Table
Explanatory Text
C.3 SMS Channel Configuration
C.3.1 Adding an SMS Channel
C.3.1.1 Adding the Channel Definition and Rewrite Rules
To Add Channel Definition and Rewrite Rules
C.3.1.2 Controlling the Number of Simultaneous Connections
C.3.2 Creating an SMS Channel Option File
C.3.3 Available Options
C.3.3.1 Email to SMS Conversion Options
GATEWAY_NOTIFICATIONS
MAX_MESSAGE_PARTS
MAX_MESSAGE_SIZE
MAX_PAGE_SIZE
MAX_PAGES_PER_MESSAGE
ROUTE_TO
SMSC_DEFAULT_CHARSET
USE_HEADER_FROM
USE_HEADER_PRIORITY
USE_HEADER_REPLY_TO
USE_HEADER_RESENT
USE_HEADER_SENSITIVITY
USE_UCS2
C.3.3.2 SMS Gateway Server Option
GATEWAY_PROFILE
C.3.3.3 SMS Options
DEFAULT_DESTINATION_NPI
DEFAULT_DESTINATION_TON
DEFAULT_PRIORITY
DEFAULT_PRIVACY
DEFAULT_SERVICE_TYPE
DEFAULT_SOURCE_ADDRESS
DEFAULT_SOURCE_NPI
DEFAULT_SOURCE_TON
DEFAULT_VALIDITY_PERIOD
DESTINATION_ADDRESS_NUMERIC
DESTINATION_ADDRESS_PREFIX
PROFILE
USE_SAR
C.3.3.4 SMPP Options
ESME_ADDRESS_NPI
ESME_ADDRESS_TON
ESME_IP_ADDRESS
ESME_PASSWORD
ESME_SYSTEM_ID
ESME_SYSTEM_TYPE
MAX_PAGES_PER_BIND
REVERSE_ORDER
SMPP_MAX_CONNECTIONS
SMPP_PORT
SMPP_SERVER
TIMEOUT
C.3.3.5 Localization Options
CONTENT_PREFIX
DSN_DELAYED_FORMAT
DSN_FAILED_FORMAT
DSN_RELAYED_FORMAT
DSN_SUCCESS_FORMAT
FROM_FORMAT
FROM_NONE
LANGUAGE
LINE_STOP
NO_MESSAGE
SUBJECT_FORMAT
SUBJECT_NONE
DEBUG
C.3.3.6 Formatting Templates
C.3.4 Adding Additional SMS Channels
C.3.5 Adjusting the Frequency of Delivery Retries
C.3.6 Sample One-Way Configuration (MobileWay)
C.3.6.1 Debugging
C.3.7 Configuring the SMS Channel for Two-Way SMS
C.4 SMS Gateway Server Theory of Operation
C.4.1 Function of the SMS Gateway Server
C.4.2 Behavior of the SMPP Relay and Server
C.4.3 Remote SMPP to Gateway SMPP Communication
C.4.4 SMS Reply and Notification Handling
C.4.4.1 Routing Process for SMS Replies
C.5 SMS Gateway Server Configuration
C.5.1 Setting Up Bidirectional SMS Routing
C.5.1.1 Set the SMS Address Prefix
C.5.1.2 Set the Gateway Profile
C.5.1.3 Configure the SMSC
C.5.2 Enabling and Disabling the SMS Gateway Server
C.5.3 Starting and Stopping the SMS Gateway Server
C.5.4 SMS Gateway Server Configuration File
C.5.5 Configuring Email-To-Mobile on the Gateway Server
C.5.5.1 A Gateway Profile
To Configure an Email-to-mobile Gateway Profile
C.5.5.2 An SMPP Relay
To Configure an SMPP Relay
C.5.5.3 An SMPP Server
To Configure an SMPP Server
C.5.6 Configuring Mobile-to-Email Operation
C.5.6.1 Configure a Mobile-to-Email Gateway Profile
To Configure the Gateway Profile
C.5.6.2 Configure a Mobile-to-Email SMPP Server
C.5.7 Configuration Options
C.5.8 Global Options
C.5.8.1 Thread Tuning Options
THREAD_COUNT_INITIAL
THREAD_COUNT_MAXIMUM
THREAD_STACK_SIZE
C.5.8.2 Historical Data Tuning
HISTORY_FILE_DIRECTORY
HISTORY_FILE_MODE
HISTORY_FILE_ROLLOVER_PERIOD
RECORD_LIFETIME
C.5.8.3 Miscellaneous
DEBUG
LISTEN_CONNECTION_MAX
LOG_PAGE_COUNT
C.5.9 SMPP Relay Options
C.5.9.1 LISTEN_BACKLOG
LISTEN_CONNECTION_MAX
LISTEN_INTERFACE_ADDRESS
LISTEN_PORT
LISTEN_RECEIVE_TIMEOUT
LISTEN_TRANSMIT_TIMEOUT
MAKE_SOURCE_ADDRESSES_UNIQUE
SERVER_HOST
SERVER_PORT
SERVER_RECEIVE_TIMEOUT
SERVER_TRANSMIT_TIMEOUT
C.5.10 SMPP Server Options
C.5.10.1 LISTEN_BACKLOG
LISTEN_CONNECTION_MAX
LISTEN_INTERFACE_ADDRESS
LISTEN_PORT
LISTEN_RECEIVE_TIMEOUT
LISTEN_TRANSMIT_TIMEOUT
C.5.11 Gateway Profile Options
C.5.11.1 CHANNEL
EMAIL_BODY_CHARSET
EMAIL_HEADER_CHARSET
FROM_DOMAIN
PARSE_RE_0, PARSE_RE_1, ..., PARSE_RE_9
PROFILE
SELECT_RE
SMSC_DEFAULT_CHARSET
USE_SMS_PRIORITY
USE_SMS_PRIVACY
C.5.12 Configuration Example for Two-Way SMS
C.5.12.1 Additional sms_option File Settings
Performing the Loopback Test
C.6 SMS Gateway Server Storage Requirements
Appendix D Installation Worksheets
D.1 Directory Server Installation
D.2 Directory Server Setup Script (comm_dssetup.pl)
D.3 Messaging Server Initial Runtime Configuration
Glossary
© 2010, Oracle Corporation and/or its affiliates