Remove Docker example from update docs and add section to claim troubleshooting (#10103)
* Remove Docker example and add claiming troubleshooting section * Update troubleshooting recs for claim not found * Update claiming script with full path
Joel Hans committed
Nov 19, 2020 at 09:13 UTC
25f95e33381b7b92fd24980ed3fa8aa138c949ac
2 files changed
+12
-17
claim/README.md
+10
@@ -194,6 +194,16 @@ might be having with the ACLK or claiming process.
194
195
Use these keys and the information below to troubleshoot the ACLK.
196
197
+#### bash: netdata-claim.sh: command not found
198
+
199
+If you run the claiming script and see a `command not found` error, you either installed Netdata in a non-standard
200
+location or are using an unsupported package. If you installed Netdata in a non-standard path using the `--install`
201
+option, you need to update your `$PATH` or run `netdata-claim.sh` using the full path. For example, if you installed
202
+Netdata to `/opt/netdata`, use `/opt/netdata/bin/netdata-claim.sh` to run the claiming script.
203
+
204
+If you are using an unsupported package, such as a third-party `.deb`/`.rpm` package provided by your distribution,
205
+please remove that package and reinstall using our [recommended kickstart script](/docs/get#install-the-netdata-agent).
206
+
207
#### Claiming on older distributions (Ubuntu 14.04, Debian 8, CentOS 6)
208
209
If you're running an older Linux distribution or one that has reached EOL, such as Ubuntu 14.04 LTS, Debian 8, or CentOS
packaging/installer/UPDATE.md
+2
-17
@@ -126,8 +126,7 @@ docker pull netdata/netdata:latest
126
```
127
128
Next, to stop and remove any containers using the `netdata/netdata` image. Replace `netdata` if you changed it from the
129
-default in our [Docker installation
130
-instructions](/packaging/docker/README.md#run-the-agent-with-the-docker-command).
129
+default.
130
131
```bash
132
docker stop netdata
@@ -135,21 +134,7 @@ docker rm netdata
134
```
135
136
You can now re-create your Netdata container using the `docker` command or a `docker-compose.yml` file. See our [Docker
138
-installation instructions](/packaging/docker/README.md#run-the-agent-with-the-docker-command) for details. For
139
-example, using the `docker` command:
140
-
141
-```bash
142
-docker run -d --name=netdata \
143
- -p 19999:19999 \
144
- -v /etc/passwd:/host/etc/passwd:ro \
145
- -v /etc/group:/host/etc/group:ro \
146
- -v /proc:/host/proc:ro \
147
- -v /sys:/host/sys:ro \
148
- -v /etc/os-release:/host/etc/os-release:ro \
149
- --cap-add SYS_PTRACE \
150
- --security-opt apparmor=unconfined \
151
- netdata/netdata
152
-```
137
+installation instructions](/packaging/docker/README.md#create-a-new-netdata-agent-container) for details.
138
139
## macOS
140