XFOR: Manual Dir-Sync with Exchange as Dir-Sync Requestor

ID: Q148309

The information in this article applies to:

Microsoft Exchange Server, versions 4.0, 5.0, 5.5

SUMMARY

This article explains how to perform manual directory synchronization (dirsync) between Microsoft PC Mail postoffices and Microsoft Exchange Server as the dirsync requestor. This article assumes you have already configured directory synchronization.

I. Preparations Before Manual Directory Synchronization

You need to do the following:

For Microsoft Exchange Server version 4.0, enable the Pause button for the Microsoft Exchange Directory Synchronization (Dir- Sync) in the Windows NT Server Registry. For Microsoft Exchange Server versions 5.0 and 5.5, the Pause button is enabled by default and does not require editing the registry.

Increase diagnostic logging to assist you in troubleshooting the manual directory synchronization process.

Configure Windows NT Server Registry to Enable the Pause Button for the Exchange Directory Synchronization Service

NOTE: It is not necessary to add the PauseKicksDX registry entry to Exchange Server version 5.0 or later as this functionality is already included.

WARNING: Using Registry Editor incorrectly can cause serious, system-wide problems that may require you to reinstall Windows NT to correct them. Microsoft cannot guarantee that any problems resulting from the use of Registry Editor can be solved. Use this tool at your own risk.

Run the Registry Editor (REGEDT32.EXE).

Under the HKEY_LOCAL_MACHINE subtree, go to the following subkey:
```
SYSTEM\CurrentControlSet\Services\MSExchangeDX 
```

Select Edit.

Choose Add Value.

In the Value name box, type:

PauseKicksDX

From the Data type box, select REG_DWORD.

Choose OK.

In the DWORD editor box, type: 1

Choose OK.

Run Control Panel and choose Services to stop and restart the Microsoft Exchange Directory Synchronization service in order for the service to recognize this value.

Increase Diagnostic Logging to Assist You in Troubleshooting the Manual Directory Synchronization Process

Run Microsoft Exchange Administrator.

From the Container window select the appropriate site Configuration, Connections container:

Double-click the Microsoft Mail Connector.

From the Diagnostics Logging property page, highlight the MSExchangePCMTA and set the Logging level to Maximum.

II. How to Do a Manual Directory Synchronization

NOTE: If the Microsoft Mail executables are run from a command prompt under Microsoft Windows NT, preface the commands with FORCEDOS. For example, the first command run for T1 would be:

forcedos reqmain -d<drive> -t

where <drive> refers to the drive letter connected to the mail database.

NOTE: Commands must be run from the direcory where the execuatble is located or you will receive the error "FORCEDOS: Program file not found." Most commonly, the directory \MAILEXE will contain all the Microsoft Mail executable files.

(T1) On every Microsoft Mail Postoffice involved in Dirsync as a requestor, including the postoffice defined as the Dirsync server, type the following command from the Microsoft Mail executables directory:

reqmain -d<drive> -t

(T1) On every Exchange Server involved in Dirsync as a requestor, use Control Panel, Services to pause the Microsoft Exchange Directory Synchronization service. After the Pause button has been selected the administrator will receive the following error message which can be ignored:

Could not pause the Microsoft Exchange Directory Synchronization service on \\<server>. Error 2140: An internal Windows NT error occurred. Click on OK.

The Dirsync messages are delivered by the Microsoft Mail Connector to the Microsoft Mail Dirsync Server and queued in the SYSTEM.MBG to await T2 events.

Using the Event Viewer Application Log, verify the Dirsync message has been transferred to the Microsoft Mail Dirsync Server. You should see the following two entries:


      * Event ID: 4395
         Category: Sent
         Description: Mail sent from \\<Requestor Server>\MAILDAT$
               FROM:  <DXA Requestor Organization>/<DXA Requestor Site>/SYSTEM1
               TO:    <Dirsync Server Network>/<Dirsync Server PO>/$SYSTEM

      * Event ID: 4355
         Category: Moved In
         Description: Mail received on \\<Dirsync Server>\MAILDATA
               FROM:  <DXA Requestor Organization>/<DXA Requestor Site>/SYSTEM1
               TO:    <Dirsync Server Network>/<Dirsync Server PO>/$SYSTEM

NOTE: You can modify the Polling Frequency to check for mail every minute to ensure mail is transferred quickly. To change the Polling Frequency, use the Microsoft Exchange Administrator program to do the following:

From the Container window, select the appropriate site's Configuration, Connections container.

Open the Microsoft Mail Connector and select the Connector MTAs property page.

Highlight the appropriate Microsoft Mail Connector (PC) MTA Service and select the Configure button.

Change the value of "Check for mail every __ minute" to 1.

Be sure to stop and start the service for the change to take affect.

(T2) On the Microsoft Mail Dirsync Server, type the following commands from the Microsoft Mail executables directory:
srvmain -r -d<drive>
srvmain -t -d<drive>

where <drive> refers to the drive letter connected to the mail database.

The SRVMAIN -R command receives and places updates in the MSTTRANS.GLB file. The SRVMAIN -T command reads the SRVCONF.GLB file, determines which updates need to be sent to each requestor, reads the MSTTRANS.GLB file to create the updates, generates a mail message back to each requestor that sent a request to the server and finally places the outgoing mail in the P1 directory.

Using the Event Viewer Application Log, verify the Dirsync message has been transferred to the Exchange Requestor. You should see the following two entries:


      * Event ID: 4395
         Category: Moved Out
         Description: Mail sent from \\<Dirsync Server Server>\MAILDATA
               FROM: <Dirsync Server Network>/<Dirsync Server PO>/$SYSTEM
               TO:  <DXA Requestor Organization>/<DXA Requestor Site>/SYSTEM1

      * Event ID: 4355
         Category: Received
         Description: Mail received on \\<Requestor Server>\MAILDAT$
               FROM: <Dirsync Server Network>/<Dirsync Server PO>/$SYSTEM
               TO:  <DXA Requestor Organization>/<DXA Requestor Site>/SYSTEM1

(T3) On every Exchange Server involved in Dirsync as a requestor, the DXA Requestor dynamically applies the changes as soon as they arrive. The DXA Requestor does not need to be configured with a scheduled T3 time.

(T3) On every Microsoft Mail Postoffice involved in DirSync as a requestor, type the following commands from the Microsoft Mail executables directory:
reqmain -d<drive> -r
import -d<drive> admin -p<password> -q -y
rebuild -d<drive> -f

where <drive> refers to the drive letter connected to the mail database. The REQMAIN -R command receives the updates and moves them into the SRVTRANS.GLB file. The import command takes the SRVTRANS.GLB records and moves them into the temporary transaction files depending on what types of addresses they contain. Then the Import command moves the names into the .USR and .NME files. The -Q option tells Import to use the SRVTRANS.GLB file for the update, and the -Y option tells Import to run without asking for permission to continue. The rebuild -F command takes the network names, the .NME files, and the .USR files to build the GAL and the GAL index file. The -F option is the same as the -Y option for import.

This concludes the manual Dirsync process.

REFERENCES

For more information on Microsoft Mail for PC Networks Directory Synchronization, please refer to the "Directory Synchronization (Dir-Sync)" document.

You can obtain this document from the following sources:

Microsoft's World Wide Web Site on the Internet

The Internet (Microsoft anonymous ftp server)

The Microsoft Network (MSN)

Microsoft Product Support Services

The following self-extracting file is available for download from the Microsoft Software Library: Wa0725.exe

This document has also been posted to the following Internet location:

ftp://ftp.microsoft.com/bussys/mail/pcmail public/WA0725/

For more information about how to obtain this document, please see the following article in the Microsoft Knowledge Base:

Q96060 PC DirSync: Directory Synchronization (Dir-Sync)

For additional instructions on Microsoft Exchange Directory Synchronization, please refer to Chapter 14 of the Microsoft Exchange Server Administrator's Guide.

For additional information on how to perform manual directory synchronization between Microsoft PC Mail Postoffices and Microsoft Exchange Server, please see the following article in the Microsoft Knowledge Base:

Q147464 Manual Dirsync with Exchange as Dirsync Server

Additional query words: dir-sync dirsynch faq


Keywords          : kbenv XFOR 
Version           : winnt:4.0,5.0,5.5
Platform          : winnt 
Issue type        :

Last Reviewed: March 20, 1999