influxdata / influxdata/docs-v2
Replacing data nodes instructions are dangerous
- Dominant language
- JavaScript
- Stars
- 82
- Forks
- 326
- Avg merge
- 1d 1h
- Merged PRs (30d)
- 82
Description
When replacing data nodes, it says to just run `update-data` to let a new node take its place. This is problematic:
1. If there is any data with RF<2, it gets lost if you do this. I think this needs a big warning.
2. AE is off by default but these instructions assume it is on
3. If the data node is currently working (not a failed/lost disk), users could also just copy data over and use the instructions from https://docs.influxdata.com/enterprise_influxdb/v1.9/administration/manage/renaming/#rename-data-nodes , which seems better than waiting for AE to fix things.
##### Relevant URLs
(https://docs.influxdata.com/enterprise_influxdb/v1.9/administration/manage/clusters/replacing-nodes/#replace-data-nodes-in-an-influxdb-enterprise-cluster)
@timhallinflux FYI
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with the replacing-data-nodes section at the relevant URL, then compare the linked rename-data-nodes instructions. Update the guidance to warn about RF<2 data loss, state that AE is off by default, and distinguish working nodes from failed or lost disks. Verify the revised links and rendered documentation.
Written by the indexing model from the issue text.
Assessment
- Domain
- databases, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100