| --- |
| layout: docpage |
| |
| title: "Documentation" |
| |
| is_homepage: false |
| is_sphinx_doc: true |
| |
| doc-title: "Nodetool" |
| doc-header-links: ' |
| <link rel="top" title="Apache Cassandra Documentation v3.11.11" href="../../index.html"/> |
| ' |
| doc-search-path: "../../search.html" |
| |
| extra-footer: ' |
| <script type="text/javascript"> |
| var DOCUMENTATION_OPTIONS = { |
| URL_ROOT: "", |
| VERSION: "", |
| COLLAPSE_INDEX: false, |
| FILE_SUFFIX: ".html", |
| HAS_SOURCE: false, |
| SOURCELINK_SUFFIX: ".txt" |
| }; |
| </script> |
| ' |
| |
| --- |
| <div class="container-fluid"> |
| <div class="row"> |
| <div class="col-md-3"> |
| <div class="doc-navigation"> |
| <div class="doc-menu" role="navigation"> |
| <div class="navbar-header"> |
| <button type="button" class="pull-left navbar-toggle" data-toggle="collapse" data-target=".sidebar-navbar-collapse"> |
| <span class="sr-only">Toggle navigation</span> |
| <span class="icon-bar"></span> |
| <span class="icon-bar"></span> |
| <span class="icon-bar"></span> |
| </button> |
| </div> |
| <div class="navbar-collapse collapse sidebar-navbar-collapse"> |
| <form id="doc-search-form" class="navbar-form" action="../../search.html" method="get" role="search"> |
| <div class="form-group"> |
| <input type="text" size="30" class="form-control input-sm" name="q" placeholder="Search docs"> |
| <input type="hidden" name="check_keywords" value="yes" /> |
| <input type="hidden" name="area" value="default" /> |
| </div> |
| </form> |
| |
| |
| |
| <ul> |
| <li class="toctree-l1"><a class="reference internal" href="../../getting_started/index.html">Getting Started</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../architecture/index.html">Architecture</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../data_modeling/index.html">Data Modeling</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../cql/index.html">The Cassandra Query Language (CQL)</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../configuration/index.html">Configuring Cassandra</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../operating/index.html">Operating Cassandra</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../index.html">Cassandra Tools</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../troubleshooting/index.html">Troubleshooting</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../development/index.html">Cassandra Development</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../faq/index.html">Frequently Asked Questions</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../bugs.html">Reporting Bugs and Contributing</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="../../contactus.html">Contact us</a></li> |
| </ul> |
| |
| |
| |
| </div><!--/.nav-collapse --> |
| </div> |
| </div> |
| </div> |
| <div class="col-md-8"> |
| <div class="content doc-content"> |
| <div class="content-container"> |
| |
| <div class="section" id="nodetool"> |
| <h1>Nodetool<a class="headerlink" href="#nodetool" title="Permalink to this headline">¶</a></h1> |
| </div> |
| <div class="section" id="usage"> |
| <h1>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h1> |
| <dl class="docutils"> |
| <dt>usage: nodetool [(-u <username> | –username <username>)]</dt> |
| <dd>[(-pw <password> | –password <password>)] |
| [(-pwf <passwordFilePath> | –password-file <passwordFilePath>)] |
| [(-h <host> | –host <host>)] [(-p <port> | –port <port>)] <command> [<args>]</dd> |
| </dl> |
| <p>The most commonly used nodetool commands are:</p> |
| <blockquote> |
| <div><p><a class="reference internal" href="assassinate.html"><span class="doc">assassinate</span></a> - Forcefully remove a dead node without re-replicating any data. Use as a last resort if you cannot removenode</p> |
| <p><a class="reference internal" href="bootstrap.html"><span class="doc">bootstrap</span></a> - Monitor/manage node’s bootstrap process</p> |
| <p><a class="reference internal" href="cleanup.html"><span class="doc">cleanup</span></a> - Triggers the immediate cleanup of keys no longer belonging to a node. By default, clean all keyspaces</p> |
| <p><a class="reference internal" href="clearsnapshot.html"><span class="doc">clearsnapshot</span></a> - Remove the snapshot with the given name from the given keyspaces. If no snapshotName is specified we will remove all snapshots</p> |
| <p><a class="reference internal" href="compact.html"><span class="doc">compact</span></a> - Force a (major) compaction on one or more tables or user-defined compaction on given SSTables</p> |
| <p><a class="reference internal" href="compactionhistory.html"><span class="doc">compactionhistory</span></a> - Print history of compaction</p> |
| <p><a class="reference internal" href="compactionstats.html"><span class="doc">compactionstats</span></a> - Print statistics on compactions</p> |
| <p><a class="reference internal" href="decommission.html"><span class="doc">decommission</span></a> - Decommission the <em>node I am connecting to</em></p> |
| <p><a class="reference internal" href="describecluster.html"><span class="doc">describecluster</span></a> - Print the name, snitch, partitioner and schema version of a cluster</p> |
| <p><a class="reference internal" href="describering.html"><span class="doc">describering</span></a> - Shows the token ranges info of a given keyspace</p> |
| <p><a class="reference internal" href="disableautocompaction.html"><span class="doc">disableautocompaction</span></a> - Disable autocompaction for the given keyspace and table</p> |
| <p><a class="reference internal" href="disablebackup.html"><span class="doc">disablebackup</span></a> - Disable incremental backup</p> |
| <p><a class="reference internal" href="disablebinary.html"><span class="doc">disablebinary</span></a> - Disable native transport (binary protocol)</p> |
| <p><a class="reference internal" href="disablegossip.html"><span class="doc">disablegossip</span></a> - Disable gossip (effectively marking the node down)</p> |
| <p><a class="reference internal" href="disablehandoff.html"><span class="doc">disablehandoff</span></a> - Disable storing hinted handoffs</p> |
| <p><a class="reference internal" href="disablehintsfordc.html"><span class="doc">disablehintsfordc</span></a> - Disable hints for a data center</p> |
| <p><a class="reference internal" href="disablethrift.html"><span class="doc">disablethrift</span></a> - Disable thrift server</p> |
| <p><a class="reference internal" href="drain.html"><span class="doc">drain</span></a> - Drain the node (stop accepting writes and flush all tables)</p> |
| <p><a class="reference internal" href="enableautocompaction.html"><span class="doc">enableautocompaction</span></a> - Enable autocompaction for the given keyspace and table</p> |
| <p><a class="reference internal" href="enablebackup.html"><span class="doc">enablebackup</span></a> - Enable incremental backup</p> |
| <p><a class="reference internal" href="enablebinary.html"><span class="doc">enablebinary</span></a> - Reenable native transport (binary protocol)</p> |
| <p><a class="reference internal" href="enablegossip.html"><span class="doc">enablegossip</span></a> - Reenable gossip</p> |
| <p><a class="reference internal" href="enablehandoff.html"><span class="doc">enablehandoff</span></a> - Reenable future hints storing on the current node</p> |
| <p><a class="reference internal" href="enablehintsfordc.html"><span class="doc">enablehintsfordc</span></a> - Enable hints for a data center that was previsouly disabled</p> |
| <p><a class="reference internal" href="enablethrift.html"><span class="doc">enablethrift</span></a> - Reenable thrift server</p> |
| <p><a class="reference internal" href="failuredetector.html"><span class="doc">failuredetector</span></a> - Shows the failure detector information for the cluster</p> |
| <p><a class="reference internal" href="flush.html"><span class="doc">flush</span></a> - Flush one or more tables</p> |
| <p><a class="reference internal" href="garbagecollect.html"><span class="doc">garbagecollect</span></a> - Remove deleted data from one or more tables</p> |
| <p><a class="reference internal" href="gcstats.html"><span class="doc">gcstats</span></a> - Print GC Statistics</p> |
| <p><a class="reference internal" href="getcompactionthreshold.html"><span class="doc">getcompactionthreshold</span></a> - Print min and max compaction thresholds for a given table</p> |
| <p><a class="reference internal" href="getcompactionthroughput.html"><span class="doc">getcompactionthroughput</span></a> - Print the MB/s throughput cap for compaction in the system</p> |
| <p><a class="reference internal" href="getconcurrentcompactors.html"><span class="doc">getconcurrentcompactors</span></a> - Get the number of concurrent compactors in the system.</p> |
| <p><a class="reference internal" href="getendpoints.html"><span class="doc">getendpoints</span></a> - Print the end points that owns the key</p> |
| <p><a class="reference internal" href="getinterdcstreamthroughput.html"><span class="doc">getinterdcstreamthroughput</span></a> - Print the Mb/s throughput cap for inter-datacenter streaming in the system</p> |
| <p><a class="reference internal" href="getlogginglevels.html"><span class="doc">getlogginglevels</span></a> - Get the runtime logging levels</p> |
| <p><a class="reference internal" href="getsstables.html"><span class="doc">getsstables</span></a> - Print the sstable filenames that own the key</p> |
| <p><a class="reference internal" href="getstreamthroughput.html"><span class="doc">getstreamthroughput</span></a> - Print the Mb/s throughput cap for streaming in the system</p> |
| <p><a class="reference internal" href="gettimeout.html"><span class="doc">gettimeout</span></a> - Print the timeout of the given type in ms</p> |
| <p><a class="reference internal" href="gettraceprobability.html"><span class="doc">gettraceprobability</span></a> - Print the current trace probability value</p> |
| <p><a class="reference internal" href="gossipinfo.html"><span class="doc">gossipinfo</span></a> - Shows the gossip information for the cluster</p> |
| <p><a class="reference internal" href="help.html"><span class="doc">help</span></a> - Display help information</p> |
| <p><a class="reference internal" href="info.html"><span class="doc">info</span></a> - Print node information (uptime, load, …)</p> |
| <p><a class="reference internal" href="invalidatecountercache.html"><span class="doc">invalidatecountercache</span></a> - Invalidate the counter cache</p> |
| <p><a class="reference internal" href="invalidatekeycache.html"><span class="doc">invalidatekeycache</span></a> - Invalidate the key cache</p> |
| <p><a class="reference internal" href="invalidaterowcache.html"><span class="doc">invalidaterowcache</span></a> - Invalidate the row cache</p> |
| <p><a class="reference internal" href="join.html"><span class="doc">join</span></a> - Join the ring</p> |
| <p><a class="reference internal" href="listsnapshots.html"><span class="doc">listsnapshots</span></a> - Lists all the snapshots along with the size on disk and true size.</p> |
| <p><a class="reference internal" href="move.html"><span class="doc">move</span></a> - Move node on the token ring to a new token</p> |
| <p><a class="reference internal" href="netstats.html"><span class="doc">netstats</span></a> - Print network information on provided host (connecting node by default)</p> |
| <p><a class="reference internal" href="pausehandoff.html"><span class="doc">pausehandoff</span></a> - Pause hints delivery process</p> |
| <p><a class="reference internal" href="proxyhistograms.html"><span class="doc">proxyhistograms</span></a> - Print statistic histograms for network operations</p> |
| <p><a class="reference internal" href="rangekeysample.html"><span class="doc">rangekeysample</span></a> - Shows the sampled keys held across all keyspaces</p> |
| <p><a class="reference internal" href="rebuild.html"><span class="doc">rebuild</span></a> - Rebuild data by streaming from other nodes (similarly to bootstrap)</p> |
| <p><a class="reference internal" href="rebuild_index.html"><span class="doc">rebuild_index</span></a> - A full rebuild of native secondary indexes for a given table</p> |
| <p><a class="reference internal" href="refresh.html"><span class="doc">refresh</span></a> - Load newly placed SSTables to the system without restart</p> |
| <p><a class="reference internal" href="refreshsizeestimates.html"><span class="doc">refreshsizeestimates</span></a> - Refresh system.size_estimates</p> |
| <p><a class="reference internal" href="reloadlocalschema.html"><span class="doc">reloadlocalschema</span></a> - Reload local node schema from system tables</p> |
| <p><a class="reference internal" href="reloadtriggers.html"><span class="doc">reloadtriggers</span></a> - Reload trigger classes</p> |
| <p><a class="reference internal" href="relocatesstables.html"><span class="doc">relocatesstables</span></a> - Relocates sstables to the correct disk</p> |
| <p><a class="reference internal" href="removenode.html"><span class="doc">removenode</span></a> - Show status of current node removal, force completion of pending removal or remove provided ID</p> |
| <p><a class="reference internal" href="repair.html"><span class="doc">repair</span></a> - Repair one or more tables</p> |
| <p><a class="reference internal" href="replaybatchlog.html"><span class="doc">replaybatchlog</span></a> - Kick off batchlog replay and wait for finish</p> |
| <p><a class="reference internal" href="resetlocalschema.html"><span class="doc">resetlocalschema</span></a> - Reset node’s local schema and resync</p> |
| <p><a class="reference internal" href="resumehandoff.html"><span class="doc">resumehandoff</span></a> - Resume hints delivery process</p> |
| <p><a class="reference internal" href="ring.html"><span class="doc">ring</span></a> - Print information about the token ring</p> |
| <p><a class="reference internal" href="scrub.html"><span class="doc">scrub</span></a> - Scrub (rebuild sstables for) one or more tables</p> |
| <p><a class="reference internal" href="setcachecapacity.html"><span class="doc">setcachecapacity</span></a> - Set global key, row, and counter cache capacities (in MB units)</p> |
| <p><a class="reference internal" href="setcachekeystosave.html"><span class="doc">setcachekeystosave</span></a> - Set number of keys saved by each cache for faster post-restart warmup. 0 to disable</p> |
| <p><a class="reference internal" href="setcompactionthreshold.html"><span class="doc">setcompactionthreshold</span></a> - Set min and max compaction thresholds for a given table</p> |
| <p><a class="reference internal" href="setcompactionthroughput.html"><span class="doc">setcompactionthroughput</span></a> - Set the MB/s throughput cap for compaction in the system, or 0 to disable throttling</p> |
| <p><a class="reference internal" href="setconcurrentcompactors.html"><span class="doc">setconcurrentcompactors</span></a> - Set number of concurrent compactors in the system.</p> |
| <p><a class="reference internal" href="sethintedhandoffthrottlekb.html"><span class="doc">sethintedhandoffthrottlekb</span></a> - Set hinted handoff throttle in kb per second, per delivery thread.</p> |
| <p><a class="reference internal" href="setinterdcstreamthroughput.html"><span class="doc">setinterdcstreamthroughput</span></a> - Set the Mb/s throughput cap for inter-datacenter streaming in the system, or 0 to disable throttling</p> |
| <p><a class="reference internal" href="setlogginglevel.html"><span class="doc">setlogginglevel</span></a> - Set the log level threshold for a given class. If both class and level are empty/null, it will reset to the initial configuration</p> |
| <p><a class="reference internal" href="setstreamthroughput.html"><span class="doc">setstreamthroughput</span></a> - Set the Mb/s throughput cap for streaming in the system, or 0 to disable throttling</p> |
| <p><a class="reference internal" href="settimeout.html"><span class="doc">settimeout</span></a> - Set the specified timeout in ms, or 0 to disable timeout</p> |
| <p><a class="reference internal" href="settraceprobability.html"><span class="doc">settraceprobability</span></a> - Sets the probability for tracing any given request to value. 0 disables, 1 enables for all requests, 0 is the default</p> |
| <p><a class="reference internal" href="snapshot.html"><span class="doc">snapshot</span></a> - Take a snapshot of specified keyspaces or a snapshot of the specified table</p> |
| <p><a class="reference internal" href="status.html"><span class="doc">status</span></a> - Print cluster information (state, load, IDs, …)</p> |
| <p><a class="reference internal" href="statusbackup.html"><span class="doc">statusbackup</span></a> - Status of incremental backup</p> |
| <p><a class="reference internal" href="statusbinary.html"><span class="doc">statusbinary</span></a> - Status of native transport (binary protocol)</p> |
| <p><a class="reference internal" href="statusgossip.html"><span class="doc">statusgossip</span></a> - Status of gossip</p> |
| <p><a class="reference internal" href="statushandoff.html"><span class="doc">statushandoff</span></a> - Status of storing future hints on the current node</p> |
| <p><a class="reference internal" href="statusthrift.html"><span class="doc">statusthrift</span></a> - Status of thrift server</p> |
| <p><a class="reference internal" href="stop.html"><span class="doc">stop</span></a> - Stop compaction</p> |
| <p><a class="reference internal" href="stopdaemon.html"><span class="doc">stopdaemon</span></a> - Stop cassandra daemon</p> |
| <p><a class="reference internal" href="tablehistograms.html"><span class="doc">tablehistograms</span></a> - Print statistic histograms for a given table</p> |
| <p><a class="reference internal" href="tablestats.html"><span class="doc">tablestats</span></a> - Print statistics on tables</p> |
| <p><a class="reference internal" href="toppartitions.html"><span class="doc">toppartitions</span></a> - Sample and print the most active partitions for a given column family</p> |
| <p><a class="reference internal" href="tpstats.html"><span class="doc">tpstats</span></a> - Print usage statistics of thread pools</p> |
| <p><a class="reference internal" href="truncatehints.html"><span class="doc">truncatehints</span></a> - Truncate all hints on the local node, or truncate hints for the endpoint(s) specified.</p> |
| <p><a class="reference internal" href="upgradesstables.html"><span class="doc">upgradesstables</span></a> - Rewrite sstables (for the requested tables) that are not on the current version (thus upgrading them to said current version)</p> |
| <p><a class="reference internal" href="verify.html"><span class="doc">verify</span></a> - Verify (check data checksum for) one or more tables</p> |
| <p><a class="reference internal" href="version.html"><span class="doc">version</span></a> - Print cassandra version</p> |
| <p><a class="reference internal" href="viewbuildstatus.html"><span class="doc">viewbuildstatus</span></a> - Show progress of a materialized view build</p> |
| </div></blockquote> |
| <p>See ‘nodetool help <command>’ for more information on a specific command.</p> |
| </div> |
| |
| |
| |
| |
| </div> |
| </div> |
| </div> |
| </div> |
| </div> |