netdata update instructions after recent changes (#5277)
* netdata update instructions after recent changes * Update UPDATE.md
Chris Akritidis committed
Jan 28, 2019 at 12:26 UTC
afe8af3372eaa6862207ad3b769b5f5c7355e21c
1 file changed
+15
-33
packaging/installer/UPDATE.md
+15
-33
@@ -9,53 +9,41 @@ The update procedure depends on how you installed it:
9
10
## You downloaded it from github using git
11
12
-### Manual update
12
+### Manual update to get the latest git commit
13
14
-The installer `netdata-installer.sh` generates a `netdata-updater.sh` script in the directory you downloaded netdata.
15
-You can use this script to update your netdata installation with the same options you used to install it in the first place.
16
-Just run it and it will download and install the latest version of netdata. The same script can be put in a cronjob to update your netdata at regular intervals.
14
+netdata versions older than `v1.12.0-rc2-52` had a `netdata-updater.sh` script in the root directory of the source code, which has now been deprecated. The manual process that works for all versions to get the latest commit in git is to use the `netdata-installer.sh`. The installer preserves your configuration. You just need to be mindful of any installer options you may have used to customize your original installation.
15
16
```sh
17
# go to the git downloaded directory
18
cd /path/to/git/downloaded/netdata
19
22
-# run the updater
23
-./netdata-updater.sh
24
-```
25
-
26
-_Netdata will be restarted with the new version._
27
-
28
-If you don't have this script (e.g. you deleted the directory where you downloaded netdata), just follow the **[[Installation]]** instructions again. The installer preserves your configuration. You can also update netdata to the latest version by hand, using this:
29
-
30
-```sh
31
-# go to the git downloaded directory
32
-cd /path/to/git/downloaded/netdata
33
-
34
-# download the latest version
20
+# update your local copy
21
git pull
22
37
-# rebuild it, install it, run it
38
-./netdata-installer.sh
23
+# run the netdata installer
24
+sudo ./netdata-installer.sh
25
```
26
27
_Netdata will be restarted with the new version._
28
29
Keep in mind, netdata may now have new features, or certain old features may now behave differently. So pay some attention to it after updating.
30
31
+### Manual update to get the latest nightly build
32
+
33
+The `kickstart.sh` one-liner will do a one-time update to the latest nightly build, if executed as follows:
34
+```
35
+bash <(curl -Ss https://my-netdata.io/kickstart.sh --no-updates)
36
+```
37
+
38
### Auto-update
39
40
_Please, consider the risks of running an auto-update. Something can always go wrong. Keep an eye on your installation, and run a manual update if something ever fails._
41
49
-You can call `netdata-updater.sh` from a cron-job. A successful update will not trigger an email from cron.
42
+Calling the `netdata-installer.sh` with the `--auto-update` or `-u` option will create an `auto-updater` script under
43
+either `/etc/cron.daily/`, or `/etc/periodic/daily/`. Whenever the `auto-updater` is executed, it checks if a newer nightly build is available and then handles the download, installation and netdata restart.
44
51
-```sh
52
-# Edit your cron-jobs
53
-crontab -e
45
+Note that after Jan 2019, the `kickstart.sh` one-liner `bash <(curl -Ss https://my-netdata.io/kickstart.sh)` calls the `netdata-installer.sh` with the auto-update option. So if you just run the one-liner without options once, your netdata will be kept auto-updated.
46
55
-# add a cron-job at the bottom. This one will update netdata every day at 6:00AM:
56
-# update netdata
57
-0 6 * * * /path/to/git/downloaded/netdata/netdata-updater.sh
58
-```
47
48
## You downloaded a binary package
49
@@ -64,10 +52,4 @@ If you installed it from a binary package, the best way is to **obtain a newer c
52
If a newer version of netdata is not available from the source you got it, we suggest to uninstall the version you have and follow the **[[Installation]]** instructions for installing a fresh version of netdata.
53
54
67
-
68
-
69
-
70
-
71
-
72
-
55
[]()