Chat now with support
Chat with Support

Directory Sync Pro for Active Directory 20.11.1 - User Guide


The Nodes feature allows two or more Directory Sync Pro for Active Directory services to be installed and configured to point to the same SQL database, and ensures that only one instance is active and syncing objects. This feature is designed for basic disaster recovery purposes. This feature only applies to the AD service (BinaryTree.DirSync.Exhange.exe).

Each instance of the Directory Sync Pro for Active Directory service is referred to as a Node. Only one node can be active at any moment and is the only node that will sync profiles. Nodes can be switched between active and passive on the Nodes screen.

Nodes must be started and stopped manually from the server on which they are installed. Only the state of the Node (active or passive) can be changed on the Nodes screen.


Directory Sync Pro for Active Directory Nodes

The Nodes list has the following columns:

  • Name: The name of the server on which the Node is running.
  • Status: The status of the server, whether it is Online or Offline.
  • State: The state of the server, whether it is the Active Node or a Passive node.
  • Last Contact: The last time the Node checked in with SQL.

The Nodes screen has the following buttons:

  • Deactivate: Makes an Active Node into a Passive Node. This button is only available when the Active Node is selected in the list. Any running sync jobs will be canceled.
  • Activate: Makes a Passive Node into the Active Node. Only one Node can be active at a time, so this button is only available when all Nodes are Passive Nodes.
  • Remove: Removes a Node from the list. The Active Node cannot be removed, so this button is only available for Passive Nodes.
  • Refresh: Refreshes the Nodes list. The list does not automatically refresh.

Click the Node to view additional details, such as the Node’s unique GUID.


Node Running

Periodically (every 30 seconds), a node will check in with SQL to determine if it should switch state to Active or Passive. Any node state switches will be written to the Windows Event Log.

If the node is Active and it is switched to Passive, any running syncs will continue to run to completion. This will allow the node to cancel any running profiles.

Removing a node from the list on the Nodes screen does not terminate or uninstall the node. Nodes must be manually stopped and uninstalled.

The Last Contact time will be updated every time the node checks in. If a node shows as online but there have not been any updates to the Last Contact time within the last 30 seconds, the node may have terminated unexpectedly.


Node Shutdown - Normal Termination

When a node is shutdown (the service is stopped) it will notify SQL that it is shutting down. This will change the status of the node to Offline. The Last Contact time will also be updated. The state of the node will not change.


Node Shutdown - Unexpected Termination

If a node terminates unexpectedly, then SQL will not be notified of the shutdown. In this case, the node will still be shown in the Nodes screen as Online, but the Last Contact time will no longer be updated.

If a passive node terminates unexpectedly, the service can be manually restarted.

If the active node terminates unexpectedly, it will still be displayed on the Nodes screen as the active node. There are two options in this case:

  • The node may be manually restarted, and will resume processing as the active node.
  • The node may be deactivated on the Nodes screen. Running profiles will be marked for cancellation and the currently active node will be made a passive node. Once this is done, a different node can be made the active node.

If the crashed node will no longer be used, it can be removed from the Nodes screen.


General Settings

If your migration project includes Exchange as a source or target, you can modify your options on this screen.

Exchange Options

Promote Target User Contacts

If you check this box, any TARGET contacts will be converted into mail-enabled users.

For the scope of this feature a Microsoft Exchange Mail Enabled Contact is defined as an Active Directory contact where the LegacyExchangeDN attribute is not null. A contact will be promoted to a user if the primary SMTP address on the a source object matches the external or target email address of the contact. Once the attributes have been stored on the newly created Microsoft Exchange User on the target, the Contact object will be removed from the target. The source User must have a LegacyExchangeDN. The contacts in the source, that will be converted, must be in a different OU than the Target OU selected on the AD Target tab.

This option may not be selected if the setting Create Mail Enabled Users As on the AD Target Options Users tab is set to Contact, or if the source object is already a contact.

Promote Target Group Contacts

If you check this box, any TARGET groups will be converted into mail-enabled users.

Update Mailbox-Enabled Objects only

Checking this box will cause Directory Sync Pro for Active Directory to only update those objects that are mail-enabled.

Configure Contacts for Delegation

Choose how to configure contacts for delegation.

Add x500 Proxy to Source

If you need to migrate mailbox permissions, check the box that adds the x500 proxy to the source. Note that this is one of the only times that Directory Sync Pro for Active Directory makes any changes to a SOURCE object.

Enable Resource Forest

If you are migrating your mailboxes into a resource forest, check the Enable Resource Forest box. This will set the Master Account SID on all synchronized mailboxes in the target environment.

PowerShell Script

You have the option to create your own scripts using PowerShell that can be run against after a sync is completed. The script will run using the target credentials that you entered when creating this profile.

General Object Settings

Target Proxy Address Overwrite Behavior

If you check this box, source proxy addresses will always overwrite the proxy addresses in the target, replacing whatever values are there, if any. If this box is left unchecked, the source proxy address will only be added to those target objects where this attribute is currently empty.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating