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:
[email protected]
