Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- howto:installation_auf_webhoster_2 [2016/09/03 18:51] – lftp Beispiele jau
+++ howto:installation_auf_webhoster_2 [2019/11/04 11:07] – Verallgemeinert, config.yaml jau
@@ Zeile 3: / Zeile 3: @@
 ===== Motivation =====
 Nicht jeder hat vielleicht einen eigenen 24/7 Server für den Volkszähler zu Verfügung oder es nervt die Performance eines low-cost LAMP Ansatzes (z.B. auf RaspberryPi). Wer bei einer Monatsanzeige schon mal gefühlte Stunden gewartet hat, sehnt sich nach mehr Leistung. Ein Lösungsansatz kann eine Webhoster Implementierung sein. Für einen erträglichen Monatsbetrag (geht so ab 1,99€/Monat los) bekommt man eine eigene Domain und ein paar GigaByte Webspace.
-Diese preiswerten Angebote bieten allerdings keinen root Zugang und somit ist die Einrichtung des Volkszählers nicht über den Standardweg zu erledigen. Mit ein paar Handmodifikationen läßt sich das aber in Griff kriegen.
+Diese preiswerten Angebote bieten allerdings keinen root- oder SSH-Zugang und somit ist die Einrichtung des Volkszählers nicht über den Standardweg zu erledigen. Mit ein paar Handmodifikationen lässt sich das aber in Griff kriegen.
 ===== Voraussetzungen =====
@@ Zeile 12: / Zeile 12: @@
   * PHP Skript Memory Limit min. 32M (sonst gibt es bei Monats- oder Jahresüberblicken eine PHP Fehlermeldung)
-Meine Wahl fiel auf Hosteurope, da ich da schon Webspace habe und nutze. Die folgenden Schritte beschreiben die Installation dort ist aber sicher auch für andere WebHoster gültig.
+Das folgende Beispiel bezieht sich auf Hosteurope. Die folgenden Schritte beschreiben die Installation dort, ist aber sicher auch für andere Webhoster gültig.
 ===== Vorbereitungen =====
@@ Zeile 25: / Zeile 25: @@
 Vorab: Sollte das System noch nicht laufen, kann man den Export mit Standardeinstellungen machen. Sollten aber schon Daten in die lokale DB geloggt werden empfiehlt sich folgendes:
-Zunächst einmal legt man sich eine Datenbank über das Backend des Webhosters an, ggf. nutzt man die einzig vorhandene. Mit den zugehörigen Daten loggt man sich in das PHPMyAdmin des Hosters (oder das selbst auf dem Webspace installierte) ein, um die Schemata einzuspielen. Am einfachsten geht dies, indem man mit dem phpMyAdmim folgende Schritte durchführt:
+Zunächst einmal legt man sich eine Datenbank über das Backend des Webhosters an, ggf. nutzt man die einzig vorhandene. Mit den zugehörigen Daten loggt man sich in das phpMyAdmin des Hosters (oder das selbst auf dem Webspace installierte) ein, um die Schemata einzuspielen. Am einfachsten geht dies, indem man mit dem phpMyAdmim folgende Schritte durchführt:
   * Datenbank auswählen
   * Reiter "Exportieren"
@@ Zeile 50: / Zeile 50: @@
 ==Variante eins==
-Wir kopieren den gesamten Inhalt von ''/var/www/volkszaehler.org/'' in ein Verzeichnis unserer Wahl beim Hoster (z.B. ''/was/auch/immer/vz.domain.tld/'')\\
+Wir kopieren per ftp-Befehl den gesamten Inhalt von ''/var/www/volkszaehler.org/'' in ein Verzeichnis unserer Wahl beim Hoster (z.B. ''/was/auch/immer/vz.domain.tld/'')
-Z.B. mit einem FTP-Client: (lftp ist nicht im Rasperry-Image enthalten und muss erst installiert werden)
-<code>
-lftp -e "mirror -R /var/www/volkszaehler.org/ ./;quit" -u [FTP-USER]:[PASSWORT] [FTP-SERVER]
-</code>
-==Variante zwei==
+==Variante zwei== Wir packen das Zeug per ''tar czf vz.tgz /var/www/volkszaehler.org/*'', laden diese Datei hoch und basteln uns eine zweite (PHP-)Datei (''uncompress.php''), die per System Call das ganze wieder auspackt:
-Wir packen das Zeug per ''tar czf vz.tgz /var/www/volkszaehler.org/*'', laden diese Datei hoch und basteln uns eine zweite (PHP-)Datei (''uncompress.php''), die per System Call das ganze wieder auspackt:
 <code>
 <?php
@@ Zeile 75: / Zeile 70: @@
 ===== Anpassungen =====
-== ''/vz.domain.tld/etc/volkszaehler.conf.php'' ==
+== ''/vz.domain.tld/etc/config.yaml'' ==
 <code>
 ...
-// Benutzername (wird vom Webhoster vergeben)
+db:
-$config['db']['user'] = 'webxxx';
+// Benutzername der Datenbank (wird vom Webhoster vergeben)
+  user: webxxx;
 ...
 // zugehöriges Password
-$config['db']['password'] = 'password';
+  password: password;
 ...
 // Name der Datenbank (auch vom Webhoster beim Anlegen vergeben)
-$config['db']['dbname'] = 'usr_webxxx_1';
+  dbname: usr_webxxx_1;
 ...
 // das gleiche noch mal für Admin
-$config['db']['admin']['user'] = 'webxxx';
+  admin:
-$config['db']['admin']['password'] = 'password';
+    user: webxxx
+    password: password
 ...
 </code>
@@ Zeile 102: / Zeile 99: @@
 Fertig sind wir aber natürlich noch nicht. Jetzt folgt die Anpassung (bzw. Erstellung) der 'vzlogger.conf' auf dem System, das die Daten senden soll.
-Falls der ''vzlogger'' schon brav seinen Dienst verrichtet, braucht man lediglich in der Konfigdatei den Middlewarepfad auf ''http://vz.domain.tld/middleware.php'' anpassen, den Prozess stoppen und neu starten (Pros haben ja schon längst ein Skript in ''/etc/init.d'' dafür liegen...).
+Falls der ''vzlogger'' schon brav seinen Dienst verrichtet, braucht man lediglich in der Konfigdatei
+<code>"middleware": "http://localhost/middleware.php",</code>
+den Middlewarepfad auf ''http://vz.domain.tld/middleware.php'' anpassen, den Prozess per ''systemd'' stoppen und neu starten.
 Ansonsten muss die ganz normale Einrichtung gemacht werden: Kanäle in der Middleware anlegen, UUIDs kopieren, in die Konfig eintragen, etc...
@@ Zeile 109: / Zeile 108: @@
 Klickt im phpMyAdmin auf den Home-Button, dann auf den Reiter ''Gleiche ab'', wählt als Zieldatenbank ''Aktueller Server'' und gebt bei ''Quell-Datenbank'' die Daten der alten Datenbank an:
 Voraussetzung ist natürlich ein (temporäres) Port-Forwarding von Port 3306 auf den alten Server, sofern der im Heimnetz steht...
-=====Update=====
-Da das Projekt auch nicht stehen bleibt möchte man vielleicht irgendwann mal den Code beim Webhoster aktualisieren. Dazu muss erst der Volkszähler [[howto/git#wie_aktualisiere_ich_meine_middleware-installation_auf_den_aktuellen_stand|lokal aktualisiert]] werden.\\
-Und dann per FTP abgleichen, natürlich nur was neuer und keine Konfigurationsdatei ist:
-<code>lftp -e "mirror -nR -X volkszaehler.conf.php /var/www/volkszaehler.org/ ./;quit" -u [FTP-USER]:[PASSWORT] [FTP-SERVER]</code>