Fork me on GitHub

The Push Replication Hub & Spoke Example

Prerequisites

To run this example the Oracle Coherence Incubator must be built and installed locally. Instructions on how to achieve this are located here: Building the Oracle Coherence Incubator.

Source Code

The source code for this example is located in the coherence-pushreplicationpattern-examples module of the Oracle Coherence Incubator.

Overview

This example demonstrates Push Replication Pattern configured in a "Hub & Spoke" topology, where by one cluster, the "hub"/"active" cluster, uses an application that performs read/write operations. These operations are then replicated to two or more other "spoke"/"passive" clusters, that of which are predominantly being used in a read-only mode. Entries that may be updated by applications in the "spoke" clusters are not replicated back to the "hub" cluster.

The Hub and Spoke Topology

There are six applications to run as part of this example. The following details the intent, instructions and the order in which to run these applictions.

The following instructions assume that $COHERENCE_INCUBATOR is the directory in which the Oracle Coherence Incubator source code has been downloaded, unpacked and built according to the prerequisites outlined above.

Step 1. Running the Active Server (Site 1)

Execute the following shell commands to start the "Active Server".

In a new Terminal / Shell Console for the "Active Server (Site 1)"

  1. Change to the Push Replication Pattern Examples directory.

    cd $COHERENCE_INCUBATOR/coherence-pushreplicationpattern-examples/target

  2. Run the "Active Server (Site 1)"

    java -jar coherence-pushreplicationpattern-examples-11.2.1-SNAPSHOT.jar hubspoke-active-server.properties

Step 2. Running the Passive Server (Site 2)

Execute the following shell commands to start the "Passive Server (Site 2)".

In a new Terminal / Shell Console for the "Passive Server (Site 2)"

  1. Change to the Push Replication Pattern Examples directory.

    cd $COHERENCE_INCUBATOR/coherence-pushreplicationpattern-examples/target

  2. Run the "Passive Server (Site 2)"

    java -jar coherence-pushreplicationpattern-examples-11.2.1-SNAPSHOT.jar hubspoke-passive1-server.properties

Step 3. Running the Passive Listener (Site 2) Application

Execute the following shell commands to start the "Passive Listener (Site 2)". This application will output cache events detailing the updates occuring in the "Passive Server (Site 2)". These updates originate from the "Active Server (Site 1)".

In a new Terminal / Shell Console for the "Passive Listener (Site 2)"

  1. Change to the Push Replication Pattern Examples directory.

    cd $COHERENCE_INCUBATOR/coherence-pushreplicationpattern-examples/target

  2. Run the "Passive Listener (Site 2)"

    java -jar coherence-pushreplicationpattern-examples-11.2.1-SNAPSHOT.jar hubspoke-listener1.properties

Step 4. Running the Passive Server (Site 3)

Execute the following shell commands to start the "Passive Server (Site 3)".

In a new Terminal / Shell Console for the "Passive Server (Site 3)"

  1. Change to the Push Replication Pattern Examples directory.

    cd $COHERENCE_INCUBATOR/coherence-pushreplicationpattern-examples/target

  2. Run the "Passive Server (Site 3)"

    java -jar coherence-pushreplicationpattern-examples-11.2.1-SNAPSHOT.jar hubspoke-passive2-server.properties

Step 5. Running the Passive Listener (Site 3) Application

Execute the following shell commands to start the "Passive Listener (Site 3)". This application will output cache events detailing the updates occuring in the "Passive Server (Site 3)". These updates originate from the "Active Server (Site 1)".

In a new Terminal / Shell Console for the "Passive Listener (Site 3)"

  1. Change to the Push Replication Pattern Examples directory.

    cd $COHERENCE_INCUBATOR/coherence-pushreplicationpattern-examples/target

  2. Run the "Passive Listener (Site 3)"

    java -jar coherence-pushreplicationpattern-examples-11.2.1-SNAPSHOT.jar hubspoke-listener2.properties

Step 6. Running the Active Publisher (Site 1) Application

Execute the following shell commands to start the "Active Publisher (Site 1)". This application will insert, update and remove entries in the "Active Server (Site 1)", that of which will then "push" said updates to the "Spoke" / "Passive Servers".

In a new Terminal / Shell Console for the "Active Publisher (Site 1)"

  1. Change to the Push Replication Pattern Examples directory.

    cd $COHERENCE_INCUBATOR/coherence-pushreplicationpattern-examples/target

  2. Run the "Active Publisher (Site 1)"

    java -jar coherence-pushreplicationpattern-examples-11.2.1-SNAPSHOT.jar hubspoke-publisher.properties