2020er Image für Raspberry PI Version 4 und 3

In dieser Anleitung wird beschrieben, wie das 2020er Homeserverimage für einen Raspberry PI4 oder PI3 installiert werden kann.

Von einem alten Image auf ein neues Raspberry PI Image wechseln
- Falls noch kein Onlinebackup eingerichtet ist, dies zuerst erledigen unter: System -> Verwaltung -> Online Backup
- Die Backup ID erhalten alle Homeserveruser per Email an info@haus-bus.de
- Auf der Online Backup Seite klicken auf "Snapshot erstellen", um vom aktuellen Stand der Dinge ein Onlinebackup zu erstellen. Das kann bis zu 5 Minuten dauern. Dann bitte schauen, ob der Snapshop auf der Seite angezeigt wird.
- Die ID vom Onlinebackup unbedingt merken/aufschreiben
- Zur Sicherheit ein Backup der aktuellen SD Karte per WinDiskImager erstellen oder besser direkt eine neue SD Karte für das neue Image verwenden

Neues Image installieren
Es ist empfehlenswert für ein neues Homeserverimage eine neue SD Karte zu verwenden, da man die alte als Backup zur Seite legen kann. Der Homeserver benötigt eine SD Karte mit mindestens 4GB Größe. Empfehlenswert sind mindestens 8GB, um ausgiebig loggen und Daten für Diagramme und Statistiken speichern zu können

- Image runterladen und entpacken: http://www.haus-bus.de/homeserver2020.img.gz
  (Mit Firefox runterladen. InternetExplorer und Chrome haben scheinbar ein Problem beim Runterladen von GZ Dateien)
  Die Dateigröße muss nach dem Download 884.432.457 Bytes betragen
- Image mit 7-zip entpacken
- Mit WinDiskImager Image auf SD Karte schreiben: http://www.haus-bus.de/win32diskimager.zip
- SD Karte in Raspberry einlegen und starten

WICHTIG WICHTIG WICHTIG WICHTIG
In jedem Image gibt es einige Bugs, die nachträglich gefixed werden.
Deshalb muss man nun unbedingt während der Raspberry Internetzugang hat noch folgende Schritte durchführen:
- Für den Zugriff auf den Raspberry per SSH benötigt man einen SSH Client wie Putty, der z.b. hier heruntergeladen werden kann:
   http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe

- Mit putty per SSH auf dem raspberry einloggen mit den Standarddaten User: homeserver Passwort: SmartHome
- sudo su
- cd /var/www/homeserver
- wget www.haus-bus.de/patchImage.txt
- chmod 777 patchImage.txt
- ./patchImage.txt

- Dateisystem der SD Karte expanden. Damit der Homeserver genug Platz für die Datenbank hat und auch Reparaturen nach einem Stromausfall nicht mangels Discspace scheitern, muss die SD Karte expanded werden, damit der gesamte Platz der SD Karte verwendet wird. Per SSH als su 'raspi-config' starten und Advanced Optiones -> expandFilesystem wählen. Danach bei der Rückfrage wählen, dass gebootet wird

Der erste Start
- Homeserver Weboberfläche aufrufen http://raspberry/homeserver
- Zuerst auf jeden Fall ein Update der Webapplikation durchführen unter System -> Softwareupdates -> Onlineversionen lesen und danach „Aktualisieren“ wählen bei Webapplikation

- Wenn nun ein altes Backup installiert werden soll, geht man erneut unter System -> Verwaltung -> Online Backup und trägt die gemerkte Backup ID ein und klickt anschließend beim neusten bzw. Snapshot Backup auf wiederherstellen
- Nach 1-2 Minuten einmal Onlinestatus der Controller aktualisieren. Falls das Backup noch nicht eingespielt ist, nochmal nach einer weiteren Minute prüfen

- ACHTUNG: Beim Einspielen eines Backups vom Vorgängerimage aus dem Jahr 2018 ist es sehr wahrscheinlich, dass einige Tabellen repariert werden müssen, da diese vom Typ INNO-DB sind, welcher im neuen Image nicht mehr verwendet wird. Dafür bitte einfach nur per SSH einloggen, ins Verzeichnis /var/www/homeserver wechseln und dann aufrufen php repairTables.php

- Falls das Backup aus einem unbekannten Grund nicht eingespielt wird, bitte per SSH einloggen und folgendes aufrufen

 sudo /var/www/homeserver/homeserverRestore.sh

Nun ist der Homeserver einsatzbereit !

Falls etwas schief gelaufen ist
- Per SSH einloggen s.u.
- Datenbank neu zu starten per: /etc/init.d/mysql restart
- Udpworker neu zu starten per: /etc/init.d/udpworker restart
- Oder einfach der raspberry einmal komplett neu starten

Per SSH einloggen
- Per SSH (putty) auf dem raspberry einloggen per User: homeserver Pass: SmartHome
- Zum admin machen per: sudo su

Passwörter ändern
- Per SSH (putty) auf dem raspberry einloggen per User: homeserver Pass: SmartHome
- Linux Passworts ändern: passwd
- FTP Passwort ändern: ftpasswd --passwd --name homeserver --uid 33 --gid 33 --home /var/www/ --shell /bin/false
- Datenbank Passwort ändern. Hier sind 2 Schritte nötig:
1. Datenbankpasswort Bei MYSQL einloggen: mysql -u root –p Passwort leer bestätigen Neues Passwort setzen per: SET PASSWORD FOR 'root'@'localhost' = PASSWORD('ganzneuespw'); Beendet mit: exit;
2. Homeserver Datenbankverbindung anpassen: Per SSH oder FTP die Datei include/dbconnect.php im Homeserververzeichnis (/var/www/homeserver) editieren und die Zugangsdaten anpassen

Erweiterte/umfangreiche Skripte in PHP einbinden
Der Homeserver bietet für eigene PHP Plugins eine eigene Schnittstelle, an die man sich leicht andocken kann.
Im Verzeichnis User befindet sich die Datei homeserver/user/myUserPlugin.php, in der man eigene Implementierungen einbringen kann. Alle im Bussystem verschickten Events können hier ausgewertet und sämtliche Aktionen ausgelöst werden. Alle zur Verfügung stehenden Funktionen und Parameter sind in der Datei homeserver/userPlugin.php dokumentiert. (Diese Klasse darf aber nicht modifiziert werden) Alle Dateien, die im user Verzeichnis angelegt werden, kommen automatisch mit in Backup und gehen auch nach einer Neuinstallation des Basisimages nicht verloren.


Emailversand auf Homeserver ermöglichen
Wenn ihr mit dem Homeserver Emailbenachrichtungen verschicken möchtest, muss ein Emailkonto konfiguriert werden.
- sudo nano /etc/ssmtp/ssmtp.conf
Dort folgende Zeilen eintragen bzw. ändern: root=EIN.BEISPIEL@gmail.com mailhub=smtp.gmail.com:587 hostname=EIN.BEISPIEL@gmail.com UseSTARTTLS=YES AuthUser=EIN.BEISPIEL AuthPass=GEHEIM FromLineOverride=YES
Die Daten müssen zu eurem Emailaccount passen, mit dem ihr auch sonst Emails verschickt.