summaryrefslogtreecommitdiffstats
path: root/claim
diff options
context:
space:
mode:
authorJoel Hans <joel@netdata.cloud>2020-05-14 05:29:23 -0700
committerGitHub <noreply@github.com>2020-05-14 05:29:23 -0700
commit0ed5a8c76f37d57e11e412137cc61db1fab2f0a3 (patch)
treec9dfba9d74ba12d73c223be865791f5625b6417b /claim
parent6393b2f535c993de9f341d2245ad8ba327694281 (diff)
Add text to claiming doc about reclaiming with id= (#9027)
* Add text about reclaiming * Changed some wording * Address Andrew's comments
Diffstat (limited to 'claim')
-rw-r--r--claim/README.md16
1 files changed, 11 insertions, 5 deletions
diff --git a/claim/README.md b/claim/README.md
index 6dda79f1f5..168c6915d6 100644
--- a/claim/README.md
+++ b/claim/README.md
@@ -261,18 +261,24 @@ If you are certain firewall and proxy settings are not the issue, you should con
GitHub](https://github.com/netdata/netdata/issues/new?labels=bug%2C+needs+triage%2C+ACLK&template=bug_report.md&title=ACLK-available-is-false)
with details about your system and relevant output from `error.log`.
-### Unclaim (remove) an Agent from Netdata Cloud
+### Remove and reclaim a node
-The best method to remove an Agent from Netdata Cloud is to unclaim it by deleting the `cloud.d/` directory in your
-Netdata library directory.
+To remove a node from your Space in Netdata Cloud, delete the `cloud.d/` directory in your Netdata library directory.
```bash
cd /var/lib/netdata # Replace with your Netdata library directory, if not /var/lib/netdata/
sudo rm -rf cloud.d/
```
-Once you delete the `cloud.d/` directory, the ACLK will not connect to Cloud the next time the Agent starts, and Cloud
-will show it as **unreachable**. You can then remove it from your War Rooms.
+This node no longer has access to the credentials it was claimed with and cannot connect to Netdata Cloud via the ACLK.
+You will still be able to see this node in your War Rooms in an **unreachable** state.
+
+If you want to reclaim this node into a different Space, you need to create a new identity by adding `-id=$(uuidgen)` to
+the claiming script parameters. For example, using the default claiming script:
+
+```bash
+sudo netdata-claim.sh -token=TOKEN -rooms=ROOM1,ROOM2 -url=https://app.netdata.cloud -id=$(uuidgen)
+```
## Claiming reference