summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2021-02-09 12:52:55 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2021-02-09 12:52:55 +0000
commite1513d7038abbcd2140d2ebfe31eec4c06498f6f (patch)
tree9f68464c37d2efe32f7c84e5ce03ef608d4d8d02
parentMoving myself to maintainer, thanks Lennart. (diff)
downloadnetdata-e1513d7038abbcd2140d2ebfe31eec4c06498f6f.tar.xz
netdata-e1513d7038abbcd2140d2ebfe31eec4c06498f6f.zip
Adding README.Debian for netdata, explaining mysql/mariadb tplugin things (Closes: #921047).
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
l---------debian/netdata-core-no-sse.README.Debian1
-rw-r--r--debian/netdata-core.README.Debian43
2 files changed, 44 insertions, 0 deletions
diff --git a/debian/netdata-core-no-sse.README.Debian b/debian/netdata-core-no-sse.README.Debian
new file mode 120000
index 000000000..bbb6e37e3
--- /dev/null
+++ b/debian/netdata-core-no-sse.README.Debian
@@ -0,0 +1 @@
+netdata-core.README.Debian \ No newline at end of file
diff --git a/debian/netdata-core.README.Debian b/debian/netdata-core.README.Debian
new file mode 100644
index 000000000..8f1ab853f
--- /dev/null
+++ b/debian/netdata-core.README.Debian
@@ -0,0 +1,43 @@
+netdata for Debian
+==================
+
+1. Web UI
+---------
+
+If you install netdata-web, the web UI will be available by default on
+http://localhost:19999
+
+
+2. Plugins
+----------
+
+netdata has a lot of plugins. Some of them need extra configuration on the
+host system to work. Here are some notes for that...
+
+2.1 mysql/mariadb
+-----------------
+
+netdata by default tries to read /etc/mysql/debian.cnf and use the
+debian-sys-maint credentials to access the database.
+
+For Debian 10 and older, you *could* (but shouldn't, see below) grant netdata
+access to debian.cnf by setting the group ownership to netdata.
+
+For Debian 11 and newer, the debian.cnf is no longer used.
+
+Instead (and preferably also for Debian 10 and older), a dedicated read-only
+database user should be created:
+
+ $ sudo mariadb -u root
+ MariaDB > create user 'netdata'@'localhost';
+ MariaDB > grant usage on *.* to 'netdata'@'localhost';
+ MariaDB > flush privileges;
+ MariaDB > exit
+
+Note that this will allow the netdata to connect to mariadb but *not* read
+any data (which it does not need to).
+
+Naming the user 'netdata' saves you from configuring anything in netdata itself
+and it will automatically pick it up once the user has been created.
+
+ -- Daniel Baumann <daniel.baumann@progress-linux.org> Tue, 09 Feb 2021 11:03:31 +0100