Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:controller:vzlogger:installation_cpp-version [2021/02/13 12:53] – weitere Gruppen & Rechte jau
+++ software:controller:vzlogger:installation_cpp-version [2024/05/12 19:36] (aktuell) – Paket Installation jau
@@ 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 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 84: @@
 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 94: @@
 === 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 112: @@
 </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 141: @@
 === 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 213: / Zeile 251: @@
 </code>
-Dabei auch die Schreibrechte aufs Logfile berückrichtigen!
+Für das Logfile ein Unterverzeichnis mit passenden Schreibrechten anlegen.
 <code>
-sudo chgrp staff /var/log
+sudo mkdir /var/log/vzlogger
-sudo chmod g+w /var/log
+sudo chgrp staff /var/log/vzlogger
-sudo chown vzlogger /var/log/vzlogger.log
+sudo chmod g+w /var/log/vzlogger
-sudo chmod g+w /var/log/vzlogger.log
 </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 ===