nodetool settimeout

Temporarily overrides a specified request timeout limit. To persist the change, you must edit the corresponding request timeout setting in cassandra.yaml.

To get the current timeout values, use nodetool gettimeout.

Synopsis

nodetool [<connection_options>] settimeout
[--] <timeout_type> <timeout>

Definition

The short- and long-form options are comma-separated.

Connection options

-h, --host hostname

The hostname or IP address of a remote node or nodes. When omitted, the default is the local machine.

-p, --port jmx_port

The JMX port number.

-pw, --password jmxpassword

The JMX password for authenticating with secure JMX. If a password is not provided, you are prompted to enter one.

-pwf, --password-file jmx_password_filepath

The filepath to the file that stores JMX authentication credentials.

-u, --username jmx_username

The username for authenticating with secure JMX.

Command arguments

--

Separates an option from an argument that could be mistaken for an option.

timeout

Time to wait in milliseconds. Set to 0 to disable the specified timeout.

timeout_type

The request timeout type. Each type corresponds with a timeout limit setting in cassandra.yaml.

Request timeout settings

settimeout argument

cassandra.yaml setting 65 PR-465

read

read_request_timeout_in_ms

range

range_request_timeout_in_ms

write

write_request_timeout_in_ms

counterwrite

counter_write_request_timeout_in_ms

cascontention

cas_contention_timeout_in_ms

truncate

truncate_request_timeout_in_ms

streamingsocket

Streaming socket timeout in milliseconds.

misc

Miscellaneous request timeout

Examples

  • Set the timeout limit for write requests to 15 ms:

    nodetool settimeout write 15
  • Disable the timeout limit for truncate requests:

    nodetool settimeout truncate 0

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | Privacy policy | Terms of use Manage Privacy Choices

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: Contact IBM