nodetool setmaxhintwindow
Sets the maximum hint window in milliseconds.
Synopsis
Section titled “Synopsis”nodetool [connection_options] setmaxhintwindow <hint_window_in_ms>See connection options for connection options.
Description
Section titled “Description”nodetool setmaxhintwindow configures the maximum duration for which hints will be stored for an unavailable node. Hints for nodes down longer than this window are not stored.
Arguments
Section titled “Arguments”| Argument | Description |
|---|---|
hint_window_in_ms | Maximum hint window in milliseconds |
Examples
Section titled “Examples”Set to 6 Hours
Section titled “Set to 6 Hours”nodetool setmaxhintwindow 21600000Set to 1 Hour
Section titled “Set to 1 Hour”nodetool setmaxhintwindow 3600000Verify Change
Section titled “Verify Change”nodetool setmaxhintwindow 21600000nodetool getmaxhintwindowCommon Values
Section titled “Common Values”| Duration | Milliseconds |
|---|---|
| 1 hour | 3600000 |
| 3 hours (default) | 10800000 |
| 6 hours | 21600000 |
| 12 hours | 43200000 |
| 24 hours | 86400000 |
When to Use
Section titled “When to Use”Longer Expected Outages
Section titled “Longer Expected Outages”# Increase for maintenance windowsnodetool setmaxhintwindow 43200000 # 12 hoursReduce Disk Usage
Section titled “Reduce Disk Usage”# Shorter window = less hint storagenodetool setmaxhintwindow 3600000 # 1 hourBest Practices
Section titled “Best Practices”Hint Window Guidelines
- Balance - Longer window = more disk, better coverage
- Consider SLAs - Set based on recovery expectations
- Cluster-wide - Apply same setting on all nodes
- Persist in config - Update cassandra.yaml for permanence
Related Commands
Section titled “Related Commands”| Command | Relationship |
|---|---|
| getmaxhintwindow | View current setting |
| listpendinghints | View pending hints |