--- title: "Managing Replication Peers" slug: "managing-replication-peers" tags: ["5.4"] updated: 2026-11-01T10:54:39Z published: 2026-11-01T10:54:39Z canonical: "docs.vastdata.com/managing-replication-peers" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Managing Replication Peers A replication peer is another cluster configured as a destination for synchronous or asynchronous replication. ## Viewing Replication Peers in VAST Web UI - From the left navigation menu, select Data Protection and then Replication Peers. For each replication peer, the following information can be displayed: > [!TIP] > **Tip** > > To display or hide fields, click ![column_menu.png](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/img-7f1bcc5ffaeed9cbf182efe768970783(97).png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A37%3A52Z&se=2026-11-08T10%3A37%3A52Z&sr=c&sp=r&sig=ph2x7KzX%2BLMhXLh6EEnfFPsHeRo8skCiN5Gmd%2FXCBDY%3D) to the right of a column title, and then click ![columns.png](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/img-918b4797fca5961ded0a6026c39d1bb1(103).png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A37%3A52Z&se=2026-11-08T10%3A37%3A52Z&sr=c&sp=r&sig=ph2x7KzX%2BLMhXLh6EEnfFPsHeRo8skCiN5Gmd%2FXCBDY%3D) to open a dropdown where you can select or unselect fields. | Field | Description | | --- | --- | | ID | The ID of the replication peer. | | Name | The name of the replication peer. | | Remote Peer Name | The name of the remote peer cluster. | | State | The state of the replication peer. Possible values: - Connected. The connection with the remote peer is alive. - Not Connected. There is no connection with the remote peer. - Delete_pending. The peer is being deleted. - Error. There is an error establishing connection with the remote peer either because the configured target cluster is not found or because the configured target cluster is the same as the source cluster, which is not supported. | | Remote VIP | The remote virtual IP. | | Remote Virtual IP Ranges | The range of virtual IPs in the replication virtual IP pool on the remote peer. For example: 172.16.10.[10-11] | | Local Virtual IP Pool | The replication virtual IP pool configured on the local cluster. | | Remote Space Left | The logical capacity remaining available on the remote peer. | | Last Heart Beat | The time of the last successful message sent, arrived and acknowledged by the peer. | | Remote Version | The software version running on the remote peer. | | Local | - Yes. The replication peer was configured on the local cluster. - No. The replication peer was configured on the remote peer and mirrored to the local cluster. | | Health | An indication of whether the state is OK or not: - OK. if *State* is *Connected*. - Error, if *State* is other than *Connected*. | | Secure Mode | Indicates whether replication to this peer will be encrypted over the wire with mTLS (Secure) or not (None). | ## **Creating a Replication Peer in** **VAST Web UI** This step involves establishing a connection to a remote cluster that will be the destination peer. The replication peer configuration is mirrored on the remote cluster as well. 1. From the left navigation menu, select Data Protection and then Replication Peers. 2. Click Create Peer. 3. Complete the fields: | Field | Description | | --- | --- | | **Peer Name** | Enter a name for the peer configuration. The peer configuration will be mirrored on the remote cluster and have the same name on both clusters. For example: *VASTmain-VASTbackup* | | **Remote VIP** | Enter any one of the virtual IPs belonging to the replication VIP pool to use as the leading remote virtual IP. The remote virtual IP is used to establish an initial connection between the peers. Once the connection is established, the peers share their external network topology and form multiple connections between the VIPs. If the remote peer's replication virtual IP pool is changed after the initial peer configuration, the new virtual IPs are learned automatically if the new range of IPs in the modified virtual IP pool intersects with the previous IP range. However, if the new IP range does not intersect with the old range, the remote virtual IP must be modified on the local peer. | | **Local Virtual IP pool** | From the dropdown, select the replication virtual IP pool configured on the local cluster, or click **Add New Virtual IP pool** to create a new one. | | **Secure Mode** | Select a secure mode for the peer: - **Secure**. Replication to this peer will be encrypted over the wire with mTLS. Secure mode requires a certificate, key and root certificate to be [uploaded to VMS](/docs-5-4/docs/encrypting-replication-with-mtls-tg) for mTLS encryption. - **None**. Replication to this peer will not be encrypted over the wire. ### **Caution** This setting cannot be changed after creating the replication peer. | 4. Click Create. The replication peer is created and mirrored to the remote cluster. The details are displayed in the Replication Peers page on both the local cluster and the remote cluster. ## Modifying a Replication Peer in VAST Web UI To modify the configuration of a peer, open the Actions menu for the peer and select Edit. Make your changes and then click Update. ## Removing a Replication Peer in VAST Web UI A replication peer may not be deleted if it is being used by a protection policy. To remove a peer, open the Actions menu for the peer and select Remove. Click Yes to confirm the removal. ## Managing Replication Peers in VAST CLI To manage replication peers via the [VAST CLI,](/docs-5-4/docs/using-the-vast-cli) use the following commands. | Task | Command | | --- | --- | | Display replication peers | [replicationpeer list](/docs-5-4/docs/en/replicationpeer-list) | | Display details of a specific replication peer | [replicationpeer show](/docs-5-4/docs/en/replicationpeer-show) | | Create a replication peer | [replicationpeer create](/docs-5-4/docs/en/replicationpeer-create) | | Modify a replication peer | [replicationpeer modify](/docs-5-4/docs/en/replicationpeer-modify) | | Delete a replication peer | [replicationpeer delete](/docs-5-4/docs/en/replicationpeer-delete) |