Deleting a Standby Provider

You may choose to remove a Standby Provider node from an HA cluster when it fails to function, or when the node will be offline for an extended period of time.

Data Management for VMware Tanzu does not currently support deleting a Standby Provider from a Provider HA cluster via the console. You must use the DMS API to delete a Standby.

You must initiate the removal of a Standby Provider from the Primary Provider node. After you remove a Standby Provider, the Provider VM can no longer be used in DMS.

Note: DMS does not support moving between Provider standalone and High Availability modes. If only a single Primary Provider remains in your HA cluster and you want to return to standalone Provider mode, you must deploy a new Provider VM and restore it from a backup of the remaining (Primary) Provider node.

Prerequisites

Identify the instance identifier of the Standby Provider node that you want to delete. You can obtain the identifier by invoking the /appliance/provider-ha-nodes endpoint of the Data Management for VMware Tanzu API, locating the node in the output, and extracting the id.

GET https://<provider-ip-address>/appliance/provider-ha-nodes

Sample output excerpt:

...
  {
    "id": "e6e517e5-fca0-4778-96bd-52cb374fb87d",
    "state": "ACTIVE_MODE",
    "role": "SECONDARY",
     ...
  }
...

Procedure

Perform the following procedure to delete a Standby Provider from a Provider HA cluster:

1. Invoke the https://<primary-provider-ip-address>/appliance/provider-ha/<standby-provider-id> endpoint of the Data Management for VMware Tanzu API, specifying the instance identifier of the Standby Provider that you want to delete.

   DELETE https://<provider-ip-address>/appliance/provider-ha/<standby-provider-id>
   

2. Get the Provider HA nodes, examine the output, and verify that the deleted Standby Provider is no longer in the list:

   GET https://<provider-ip-address>/appliance/provider-ha-nodes