Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-7530

Add terseClusterInfo to the REST API docs

    XMLWordPrintable

Details

    • Improvement
    • Resolution: Unresolved
    • Critical
    • 6.6.1, Cheshire-Cat
    • 6.6.0
    • rest
    • None
    • DOC-2020-S20-Oct18, DOC-2020-S22-Nov15, DOC-2020-S21-Nov01, DOC-2020-S23-Nov29, DOC-2020-S24-Dec13
    • 1

    Description

      We are documenting the following REST API that users can use to identify which node is the orchestrator. pools/default/terseClusterInfo.

      This REST API returns the following information:

      $ curl -sX GET -u Administrator:password 'http://hostname:8091/pools/default/terseClusterInfo' | jq .
      {
        "clusterUUID":"929bd61a4b16ae5555940c6720e8f312",
        "orchestrator":"n_1@127.0.0.1",
        "isBalanced":true,
        "clusterCompatVersion":"7.0"
      }
      

      Cluster UUID is self explanatory.

      "orchestrator" refers to the node which is currently believed to be the orchestrator by the node against which the REST API is invoked. There are a number of caveats that users of this REST API need to bear in mind:

      1. the value will be "undefined" if the node is unaware of the existence of an orchestrator for whatever reason (this is the initial value for instance)
      2. other nodes may believe there to be a different orchestrator and in fact if a network is partitioned this will happen
      3. the orchestrator may change at any time. In fact by the time you have received the value it may have already changed.

      "isBalanced" is true if this nodes understanding of the cluster is that a rebalance is not required. (I.e. data is distributed evenly and the topology aware services are in balance.)

      Cluster compat version is this nodes understanding of the compat version a cluster is running at. Cluster compat version are the minimum compat version of all nodes in the cluster. E.g. if a cluster has 9 7.0 nodes and 1 6.5 node, the compat version is 6.5.

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

              tony.hillman Tony Hillman (Inactive)
              dfinlay Dave Finlay
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

                Created:
                Updated:

                Gerrit Reviews

                  There are no open Gerrit changes

                  PagerDuty