About the nodetool utility

Where is the cassandra-env.sh file?

The location of the cassandra-env.sh file depends on the type of installation:

Installation Type Location

Package installations + Installer-Services installations


Tarball installations + Installer-No Services installations


The nodetool utility is a command-line interface for monitoring a cluster and performing routine database operations. It is typically run from an operational node.

The nodetool utility supports the most important JMX metrics and operations, and includes other useful commands for cluster administration, such as the proxyhistogram command.

Command formats

nodetool [options] command [args]

Tarball and Installer No-Services path:


Connection options

Connection options specify how to connect and authenticate for all nodetool commands:

Connection options
Short Long Description



Hostname or IP address.



Port number.



Password file path.








Separates command parameters from a list of options.

  • 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.

  • The repair and rebuild commands can affect multiple nodes in the cluster.

  • Most nodetool commands operate on a single node in the cluster if -h is not used to identify one or more other nodes. 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, for remote invocation, identify the target node, or nodes, using -h.


nodetool -u username -pw password describering demo_keyspace

Using nodetool command help

nodetool help

Provides a listing of nodetool commands.

nodetool help command name

Provides help on a specific command. For example:

nodetool help upgradesstables

For more information, see nodetool help.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com