From: Quanah Gibson-Mount Date: Tue, 28 Apr 2009 02:56:57 +0000 (+0000) Subject: delta-syncrepl png and svg files. X-Git-Tag: OPENLDAP_REL_ENG_2_4_17~134 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=2147b25b410626fa4f117015827e81133511d221;p=openldap delta-syncrepl png and svg files. n-way-multimaster png and svg files. First attempt to visualise refreshOnly and refreshAndPersist modes of LDAP Sync Protocol. --- diff --git a/doc/guide/admin/delta-syncrepl.png b/doc/guide/admin/delta-syncrepl.png new file mode 100644 index 0000000000..ca1da1445c Binary files /dev/null and b/doc/guide/admin/delta-syncrepl.png differ diff --git a/doc/guide/admin/ldap-sync-refreshandpersist.png b/doc/guide/admin/ldap-sync-refreshandpersist.png new file mode 100644 index 0000000000..f6a2232ce8 Binary files /dev/null and b/doc/guide/admin/ldap-sync-refreshandpersist.png differ diff --git a/doc/guide/admin/ldap-sync-refreshonly.png b/doc/guide/admin/ldap-sync-refreshonly.png new file mode 100644 index 0000000000..7f4a95e740 Binary files /dev/null and b/doc/guide/admin/ldap-sync-refreshonly.png differ diff --git a/doc/guide/admin/n-way-multi-master.png b/doc/guide/admin/n-way-multi-master.png new file mode 100644 index 0000000000..8eadf773ba Binary files /dev/null and b/doc/guide/admin/n-way-multi-master.png differ diff --git a/doc/guide/admin/replication.sdf b/doc/guide/admin/replication.sdf index acc8b7ddfb..d46243b395 100644 --- a/doc/guide/admin/replication.sdf +++ b/doc/guide/admin/replication.sdf @@ -245,7 +245,7 @@ time the provider reads the last saved {{EX:contextCSN}} into memory and uses the in-memory copy exclusively thereafter. By default, changes to the {{EX:contextCSN}} as a result of database updates will not be written to the database until the server is cleanly -shut down. A checkpoint facility exists to cause the contextCSN to +shut down. A checkpoint facility exists to cause the {{EX:contextCSN}} to be written out more frequently if desired. Note that at startup time, if the provider is unable to read a @@ -291,7 +291,7 @@ specification, it is possible for a modification to remove an entry from the replication scope even though the entry has not been deleted on the provider. Logically the entry must be deleted on the consumer but in {{refreshOnly}} mode the provider cannot detect and propagate -this change without the use of the session log. +this change without the use of the session log on the provider. For configuration, please see the {{SECT:Syncrepl}} section. diff --git a/doc/guide/images/src/delta-syncrepl.svg b/doc/guide/images/src/delta-syncrepl.svg new file mode 100644 index 0000000000..4464a955d3 --- /dev/null +++ b/doc/guide/images/src/delta-syncrepl.svg @@ -0,0 +1,4856 @@ + + + + + + + Firewall2 + + + + wall + brick + computer + networksym + + + + + Open Clip Art Library + + + + + HASH(0x89c79d4) + + + + + HASH(0x89c79d4) + + + + image/svg+xml + + + en + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Delta-syncrepl Master/Provider Delta-syncrepl is a changelog-based variant of syncrepl. It works by maintaining a changelog of a selectable depth on the provider. The replication consumer checks the changelog for the changes. + + + + + cn=accesslogdatabase to holdchanges etc. + + + + + + main database + + + + + + + + Consumer which uses syncrepl and the "syncdata=accesslog" setting.Switches back to normal syncrepl if gets too far out of sync, then once caught up goes back to delta. + + + + diff --git a/doc/guide/images/src/ldap-sync-refreshandpersist.svg b/doc/guide/images/src/ldap-sync-refreshandpersist.svg new file mode 100644 index 0000000000..d5047ff20b --- /dev/null +++ b/doc/guide/images/src/ldap-sync-refreshandpersist.svg @@ -0,0 +1,4853 @@ + + + + + + + Firewall2 + + + + wall + brick + computer + networksym + + + + + Open Clip Art Library + + + + + HASH(0x89c79d4) + + + + + HASH(0x89c79d4) + + + + image/svg+xml + + + en + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + LDAP Content Synchronization Operation - refreshAndPersist + + + + + 1. Same as refreshOnly request,but refreshAndPersist modeset. + Server + Client + 2a. Same as refreshOnly mode. + 2b. This time, send a Sync InfoMessage to client indicating refreshstage is done and then enters the persist stage + 3. After receiving the message, the client will construct a synchronized copy as describedin the refreshOnly mode. + 4. Server can now send change notifications based on original SyncSearch Request + 6. Server may terminate Sync Operation.If it doesn't provide a cookie, a fullrefresh is needed by client. + 5a. For returned entries the SearchResultEntry will have the Sync State Control set to either;add, delete or modify + + + + 5b. Waits for server to send entries + 7. Client refreshes if disconnects and provides last syncCookie if ithas one. + + diff --git a/doc/guide/images/src/ldap-sync-refreshonly.svg b/doc/guide/images/src/ldap-sync-refreshonly.svg new file mode 100644 index 0000000000..27f6f4032d --- /dev/null +++ b/doc/guide/images/src/ldap-sync-refreshonly.svg @@ -0,0 +1,4814 @@ + + + + + + + Firewall2 + + + + wall + brick + computer + networksym + + + + + Open Clip Art Library + + + + + HASH(0x89c79d4) + + + + + HASH(0x89c79d4) + + + + image/svg+xml + + + en + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + LDAP Content Synchronization Operation - refreshOnly + + + + + + + 1. Initial client copy Syncrequest - search requestwith Sync Request Controlwith mode set to 'resfreshOnly' + Server + Client + 2a. Returns content matching search and with each entry provides a SyncState Control which contains the 'entryUUID' + 2b. Follows with a SearchResultDone with a 'Sync Done Control' whichprovides the syncCookie - this cookierepresents the session state. + 3. Polls for updates providing the previously issued syncCookie + 4a. Use present or delete phase?Both can be used, present brings client copy up to a point where deletecan begin. + 4b. Server uses syncCookie as an indicator of what client got before andthen sends copies of entries that havechanged. All attributes are sent. + 5. Repeat using syncCookie, i.e.go back to step 3. + + + diff --git a/doc/guide/images/src/n-way-multi-master.svg b/doc/guide/images/src/n-way-multi-master.svg new file mode 100644 index 0000000000..65896783f9 --- /dev/null +++ b/doc/guide/images/src/n-way-multi-master.svg @@ -0,0 +1,5293 @@ + + + + + + + Firewall2 + + + + wall + brick + computer + networksym + + + + + Open Clip Art Library + + + + + HASH(0x89c79d4) + + + + + HASH(0x89c79d4) + + + + image/svg+xml + + + en + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + N-Way Multi-Master + + + + + + + + + + + + + + + + + + + + + Example of aNormal topology + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Example of a ComplexTopology + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + m1 + m2 + m4 + m3 + m1 + m2 + m3 + m4 + m5 + m6 + m7 + m8 + + + + + +