SmartHomeNG Release v1.7.1

[Msinn]

Mit dem Aufruf muss dir das Release 1.7 (bei einer nackten Neuinstallation) auch schon um die Ohren geflogen sein.

In der Doku steht ausdrücklich: Den Dienst erst einrichten, wenn SmartHomeNG soweit läuft.

Beim ersten Start einer Neuinstallation beendet sich SmartHomeNG natürlicherwise mit einem Fehler, da nicht einmal der grundlegende Satz an Packages installiert ist. Der wird dann installiert (das war bei v1.7 bereits so und ist unverändert).

Dazu muss der Start aus dem smarthome Verzeichnis erfolgen. Also:

cd /usr/local/smarthome
python3 bin/smarthome.py

Dann werden die minimal benötigten Packages installiert (noch Konsoleausgabe, wie es auch in der Dokumentation steht)
Danach startet SmartHomeNG neu und kann anschließend normal loggen. Dann wir geprüft ob die Packages für die Module installiert sind...

Aber ich habe keine Lust das Handbuch jetzt hier nochmal in den Thread zu schreiben...

[Sisamiwe]

Hallo,
ich habe meine Produktivinstanz heute auch dem Update auf 1.7.1 unterzogen. Dabei bin auf folgendes Problem gestoßen:

• nach dem Update mit git pull sowohl von shNG als auch den Plugins kann ich shNG über die Konsole mit

  python3 /usr/local/smarthome/bin/smarthome.py

  fehlerfrei starten. Die Logs zeigen keine Fehler
• möchte ich nun shNG wieder über den Dienst starten, gibt es eine Fehlermeldung und shNG wird nicht gestartet

   [root@SmartHomeNG ~]# systemctl status smarthome.service
  	● smarthome.service - SmartHomeNG daemon
  	Loaded: loaded (/lib/systemd/system/smarthome.service; enabled; vendor preset: enabled)
  	Active: failed (Result: exit-code) since Tue 2020-04-14 13:40:41 CEST; 5s ago
  	Process: 2154 ExecStart=/usr/bin/python3 /usr/local/smarthome/bin/smarthome.py (code=exited, status=1/FAILURE)
  	
  	Apr 14 13:40:40 SmartHomeNG python3[2154]: test_requirements: 'holidays' not installed. Minimum v0.9.11 needed
  	Apr 14 13:40:40 SmartHomeNG python3[2154]: Installing core requirements for the current user, please wait...
  	Apr 14 13:40:40 SmartHomeNG python3[2154]: len(stderr)=114
  	Apr 14 13:40:40 SmartHomeNG python3[2154]: ERROR: Could not open requirements file: [Errno 2] Datei oder Verzeichnis nicht gefunden: 'requirements/core.txt'
  	Apr 14 13:40:40 SmartHomeNG python3[2154]: Python package requirements not met - SmartHomeNG is terminating
  	Apr 14 13:40:40 SmartHomeNG python3[2154]: ERROR: Unable to install core requirements
  	Apr 14 13:40:41 SmartHomeNG systemd[1]: smarthome.service: Control process exited, code=exited status=1
  	Apr 14 13:40:41 SmartHomeNG systemd[1]: Failed to start SmartHomeNG daemon.
  	Apr 14 13:40:41 SmartHomeNG systemd[1]: smarthome.service: Unit entered failed state.
  	Apr 14 13:40:41 SmartHomeNG systemd[1]: smarthome.service: Failed with result 'exit-code'.

Wodurch wird der Fehler verusacht? Die requirements sind alle erfüllt, sonst würde der Start über die Konsole nicht klappen.
Liegt es am Nutzer?

[Msinn]

Aktuelle Version
Stand 14. April 2020 ist jetzt im master Branch die Version v1.7.1 als stabile Version von SmartHomeNG verfügbar.
Nur die Master Version sollte für den produktiven Einsatz benutzt werden!
Es ist nicht nur für Anfänger die richtige Wahl.

Develop Branch
Es findet eine aktive Weiterentwicklung statt, daher bitte mit einem Produktionssystem nicht auf den Entwicklungszweig gehen!
Man sollte nur auf den develop Branch gehen, wenn man genau weiß, was man da macht.
Es kann immer mal passieren, dass der develop branch aufgrund der laufenden Entwicklung in einem nicht lauffähigen Zustand ist.

Auch ein Mischen vom master Branch und develop Plugins kann, aber muß nicht klappen, da einige Plugins aus dem develop Branch Funktionalitäten des
Core benötigen könnten, die im master branch noch nicht vorhanden sind. In diesem Fall wird das Plugin nicht laden und einen Log Eintrag schreiben.

smarthomeNG ist als Organisation bei Github angelegt, so dass mehrere Admins Schreibrechte auf das Repository haben.


Dokumentation
Unter https://www.smarthomeNG.de findet sich unser Blog und der Startpunkt für die Dokumentation:

• Die für das Release aktualisierte Anwender-Dokumentation ist unter https://www.smarthomeNG.de/user/ zu finden.
• Die für das Release aktualisierte Entwickler-Dokumentation ist unter https://www.smarthomeNG.de/developer/ zu finden.

Was ist neu in SmartNomeNG v1.7.1?
Die Neuerungen erstrecken sich über Bugfixes für den Core von SmartHomeNG sowie Änderungen und Bugfixes für diverse Plugins. Es ist auch ein neues Plugin hinzugekommen. Die Release Notes sind unter www.smarthomeng.de zu finden. Bitte auch die vollständigen Release Notes für das Release 1.7 beachten.


Was ist beim Update zu beachten?
Die Unterstützung des MQTT Protokolls ist in den Core umgezogen. Dadurch kann das Protokoll auch aus Logiken und mehreren Plugins genutzt werden. Dadurch ändert sich die Konfiguration. Ausführliche Informationen zu den Änderungen und zur Konfiguration finden sich auf www.smarthomeNG.de


Unterstützung
Natürlich gibt es hier im Forum Unterstützung. Zusäzlich haben wir auf https://gitter.im/smarthomeNG/smarthome einen Chat für SmartHomeNG eingerichtet. Dort schauen viele User und Entwickler in regelmäßgen Abständen rein.


Fehlerbehebung
Bevor ihr postet oder um Hilfe fragt, bitte

• im Administrations-Interface einen Überblick verschaffen ob z.B. config files richtig im SmartHomeNG ankommen
• Im Logfile nach Fehlern oder Warnungen suchen und wenn möglich deren Ursachen beseitigen.
• SmartHomeNG im Debugmodus starten oder besser: Für nur den betroffenen Teil den Log-Level auf INFO oder DEBUG hochsetzen.

Wenn Ihr Hilfe braucht und nicht weiterkommt werden Euch andere hier im Forum gerne weiterhelfen.

Wenn ihr dann postet, geizt bitte nicht mit Informationen über eure Installation. Wir können alle nicht Hellsehen. Für uns hilfreich oder sogar notwendig sind unter anderem:

• Beschreibung was ihr erreichen wollt
• Erläuterung was ihr bisher gemacht habt
• Genaue Bescheibung des wahrgenommenen Problems
• ("Läuft nicht" ist da nicht ausreichend...)
• Erläuterung welches Verhalten ihr erwartet
• SmartHomeNG Version
• Python Version
• Betriebssystem mit Version
• eingesetzte Hardware
• Art der Installation
• (z.B. Nach Komplettanleitung oder Raspberry Pi Image oder Update von Vorversion oder ...)
• Konfigurierte Plugins (gerne die etc/plugin.yaml mit posten)
• gegebenfalls die entsprechenden Item Konfigurationen (aus items/*.yaml)

Viel Spaß und viel Erfolg mit Eurem SmartHomeNG!!!