Installation OpenSenseMap (optional) - SBorg2014/WLAN-Wetterstation GitHub Wiki

Die Bereitstellung der Messdaten auf OpenSenseMap ist optional und lässt sich jederzeit aktivieren oder auch wieder deaktivieren. OpenSenseMap (im folgenden OSEM genannt) wird erst ab Version 1.4.0 des WLAN-Shellskriptes unterstützt. Benötigt wird noch "jq" für Linux. Dies ist ein wenige kByte großer JSON-Parser und wird beim Aufruf des Shell-Skriptes installiert falls auf dem System nicht vorhanden. Ab Version V1.5.0 wird "jq" auch vom WLAN-Shellskript benutzt und ist dann sowieso eine Grundvoraussetzung zur Nutzung.

Die Installation von OSEM kann komplett durch das WLAN-Shellskript erfolgen (neuen User, SenseBox und Sensoren registrieren) oder auch nur in Teilen, bei bestehendem User-Account oder bereits bestehender SenseBox.

Bei der User-Registrierung sollte man wie üblich ein Passwort benutzen welches sonst nirgends Anwendung findet. So ist im Zweifelsfall bei einer Kompromittierung nur ein Dienst betroffen. Außerdem wird das Passwort im Klartext in der Konfigurationsdatei gespeichert. Somit könnte jeder der Zugriff auf das System erlangt und weiß wonach er zu suchen hat das Passwort herausfinden.

Installation

Wir öffnen ein Terminal und wechseln in das Installationsverzeichnis des WLAN-Shellskriptes. Dort rufen wir ./wetterstation.sh --osem_reg auf. Dies kann bei laufender Wetterstation-Instanz erfolgen, ein vorheriges beenden ist nicht nötig. Sollte "jq" (siehe oben) nicht auf dem System installiert sein, wird nun versucht diesen zu installieren. Dafür ist die Eingabe des root-Passwortes nötig. Ansonsten muss man "jq" selbst von Hand passend zur eigenen Distribution installieren. Ohne "jq" funktioniert OSEM nicht!

Für alle Eingaben gilt: drücken von ENTER hat dieselbe Auswirkung bei [Ja/Nein] - Eingaben wie die Eingabe von Nein. Die Eingabe muss so stattfinden wie in der Auswahl angegeben. Ein "J" genügt bspw. nicht bei "Ja". Werden alle Eingaben mit ENTER bestätigt beendet sich das Skript ohne jegliche Änderungen durchzuführen.Eine Syntax-Prüfung ob die Eingaben valide sind erfolgt nicht! Dies bekommt man spätestens durch eine abschließende Fehlermeldung bei der Ausführung mitgeteilt.

1. Useraccount registrieren

Falls man schon einen Account hat oder diesen lieber über die Webseite anlegen möchte (dann jetzt durchführen und erst dann hier weiter machen: ENTER drücken und direkt zu Punkt #2 springen), sonst mit der Einrichtung eines neuen User-Accounts beginnen. Die Einrichtung ist selbsterklärend:

Mit dem abschließendem J wird der Account angelegt und man muss nun die Email-Adresse per Link in der empfangenen Email im Posteingang der hinterlegten Email-Adresse bestätigen. Da dort auch weitere Emails landen falls man Änderungen vornimmt, sollte dies keine Einmal-/Wegwerf-Email-Adresse sein.

2. SenseBox registrieren

Im Installationsverzeichnis des WLAN-Shellskriptes rufen wir (kommend von #1 abermals) ./wetterstation.sh --osem_reg auf und überspringen die Abfrage Neuen SenseBox-User registrieren mittels ENTER. Die Geolocation lässt sich bspw. über https://www.gpskoordinaten.de/ oder ähnliche ermitteln:

Wir loggen uns in unseren Account auf OSEM ein und kopieren uns unter

• Usermenü (ganz rechts oben auf der Seite) --> Dashboard >> die SenseBox-ID
• und unter der gewählten SenseBox noch --> Editieren --> Sicherheit >> den "Schlüssel" (=Security-Token; Anzeige über das "Auge" aktivieren)
  und setzen gleich noch bei Box Authentifizierung aktivieren einen Haken (damit nicht jeder einfach Daten in unsere SenseBox schicken kann)

Beides tragen wir nun mittels Editors wie bspw. "nano" in die wetterstation.conf ein und speichern die Änderungen ab: nano ./wetterstation.conf:

3. Sensoren registrieren

Im Installationsverzeichnis des WLAN-Shellskriptes rufen wir (letztmalig) ./wetterstation.sh --osem_reg auf und überspringen die Abfrage Neuen SenseBox-User registrieren und Neue SenseBox registrieren jeweils mittels ENTER.

Ist die Registrierung der Sensoren abgeschlossen, bleibt die Beantwortung der letzten Frage übrig. Soll OSEM nun aktiviert werden und der dafür nötige Neustart des Service (cronjob-User müssen per Hand neu starten) durchgeführt werden?

Die jederzeit mögliche (De-)Aktivierung erfolgt in der "wetterstation.conf" über den Parameter openSenseMap=[true/false] und Neustart des Services/Skriptes.