Sun Java System Messaging Server 6.3 Administration Guide

Sun Java System Messaging Server 6.3 Administration Guide Revision History

Version 

Date 

Description of Changes 

14 

15 February 2008 

Fixed a number of documentation bugs. Changes are listed below. 

13 

22 July 2007 

12 

8 June 2007 

11 

14 April 2007 

10 

March 2007 

Initial release of this technical note. 

Administration Guide Revision Changes from Version 14 to 15

These are Administration Guide changes from 819-4428-14 to 819-4428-15. < > angle bracketed words indicate deleted text with replaced by words immediately following. [ ] bracketed words indicated new text.

Chapter 1, Post-install Tasks and Layout

To Run the Configure Program

In this section, added the following note regarding Solaris 10 at the end of the discussion of adding the FQDN in the etc/hosts/ and related files:


Note –

On Solaris OS 10 U3 and earlier platforms, you not only have to add the Fully Qualified Domain Name (FQDN) to the /etc/hosts file, but also to the/etc/inet/ipnodes file. Otherwise, you will get an error indicating that your host name is not a Fully Qualified Domain Name. From Solaris OS 10U4 onwards, the contents of the /etc/inet/ipnodes and /etc/hosts files have been merged together into just the/etc/hosts file. Applying kernel patch 120011-14 on any Solaris 10 system will also perform the merge, and subsequent removal of the/etc/inet/ipnodes file.


New level 2 section: 1.10.1 Java Message Queue (JMQ) Tuning.

Chapter 11, Configuring Rewrite Rules

Added the following paragraph to 11.4.2. Repeated Rewrites Template, A%B: [Note, however, that while the special A%B form does cause rewriting of the current domain to restart, it is actually just a continuation of the current rewriting process. It does not rewrite the entire process from the beginning. It does not perform the $* pattern when it goes through the second time.]

Chapter 12, Configuring Channel Definitions

Removed immnourgent

12.4.1 Configuring SMTP Channel Options

Added the following paragraph: <SMTP channel options that pertain to a destination channel should be placed in the appropriate channel option file (that is, tcp_local_option, tcp_auth_option, tcp_intranet_option). SMTP channel option files that pertain to a source channel MUST be placed in the tcp_local_option file since all messages come into the MTA via the tcp_local channel before any channel switching takes place for incoming messages.>

Chapter 14, Integrating Spam and Virus Filtering Programs Into Messaging Server

Removed references to the SOCKS_USERNAME and SOCKS_PASSWORD options from the book. The references appeared in the following sections in Chapter 14:

14.4.7 SpamAssassin Options

14.5.5 SAVSE Options

14.6.5 ClamAV Options

To Deploy Milter

Chapter 16, LMTP Delivery

Removed all references and instructions regarding the LMTP native channel.

Chapter 18, Mail Filtering and Access Control

Processing Control ($C, $L, $R, $E)

Rewrote this section.

Table 18–3

Changed description of $T text to the following: If bit 1 (value 2) of the LOG_CONNECTION MTA option is set and the $N flag is set so that the connection is rejected, then $T outputs the entire right hand side text in a "T" record. The T log entry will include the entire mapping result string ($N and its string). In contrast, bit 4 of LOG_CONNECTION is a different effect: it will cause material after two vertical bars to be included in normal "C" (connection close) records.

18.3.4 PORT_ACCESS Mapping Table

Added a new table. Fixed other table.

18.3.5 IP_ACCESS Mapping Table

<source-channel|address-count|address-current|ip-current|hostname>source-channel|address-current|address-count|ip-current|hostname

18.4 When Access Controls Are Applied

Added new information at the bottom of this section about when access control mapping tables are applied.

18.7.4 To Use DNS Lookups Including RBL Checking for SMTP Relay Blocking

Fixed some errors in the code and added new text added regarding the PORT_ACCESS table being probed both by the dispatcher, when accepting connections, and by the tcp_smtp_server process under certain circumstances.

Chapter 19, Throttling Incoming Connections Using MeterMaid

New note added to the bottom of 19.3 Configutil Parameters for MeterMaid

Chapter 20, Managing the Message Store

Globally replaced moveuser with MoveUser. Note capitalization.

To Add an Email Group to a Shared Folder

readership -s user/gregk/<tennis>gardening tennis@sesta.com lrp

Table 20–9

<Age of message in days before being expunged. (integer)>Number of days in the message store before being expunged. (integer)

20.14.4.9 IMAP Events Become Slow

Brand new section.

Expiration Rules Guidelines

Added new material to the Note: This is still true, but expire rules using header constraints (example: expiring a message with a specific subject line) are not supported. <Also, regular expressions in the expire rules created with configutil need to be POSIX compliant rules. If you want to use UNIX compliant regular expressions you will have to use the store.expire file. In addition, using both configutil options and the global store.expirerule configuration file is not supported. If the configuration file is present, configutil options are not used.> In any case, it is best to use store.expirerule to specify all expiration rules.

20.11.4 To Monitor Quota Limits

Removed imquotacheck -i. No longer valid.

20.10.2 To Move Mailboxes to a Different Disk Partition

<Make sure user is disconnected from their mailbox during the migration process . . .> The user does not have to be disconnected from their mailbox during this migration process.

20.12.8 Troubleshooting Backup and Restore Problems and To Migrate User Mailboxes from One Messaging Server to Another While Online

Added the following text: When imsrestore or any processing intensive operation takes significantly more system resources than normal, and continues doing so longer than the msprobe interval, there may be a temporary backlog of DB transaction log files to be cleared. If there are more files than specified in local.store.maxlog, then msprobe may erroneously restart all the processes during a restore. To prevent this from happening, disable msprobe during the imsrestore.

20.14.4.1 Reduced Message Store Performance

Added this section, which basically cross-references Tuning the mboxlist Database Cache

To Move Mailboxes Using an IMAP client

In step 2, changed <local.store.relinker to enable> to [Set local.store.relinker.enabled] to yes]

To Move Mailboxes Using the MoveUser Command

In step 2, changed <local.store.relinker to enable> to [Set local.store.relinker.enabled] to yes]

To Move Mailboxes Using the imsimport Command

In step 2, changed <local.store.relinker to enable> to [Set local.store.relinker.enabled] to yes]

Chapter 23, Configuring Security and Access Control

23.7 Configuring Client Access to POP, IMAP, and HTTP Services

Discussed the LDAP method of configuring client access. Added cross-references to the LDAP attributes mailAllowedServiceAccess in Sun Java Communications Suite 5 Schema Reference and mailDomainAllowedServiceAccess in Sun Java Communications Suite 5 Schema Reference

Chapter 24, Administering S/MIME for Communications Express Mail

24.1 What is S/MIME?

Rewrote this section.

Administration Guide Revision Changes from Version 12 to 14

These are Administration Guide changes from 819-4428-12 to 819-4428-14. < > angle bracketed words indicate deleted text with replaced by words immediately following. [ ] bracketed words indicated new text. Note that only one change was between 12 and 13, and that was the addition of this Revision Guide History.

Chapter 3, Configuring High Availability

4.5.1 Automatic Restart in High Availability Deployments

Chapter 4, Configuring General Messaging Capabilities

Table 4–5, entry for local.autorestart.timeout <fails more than twice> fails more than once

4.12 Email Security Concerns

Added this new section which talks about disabling XADR, XCIR, XGEN, and XSTA.

Chapter 9, MTA Address Translation and Routing

9.1.3.8 Delivery Options Processing

In the example: <=$M%$\\> [=$M%$\]

Chapter 10, About MTA Services and Configuration

8.7 The Job Controller

Added new information about setting MAX_MESSAGES.

Chapter 12, Configuring Channel Definitions

Table 12–21.s

smtp (This keyword is equivalent to <smtp_crorlf> smtp_crlf.)

12.4.2.1 Channel Protocol Selection and Line Terminators

<The keyword smtp_crlf means that lines must be terminated with a carriage return (CR) line feed (LF) sequence. The keyword smtp_lf or smtp means that an LF without a preceding CR is accepted. Finally, smtp_cr means that a CR is accepted without a following LF. These option affect only the handling of incoming material.>

[The keyword smtp_crlf or smtp means that lines must be terminated with a carriage return (CR) line feed (LF) sequence. The keyword smtp_lf means that an LF without a preceding CR is accepted as well as the standard CRLF sequence. The keyword smtp_cr means that a CR is accepted without a following LF. Finally, smtp_crorlf means that any of CR, LF, or the standard CRLF sequence are allowed as the SMTP line terminator. These option affect only the handling of incoming material.]

12.6.14 Handling Personal Names in Address Header Lines

Added: If the PERSONAL_NAMES mapping table returns 8-bit characters, they are UTF-8 encoded.

Chapter 13, Using Predefined Channels

13.5 The Conversion Channel

Rewrote a number of small sections to make clearer. This in response to bug 4902284.

Chapter 14, Integrating Spam and Virus Filtering Programs Into Messaging Server

14.2.3 Specifying Actions to Perform on Spam Messages

Table 14–1, MTA Spam Filter Options. Rewrote spamfilterX_final

14.9 Cloudmark Anti-Abuse Client

Mentioned support for Cloudmark anti-spam solution.

14.7 Support for Sieve Extensions

Added that spamadjust and spamtest can be also be used with Brightmail.

Chapter 16, LMTP Delivery

16.5.1 To Configure Back End Stores with LMTP and a Minimal MTA

tcp_lmtpss lmtp [flagtransfer]

Chapter 18, Mail Filtering and Access Control

18.3 Access Control Mapping Table Flags

Table 18–2 — Enhanced description of $X.

Chapter 20, Managing the Message Store

Wherever hashdir was recommended as the command to use for finding the directory containing a specified folder, mboxutil -lxp pattern was recommended instead.

20.2.1 Valid UIDs and Folder Names

Rewrote this section and renamed it to Valid UIDs and Folder Names.

Chapter 26, Troubleshooting the MTA

26.2.7 Starting and Stopping Individual Channels

Added the following:

NOTE - The command imsimta qm start/stop channel may fail if run simultaneously for many channels at the same time. The tool might have trouble updating the hold_list and could report: QM-E-NOTSTOPPED, unable to stop the channel; cannot update the hold list." imsimta qm start/stop channel should only be used sequentially with a few seconds interval between each run.

If you only want the channel to run between certain hours, use the following options in the channel definition section in the job controller configuration file:

urgent_delivery=08:00-20:00
normal_delivery=08:00-20:00
nonurgent_delivery=08:00-20:00

Appendix C, Short Message Service (SMS)

C.2.5.2 Message Body Entries

< These entries establish mappings to be applied to . . .> Text removed. Body mappings are not supported.

Administration Guide Revision Changes from Version 10 to 12

These are Administration Guide changes from 819-4428-10 to 819-4428-12. < > angle bracketed words indicate deleted text with replaced by words immediately following. [ ] bracketed words indicated new text.

Chapter 1, Post-install Tasks and Layout

1.6 SMTP Relay Blocking

1) <$(192.45.67.89/24)> $(192.45.67.89/32)

2) <first 24> full 32

1.8 Handling sendmail Clients

When you <upgraded>installed previous versions of Messaging Server, the /usr/lib/sendmail binary was replaced with a component of the <sendmail>Messaging Server product. In Messaging Server, Messaging Server {6.0 to the current version,} this replacement during <upgrade>install is no longer <occurs>necessary. Therefore, you may need to obtain the proper version of the /usr/lib/sendmail binary from the most current sendmail patch.

<FEATURE("nullclient', "smtp:rhino.west.sesta.com')dnl
MASQUERADE_AS("west.sesta.com')dnl
define("confDOMAIN_NAME', "west.sesta.com')dnl>

Replaced by:

FEATURE(`nullclient', `smtp:rhino.west.sesta.com')dnl
MASQUERADE_AS(`west.sesta.com')dnl
define(`confDOMAIN_NAME', `west.sesta.com')dnl

Chapter 2, Upgrading from Messaging Server 5.2 to Sun Java System Messaging Server

All of this moved to the technical article entitled: Upgrading from Messaging Server 5.2 to Sun Java System Messaging Server.

Chapter 3, Configuring High Availability

3.1 Supported Versions Moved to Release Notes

3.4.1 Sun Cluster Requirements. Version requirements are moved to Release Notes.

Chapter 4, Configuring General Messaging Capabilities

4.4.1 To Start and Stop Services in an HA Environment

To Start, Stop, Restart in Veritas <1.3, 2.0, 2.1,>3.5, 4.0, 4.1 and <3.5> 5.0 Environments

4.4.2 To Start and Stop Services in a non-HA Environment. Minor typos.

4.4.3 Starting and Stopping a Messaging Server Running in MTA-only Mode. New section!

4.6 To Schedule Automatic Tasks

1) <A fully qualified command pathname is required.>Paths can be relative to msg-svr-base or absolute paths. See Pre-defined Automatic Tasks for relative path examples.

2) <send SIGHUP to> refresh the scheduler process: <kill -HUP> refresh sched [scheduler_pid]

4.6.1 Scheduler Examples

<20,40,60> 0,20,40

4.8 To Set a User-Preferred Language

<accept-language> Accept-Language (twice!)

Chapter 5, Configuring POP, IMAP, and HTTP Services

5.2.1 To Allow Log In without Using the Domain Name

<inetdomainsearchfilter> inetDomainSearchFilter

5.2.3 Certificate-Based Login

<You don't need to disable password login to enable certificate-based login. If password login is enabled, and if> If

5.6.1.1 Prerequisites

<Ibiff> iBiff (twice)

To Configure IMAP IDLE

<As mailsrv run> Run:

<local.store.notifyplugin.ensHos> local.store.notifyplugin.enshost
	<local.store.notifyplugin.ensHost> local.store.notifyplugin.enshost
	<local.store.notifyplugin.ensEventKey> local.store.notifyplugin.enseventkey
	<local.store.notifyplugin.ensEventKeyl> local.store.notifyplugin.enseventkey

Chapter 6, Enabling Single Sign-On (SSO)

No changes.

Chapter 7, Configuring and Administering Multiplexor Services

7.2.3 Certificate-Based Client Authentication

<certmap>certmap.conf

To Configure MMP with SSL (Version 13)

Steps 2, 3, Note removed:

<2. If you have installed the Admin Server . . . >

<3. Since the sslpassword.conf file is set . . . >

< NOTE: An alternative approach to steps 1-8 . . .>

Steps 5 & 6 consolidated into a single step: [If you do not want to use SSL between the . . .]

7.4.1.1 IMAP Configuration Example

1) </opt/SUNWmsgsr/config/cert7.db> /opt/SUNWmsgsr/config/cert8.db

2) <"".> /opt/SUNWmsgsr/config/sslpassword.conf

7.4.1.2 POP Configuration Example

<It also provides a spoof message file.>

7.5.1 To Configure Mail Access with MMP

<is not configured automatically, it has to be explicitly configured. In addition, the MMP>

7.5.2 To Set a Failover MMP LDAP Server

1) <IMAPProxyAservice.cfg>ImapProxyAservice.cfg

2) </o=INTERNET"> /o=internet

3) [Make sure there is a space between the host names in the above configuration.]

Chapter 8, MTA Concepts

No substantive changes.

Chapter 9, MTA Address Translation and Routing

9.1.1.2 Domain Map Determination of Domain Locality

Appended to end of section:

[Two MTA options support more efficient domain lookups from user base domain names. They are LDAP_BASEDN_FILTER_SCHEMA1, which is a string specifying a filter used to identify Schema 1 domains when performing user base domain name searches. The default is the value of LDAP_DOMAIN_FILTER_SCHEMA1 if that MTA option is specified. If neither option is specified the default is (objectclass=inetDomain). LDAP_BASEDN_FILTER_SCHEMA2 is a string specifying additional filter elements used to identify Schema 2 domains when performing user base domain name searches. The default is the value of LDAP_DOMAIN_FILTER_SCHEMA2, if that MTA option is specified. If neither option is specified, the default is an empty string.]

9.1.2.2 The $V Metacharacter

Added to bulleted MTA option list: LDAP_DOMAIN_ATTR_CATCHALL_MAPPING (no default value)

9.1.3.12 Optin and Presence Attributes

1) Rewrote the first sentence to: The LDAP_OPTIN1 through LDAP_OPTIN8 MTA options specify LDAP attributes for per-user spam filter opt-in values based on destination addresses.

2) Added the following to first paragraph: LDAP_SOURCE_OPTIN1 through LDAP_SOURCE_OPTIN8 provide comparable originator-address-based per-user spam filter optins.

9.1.4 To Modify Group Membership Attribute Syntax New section.

Chapter 10, About MTA Services and Configuration

Table 10–1

<c_channel>b_channel <d_channel>a_channel

10.3.1 File Format in the Mappings File

1) In entire chapter: <use_text_database> use_text_databases

2) <252> 256 and 1024 characters respectively. [The maximum size of a line in the mapping file is 4096.]

Table 10–4

In entry for $E: [$+1E exits immediately without interpreting the rest of the template.]

Table 10–6

In entry MAX_MESSAGES [The minimum value is 10.]

10.9 To Convert Addresses from an Internal Form to a Public Form

<NOTE: Messaging Server provides other facilities for address manipulation, such as the aliases file and specialized mapping tables. For best performance, however, rewrite rules should be used whenever possible to perform address manipulations. See Chapter 11, Configuring Rewrite Rules.>

[Messaging Server provides other facilities for address manipulation, such as the aliases file and specialized mapping tables. For best performance, however, rewrite rules should be used whenever possible to perform address manipulations. See Chapter 11, Configuring Rewrite Rules.]

Table 10–8

Added. Completely new.

10.10.4.1 To Block Content Return on Large Messages

Appended at end:

[The MTA fetches the block limit associated with the envelope return address and will set RET=HDRS if no return policy is specified and the message size exceeds the block limit. This prevents nondelivery reports for large messages from being undeliverable themselves. No new options or settings are associated with this change.]

10.12 Optimizing MTA Performance. New section.

10.12.1 Optimizing Authorization Checks to the LDAP Directory for Messages Addressed to Mailing Lists. New section.

Chapter 11, Configuring Rewrite Rules

Table 11–4

Added entry for $nT: Overrides the default ALIAS_MAGIC setting, where n is an appropriate value for the ALIAS_MAGIC MTA option. Overrides the setting for the domain when the rule matches during alias expansion.

Table 11–5

Added entry for $. See manual.

Chapter 12, Configuring Channel Definitions

New Channels: addresssrs, caption, chunkingclient, chunkingserver, description, destinationspamfilterX, destinationsrs, disabledestinationspamfilterX, disablesourcespamfilterX, ignoremessageencoding, ignoremultipartencoding, interpretmessageencoding, interpretmultipartencoding, noaddresssrs, nochunkingclient, nochunkingserver, nodestinationsrs, nosourcesrs, sourcespamfilterX, sourcesrs.

New sections: 12.4.6 Support for SMTP Chunking, 12.6.20 Recipient Address Handling, 12.8.5 Interpreting Content-transfer-encoding Fields on Multiparts and Message/RFC822 Parts, 12.12.9 Set Channel Displays for Monitoring Framework

12.12.5 Spam Filter Keywords. Rewrote and added new keywords.

Chapter 13, Using Predefined Channels

Table 13–1

tcp_local entry adds the following: [Sometimes tcp_local gets mail from remote SMTP hosts via proxy or firewall. tcp_local is also sometimes used for internal relay activities.]

Mail Conversion Tags

Added a lot of new material including a new section Including Conversion Tag Information in Various Mapping Probes.

Chapter 14, Integrating Spam and Virus Filtering Programs Into Messaging Server

Table 14–1

LDAP_optinX rewritten. LDAP_SOURCE_OPTINX added.

Table 14–3

New entry for USERNAME_MAPPING.

To Specify User-level Filtering

New Note added to Step 1.

To Specify Domain-level Filtering. New Note added to Step 1.

14.7 Support for Sieve Extensions. New paragraph added (3rd from top).

To Deploy Milter

<spamfilterX_config_file=/opt/SUNWmsgsr/lib/milter.opt> spamfilter1_config_file=/opt/SUNWmsgsr/lib/milter.opt

14.10 Other Anti-Spam and Denial-of-Service Technologies. New section.

14.10.1 Anti-Spam Technique: Delay Sending the SMTP Banner. New Section

Chapter 15, Handling Forged Email Using the Sender Policy Framework

15.7 Handling Forwarded Mail in SPF Using the Sender Rewriting Scheme (SRS). New Section

Chapter 16, LMTP Delivery

16.5.1 To Configure Back End Stores with LMTP and a Minimal MTA. Rewritten.

16.5.4 Handling 4.2.1 Mailbox Busy Error in Response to LMTP Message Data. New section

Chapter 17, Vacation Automatic Message Reply

17.4 Vacation Autoreply Attributes

New attribute definition: LDAP_AUTOREPLY_ADDRESSES

17.5.1 To Send Autoreply Messages for Email That Have Been Automatically Forwarded from Another Mail Server. New section.

Chapter 18, Mail Filtering and Access Control

Table 18–2

New entry for $! (Available in FROM_ACCESS only). Disables the sending of vacation messages regarding this message; that is, it sets the novacation flag.

18.3.3 FROM_ACCESS Mapping Table

Added paragraph to end of section: [The $( metacharacter in a FROM_ACCESS specifies that an address should be read from the result string and used to replace the current overriding postmaster address. $) has the same effect with the added constraint that the overriding postmaster address must not be set prior to invoking the mapping. This allows for specific postmaster addresses to be used with addresses in nonlocal domains - domain postmaster addresses by definition only work with locally defined domains. The override address is (currently) the last string read from the FROM_ACCESS result prior to reading any $N/$F failure result.]

Table 18–3

New Entry for $D: Causes an additional argument to be read from the template result after the mandatory SMTP auth rulset and realm, and optional application information addition. This value must be an integer with the same semantics as the BANNER_PURGE_DELAY value. That is, it specifies the number of centiseconds to delay before purging and sending the banner. A value of 0 disabled both the delay and purge. Note that any PORT_ACCESS mapping setting overrides the BANNER_PURGE_DELAY SMTP channel option. See Anti-Spam Technique: Delay Sending the SMTP Banner for details on using this anti-spam feature. $U [Selectively] enable channel level debugging.

18.3.6 To Limit Specified IP Address Connections to the MTA

First paragraph rewritten: To limit how often a particular IP address can connect to the MTA, see Chapter 19, Throttling Incoming Connections Using MeterMaid. Limiting connections by particular IP addresses can be useful for preventing excessive connections used in denial-of-service attacks. In the past, this function was performed using the shared library, conn_throttle.so in the Port Access mapping table. No new enhancements are planned for conn_throttle.so and MeterMaid is its more effective replacement.

18.10 Sieve Filter Support

Two new bullets:

:resetmailfrom - Reset the envelope FROM: address to that of the current Sieve owner.

:keepmailfrom- Preserve the envelope FROM: address from the original message.

:notify - Specify a new set of notification flags for the redirected message. A single parameter is required giving a list of notification flags. The same set of flags accepted by the NOTIFY parameter of the DSN SMTP extension are accepted here: SUCCESS, FAILURE, DELAY and NEVER. Note that these flags are specified as a Sieve list, for example:

redirect :notify ["SUCCESS","FAILURE"] "foo@example.com";

The default if :notify isn't specified as the normal SMTP default of FAILURE, DELAY.:keepmailfrom is the default unless :notify is specified, in which case the default switches to :resetmailfrom. The one additional exception is that specification of the SUCCESS flag forces the use of :resetmailfrom unconditionally.

Chapter 19, Throttling Incoming Connections Using MeterMaid

Rewritten for clarity. Also added two new sections:

19.4 Limit Excessive IP Address Connections Using Metermaid—Example and 19.4.1 Additional Useful MeterMaid Options

Chapter 20, Managing the Message Store

Changed three instances of store.overquotastatus to local.store.overquotastatus in Table 20–7and 20.8.4.4 To Enable or Disable Quota Enforcement.

20.14.1.4 Check stored Processes

<stored -t -v> imcheck

20.15 Migrating or Moving Mailboxes to a New System

This entire section was moved from Chapter 2, Upgrading from Messaging Server 5.2 to Sun Java System Messaging Server.

Chapter 21, Message Archiving No changes.

Chapter 22, Configuring the JMQ Notification Plug-in to Produce Messages for Message Queue

To Configure a JMQ Notification Plug-in.

<o Sun Java Messaging Server 6 2006Q3>

Chapter 23, Configuring Security and Access Control

23.1 About Server Security

For "End-user account configuration" bullet, <product (valid only for Sun LDAP Schema 1).>

Chapter 24, Administering S/MIME for Communications Express Mail

No substantive changes

Chapter 25, Managing Logging

25.3.1 Understanding the MTA Log Entry Format

Step 5: [The SMS channel can be configured to log a page count rather than file size in this field. See LOG_PAGE_COUNT.]

Table 25–3

<P POP-before-SMTP via the MMP was used. P is added to the E record.>

25.3.3 Specifying Additional MTA Logging Options

To Send MTA Logs to syslog

<A value of 0 is the default and indicates that syslog (event log) logging is not performed.> [A value of 0 disables generation of the syslog notices. A non-zero value enables generation of the syslog notices, with the absolute value controlling the syslog priority and facility mask. (Positive values mean syslog notices and the regular mail.log* entries; negative values, which are not recommended, mean syslog notices only, disabling the regular mail.log* entries. A value of 0 is the default and indicates that syslog (event log) logging is not performed.]

To Control Formatting of Log Entries

1) Add to enqueue/dequeue attributes:

[qt - the amount of time a message has spent in the queue (LOG_QUEUE_TIME=1)]

2) Add to connection attributes: [ct - the amount of time a message has spent in the queue (LOG_QUEUE_TIME=1, also used in en entries)]

3) Updated the following MTA Logging examples:

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 — Outbound Connection Logging <process ID here is the same, 40a5> [process ID here is the same, 1f625] [10. The connection mailhub.sesta.com is closed now that the delivery of the message (dave in this example) is complete.]

25.3.4.10 MTA Logging Example: Inbound Connection Logging

To Enable Message Tracing

1) [configutil -o local.msgtrace.active -v "msgtrace" In this command message trace information for all processes is written to the msgtrace log file]

2) Remove the next two sections: <To Redirect Message Tracing to a Single Log File> and <To Unconfigure Message Trace Loggings>

Chapter 26, Troubleshooting the MTA

26.2.4 Check that the Job Controller and Dispatcher are Running26.2.4 Check that the Job Controller and Dispatcher are Running

You could also use imsimta qm jobs to list, channel by channel, all active and pending delivery processing jobs currently being managed by the Job Controller. Additional cumulative information is provided for each channel such as the number of message files successfully delivered and those requeued for subsequent delivery attempts. The command syntax is as follows:

jobs [-[no]hosts] [-[no]jobs] [-[no]messages] [channel-name]

26.3.8.1 Diagnosing and Cleaning up .HELD Messages Rewritten.

Chapter 27, Monitoring Messaging Server

27.4.1.2 To Monitor the Size of the Message Queues

<use imsimta qm and imsimta summarize.> [use imsimta qm and imsimta summarize.]

Appendix A, SNMP SupportNo substantive changes

Appendix B, Administering Event Notification Service in Messaging Server No substantive changes.

Appendix C, Short Message Service (SMS)

Table C–5

Under Miscellaneous Options:

1) DEBUG - Default: <1>6

2) LISTEN_CONNECTION_MAX - Maximum number of concurrent, inbound TCP connections to allow across all SMPP relay and server instantiations. Default: 10,000

3) LOG_PAGE_COUNT - Controls the value recorded in the mail.log file's message size field to be page count instead of blocks. Default 0

C.5.8.3 Miscellaneous

New section for LOG_PAGE_COUNT.

Appendix D, Installation Worksheets No differences.