Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:controller:vzlogger:installation_cpp-version [2021/02/10 16:13] – BUILD_TEST konsequent aus jau
+++ software:controller:vzlogger:installation_cpp-version [2024/12/05 15:52] (aktuell) – [Systemvoraussetzungen zur Kompilierung des vzlogger] justinotherguy
@@ Zeile 6: / Zeile 6: @@
 Unser Repository: https://github.com/volkszaehler/vzlogger\\
-Derzeit ist vzlogger und (auf manchen Plattformen) ein paar der Bibliotheken (Libraries) nur als Quellcode verfügbar. Diese müssen vor gebrauch kompiliert (übersetzt) werden.
+====== vzlogger aus Paket installieren ======
+Dank [[https://cloudsmith.com/|Cloudsmith]] ist vzlogger als vorkompiliertes Binary-Paket für Debian und Raspbian verfügbar. Abhängigkeiten werden automatisch aufgelöst und installiert. Allerdings ist es kein offizielles Debian-Paket, man muss die Quelle dem System erst noch bekannt machen. Cloudsmith bietet dafür ein Script an das diesen Teil der Arbeit für uns erledigt.
+<note important>Der nachfolgende Befehl führt das Script mit ''sudo'' aus, ein potentielles Sicherheitsrisiko. Wer das nicht möchte kann die Schritte, [[https://cloudsmith.io/~volkszaehler/repos/volkszaehler-org-project/setup/#formats-deb|entsprechend der von Cloudsmith bereitgestellten Anleitung]], einzeln ausführen.</note>
+<code>
+curl -1sLf \
+  'https://dl.cloudsmith.io/public/volkszaehler/volkszaehler-org-project/setup.deb.sh' \
+  | sudo -E bash
+</code>
+Das Script identifiziert das vorhanden Betriebssystem und die Hardware, nimmt entsprechende Einstellungen vor und richtet den Paketmanager passend ein.
+Danach kann nach üblicher Manier über den Paketmanager installiert werden:
+<code>
+sudo apt-get update
+sudo apt-get install vzlogger
+</code>
+Systemd wird in diesem Zuge mit eingerichtet, die ''vzlogger.conf'' muss noch auf die eigenen Bedürfnisse angepasst werden.
+<note>Diese Binaries umfassen leider nicht alle Funktionen von vzlogger.</note>
+====== vzlogger compilieren ======
+Vzlogger hat zusätzliche Features (OMS, OCR), die erforderlichen Bibliotheken (Libraries) sind allerdings nur als Quellcode verfügbar. Diese müssen vor gebrauch kompiliert (übersetzt) werden.
 Dies macht man praktischerweise in einem Verzeichnis, in dem dein "normaler" Nutzer Schreibrechte hat. Zum Beispiel dein Home-Verzeichnis:
@@ Zeile 14: / Zeile 41: @@
 </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 70: @@
 === Debian Pakete ===
-Für auf Debian 9 "Stretch" und 10 "Buster" 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 update && sudo apt-get install install extrace git-core cmake libtool dh-autoreconf uuid-dev libmicrohttpd-dev build-essential pkg-config libgnutls28-dev libssl-dev libmosquitto-dev libgcrypt20-dev libcurl3-dev libunistring-dev libssl-dev libsasl2-dev libcurl4-openssl-dev uuid-dev libtool libltdl-dev</code>
-installiert werden. Eventuell erstmal <code>sudo apt-get update</code> ausführen.
+installiert werden.
 ===== Build per Script =====
@@ Zeile 57: / Zeile 85: @@
 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 95: @@
 === 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 113: @@
 </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 142: @@
 === 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 187: / Zeile 226: @@
-====== vzlogger als anderer Benutzer (z.B.: pi) ausführen ======
+====== vzlogger als anderer Benutzer ausführen ======
 === Elevated privileges für vzlogger binary setzen ===
@@ Zeile 195: / Zeile 234: @@
 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 ===
@@ Zeile 200: / Zeile 271: @@
 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 pi lautet es zum Beispiel:
+Unter der Kategorie [Service] fügt man eine weitere Zeile hinzu. Für den User vzlogger lautet es zum Beispiel:
 <code>
-User=pi
+User=vzlogger
 </code>
-Nun muss der Service nur neu gestartet werden und vzlogger läuft unter dem angegebenden Benutzer:
+Nun muss der Service nur neu gestartet werden und vzlogger läuft unter dem angegebenen Benutzer:
 <code>