summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Emm. Katsoulakis <34388743+paulkatsoulakis@users.noreply.github.com>2019-07-10 22:57:01 +0200
committerGitHub <noreply@github.com>2019-07-10 22:57:01 +0200
commit92057dee692fc82ee7e8ab2525bc9af620707f0b (patch)
tree7f396208c9058d896456614fe68bd16e54895f11
parentfbc419dd456e53423f2d66023530fb8c59acc3dd (diff)
Netdata/packaging: Add documentation for binary packages, plus draft table for distributions support (#6422)
* netdata/packaging: Python default for all * netdata/packaging: Binary Packages documentation - intro * netdata/packaging: Bring on board the distributions table and refer this to our readme * netdata/packaging: [ci skip] Add more details * netdata/packaging: move up, totally the wrong place to put it * netdata/packaging: reduce marketing * netdata/packaging: attend feedback * netdata/packaging: Documentation - add architecture * netdata/packaging: Update buildyaml.sh for the links to work * netdata/packaging: further documentation clean ups
-rwxr-xr-xdocs/generator/buildyaml.sh1
-rw-r--r--packaging/DISTRIBUTIONS.md37
-rw-r--r--packaging/installer/README.md26
3 files changed, 60 insertions, 4 deletions
diff --git a/docs/generator/buildyaml.sh b/docs/generator/buildyaml.sh
index e4a5466a4c..1880a6ec97 100755
--- a/docs/generator/buildyaml.sh
+++ b/docs/generator/buildyaml.sh
@@ -138,6 +138,7 @@ echo -ne " - 'docs/Demo-Sites.md'
- 'packaging/installer/README.md'
- 'packaging/docker/README.md'
- 'packaging/installer/UPDATE.md'
+ - 'packaging/DISTRIBUTIONS.md'
- 'packaging/installer/UNINSTALL.md'
- 'docs/GettingStarted.md'
- Running Netdata:
diff --git a/packaging/DISTRIBUTIONS.md b/packaging/DISTRIBUTIONS.md
new file mode 100644
index 0000000000..d180f25f63
--- /dev/null
+++ b/packaging/DISTRIBUTIONS.md
@@ -0,0 +1,37 @@
+# Netdata distribution support matrix
+![](https://raw.githubusercontent.com/netdata/netdata/master/web/gui/images/packaging-beta-tag.svg?sanitize=true)
+
+In the following table we've listed Netdata's official supported operating systems. We detail the distributions, flavors, and the level of support Netdata is currently capable to provide.
+
+The following table is a work in progress. We have concluded on the list of distributions
+that we currently supporting and we are working on documenting our current state so that our users
+have complete visibility over the range of support.
+
+Distribution | Family | Architecture | Code health | Installer support | Kickstart support | Binary packaging support | Integrity testing (CI) | Functionality testing (CI) | Community support
+:------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | :--------------------
+14.04.6 LTS (Trusty Tahr) | Ubuntu | | | | | | | |
+16.04.6 LTS (Xenial Xerus) | Ubuntu | | | | | | | |
+18.04.2 LTS (Bionic Beaver) | Ubuntu | | | | | | | |
+19.04 (Disco Dingo) Latest | Ubuntu | | | | | | | |
+Debian 7 (Wheezy) | Debian | | | | | | | |
+Debian 8 (Jessie) | Debian | | | | | | | |
+Debian 9 (Stretch) | Debian | | | | | | | |
+Debian 10 (Buster) | Debian | | | | | | | |
+Versions 6.* | RHEL | | | | | | | |
+Versions 7.* | RHEL | | | | | | | |
+Versions 8.* | RHEL | | | | | | | |
+Fedora 28 | Fedora | | | | | | | |
+Fedora 29 | Fedora | | | | | | | |
+Fedora 30 | Fedora | | | | | | | |
+Fedora 31 | Fedora | | | | | | | |
+CentOS 6.* | Cent OS | | | | | | | | |
+CentOS 7.* | Cent OS | | | | | | | | |
+CentOS 8.* | Cent OS | | | | | | | | |
+Open SuSE Leap 15.0 | Open SuSE | | | | | | | |
+Open SuSE Leap 15.1 | Open SuSE | | | | | | | |
+Open SuSE Tumbleweed (latest) | Open SuSE | | | | | | | |
+SuSE Enterprise Linux Server 11 | SLES | | | | | | | |
+SuSE Enterprise Linux Server 12 | SLES | | | | | | | |
+SuSE Enterprise Linux Server 15 | SLES | | | | | | | |
+Arch Linux (latest) | Arch | | | | | | | |
+All other linux | Other | | | | | | | |
diff --git a/packaging/installer/README.md b/packaging/installer/README.md
index c03d7b4f37..00aa9f7a1c 100644
--- a/packaging/installer/README.md
+++ b/packaging/installer/README.md
@@ -6,7 +6,6 @@ The best way to install Netdata is directly from source. Our **automatic install
!!! warning
You can find Netdata packages distributed by third parties. In many cases, these packages are either too old or broken. So, the suggested ways to install Netdata are the ones in this page.
- **We are currently working to provide our binary packages for all Linux distros.** Stay tuned...
1. [Automatic one line installation](#one-line-installation), easy installation from source, **this is the default**
2. [Install pre-built static binary on any 64bit Linux](#linux-64bit-pre-built-static-binary)
@@ -17,6 +16,7 @@ The best way to install Netdata is directly from source. Our **automatic install
7. [Enable on FreeNAS Corral](#freenas)
8. [Install on macOS (OS X)](#macos)
9. [Install on a Kubernetes cluster](https://github.com/netdata/helmchart#netdata-helm-chart-for-kubernetes-deployments)
+10. [Install using binary packages](#binary-packages)
See also the list of Netdata [package maintainers](../maintainers) for ASUSTOR NAS, OpenWRT, ReadyNAS, etc.
@@ -205,16 +205,16 @@ This is how to do it by hand:
```sh
# Debian / Ubuntu
-apt-get install zlib1g-dev uuid-dev libuv1-dev liblz4-dev libjudy-dev libssl-dev libmnl-dev gcc make git autoconf autoconf-archive autogen automake pkg-config curl
+apt-get install zlib1g-dev uuid-dev libuv1-dev liblz4-dev libjudy-dev libssl-dev libmnl-dev gcc make git autoconf autoconf-archive autogen automake pkg-config curl python
# Fedora
-dnf install zlib-devel libuuid-devel libuv-devel lz4-devel Judy-devel openssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils
+dnf install zlib-devel libuuid-devel libuv-devel lz4-devel Judy-devel openssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils python
# CentOS / Red Hat Enterprise Linux
yum install autoconf automake curl gcc git libmnl-devel libuuid-devel openssl-devel libuv-devel lz4-devel Judy-devel make nc pkgconfig python zlib-devel
# openSUSE
-zypper install zlib-devel libuuid-devel libuv-devel liblz4-devel judy-devel libopenssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils
+zypper install zlib-devel libuuid-devel libuv-devel liblz4-devel judy-devel libopenssl-devel libmnl-devel gcc make git autoconf autoconf-archive autogen automake pkgconfig curl findutils python
```
@@ -293,6 +293,24 @@ To apply the changes you made, you have to restart Netdata.
---
+### Binary Packages
+![](https://raw.githubusercontent.com/netdata/netdata/master/web/gui/images/packaging-beta-tag.svg?sanitize=true)
+
+We provide our own flavour of binary packages for the most common operating systems that comply with .RPM and .DEB packaging formats.
+
+We have currently released .RPM versions with version [1.16.0](https://github.com/netdata/netdata/releases/tag/v1.16.0). We are planning to release packages following the .DEB format on one of the following releases. Our current packaging infrastructure provider is [Package Cloud](https://packagecloud.io).
+
+Netdata is committed to support installation of our solution to all operating systems. This is a constant battle for Netdata, as we strive to automate and make things easier for our users. For the operating system support matrix, please visit our [distributions](../DISTRIBUTIONS.md) support page.
+
+We provide two separate repositories, one for our stable releases and one for our nightly releases.
+
+1. Stable releases: Our stable production releases are hosted in [netdata/netdata](https://packagecloud.io/netdata/netdata) repository of package cloud
+2. Nightly releases: Our latest releases are hosted in [netdata/netdata-edge](https://packagecloud.io/netdata/netdata-edge) repository of package cloud
+
+Visit the repository pages and follow the quick set-up instructions to get started.
+
+---
+
## Other Systems