Chat now with support
Chat with Support

Coexistence Manager for Notes 3.8.2 - User Guide

About the CMN Documentation Suite Introduction CMN Directory Connector
Directory Connector overview Installation and configuration DC Management Console Connector Creation Wizard Connector Advanced Settings Starting and stopping the Directory Connector service
CMN Mail Connector
Mail Connector features overview Coexistence mail routing basics Deployment of CMN Mail Connector Installation Configuration Mail Connector Management Console
CMN Free/Busy Connector The Log Viewer Appendix A: Known limitations Appendix B: Troubleshooting Appendix C: CMN Logs

Mail Connector

Verify that all system requirements have been met (see System requirements in the RTM Release Notes).

Verify that you have a valid Quest License Key installed. For more information, see About Quest license keys in chapter 1.

CMN processing may marginally increase or decrease the size of a message, which may rarely push a message over a receiving server’s size limit even though the original message was smaller than the server’s configured limit.

A subdomain routing method may introduce a risk that the assigned subdomain names will escape your organization’s internal communications, which in turn can cause bounce-backs on replies to those addresses. To prevent this problem, set the Notes forwarding address attribute to user@subdomain@notesdomain, which causes Domino to set the reply address for external email to the user's primary SMTP address (internet address field value).

This may be caused by a shadow redundancy feature built into Exchange 2010 SP1 RU4. Shadow redundancy keeps a copy of a message on the previous hop until the server verifies that it has successfully delivered it to all the next hops—which isn't possible when receiving a message from a mail server (like CMN) that doesn't support shadow redundancy. In that case, Exchange delays its acknowledgement to the sending server until it verifies that the message has been successfully delivered, or until a specified timeout interval expires (without verification), whichever comes first. The timeout interval is specified by the MaxAcknowledgementDelay attribute of each Receive connector. The default value is 30 seconds.

If this seems likely to be the cause of the problem, try disabling the MaxAcknowledgementDelay feature.

The Domino server is likely misconfigured (in the Outbound servers screen of CMN’s Management Console) for the wrong version.

Notes implements some features differently in different client versions, and CMN can process messages differently to accommodate those differences. Each Domino server is designated (in the Management Console) to a particular version, so CMN will know how to process messages bound for that server.

The .nsf attachment file is designed to open into a Lotus Notes client, so a Notes client must be installed on the Outlook recipient’s computer, and must be connected to a Domino server. If the recipient has no Notes client installed, the attachment will not open.

Assuming a Notes client is installed on the Outlook recipient’s computer, the NSF file type must be associated (in Windows) with the Notes client application. If the Outlook user has not defined that association, Windows will prompt the user to designate an application to use to open the file.

When a Notes user sends a message with Active Mail content to an Outlook user, who then forwards the message back to a Notes user, the Notes recipient is unable to open the .nsf attachment, and an error message reports that the database cannot be found. If the Notes recipient can save the attachment locally first, however, the attachment should open normally.

Active Mail content that references shared resources not included in the CMN.ntf file will appear to an Outlook recipient as a database with empty cells or other missing parts. To correct this, verify any shared resources that will be referenced by Active Mail content are included in the CMN.ntf template file.

This is an issue only in some environments, and the most likely solution is to change the message delivery restriction settings. Note that an Exchange group must be of the universal distribution type to be mail-enabled. For an admin to change the settings, beginning in the Exchange Management Console:

1
Select the group under Recipient Configuration | Distribution Group, then double-click the group you want to edit.
2
Click the Mail Flow Settings tab, and highlight Message Delivery Restrictions, then click Properties above.
3
De-select (unmark) the check box for Require that all senders are authenticated.
4
Save, and then restart the MS Exchange transport service.

Meeting requests originating in Notes and sent to Exchange users may be off by one hour for meetings scheduled in the period between the second Sunday in March (when daylight savings time begins) and the first Sunday in April (when DST used to begin). This is not a CMN defect, but rather an apparent issue in the way Windows processes time zone data.

Microsoft offers a free time-zone update utility (downloadable from http://support.microsoft.com/kb/2443685) that will likely correct this problem. Apply the update to the Windows OS on both the Domino server and the CMN admin server hosting the Mail Connector software.

PermanentFailure” in CMN logs; EHLO command rejected or returned as unrecognized

A PermanentFailure appears in the CMN logs, and the SMTP logs show that the EHLO command was being rejected or returned as unrecognized:

And about the same time:

You may have a firewall that is inspecting message traffic and making changes, causing CMN to fail to send a message. Investigate the environment to make sure there is no firewall manipulating traffic. “XXXX hostname unrecognized” is the target server explaining why it rejected the message and why CMN failed to send it: it received “XXXX” when it was expecting “EHLO.”

Look through your CMN Mail Connector log files for clues to help diagnose and resolve the problem. If necessary, see Appendix C: CMN Logs for instructions to configure the feature to suit your needs.

Free/Busy Connector

Troubleshooting tips for the F/B Connector are documented in an Appendix of the FBC Scenarios Guide.

 

Appendix C: CMN Logs

 

By default, CMN is installed with the log4net utility to generate log files of CMN components’ system activity. This information is critical to diagnosing any problems that may arise. CMN log entries look like this:

2011-02-18 16:20:43,851 INFO CMN.logging - Connection from 127.0.0.1:20045
2011-02-18 16:20:43,866 INFO CMN.logging - [1] Established channel from Notes(127.0.0.1:20045) to Exchange(10.4.160.17:25). Total Channels: 2
2011-02-18 16:20:48,804 INFO CMN.logging - [1] Message Sent From: , To: , Message Number: (1) Message ID: () Size: (5) Proc Time: (188)msec Routed From Notes(127.0.0.1:20045) to Exchange(10.4.160.17:25)
2011-02-18 16:20:49,788 INFO CMN.logging - [1] Router closed. Open Sockets: 0
2011-02-18 16:24:54,446 ERROR CMN.logging - [2] Message Failed 552 CMN was unable to process the message. ICal Error: The recurring series spans over 1000 days, and Exchange can not display it. From: somewhere@place.com, To: here@somewhereelse.com, Message Number: (2) Message ID: () Size: (244159) Proc Time: (2828)msec Routed From Notes(127.0.0.1:20056) to Exchange(10.4.160.17:25)

CMN logs are configured and saved separately, by component, in files that reside in or under each component’s subtree root folder. CMN logging is enabled by default, for all CMN components, and the default configurations will be suitable for almost all organizations and circumstances. The parameters that are most often edited are listed in the procedure notes below.

CMN actually generates multiple log files for each component, so you can track different types and levels of program activity. All CMN logging-configuration files are xml-format files, which you can edit with any XML editor.

NOTE: The Open Log File button in the Management Console’s Health screen is enabled only when the UdpAppender is defined in the log42net.config file of at least one module. During a new installation, the Log Viewer installer installs a file with the required UdpAppender. During an upgrade, however, the installer does not overwrite the log42net.config file, so the UdpAppender is not present, and this makes the Open Log File button invisible. To correct this, see Adding the UdpAppender to an existing log file at the end of this Appendix.

Log files for the Directory Connector

Logs are stored in the Logs subdirectory under the Directory Connector folder.

The Directory Connector log files CMN.log and CMN_ERROR.log are configured in the file
C:\Program Files (x86)\Quest\Coexistence Manager for Notes\Directory Connector\log42net.config

The Directory Connector log files Sync.log and Sync_ERROR.log are configured in the file
C:\Program Files (x86)\Quest\Coexistence Manager for Notes\Directory Connector\tools\log42net.config

The configuration section for each log file is listed below.

CMN.log

section <appender name="LogFileAppender" ...>

CMN_ERROR.log

section <appender name="ErrorLogFileAppender" ...>

Sync.log

section <appender name="LogFileAppender" ...>

Sync_ERROR

section <appender name="ErrorLogFileAppender" ...>

Related Documents