michaeljmarshall commented on a change in pull request #9857:
URL: https://github.com/apache/pulsar/pull/9857#discussion_r592915441
##########
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:
I added a commit that modified it in a similar way to your request.
Please let me know if I need any further changes. I'm not sure about the usage
of the link to pulsar admin: http://pulsar.apache.org/tools/pulsar-admin/. I
used it because you suggested it, but it seems a bit unpolished. Here is a
screenshot:
----------------------------------------------------------------
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:
[email protected]
