diff options
Diffstat (limited to 'packaging')
| -rwxr-xr-x | packaging/bundle-dashboard.sh | 14 | ||||
| -rwxr-xr-x | packaging/bundle-ebpf.sh | 5 | ||||
| -rw-r--r-- | packaging/dashboard.checksums | 1 | ||||
| -rw-r--r-- | packaging/dashboard.version | 1 | ||||
| -rw-r--r-- | packaging/docker/README.md | 7 | ||||
| -rw-r--r-- | packaging/ebpf.checksums | 6 | ||||
| -rw-r--r-- | packaging/ebpf.version | 2 | ||||
| -rw-r--r-- | packaging/go.d.checksums | 32 | ||||
| -rw-r--r-- | packaging/go.d.version | 2 | ||||
| -rw-r--r-- | packaging/installer/README.md | 101 | ||||
| -rwxr-xr-x | packaging/installer/install-required-packages.sh | 2 | ||||
| -rw-r--r-- | packaging/installer/methods/alpine.md | 24 | ||||
| -rw-r--r-- | packaging/installer/methods/cloud-providers.md | 2 | ||||
| -rw-r--r-- | packaging/installer/methods/freebsd.md | 2 | ||||
| -rw-r--r-- | packaging/installer/methods/kickstart-64.md | 20 | ||||
| -rw-r--r-- | packaging/installer/methods/kickstart.md | 20 | ||||
| -rw-r--r-- | packaging/installer/methods/macos.md | 2 | ||||
| -rw-r--r-- | packaging/installer/methods/manual.md | 32 | ||||
| -rw-r--r-- | packaging/makeself/makeself-help-header.txt | 2 | ||||
| -rw-r--r-- | packaging/version | 2 |
20 files changed, 154 insertions, 125 deletions
diff --git a/packaging/bundle-dashboard.sh b/packaging/bundle-dashboard.sh deleted file mode 100755 index 9cab084ed..000000000 --- a/packaging/bundle-dashboard.sh +++ /dev/null @@ -1,14 +0,0 @@ -#!/bin/sh - -SRCDIR="${1}" -WEBDIR="${2}" - -DASHBOARD_TARBALL="dashboard.tar.gz" -DASHBOARD_VERSION="$(cat "${SRCDIR}/packaging/dashboard.version")" - -mkdir -p "${SRCDIR}/tmp/dashboard" -curl -sSL --connect-timeout 10 --retry 3 "https://github.com/netdata/dashboard/releases/download/${DASHBOARD_VERSION}/${DASHBOARD_TARBALL}" > "${DASHBOARD_TARBALL}" || exit 1 -sha256sum -c "${SRCDIR}/packaging/dashboard.checksums" || exit 1 -tar -xzf "${DASHBOARD_TARBALL}" -C "${SRCDIR}/tmp/dashboard" || exit 1 -# shellcheck disable=SC2046 -cp -a $(find "${SRCDIR}/tmp/dashboard/build" -mindepth 1 -maxdepth 1) "${WEBDIR}" diff --git a/packaging/bundle-ebpf.sh b/packaging/bundle-ebpf.sh index ecc365ea4..c51162987 100755 --- a/packaging/bundle-ebpf.sh +++ b/packaging/bundle-ebpf.sh @@ -10,5 +10,8 @@ mkdir -p "${SRCDIR}/tmp/ebpf" curl -sSL --connect-timeout 10 --retry 3 "https://github.com/netdata/kernel-collector/releases/download/${EBPF_VERSION}/${EBPF_TARBALL}" > "${EBPF_TARBALL}" || exit 1 grep "${EBPF_TARBALL}" "${SRCDIR}/packaging/ebpf.checksums" | sha256sum -c - || exit 1 tar -xaf "${EBPF_TARBALL}" -C "${SRCDIR}/tmp/ebpf" || exit 1 +if [ ! -d "${PLUGINDIR}/ebpf.d" ];then + mkdir "${PLUGINDIR}/ebpf.d" +fi # shellcheck disable=SC2046 -cp -a $(find "${SRCDIR}/tmp/ebpf" -mindepth 1 -maxdepth 1) "${PLUGINDIR}" +cp -a $(find "${SRCDIR}/tmp/ebpf" -mindepth 1 -maxdepth 1) "${PLUGINDIR}/ebpf.d" diff --git a/packaging/dashboard.checksums b/packaging/dashboard.checksums deleted file mode 100644 index 26a32da7f..000000000 --- a/packaging/dashboard.checksums +++ /dev/null @@ -1 +0,0 @@ -3edf0957252cbb107d6d16928c3a1167d3b4ae54e45f8bd7972a81f266781f4a dashboard.tar.gz diff --git a/packaging/dashboard.version b/packaging/dashboard.version deleted file mode 100644 index 8e6d5ffc3..000000000 --- a/packaging/dashboard.version +++ /dev/null @@ -1 +0,0 @@ -v2.13.28_ diff --git a/packaging/docker/README.md b/packaging/docker/README.md index a960897d8..ed136cfa9 100644 --- a/packaging/docker/README.md +++ b/packaging/docker/README.md @@ -11,7 +11,7 @@ you get set up quickly, and doesn't install anything permanent on the system, wh See our full list of Docker images at [Docker Hub](https://hub.docker.com/r/netdata/netdata). -Starting with v1.12, Netdata collects anonymous usage information by default and sends it to Google Analytics. Read +Starting with v1.30, Netdata collects anonymous usage information by default and sends it to a self hosted PostHog instance within the Netdata infrastructure. Read about the information collected, and learn how to-opt, on our [anonymous statistics](/docs/anonymous-statistics.md) page. @@ -354,9 +354,8 @@ services: ### Pass command line options to Netdata Since we use an [ENTRYPOINT](https://docs.docker.com/engine/reference/builder/#entrypoint) directive, you can provide -[Netdata daemon command line options](https://learn.netdata.cloud/docs/agent/daemon/#command-line-options) such as the -IP address Netdata will be running on, using the [command -instruction](https://docs.docker.com/engine/reference/builder/#cmd). +[Netdata daemon command line options](/daemon/README.md#command-line-options) such as the IP address Netdata will be +running on, using the [command instruction](https://docs.docker.com/engine/reference/builder/#cmd). ## Install the Agent using Docker Compose with SSL/TLS enabled HTTP Proxy diff --git a/packaging/ebpf.checksums b/packaging/ebpf.checksums index d8fdbb699..7b13f7655 100644 --- a/packaging/ebpf.checksums +++ b/packaging/ebpf.checksums @@ -1,3 +1,3 @@ -380e31fe143e7b53bcebaaf03a04d143ae82e13318b264461ebb5d3ac9026ae5 netdata-kernel-collector-glibc-v0.6.1.tar.xz -5a196ab8a00d307a4f6a5c213178bd62e5720173f433afc6e77dfa911fb6ca56 netdata-kernel-collector-musl-v0.6.1.tar.xz -683e6676c1eee0cd4a7da5be953e94052e780de1ca375146a488d62593220c46 netdata-kernel-collector-static-v0.6.1.tar.xz +1442027d53cf11e1b086ec837659a498a9a2738ef43e44b32a2a0171d057544a netdata-kernel-collector-glibc-v0.6.3.tar.xz +0863b06e78bb3a596cb1f68d13560301f563683cb174fd27b1e34c232e6f3c22 netdata-kernel-collector-musl-v0.6.3.tar.xz +571dddd2b3b06d9f53cc24384ffbd88e2bb662ad953acaef46c76249186fe3b6 netdata-kernel-collector-static-v0.6.3.tar.xz diff --git a/packaging/ebpf.version b/packaging/ebpf.version index 14909610e..e4c57af0b 100644 --- a/packaging/ebpf.version +++ b/packaging/ebpf.version @@ -1 +1 @@ -v0.6.1 +v0.6.3 diff --git a/packaging/go.d.checksums b/packaging/go.d.checksums index 3de8797d6..641563eb2 100644 --- a/packaging/go.d.checksums +++ b/packaging/go.d.checksums @@ -1,16 +1,16 @@ -ebfdec0f2363b395b135a540a7ce2ef72414fa0948a35dae6d50c7a6c8050e75 *config.tar.gz -0f19be07c9359cbde99536e46d7499ea2f50920ee4413ec289797ca6f62232a4 *go.d.plugin-v0.28.1.darwin-amd64.tar.gz -f5154a45038609dac8d3d86eeaadc2a2c61ed564caa01589e401896d9a4b5897 *go.d.plugin-v0.28.1.freebsd-386.tar.gz -3fc5780801b4b08205773c0f0bdf556fdee364c5feb3e060aa710d8a1e491a2b *go.d.plugin-v0.28.1.freebsd-amd64.tar.gz -ae32c3a6434a392215eda9e0564188b645cc35e4a7c5844407da716742d01c5b *go.d.plugin-v0.28.1.freebsd-arm.tar.gz -7e1fa2404195701b8726efafc09fc8df3884a292fca33ac94539f48508de36dc *go.d.plugin-v0.28.1.freebsd-arm64.tar.gz -e24da1e441cb567450ef99397066dbfa73181873920d7b909a4dfe5901c38c64 *go.d.plugin-v0.28.1.linux-386.tar.gz -6735e94e2842182d5a0b8bbb419e222596de451698e8f890384d93e2a1a2d950 *go.d.plugin-v0.28.1.linux-amd64.tar.gz -d4cfe21f1716b531329d57afe39ffc863bba94a884ab988d5f6e1b0cfbf2a1eb *go.d.plugin-v0.28.1.linux-arm.tar.gz -d01386cb7ac1c0046430365383315affcc54ad9e7be73e6e7892214d8e32e030 *go.d.plugin-v0.28.1.linux-arm64.tar.gz -57d1db26c7815f7fec3f6773df0ac704846be03e221882c3eac4fc72ddbf4198 *go.d.plugin-v0.28.1.linux-mips.tar.gz -2dea3359b6613d7a557a1893f2b652796d2862030fd32a90107e59ccc2db398d *go.d.plugin-v0.28.1.linux-mips64.tar.gz -920215d7cf5dd40344d18033c8e3861fe1e381a7897f361a601b16dafd90ab62 *go.d.plugin-v0.28.1.linux-mips64le.tar.gz -bb9b560e497a238e090649f61126cd4b0c7953db4c2f4b4e5400b1f1b4c5f56d *go.d.plugin-v0.28.1.linux-mipsle.tar.gz -523f3197622675cdc3ceb4a54ac01a98c2b89f9e942e31917bc8e6f905e01d66 *go.d.plugin-v0.28.1.linux-ppc64.tar.gz -e72506cb5d0d5f4227eb53bff05fe19ea23fce8025da106284a34b2dc44435d6 *go.d.plugin-v0.28.1.linux-ppc64le.tar.gz +512b371cde4303bce1e0d5721dadd21738b2ef779f3b502b3094eb122dc34a5e *config.tar.gz +222f585c7dc107d3325eba9b59728b2b476c3ef46ccf3e956b113a74b5b7d51c *go.d.plugin-v0.28.2.darwin-amd64.tar.gz +32a293f2363fbd85d07317c809b3ac89df3385b1c0fa63c970c0f9be9f6fe6ba *go.d.plugin-v0.28.2.freebsd-386.tar.gz +e90d4df084395aca47a2927ece350777e7b625db43ebfc2d503aabfd29f2e5dc *go.d.plugin-v0.28.2.freebsd-amd64.tar.gz +274380b5fcef455d144c52b5d73b41d0c406743db36518be3772ace4199c8a28 *go.d.plugin-v0.28.2.freebsd-arm.tar.gz +418a36b506377c19080d76878ce8f7766da00c2b6eec5b4ebe074c7c39a0905d *go.d.plugin-v0.28.2.freebsd-arm64.tar.gz +5d3b317da540ee064a622e3a91162744b883342db4fff97ad401d297d35388f1 *go.d.plugin-v0.28.2.linux-386.tar.gz +3274c55132582df296dbbbd9705f9a7693bf71faee37959da7ed8641d88f16f0 *go.d.plugin-v0.28.2.linux-amd64.tar.gz +3f449ecc91d78616ebb7ca4550c328e810f0b1bb6d92c89dbad01b5da9616b5d *go.d.plugin-v0.28.2.linux-arm.tar.gz +f70ea1bacfb1f61e87c26a4bcb225f49b3507cf033b28dbefd4c7576e1928e22 *go.d.plugin-v0.28.2.linux-arm64.tar.gz +9b92040ac994877c8e16d83df396ca62cc2ac9df6f8ad7ab042e1a0ba59c979c *go.d.plugin-v0.28.2.linux-mips.tar.gz +691c783b2ee6107426ec3151d1218d530d5e28a505afea1ed1fdcbc127cc7c97 *go.d.plugin-v0.28.2.linux-mips64.tar.gz +9de8ab05f9744cb12b3e6cfbca33c98c50bcdda1699fddde096e8407f7354f21 *go.d.plugin-v0.28.2.linux-mips64le.tar.gz +1e20f44642ecb6fbb07d65ecf279af4030e03d40e0900374e7d9b2d8d775da07 *go.d.plugin-v0.28.2.linux-mipsle.tar.gz +6231c577070e8825557b5854748d715ebcd4be4bcfea8dee71ba5887f268f300 *go.d.plugin-v0.28.2.linux-ppc64.tar.gz +106de121c1f73b366bd3ae015db062d6fda1a7ceddb68316dc023ae2081b7d9d *go.d.plugin-v0.28.2.linux-ppc64le.tar.gz diff --git a/packaging/go.d.version b/packaging/go.d.version index 244df55dd..46e8233f9 100644 --- a/packaging/go.d.version +++ b/packaging/go.d.version @@ -1 +1 @@ -v0.28.1 +v0.28.2 diff --git a/packaging/installer/README.md b/packaging/installer/README.md index d5a69aa6a..5b16585fe 100644 --- a/packaging/installer/README.md +++ b/packaging/installer/README.md @@ -3,6 +3,8 @@ title: "Installation guide" custom_edit_url: https://github.com/netdata/netdata/edit/master/packaging/installer/README.md --> +import { Install, InstallBox } from '../../../src/components/Install/' + # Installation guide Netdata is a monitoring agent designed to run on all your systems: physical and virtual servers, containers, even @@ -21,7 +23,7 @@ Some third parties, such as the packaging teams at various Linux distributions, packages. We recommend you install Netdata using one of the methods listed below to guarantee you get the latest checksum-verified packages. -Starting with v1.12, Netdata collects anonymous usage information by default and sends it to Google Analytics. Read +Netdata collects anonymous usage information by default and sends it to our self hosted [PostHog](https://github.com/PostHog/posthog) installation. PostHog is an open source product analytics platform, you can read about the information collected, and learn how to-opt, on our [anonymous statistics](/docs/anonymous-statistics.md) page. @@ -70,65 +72,44 @@ operating systems. ### Alternative methods -<div class="installer-grid" markdown="1"> - -[ Install -with .deb or .rpm packages](/packaging/installer/methods/packages.md) - -[ Install -with a pre-built static binary for 64-bit systems](/packaging/installer/methods/kickstart-64.md) - -[ Install -Netdata on Docker](/packaging/docker/README.md) - -[ Install -Netdata on a Kubernetes cluster](/packaging/installer/methods/kubernetes.md) - -[ -Install Netdata on cloud providers (GCP/AWS/Azure)](/packaging/installer/methods/cloud-providers.md) - -[ Install -Netdata on macOS](/packaging/installer/methods/macos.md) - -[ Install -Netdata on FreeBSD](/packaging/installer/methods/freebsd.md) - -[ Install -from a Git checkout](/packaging/installer/methods/manual.md) - -[ Install on -offline/air-gapped systems](/packaging/installer/methods/offline.md) - -[ -Installation on PFSense](/packaging/installer/methods/pfsense.md) - -[ Install -Netdata on Synology](/packaging/installer/methods/synology.md) - -[ Manual -installation on FreeNAS](/packaging/installer/methods/freenas.md) - -[ Manual -installation on Alpine](/packaging/installer/methods/alpine.md) - -[ -Build manually from source](/packaging/installer/methods/source.md) - -</div> +<Install> + <InstallBox + to="/docs/agent/packaging/installer/methods/kickstart" + os="General Linux with one-line installer (recommended)" + svg="linux" /> + <InstallBox + to="/docs/agent/packaging/docker" + os="Run with Docker" + svg="docker" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/kubernetes" + os="Deploy on Kubernetes" + svg="kubernetes" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/macos" + os="Install on macOS" + svg="macos" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/packages" + os="Linux with .deb/.rpm packages" + svg="linux" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/kickstart-64" + os="Linux with static 64-bit binary" + svg="linux" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/manual" + os="Linux from Git" + svg="linux" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/source" + os="Linux from source" + svg="linux" /> + <InstallBox + to="/docs/agent/packaging/installer/methods/offline" + os="Linux for offline nodes" + svg="linux" /> +</Install> ## Automatic updates diff --git a/packaging/installer/install-required-packages.sh b/packaging/installer/install-required-packages.sh index 203f7c6cb..f65535dd0 100755 --- a/packaging/installer/install-required-packages.sh +++ b/packaging/installer/install-required-packages.sh @@ -1558,7 +1558,7 @@ validate_tree_centos() { echo >&2 " > Checking for Okay ..." if ! rpm -qa | grep okay > /dev/null; then if prompt "okay not found, shall I install it?"; then - run ${sudo} yum ${opts} install http://repo.okay.com.mx/centos/8/x86_64/release/okay-release-1-3.el8.noarch.rpm + run ${sudo} yum ${opts} install http://repo.okay.com.mx/centos/8/x86_64/release/okay-release-1-5.el8.noarch.rpm fi fi diff --git a/packaging/installer/methods/alpine.md b/packaging/installer/methods/alpine.md index fb448959a..51c4b0ccd 100644 --- a/packaging/installer/methods/alpine.md +++ b/packaging/installer/methods/alpine.md @@ -9,28 +9,32 @@ Execute these commands to install Netdata in Alpine Linux 3.x: ```sh # install required packages -apk add alpine-sdk bash curl libuv-dev zlib-dev util-linux-dev libmnl-dev gcc make git autoconf automake pkgconfig python logrotate +apk add alpine-sdk bash curl libuv-dev zlib-dev util-linux-dev libmnl-dev gcc make git autoconf automake pkgconfig python3 logrotate # if you plan to run node.js Netdata plugins apk add nodejs # download Netdata - the directory 'netdata' will be created -git clone https://github.com/netdata/netdata.git --depth=100 +git clone https://github.com/netdata/netdata.git --depth=100 --recursive cd netdata # build it, install it, start it ./netdata-installer.sh -# make Netdata start at boot -echo -e "#!/usr/bin/env bash\n/usr/sbin/netdata" >/etc/local.d/netdata.start -chmod 755 /etc/local.d/netdata.start +# make Netdata start at boot and stop at shutdown +cat > /etc/init.d/netdata << EOF +#!/sbin/openrc-run -# make Netdata stop at shutdown -echo -e "#!/usr/bin/env bash\nkillall netdata" >/etc/local.d/netdata.stop -chmod 755 /etc/local.d/netdata.stop +name="netdata" +command="/usr/sbin/$SVCNAME" -# enable the local service to start automatically -rc-update add local +depend() { + need net localmount + after firewall +} +EOF ``` +If you have installed Netdata in another directory, you have to change the content of the `command` variable in that script. + [](<>) diff --git a/packaging/installer/methods/cloud-providers.md b/packaging/installer/methods/cloud-providers.md index 943a649b6..7b232f322 100644 --- a/packaging/installer/methods/cloud-providers.md +++ b/packaging/installer/methods/cloud-providers.md @@ -118,7 +118,7 @@ Add a new rule with the following options: Source: Any Source port ranges: 19999 Destination: Any -Destination port randes: 19999 +Destination port ranges: 19999 Protocol: TCP Action: Allow Priority: 310 diff --git a/packaging/installer/methods/freebsd.md b/packaging/installer/methods/freebsd.md index e2af41754..9c3db900f 100644 --- a/packaging/installer/methods/freebsd.md +++ b/packaging/installer/methods/freebsd.md @@ -64,7 +64,7 @@ You can now access the Netdata dashboard by navigating to `http://NODE:19999`, r  -From Netdata v1.12 and above, anonymous usage information is collected by default and sent to Google Analytics. To read +Starting with v1.30, Netdata collects anonymous usage information by default and sends it to a self hosted PostHog instance within the Netdata infrastructure. To read more about the information collected and how to opt-out, check the [anonymous statistics page](/docs/anonymous-statistics.md). diff --git a/packaging/installer/methods/kickstart-64.md b/packaging/installer/methods/kickstart-64.md index ea6cf32ea..c390b873a 100644 --- a/packaging/installer/methods/kickstart-64.md +++ b/packaging/installer/methods/kickstart-64.md @@ -71,6 +71,26 @@ your installation. Here are a few important parameters: kickstart run the process using those files. This option conflicts with the `--stable-channel` option. If you set this _and_ `--stable-channel`, Netdata will use the local files. +### Claim node to Netdata Cloud during installation + +The `kickstart.sh` script accepts additional parameters to automatically [claim](/claim/README.md) your node to Netdata +Cloud immediately after installation. Find the `token` and `rooms` strings by [signing in to Netdata +Cloud](https://app.netdata.cloud/sign-in?cloudRoute=/spaces), then clicking on **Claim Nodes** in the [Spaces management +area](https://learn.netdata.cloud/docs/cloud/spaces#manage-spaces). + +- `--claim-token`: The unique token associated with your Space in Netdata Cloud. +- `--claim-rooms`: A comma-separated list of tokens for each War Room this node should appear in. +- `--claim-proxy`: Should take the form of `socks5[h]://[user:pass@]host:ip` for a SOCKS5 proxy, or + `http://[user:pass@]host:ip` for an HTTP(S) proxy.See [claiming through a + proxy](/claim/README.md#claim-through-a-proxy) for details. +- `--claim-url`: Defaults to `https://app.netdata.cloud`. + +For example: + +```bash +bash <(curl -Ss https://my-netdata.io/kickstart-static64.sh) --claim-token=TOKEN --claim-rooms=ROOM1,ROOM2 +``` + ## Verify script integrity To use `md5sum` to verify the integrity of the `kickstart-static64.sh` script you will download using the one-line diff --git a/packaging/installer/methods/kickstart.md b/packaging/installer/methods/kickstart.md index 0fc09ae83..e874d637d 100644 --- a/packaging/installer/methods/kickstart.md +++ b/packaging/installer/methods/kickstart.md @@ -54,6 +54,26 @@ installation. Here are a few important parameters: process using those files. This option conflicts with the `--stable-channel` option. If you set this _and_ `--stable-channel`, Netdata will use the local files. +### Claim node to Netdata Cloud during installation + +The `kickstart.sh` script accepts additional parameters to automatically [claim](/claim/README.md) your node to Netdata +Cloud immediately after installation. Find the `token` and `rooms` strings by [signing in to Netdata +Cloud](https://app.netdata.cloud/sign-in?cloudRoute=/spaces), then clicking on **Claim Nodes** in the [Spaces management +area](https://learn.netdata.cloud/docs/cloud/spaces#manage-spaces). + +- `--claim-token`: The unique token associated with your Space in Netdata Cloud. +- `--claim-rooms`: A comma-separated list of tokens for each War Room this node should appear in. +- `--claim-proxy`: Should take the form of `socks5[h]://[user:pass@]host:ip` for a SOCKS5 proxy, or + `http://[user:pass@]host:ip` for an HTTP(S) proxy.See [claiming through a + proxy](/claim/README.md#claim-through-a-proxy) for details. +- `--claim-url`: Defaults to `https://app.netdata.cloud`. + +For example: + +```bash +bash <(curl -Ss https://my-netdata.io/kickstart.sh) --claim-token=TOKEN --claim-rooms=ROOM1,ROOM2 +``` + ## Verify script integrity To use `md5sum` to verify the integrity of the `kickstart.sh` script you will download using the one-line command above, diff --git a/packaging/installer/methods/macos.md b/packaging/installer/methods/macos.md index 05883a7fe..3fa21d0cd 100644 --- a/packaging/installer/methods/macos.md +++ b/packaging/installer/methods/macos.md @@ -61,7 +61,7 @@ and install the [Judy library](https://sourceforge.net/projects/judy/) before pr Next, download Netdata from our GitHub repository: ```bash -git clone https://github.com/netdata/netdata.git +git clone https://github.com/netdata/netdata.git --recursive ``` Finally, `cd` into the newly-created directory and then start the installer script: diff --git a/packaging/installer/methods/manual.md b/packaging/installer/methods/manual.md index 6ece95240..aa49c81ac 100644 --- a/packaging/installer/methods/manual.md +++ b/packaging/installer/methods/manual.md @@ -178,15 +178,13 @@ yum install autoconf automake curl gcc git cmake libuuid-devel openssl-devel lib yum install -y http://mirror.centos.org/centos/8/PowerTools/x86_64/os/Packages/Judy-devel-1.0.5-18.module_el8.1.0+217+4d875839.x86_64.rpm ``` ---- - -### Install Netdata +## Install Netdata Do this to install and run Netdata: ```sh # download it - the directory 'netdata' will be created -git clone https://github.com/netdata/netdata.git --depth=100 +git clone https://github.com/netdata/netdata.git --depth=100 --recursive cd netdata # run script with root privileges to build, install, start Netdata @@ -201,11 +199,31 @@ cd netdata - If your server does not have access to the internet and you have manually put the installation directory on your server, you will need to pass the option `--disable-go` to the installer. The option will prevent the installer from attempting to download and install `go.d.plugin`. -Once the installer completes, the file `/etc/netdata/netdata.conf` will be created (if you changed the installation directory, the configuration will appear in that directory too). +## Optional parameters to alter your installation + +`netdata-installer.sh` accepts a few parameters to customize your installation: + +- `--dont-wait`: Enable automated installs by not prompting for permission to install any required packages. +- `--dont-start-it`: Prevent the installer from starting Netdata automatically. +- `--stable-channel`: Automatically update only on the release of new major versions. +- `--nightly-channel`: Automatically update on every new nightly build. +- `--disable-telemetry`: Opt-out of [anonymous statistics](/docs/anonymous-statistics.md) we use to make + Netdata better. +- `--no-updates`: Prevent automatic updates of any kind. +- `--reinstall`: If an existing install is detected, reinstall instead of trying to update it. Note that this + cannot be used to change installation types. +- `--local-files`: Used for [offline installations](offline.md). Pass four file paths: the Netdata + tarball, the checksum file, the go.d plugin tarball, and the go.d plugin config tarball, to force kickstart run the + process using those files. This option conflicts with the `--stable-channel` option. If you set this _and_ + `--stable-channel`, Netdata will use the local files. + +### Claim node to Netdata Cloud during installation -You can edit this file to set options. One common option to tweak is `history`, which controls the size of the memory database Netdata will use. By default is `3600` seconds (an hour of data at the charts) which makes Netdata use about 10-15MB of RAM (depending on the number of charts detected on your system). Check **\[[Memory Requirements]]**. +Unlike the [`kickstart.sh`](/packaging/installer/methods/kickstart.md) or +[`kickstart-static64.sh`](/packaging/installer/methods/kickstart-64.md) methods, the `netdata-installer.sh` script does +not allow you to automatically [claim](/claim/README.md) your node to Netdata Cloud immediately after installation. -To apply the changes you made, you have to restart Netdata. +See the [claiming](/claim/README.md) doc for details on claiming a node with a manual installation of Netdata. ### 'nonrepresentable section on output' errors diff --git a/packaging/makeself/makeself-help-header.txt b/packaging/makeself/makeself-help-header.txt index b2b1e4a76..9bcbf4518 100644 --- a/packaging/makeself/makeself-help-header.txt +++ b/packaging/makeself/makeself-help-header.txt @@ -43,7 +43,7 @@ Check its full license at: https://github.com/netdata/netdata/blob/master/LICENSE.md - Anonymous stat collection and reporting to Google Analytics is enabled + Anonymous stat collection and reporting to Netdata is enabled by default. To disable, pass --disable-telemetry option to the installer or export the environment variable DO_NOT_TRACK to a non-zero or non-empty value (e.g export DO_NOT_TRACK=1). diff --git a/packaging/version b/packaging/version index 46aa51be0..d3aa76971 100644 --- a/packaging/version +++ b/packaging/version @@ -1 +1 @@ -v1.30.1 +v1.31.0 |