nodetool getmaxhintwindow
Displays the maximum hint window in milliseconds.
Synopsis
Section titled “Synopsis”nodetool [connection_options] getmaxhintwindowSee connection options for connection options.
Description
Section titled “Description”nodetool getmaxhintwindow displays the current maximum hint window configuration. The hint window defines how long Cassandra will store hints for an unavailable node. If a node is down longer than this window, hints are not stored and repair is needed to restore consistency.
Examples
Section titled “Examples”Basic Usage
Section titled “Basic Usage”nodetool getmaxhintwindowSample Output
Section titled “Sample Output”Current max hint window: 10800000 msUnderstanding the Hint Window
Section titled “Understanding the Hint Window”Default Value
Section titled “Default Value”The default is 3 hours.
Configuration
Section titled “Configuration”The cassandra.yaml parameter name varies by version:
| Cassandra Version | Parameter Name | Example |
|---|---|---|
| Pre-4.1 | max_hint_window_in_ms | 10800000 (3 hours) |
| 4.1+ | max_hint_window | 3h |
# cassandra.yaml (4.1+)max_hint_window: 3h
# cassandra.yaml (Pre-4.1)# max_hint_window_in_ms: 10800000How It Works
Section titled “How It Works”| Node Down Duration | Hint Behavior |
|---|---|
| < hint window | Hints stored and delivered |
| > hint window | No hints stored, needs repair |
Use Cases
Section titled “Use Cases”Verify Configuration
Section titled “Verify Configuration”# Check current hint windownodetool getmaxhintwindow
# Convert to hours: 10800000ms = 3 hoursCapacity Planning
Section titled “Capacity Planning”Understanding hint window helps plan for:
- Maximum outage duration covered by hints
- When repair becomes necessary
- Hint storage disk requirements
Related Commands
Section titled “Related Commands”| Command | Relationship |
|---|---|
| setmaxhintwindow | Set hint window |
| listpendinghints | View pending hints |
| statushandoff | Check handoff status |