Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:controller:vzlogger:installation_cpp-version [2019/09/04 17:54] – libsml nicht aus Debian jau
+++ software:controller:vzlogger:installation_cpp-version [2024/02/04 11:25] (aktuell) – [Build von Hand] cmake Syntaxfehler jau
@@ Zeile 14: / Zeile 14: @@
 </code>
-Die meisten Erfahrungen mit dem Bau des vzloggers bestehen mit Debian und verwandten Distributionen (Ubuntu, Raspbian). Die folgenden Anleitungen wurden im Mai 2019 mit Debian 10 "buster" verifiziert; Informationen für Versionen älter als Debian 9 "stretch" finden sich in der Historie dieser Seite.
+Die meisten Erfahrungen mit dem Bau des vzloggers bestehen mit Debian und verwandten Distributionen (Ubuntu, Raspbian). Die folgenden Anleitungen wurden im April 2022 mit Debian 11 "Bullseye" verifiziert; Informationen für ältere Versionen finden sich in der Historie dieser Seite.
 ===== Systemvoraussetzungen zur Kompilierung des vzlogger =====
@@ Zeile 43: / Zeile 43: @@
 === Debian Pakete ===
-Für auf Debian 9 "stretch" basierende Distributionen können die meisten dieser Abhängigkeiten mit:
+Für auf Debian basierende Distributionen können die meisten dieser Abhängigkeiten mit:
-<code>sudo apt-get install build-essential git-core cmake pkg-config subversion libcurl4-openssl-dev libgnutls28-dev libsasl2-dev uuid-dev libtool libssl-dev libgcrypt20-dev libmicrohttpd-dev libltdl-dev libjson-c-dev libleptonica-dev libmosquitto-dev libunistring-dev dh-autoreconf</code>
+<code>sudo apt-get install build-essential git cmake pkg-config subversion libcurl4-openssl-dev libgnutls28-dev libsasl2-dev uuid-dev libtool libssl-dev libgcrypt20-dev libmicrohttpd-dev libltdl-dev libjson-c-dev libleptonica-dev libmosquitto-dev libunistring-dev dh-autoreconf</code>
 installiert werden. Eventuell erstmal <code>sudo apt-get update</code> ausführen.
@@ Zeile 57: / Zeile 57: @@
 Das Script bietet auch die Möglichkeit, nur einzelne Module zu übersetzen. Details dazu findet man als Kommentar im Script.
+Möchte man den vzlogger mit optionaler Funktionalität MQTT bauen lautet der Aufruf für das Script:
+<code>
+./install.sh vzlogger libjson libsml mqtt
+</code>
 === Hintergrunddienst ===
@@ Zeile 62: / Zeile 67: @@
 === Aktualisierung ===
+Ist in der Regel aber nicht nötig, aber die zugrundeliegende SML Bibliothek kann (vorher) für sich aktualisiert werden, indem:
+<code>
+cd vzlogger/libs/libsml
+git pull
+cd ../..
+./install.sh libsml
+</code>
 Zum Aktualisieren des vzlogger dient diese Prozedur:
@@ Zeile 72: / Zeile 85: @@
 </code>
-Die zugrundeliegende SML Bibliothek kann (vorher) aktualisiert werden, indem:
+Mit optionaler Funktionalität MQTT lautet hier der Aufruf für das Script:
 <code>
-cd vzlogger/libs/libsml
+./install.sh mqtt vzlogger
-git pull
-cd ../..
-./install.sh libsml
 </code>
@@ Zeile 104: / Zeile 114: @@
 === Building vzlogger ===
+<note>Hier können bei Bedarf weitere Funktionen dazu kompiliert werden z.B. MQTT, dazu den cmake-Befehl anpassen:\\ ''cmake -DBUILD_TEST=off -DENABLE_MQTT=on ..''</note>
 <code>
 git clone https://github.com/volkszaehler/vzlogger.git
@@ Zeile 109: / Zeile 120: @@
 mkdir build
 cd build
-cmake ..
+cmake -DBUILD_TEST=off ..
 make
 sudo make install
@@ Zeile 185: / Zeile 196: @@
 sudo systemctl enable vzlogger
 </code>
+====== vzlogger als anderer Benutzer ausführen ======
+=== Elevated privileges für vzlogger binary setzen ===
+Als User führt man folgenden Befehl aus, um ausreichend Rechte zum Ausführen des Programms zu erhalten:
+<code>
+sudo setcap 'cap_sys_nice=eip' /usr/local/bin/vzlogger
+</code>
+<note>Auf Raspberry können dennoch Zugriffsprobleme beim Konfigurieren der GPIO auftreten. Frühzeitiger export in ''/etc/rc.local'' umgeht das Problem.</note>
+=== Dienst-User anlegen ===
+Man kann für den Dienst einen separaten User (z.B. ''vzlogger'') ohne Homeverzeichnis anlegen und Passwort vergeben.
+<code>
+sudo useradd -M vzlogger
+sudo passwd vzlogger
+</code>
+Auf einem Raspberry den neuen User diversen Gruppen hinzufügen.
+<code>
+sudo usermod -aG gpio vzlogger
+sudo usermod -aG dialout vzlogger
+sudo usermod -aG staff vzlogger
+</code>
+Für das Logfile ein Unterverzeichnis mit passenden Schreibrechten anlegen.
+<code>
+sudo mkdir /var/log/vzlogger
+sudo chgrp staff /var/log/vzlogger
+sudo chmod g+w /var/log/vzlogger
+</code>
+=== vzlogger.conf anpassen ===
+Der neue Ort fürs Logfile muss natürlich auch vzlogger bekannt gemacht werden. ''/etc/vzlogger.conf'':
+<code>
+"log" : "/var/log/vzlogger/vzlogger.log",
+</code>
+=== Systemd Startscript anpassen ===
+Nun muss nur noch im Systemd Startscript (siehe anderer Paragraph) der User, mit welchem vzlogger ausgeführt werden soll, hinzugefügt bzw. geändert werden.
+Unter der Kategorie [Service] fügt man eine weitere Zeile hinzu. Für den User vzlogger lautet es zum Beispiel:
+<code>
+User=vzlogger
+</code>
+Nun muss der Service nur neu gestartet werden und vzlogger läuft unter dem angegebenen Benutzer:
+<code>
+sudo systemctl daemon-reload
+</code>
+=== Verwendung ===
+Das Betreiben von vzlogger unter einem anderen Benutzer als root ist vor allem bei der Verwendung vom Protokol "exec" von Bedeutung. vzlogger muss nicht für die Verwendung neu kompiliert werden. Aufrufe von "exec" werden nicht von root sondern vom verwendeten User gemacht.