Remove an inactive remote Eclipse Amlen server cluster member

Purpose

Use this command with caution. If you have a member that you no longer want to participate in the cluster, disable cluster membership by setting EnableClusterMembership to false on that member. If you have a cluster member that is inactive and cannot be restarted, then other cluster members queue the messages and retained messages until that member becomes active. Eventually, this might lead to a performance degradation. In this case you might want to permanently remove that member from the cluster by using this command. This command results in the member being permanently removed from the cluster. All messages that are queued to be sent to the inactive member are permanently deleted from the system. Outbound messages from the inactive member are also permanently deleted. For more information about disabling cluster membership, see Configure Eclipse Amlen server cluster membership.

URI

Use the Eclipse Amlen REST API POST method with the following Eclipse Amlen configuration URI:

http://<admin-endpoint-IP:Port>/ima/v1/service/remove/inactiveClusterMember

Object configuration data

Provide cluster member identification data in the payload of the POST method by using the following schema. Content-type is set to application/json:

    { 
        "ServerName": "string", 
        "ServerUID": "string"
    }

ServerName

Specifies the name of the server

ServerUID

Specifies the UID of the server.

The ServerUID is a unique identifier that is assigned to a server when that server joins a cluster. If a server leaves and then re-joins a cluster, the server is assigned a new ServerUID.

In an HA environment, the ServerUID identifies the current Primary. A Primary and Standby can have different server names, but both servers have the same ServerUID.

Usage Notes®

• Disabling cluster membership results in all messages that are being forwarded to or from this member to be permanently deleted.
• Capitalization and double quotation marks must be used as shown.
• You must specify both the ServerName and the ServerUID.
• You can query cluster members with a status of inactive by using cluster monitoring.

Example

The following example shows a POST method in cURL to remove an inactive remote cluster member:

curl -X POST 
    -H  'Content-Type: application/json'  \
    -d '  { 
            "ServerName":"ServerA",
            "ServerUID":"mxxZxR6t" 
          }
       ' \
http://127.0.0.1:9089/ima/v1/service/remove/inactiveClusterMember

The following example shows an example of response to the POST method:

    {          
        "Version": "v1",  
        "Code": "CWLNA6011",  
        "Message": "The requested configuration change has completed successfully."
    }