Benutzer-Werkzeuge

Webseiten-Werkzeuge


software:controller:vzlogger:installation_cpp-version

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
software:controller:vzlogger:installation_cpp-version [2019/05/28 22:03] zugschlussoftware:controller:vzlogger:installation_cpp-version [2024/02/04 11:25] (aktuell) – [Build von Hand] cmake Syntaxfehler jau
Zeile 6: Zeile 6:
 Unser Repository: https://github.com/volkszaehler/vzlogger\\ 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.+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. 
  
 Dies macht man praktischerweise in einem Verzeichnis, in dem dein "normaler" Nutzer Schreibrechte hat. Zum Beispiel dein Home-Verzeichnis: Dies macht man praktischerweise in einem Verzeichnis, in dem dein "normaler" Nutzer Schreibrechte hat. Zum Beispiel dein Home-Verzeichnis:
Zeile 14: Zeile 14:
 </code> </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 ===== ===== Systemvoraussetzungen zur Kompilierung des vzlogger =====
Zeile 33: Zeile 33:
   * libsasl2-dev   * libsasl2-dev
   * libuuid1   * libuuid1
-  * libsml (for sml meters)+  * libsml (für sml meters)
   * libmicrohttpd-dev >= 0.4.6 (for builtin "local" webserver)   * libmicrohttpd-dev >= 0.4.6 (for builtin "local" webserver)
   * libltdl >=0.8.0 (for OMS)   * libltdl >=0.8.0 (for OMS)
Zeile 43: Zeile 43:
 === Debian Pakete === === 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. 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. 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 === === Hintergrunddienst ===
Zeile 62: Zeile 67:
  
 === Aktualisierung === === 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: Zum Aktualisieren des vzlogger dient diese Prozedur:
Zeile 72: Zeile 85:
 </code> </code>
  
-Die zugrundeliegende SML Bibliothek kann (vorher) aktualisiert werden, indem:+Mit optionaler Funktionalität MQTT lautet hier der Aufruf für das Script:
 <code> <code>
-cd vzlogger/libs/libsml +./install.sh mqtt vzlogger
-git pull +
-cd ../.. +
-./install.sh libsml+
 </code> </code>
  
Zeile 85: Zeile 95:
 <note warning>Nur für geübte User! Wer wenig Erfahrung hat sollte den [[software:controller:vzlogger:installation_cpp-version#build_per_script|Build per Script]] machen.</note> <note warning>Nur für geübte User! Wer wenig Erfahrung hat sollte den [[software:controller:vzlogger:installation_cpp-version#build_per_script|Build per Script]] machen.</note>
  
-=== Building vzlogger ===+=== Building libsml === 
 +Debian bietet zwar ein Paket libsml-dev, das basiert aber leider auf veraltetem, nicht mehr gepflegtem Code. 
 +<code> 
 +git clone https://github.com/volkszaehler/libsml.git 
 +cd libsml 
 +sudo make 
 +</code> 
 +Libsml bietet kein 'make install' Vorgabe.
  
 +Man macht das manuell in dem man die folgenden Dateien und Verzeichnisse kopiert:
 +<code>
 +sudo cp sml/lib/libsml.* /usr/lib/
 +sudo cp -R sml/include/* /usr/include/
 +sudo cp sml.pc /usr/lib/pkgconfig/
 +</code>
 +
 +Zurück zum Ausgangsverzeichnis: <code>cd ..</code>
 +
 +=== 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> <code>
 git clone https://github.com/volkszaehler/vzlogger.git git clone https://github.com/volkszaehler/vzlogger.git
Zeile 92: Zeile 120:
 mkdir build mkdir build
 cd build cd build
-cmake ..+cmake -DBUILD_TEST=off ..
 make make
 sudo make install sudo make install
Zeile 144: Zeile 172:
 Systemd dient dazu Hintergrunddienste einzurichten und zu verwalten. Systemd dient dazu Hintergrunddienste einzurichten und zu verwalten.
  
-Das Installationsscript fragt ob es ein "systemd unit file" für dich installieren soll. Falls dein System systemd nutzt (Debian "Jessie") solltest du mit yes (ja) bestätigen.+Das Installationsscript fragt ob es ein "systemd unit file" für dich installieren soll. Falls dein System systemd nutzt (ab Debian "Jessie") solltest du mit yes (ja) bestätigen.
  
 Falls du es selbst kopieren oder editieren willst findest du ein Beispiel unter: Falls du es selbst kopieren oder editieren willst findest du ein Beispiel unter:
Zeile 168: Zeile 196:
 sudo systemctl enable vzlogger sudo systemctl enable vzlogger
 </code> </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.
  
  
software/controller/vzlogger/installation_cpp-version.1559073822.txt.gz · Zuletzt geändert: 2019/05/28 22:03 von zugschlus