From e1513d7038abbcd2140d2ebfe31eec4c06498f6f Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Tue, 9 Feb 2021 13:52:55 +0100 Subject: Adding README.Debian for netdata, explaining mysql/mariadb tplugin things (Closes: #921047). Signed-off-by: Daniel Baumann --- debian/netdata-core-no-sse.README.Debian | 1 + debian/netdata-core.README.Debian | 43 ++++++++++++++++++++++++++++++++ 2 files changed, 44 insertions(+) create mode 120000 debian/netdata-core-no-sse.README.Debian create mode 100644 debian/netdata-core.README.Debian 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 Tue, 09 Feb 2021 11:03:31 +0100 -- cgit v1.2.3