influxdata / influxdata/docs-v2

Replacing data nodes instructions are dangerous

Open Beginner friendly
#3,457 1 comment 0 reactions 0 assignees View on GitHub
Enterprise 1.x product:v1-enterprise
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.