liveBook · Manning

Nodetool status

As explained in ScyllaDB in Action

nodetool status is a nodetool command that reports the membership, health, data ownership, and location of nodes in a ScyllaDB cluster.

nodetool status gives a quick operational view of a ScyllaDB cluster: which nodes are present, whether they are healthy, what state they occupy, how much data they own, and where they are placed. section 2.1.2

Check a Docker cluster

Open a shell in the ScyllaDB container, then run nodetool status. Add --resolve-ip to display friendlier DNS names instead of node IP addresses. section 2.1.2

(scylla-1) $ nodetool status --resolve-ip

Run nodetool status --resolve-ip inside the container to inspect node placement and health. section 2.1.2

Read the two-letter node code from the status output:

  • U means Up: the node is healthy and taking traffic; D means Down: the node is unhealthy and not taking traffic. section 2.1.2
  • N means Normal: the node has previously joined successfully; J means Joining, L means Leaving, and M means Moving. section 2.1.2
  • A newly joining node appears as UJ and transitions to UN after reaching the normal state. section 2.5

The output also identifies the datacenter and rack. These groupings can be logical or physical and support redundancy, migrations, and multiregional arrangements. section 2.1.2

How ScyllaDB in Action covers it

How deep it goes
Explains output fields and status transitions, but stops short of detailed ownership or token calculations.
Examples
Demonstrates Docker shell access, resolved node names, and a single-node status listing.
What it assumes
Assumes a running ScyllaDB node and basic Docker shell access while explaining status codes from zero.
What you can do after
Operate/configure a ScyllaDB deployment by checking node health, lifecycle state, and placement.
How it connects
Connects node status with clusters, datacenters, racks, replication, and data ownership.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of ScyllaDB in Action. The section links point to the parts of the book it draws on.