User Community Service Desk Downloads

HA REST API

When run in the High Availability mode, each MDM node exposes a REST API, which can be used to check cluster and node status, connect and disconnect nodes, and perform other administrative and monitoring functions.

The API root endpoint is /ha/rest/.

Method Endpoint Description

GET

/clusterStatus

Returns an array of all MDM nodes connected to the cluster and their modes.

GET

/nodeInfo?nodeName=<nodeName>

Returns information about the MDM node specified in the nodeName parameter.

GET

/myInfo

Returns information about this MDM node.

POST

/setActiveNode?nodeName=<nodeName>

Manually set a new Active (RW) node.

POST

/connect

Connect this MDM node to the cluster.

POST

/disconnect

Disconnect this MDM node from the cluster.

Sample /clusterStatus Response
[
  {
    "hostname": "10.0.66.7",
    "name": "Mdc7",
    "ports": {
      "ha_nme_rest": 19090,
      "ha_default": 18101
    },
    "revokeLeadershipOnDisconnectTimeout": 75000,
    "maxActiveToPassiveSwitchingTime": 5000,
    "loggerDataSourceUrl": "jdbc:oracle:thin:@dbase.ataccama.com:1521/ora12c",
    "loggerTableName": "ha_log",
    "mode": "PASSIVE"
  },
  {
    "hostname": "10.0.66.6",
    "name": "mdc6",
    "ports": {
      "ha_nme_rest": 19090,
      "ha_default": 18101
    },
    "revokeLeadershipOnDisconnectTimeout": 75000,
    "maxActiveToPassiveSwitchingTime": 5000,
    "mode": "ACTIVE"
  }
]

Connection states (part of node info) that are provided by the Curator:

  • CONNECTED - MDM is connected to the cluster.

  • SUSPENDED - The quorum is lost; the node is trying to restore the connection.

  • RECONNECTED - Connection was successfully restored (from the SUSPENDED state).

  • LOST - Connection is not available; that is, the connection was not successfully restored (from the SUSPENDED state).

Was this page useful?