Skip to content

Commit 45c0a2f

Browse files
author
Maksim Davydov
committed
* removed redundant options * updated doc
1 parent 6fd955f commit 45c0a2f

File tree

1 file changed

+21
-31
lines changed

1 file changed

+21
-31
lines changed

docs/_docs/extensions-and-integrations/change-data-capture-extensions.adoc

Lines changed: 21 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -491,7 +491,7 @@ The former strategy implies that only one cluster would be activly used for data
491491

492492
The latter approach allows users to use both cluster simultaneously, meanwhile the CDC clients transfer the updates between them. For that strategy to work, the user should configure conflict resolver.
493493

494-
* To make strategies work you have two independent tools to configure:
494+
* To make things work you have two independent tools to configure:
495495

496496
** Thin/Thick clients for connection to destination clusters - responsible for 'put' opertaions on the destination cluster.
497497

@@ -509,7 +509,7 @@ The script will use predefined configuration '.xml' files from '../examples/conf
509509

510510
NOTE: Use `--help` to explore the manager capabilities
511511

512-
NOTE: Please, enable `ignite-rest-http` and `ignite-json` to be able to run `cdc-start-up.sh` with `--check`.
512+
NOTE: Please, enable `ignite-rest-http` and `ignite-json` to be able to run `cdc-start-up.sh` with `--check-cdc`.
513513

514514
Examples for reference:
515515

@@ -538,9 +538,9 @@ NOTE: All properties files are preconfigured to work out of the box.
538538

539539
** There are 5 options you can specify CDC client mode from. Take a look at `--help` command output to learn about them.
540540

541-
** You can optionaly activate both clusters at CDC client start-up with `--activate-cluster`. You need this for steady data replication. You can also use `control.sh` capabilities to activate clusters manually.
541+
** You can optionaly activate both clusters at CDC client start-up with `--activate-cluster`. You need this for data persistance at source and destination clusters. You can also use `control.sh` capabilities to activate clusters manually.
542542

543-
NOTE: Start both clusters (as in previous example with Ignite nodes) before starting CDC client
543+
NOTE: Start both clusters (as in previous example with Ignite nodes) before starting CDC client.
544544

545545
Here is an example on how to start Active-Passive inter-cluster communication with 2 separate nodes and one thin CDC client for Ignite-to-Ignite replication from cluster 1 to cluster 2 (Run the commands independently):
546546
```
@@ -549,6 +549,16 @@ Here is an example on how to start Active-Passive inter-cluster communication wi
549549
./cdc-start-up.sh --cdc-client --ignite-to-ignite-thin --activate-cluster ../examples/config/cdc-start-up/cluster-1
550550
```
551551

552+
NOTE: Make sure clusters fully started up before starting CDC client.
553+
554+
Here is an example on how to start Active-Active inter-cluster communication with 2 separate nodes and 2 CDC clients (thick) for Ignite-to-Ignite replication (Run the commands independently):
555+
```
556+
./cdc-start-up.sh --ignite ../examples/config/cdc-start-up/cluster-1
557+
./cdc-start-up.sh --ignite ../examples/config/cdc-start-up/cluster-2
558+
./cdc-start-up.sh --cdc-client --ignite-to-ignite --activate-cluster ../examples/config/cdc-start-up/cluster-1
559+
./cdc-start-up.sh --cdc-client --ignite-to-ignite ../examples/config/cdc-start-up/cluster-2
560+
```
561+
552562
NOTE: To start CDC with Kafka you need to start topics beforehand.
553563

554564
We use the following topics naming for our examples:
@@ -567,26 +577,12 @@ We use the following topics naming for our examples:
567577
./kafka-topics.sh --create --partitions 1 --replication-factor 1 --topic metadata_from_dc2 --bootstrap-server localhost:9092
568578
```
569579

570-
* Start a whole replication system with specified strategy and properties for both clusters:
571-
572-
** Use `--active-active` for Active-Active replication and `--active-passive` for Active-Passive replication.
573-
574-
** You should provide properties files paths for both cluster nodes in the end of the command
575-
576-
** By default, this script uses Ignite clients (thick) for replication. You can optionally use `--with-kafka` to transfer data through Kafka, and `--thin` to use thin clients for connections to the destination clusters.
577-
578-
NOTE: There is no need to preactivate clusters, as the script will do it for you.
579-
580-
To repeat the replication example from the previous point, you can use the following:
581-
582-
```
583-
./cdc-start-up.sh --active-passive --thin ../examples/config/cdc-start-up/cluster-1 ../examples/config/cdc-start-up/cluster-2
584-
```
585-
586-
Active-Active with thin clients and Kafka as data transport:
587-
580+
Here is an example on how to start Active-Passive inter-cluster communication with 2 separate nodes and 2 CDC clients for replication with Kafka from cluster 1 to cluster 2 (Run the commands independently):
588581
```
589-
./cdc-start-up.sh --active-active --with-kafka --thin ../examples/config/cdc-start-up/cluster-1 ../examples/config/cdc-start-up/cluster-2
582+
./cdc-start-up.sh --ignite ../examples/config/cdc-start-up/cluster-1
583+
./cdc-start-up.sh --ignite ../examples/config/cdc-start-up/cluster-2
584+
./cdc-start-up.sh --cdc-client --ignite-to-kafka --activate-cluster ../examples/config/cdc-start-up/cluster-1
585+
./cdc-start-up.sh --cdc-client --kafka-to-ignite-thin ../examples/config/cdc-start-up/cluster-2
590586
```
591587

592588
* You can check CDC replication with `--check-cdc`. Use it in parallel with Active-Passive/Active-Active replication. To start CDC check for proposed entry:
@@ -596,13 +592,7 @@ Active-Active with thin clients and Kafka as data transport:
596592

597593
The command basically puts the entry to the chosen cluster and shows the difference between the two clusters until the data fully transfered.
598594

599-
NOTE: To use it with Active-Passive, push entries only in the Active part of the CDC inter-cluster system. See the example below
600-
601-
```
602-
./cdc-start-up.sh --active-passive ../examples/config/cdc-start-up/cluster-1 ../examples/config/cdc-start-up/cluster-2
603-
```
604-
605-
`cluster-1` is an active part since its properties' directory goes first in the command. In this case there is no reason to push data to the second cluster during the check step, as the data is not replicated from the second cluster.
595+
NOTE: To use it with Active-Passive, push entries only in the Active part of the CDC inter-cluster system.
606596

607597
NOTE: Try to play with version value to see how the conflict resolver works. We propose the following sequence of operations with Active-Active:
608598

@@ -612,4 +602,4 @@ NOTE: Try to play with version value to see how the conflict resolver works. We
612602
./cdc-start-up.sh --check-cdc --key 11006 --value 3 --version 3 --cluster 1
613603
./cdc-start-up.sh --check-cdc --key 11006 --value 2 --version 2 --cluster 2
614604
```
615-
This sequence simulates the case when the first cluster receives outdated value from the second. In our case the data will not be replicated in the last command and the check would fail after 20 tries.
605+
This sequence simulates the case when the first cluster receives outdated value from the second. In our case the data will not be replicated in the last command and the check would fail after 20 tries.

0 commit comments

Comments
 (0)