Category:General
Last Updated:2011-08-11
The one-to-many sync process supported in UnitySync allows you to use one connection to read your source one time, in order to generate an ldif.txt file. Then, multiple other connections use that ldif.txt as a source when writing to their varying destinations.
The best way to set up one-to-many syncs is as follows:
1) Create an ldap-ldif connection to run Discovery, building the LDIF.txt
When creating this connection, select the appropriate Source Map / Engine Template for your Source.
Select a Destination Sync Engine of LDIF and select a destination map template that represents the directory/attribute set you want in your ldif.txt (i.e. if you want mail attributes, be sure to select a mail enabled template.)
When you run the Discovery for this connection, it will produce an ldif.txt file.
(You should not need to run the Sync phase unless you want to use Custom Mapping when generating the ldif file.)
2) Create one or more ldif-ldap connections that use the above LDIF.txt file as a source (instead of reading directly from your source).
When creating this connection, select the Source Map Template that matches the directory type you specified as the Destination Map Template in step 1.
Select a Source Sync Engine of LDIF.
Select your Destination Sync Engine and Map Template as appropriate for the destination you are syncing to in this connection.
On the General tab, click the Optional LDIF Browse button
Click the Connections button.
Double click the ldap-ldif connection created in step 1.
Highlight the LDIF.txt file and click Accept.
You will see the alternate ldif.txt file is now specified in the Optional LDIF parameter.
When you run the ldif-ldap sync, this ldif.txt file will be used as the source.
When scripting this type of configuration, it would look like the below example.
This performs one read of the source and then as many writes as you need to sync to all your destination directories.
shell "ldap-ldif connection"
shell "ldif-ldap 1"
shell "ldif-ldap 2"
etc.
Using Sync Engines of LDAP-LDAP to perform one-to-many syncs
The above instructions use Sync Engines of LDAP-LDIF and LDIF-LDAP to perform the one-to-many syncs. Alternatively, you could elect to use connections configured using LDAP-LDAP Sync Engines.
You would still use one connection to build the LDIF file... In this connection, you would only run Discovery. The Destination tab would be left blank and the Sync phase would never be run.
The multiple other connections could also be LDAP-LDAP, and in this case, the Source tab would be blank and the Discovery Phase would never be run. On the General tab, you would point to the ldif.txt created by the first connection.