20171026 conf/substitutions.conf.franchise (Community-spezifische substitions nach conf/substitutions.conf.franchise zwecks Redundanzvermeidung)

README.md

@@ -20,17 +20,19 @@ Nach erfolgreichem `make` (s.u.) findet sich der tarball in `dist/nodes2grafana.
 
 Benötigt wird außer FreeBSD oder Linux sowie den dort üblichen verdächtigen Un*x-utilities nur [SML/NJ](http://www.smlnj.org/), da der Konverter in SML'97 programmiert ist.
 
-- Das smlnj package sollte vollständig sein, d.h. muss auch `ml-build` enthalten.
+- Das `smlnj package` sollte vollständig sein, d.h. muss auch `ml-build` enthalten.
 - Wenn `heap2exec` vorhanden ist (wie beim FreeBSD port lang/smlnj), dann wird es zur Erstellung von executables genutzt. Ansonsten wird ein script installiert, dass einen heap mit Hilfe der SML/NJ runtime ausführt.
-- Für auf Debian basierende Distributionen benötigt man außer dem smlnj package auch das ml-lpt package.
+- Für auf Debian basierende Distributionen benötigt man außer dem `smlnj` package auch das `ml-lpt` package.
 
 ## Konfiguration
 
-Zwecks Konfigurationsanpassung (Pfade, Metriknamen, Community) die Datei `conf/substitutions.conf.default` nach `/etc/nodes2grafana.conf` kopieren und die zu ändernden Werte anpassen.
+Zwecks Konfigurationsanpassung für die lokale Community die Datei `conf/substitutions.conf.franchise` editieren.
 
-Zeilen, die gegenüber der substitutions.conf.default nicht geändert wurden, können auch weggelassen werden.
+Nach dem untigen ggf. `make` die `conf/substitutions.conf` nach `/etc/nodes2grafana.conf` kopieren und nach Bedarf editieren. Der Bezeichner (erstes Feld) wird durch Tabulator-Zeichen vom Substituions-Wert getrennt. Zeilen, die gegenüber der substitutions.conf nicht geändert wurden, auch weggelassen werden.
 
-Will man nicht gleich im /etc herumschreiben sondern erstmal ausprobieren, kann man `conf/substitutions.conf.local` verwenden.
+Will man nicht gleich im /etc herumschreiben sondern erstmal ausprobieren, kann man statt dessen `conf/substitutions.conf.local` verwenden.
+
+Für die Anpassung der status-group Dashboards an die lokale Community auch die Datei `dashboard/groups.prom.in` editieren. (Bei späteren Änderungen eines dortigen "regex"-labels immer den count hochzählen!)
 
 Anschließend:
 

conf/substitutions.conf.FreeBSD

@@ -1,26 +1,14 @@
-NODES_URL		https://map.ffdo.de/data/nodes.json
 FETCH_CMD		fetch -q -T 30 --no-verify-peer -o
-PROM_SEPERATOR		_
-#PROM_SEPERATOR		:
-PROM_PREFIX		ffdo_nodes
-PROM_SUMMARY_PREFIX	ffdo_nodes_summary
-PROM_INFO_PREFIX	ffdo_nodes_info
-PROM_STATS_PREFIX	ffdo_nodes_detail
-PROM_GROUPS_PREFIX	ffdo_groups
 EXPORT_DIR		/var/tmp/node_exporter
 RUN_SML			/usr/local/smlnj/bin/.run-sml
 HEAP_SUFFIX		x86-bsd
-HEAP_FILES		 
+HEAP_FILES
 HEAP_TAR_EXCLUDE	--exclude=src/*.x86-bsd
 BIN_DIR			/usr/local/bin
+# keep this:
 ETC_DIR			/etc
 DASHBOARD_DIR		/var/db/grafana/dashboards
 INSTALL_BIN_CMD		install -o 0 -g 0 -p -S -v
 INSTALL_DATA_CMD	install -o 0 -g 0 -p -S -v -m 644
-DASHBOARD_PREFIX	FF-DO-
-COMMUNITY_BRIEF		FF-DO
-COMMUNITY_FULL		Freifunk Dortmund
-COMMUNITY_URL		http://www.freifunk-dortmund.de/
-MAP_NODE_URL		https://map.ffdo.de/meshviewer/#!v:m;n:
+# keep this:
 N2G_SRC_URL		https://git.ffdo.de/altlast/nodes2grafana
-N2G_COMMUNITY_URL	http://url.free.de/ffdo/Technik/Netzinfrastruktur/Status

conf/substitutions.conf.Linux

@@ -1,28 +1,16 @@
-NODES_URL		https://map.ffdo.de/data/nodes.json
 FETCH_CMD		wget -q -O
-PROM_SEPERATOR		_
-#PROM_SEPERATOR		:
-PROM_PREFIX		ffdo_nodes
-PROM_SUMMARY_PREFIX	ffdo_nodes_summary
-PROM_INFO_PREFIX	ffdo_nodes_info
-PROM_STATS_PREFIX	ffdo_nodes_detail
-PROM_GROUPS_PREFIX	ffdo_groups
 EXPORT_DIR		/var/tmp/node_exporter
 RUN_SML			/usr/lib/smlnj/bin/.run-sml
 HEAP_SUFFIX		x86-linux
 HEAP_FILES		src/nodes2prom.x86-linux src/json-pp.x86-linux
-HEAP_TAR_EXCLUDE	 
+HEAP_TAR_EXCLUDE
 BIN_DIR			/usr/local/bin
+# keep this:
 ETC_DIR			/etc
 DASHBOARD_DIR		/var/db/grafana/dashboards
 INSTALL_BIN_CMD	install -o 0 -g 0 -p -v
 #INSTALL_BIN_CMD	cp -a
 INSTALL_DATA_CMD	install -o 0 -g 0 -p -v -m 644
 #INSTALL_DATA_CMD	cp -a
-DASHBOARD_PREFIX	FF-DO-
-COMMUNITY_BRIEF		FF-DO
-COMMUNITY_FULL		Freifunk Dortmund
-COMMUNITY_URL		http://www.freifunk-dortmund.de/
-MAP_NODE_URL		https://map.ffdo.de/meshviewer/#!v:m;n:
+# keep this:
 N2G_SRC_URL		https://git.ffdo.de/altlast/nodes2grafana
-N2G_COMMUNITY_URL	http://url.free.de/ffdo/Technik/Netzinfrastruktur/Status

conf/substitutions.conf.franchise

@@ -0,0 +1,15 @@
+# siehe auch ../dashboard/groups.prom.in zwecks Anpassung fuer die jeweilige Community
+NODES_URL		https://map.ffdo.de/data/nodes.json
+PROM_SEPERATOR		_
+#PROM_SEPERATOR		:
+PROM_PREFIX		ffdo_nodes
+PROM_SUMMARY_PREFIX	ffdo_nodes_summary
+PROM_INFO_PREFIX	ffdo_nodes_info
+PROM_STATS_PREFIX	ffdo_nodes_detail
+PROM_GROUPS_PREFIX	ffdo_groups
+DASHBOARD_PREFIX	FF-DO-
+COMMUNITY_BRIEF		FF-DO
+COMMUNITY_FULL		Freifunk Dortmund
+COMMUNITY_URL		http://www.freifunk-dortmund.de/
+MAP_NODE_URL		https://map.ffdo.de/meshviewer/#!v:m;n:
+N2G_COMMUNITY_URL	http://url.free.de/ffdo/Technik/Netzinfrastruktur/Status

dist/Makefile.in

@@ -1,5 +1,6 @@
 DISTFILES=	Makefile.in README.md \
-		conf/Makefile conf/substitute.sh conf/substitutions.conf.FreeBSD conf/substitutions.conf.Linux \
+		conf/Makefile conf/substitute.sh conf/substitutions.conf.franchise \
+		conf/substitutions.conf.FreeBSD conf/substitutions.conf.Linux \
 		dashboard/*.in dist/Makefile.in etc/*.in src test/Makefile.in
 DISTTARGET=	nodes2grafana
 DISTDIR=	tmp/${DISTTARGET}