SymmetricDS 2 User Guide v2.5 Copyright © 2007 - 2011 Eric Long, Chris Henson, Mark Hanes, Greg Wilmer Permission to use, copy, modify, and distribute the SymmetricDS 2 User Guide Version 2.5 for any purpose and without fee is hereby granted in perpetuity, provided that the above copyright notice and this paragraph appear in all copies. Table of Contents Preface ................................................................................................................................................ vi 1. Introduction ..................................................................................................................................... 1 1.1. What is SymmetricDS? ........................................................................................................ 1 1.2. Background .......................................................................................................................... 1 1.3. SymmetricDS Features ........................................................................................................ 2 1.3.1. Notification Schemes ................................................................................................ 2 1.3.2. Two-Way Table Synchronization ............................................................................. 2 1.3.3. Data Channels ........................................................................................................... 2 1.3.4. Transaction Awareness ............................................................................................. 3 1.3.5. Data Filtering and Rerouting .................................................................................... 3 1.3.6. HTTP(S) Transport ................................................................................................... 3 1.3.7. Remote Management ................................................................................................ 4 1.4. System Requirements ........................................................................................................... 4 1.5. What's new in SymmetricDS 2 ............................................................................................ 4 2. Hands-on Tutorial ........................................................................................................................... 7 2.1. Installing SymmetricDS ....................................................................................................... 8 2.2. Creating and Populating Your Databases ............................................................................ 9 2.3. Starting SymmetricDS ....................................................................................................... 10 2.4. Registering a Node ............................................................................................................. 11 2.5. Sending an Initial Load ...................................................................................................... 11 2.6. Pulling Data ....................................................................................................................... 11 2.7. Pushing Data ...................................................................................................................... 12 2.8. Verifying Outgoing Batches .............................................................................................. 12 2.9. Verifying Incoming Batches .............................................................................................. 13 3. Planning an Implementation ......................................................................................................... 15 3.1. Identifying Nodes ............................................................................................................... 15 3.2. Organizing Nodes .............................................................................................................. 15 3.3. Defining Node Groups ....................................................................................................... 18 3.4. Linking Nodes .................................................................................................................... 19 3.5. Choosing Data Channels .................................................................................................... 19 3.6. Defining Data Changes to be Captured and Routed .......................................................... 20 3.6.1. Defining Triggers .................................................................................................... 20 3.6.2. Defining Routers ..................................................................................................... 21 3.6.3. Mapping Triggers to Routers .................................................................................. 22 3.6.3.1. Planning Initial Loads .................................................................................. 22 3.6.3.2. Circular References and "Ping Back" .......................................................... 22 3.6.4. Planning for Registering Nodes .............................................................................. 22 3.7. Planning Data Transformations ......................................................................................... 23 4. Configuration ................................................................................................................................ 24 4.1. Node Properties .................................................................................................................. 24 4.2. Node ................................................................................................................................... 25 4.3. Node Group ........................................................................................................................ 26 4.4. Node Group Link ............................................................................................................... 26 4.5. Channel .............................................................................................................................. 27 Symmetric DS v2.5 ii SymmetricDS 2 User Guide 4.6. Triggers and Routers .......................................................................................................... 28 4.6.1. Trigger ..................................................................................................................... 28 4.6.2. Router ...................................................................................................................... 29 4.6.2.1. Default Router .............................................................................................. 30 4.6.2.2. Column Match Router .................................................................................. 30 4.6.2.3. Lookup Table Router ................................................................................... 32 4.6.2.4. Subselect Router .......................................................................................... 33 4.6.2.5. Scripted Router ............................................................................................ 34 4.6.3. Trigger / Router Mappings ...................................................................................... 35 4.6.3.1. Initial Load ................................................................................................... 35 4.6.3.2. Dead Triggers ............................................................................................... 37 4.6.3.3. Enabling "Ping Back" .................................................................................. 37 4.7. Opening Registration ......................................................................................................... 38 4.8. Transforming Data ............................................................................................................. 38 4.8.1. Transform Configuration Tables ............................................................................. 39 4.8.2. Transformation Types ............................................................................................. 40 5. Advanced Topics .......................................................................................................................... 42 5.1. Advanced Synchronization ................................................................................................ 42 5.1.1. Bi-Directional Synchronization .............................................................................. 42 5.1.2. Multi-Tiered Synchronization ................................................................................. 42 5.1.2.1. Registration Redirect ................................................................................... 43 5.2. Jobs .................................................................................................................................... 43 5.2.1. Route Job ................................................................................................................ 44 5.2.1.1. Overview ...................................................................................................... 45 5.2.1.2. Data Gaps ..................................................................................................... 45 5.2.2. Controlling Synchronization Frequency ................................................................. 46 5.2.3. Sync Triggers Job ..................................................................................................