UnboundID® Identity Data Sync Administration Guide Version 4.1.0 UnboundID Corp 13809 Research Blvd, Suite 500 Austin, Texas, 78750 Tel: +1 512.600.7700 Email: [email protected] Copyright This document constitutes an unpublished, copyrighted work and contains valuable trade secrets and other confidential information belonging to UnboundID Corporation. None of the foregoing material may be copied, duplicated, or disclosed to third parties without the express written permission of UnboundID Corporation. This distribution may include materials developed by third parties. Third-party URLs are also referenced in this document. UnboundID is not responsible for the availability of third-party web sites mentioned in this document. UnboundID does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. UnboundID will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources. “UnboundID” is a registered trademark of UnboundID Corporation. UNIX is a registered trademark in the United States and other countries, licenses exclusively through The Open Group. All other registered and unregistered trademarks in this document are the sole property of their respective owners. The contents of this publication are presented for information purposes only and is provided “as is”. While every effort has been made to ensure the accuracy of the contents, the contents are not to be construed as warranties or guarantees, expressed or implied, regarding the products or services described herein or their use or applicability. We reserve the right to modify or improve the design or specifications of such products at any time without notice. Copyright 2013 UnboundID Corporation All Rights Reserved Published: 2013-05-01 Contents Contents Preface........................................................................................................................................ ix Purpose of This Guide...................................................................................................................................ix Audience.........................................................................................................................................................ix Related Documentation..................................................................................................................................ix Document Conventions...................................................................................................................................x Chapter 1: Introduction.............................................................................................. 1 Overview of the Identity Data Sync.............................................................................................................. 2 The Synchronization Problem........................................................................................................................ 2 The UnboundID Advantage............................................................................................................................3 Common Synchronization Use Cases............................................................................................................ 4 Use Case: Synchronization during Directory Server Migrations.......................................................4 Advanced Replication.........................................................................................................................5 Use Case: Synchronization with Active Directory............................................................................ 8 Use Case: Synchronizing Realistic Test Environments..................................................................... 9 Use Case: Synchronizing with Relational Databases.........................................................................9 Use Case: Synchronizing through Proxy Servers.............................................................................. 9 Identity Data Sync: How It Works.............................................................................................................. 10 Point-to-Point Bidirectional Synchronization...................................................................................10 Synchronization Architecture........................................................................................................... 11 Change Tracking...............................................................................................................................11 Monitoring and Alerts...................................................................................................................... 12 Logging............................................................................................................................................. 12 Synchronization Modes of Operation...........................................................................................................13 Standard Synchronization Mode.......................................................................................................13 Notification Synchronization Mode................................................................................................. 13 Sync Operations............................................................................................................................................14 Data Transformations........................................................................................................................14 Resync............................................................................................................................................... 14 Real-Time Synchronization.............................................................................................................. 15 About the Sync Retry Mechanism................................................................................................... 15 Configuration Model.....................................................................................................................................17 Sync Control Flow Scenarios.......................................................................................................................18 A Synchronization Example.........................................................................................................................20 Available Tools Summary............................................................................................................................21 Summary....................................................................................................................................................... 22 Chapter 2: Installing the Identity Data Sync...........................................................23 Before You Begin.........................................................................................................................................24 Supported Operating Platforms........................................................................................................ 24 Software Requirements: Java........................................................................................................... 24 About the RPM Package.............................................................................................................................. 24 To Install the RPM Package............................................................................................................ 25 About the Server Installation Modes........................................................................................................... 25 Installing the UnboundID Identity Data Sync in Interactive Mode.............................................................25 To Install the Identity Data Sync in Interactive Mode.................................................................... 26 Installing the UnboundID Identity Data Sync in Non-Interactive Mode.....................................................28 To Install the Identity Data Sync in Non-Interactive Mode............................................................ 28 i Contents Installing the Identity Data Sync with a Truststore in Non-Interactive Mode.............................................28 To Install the Identity Data Sync with a Truststore in Non-Interactive Mode.................................29 Running the Server.......................................................................................................................................29 To Start the Identity Data Sync....................................................................................................... 29 To Start the Identity Data Sync with Global Sync Disabled........................................................... 29 To Run the Server as a Foreground Process....................................................................................30 To Start the Server at Boot Time.....................................................................................................30 Stopping the Identity Data Sync.................................................................................................................. 30 To Stop the Server............................................................................................................................31