Apache Cassandra™ 2.0

The nodetool utility

A command line interface for Cassandra for managing a cluster.

Command format

  • Packaged installs: nodetool -h HOSTNAME [-p JMX_PORT ] COMMAND
  • Tarball installs: install_location/bin/nodetool -h HOSTNAME [-p JMX_PORT ] COMMAND
  • Remote Method Invocation: nodetool -h HOSTNAME [-p JMX_PORT -u JMX_USERNAME -pw JMX_PASSWORD ] COMMAND

    If a username and password for RMI authentication are set explicitly in the cassandra-env.sh file for the host, then you must specify credentials.

Most nodetool commands operate on a single node in the cluster if -h is not used to identify one or more other nodes. These commands operate cluster-wide:

If the node from which you issue the command is the intended target, you do not need the -h option to identify the target; otherwise, identify the target node, or nodes, using the -h option.

Show/hide