You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by GitBox <gi...@apache.org> on 2021/03/11 13:27:53 UTC
[GitHub] [pulsar] Anonymitaet commented on a change in pull request #9857: [Documentation][Geo Replication] Document clusters create step in geo replication
Anonymitaet commented on a change in pull request #9857:
URL: https://github.com/apache/pulsar/pull/9857#discussion_r592357497
##########
File path: site2/docs/administration-geo.md
##########
@@ -45,6 +45,32 @@ All messages produced in any of the three clusters are delivered to all subscrip
As stated in [Geo-replication and Pulsar properties](#geo-replication-and-pulsar-properties) section, geo-replication in Pulsar is managed at the [tenant](reference-terminology.md#tenant) level.
+The following example connects three clusters: **us-east**, **us-west**, and **us-cent**.
+
+### Connect Clusters
+
+To replicate among clusters, you must first configure each cluster to connect to the other. You can use the [`pulsar-admin`](reference-pulsar-admin.md#clusters) tool to create the connection.
+
+Run the following command in **us-west** to configure the connection to **us-east**:
+
+```shell
+$ bin/pulsar-admin clusters create \
+ --broker-url pulsar://<DNS-OF-US-EAST>:<PORT> \
+ --url http://<DNS-OF-US-EAST>:<PORT> \
+ us-east
+```
+
+Then, run the following command in **us-west** to configure the connection to **us-cent**:
+
+```shell
+$ bin/pulsar-admin clusters create \
+ --broker-url pulsar://<DNS-OF-US-CENT>:<PORT> \
+ --url http://<DNS-OF-US-CENT>:<PORT> \
+ us-cent
+```
+
+Analogous commands will need to be run in **us-east** and **us-cent** to create the remaining necessary cluster connections for replication. For clusters using a secure connection, see the [`pulsar-admin`](reference-pulsar-admin.md#clusters) create command.
Review comment:
```suggestion
### Connect replication clusters
To replicate data among clusters, you need to configure each cluster to connect to the other. You can use the [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/) tool to create a connection.
**Example**
Suppose that you have 3 replication clusters: `us-west`, `us-cent`, and `us-east`.
1. Configure the connection from `us-west` to `us-east`.
Run the following command on `us-west`.
```shell
bin/pulsar-admin clusters create \
--broker-url pulsar://<DNS-OF-US-EAST>:<PORT> \
--url http://<DNS-OF-US-EAST>:<PORT> \
```
> #### Tip
>
> If you want to use a secure connection for a cluster, you can use the flag `--url-secure`. For more information, see [pulsar-admin clusters create](http://pulsar.apache.org/tools/pulsar-admin/).
2. Configure the connection from `us-west` to `us-cent`.
Run the following command on `us-west`.
```shell
bin/pulsar-admin clusters create \
--broker-url pulsar://<DNS-OF-US-CENT>:<PORT> \
--url http://<DNS-OF-US-CENT>:<PORT> \
```
3. Run similar commands on `us-east` and `us-cent` to create connections among clusters.
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org