Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- howto:installation_auf_webhoster [2013/02/03 20:47] – Links to howto:getstarted changed to software:middleware:installation r00t
+++ howto:installation_auf_webhoster [2022/03/14 16:06] (aktuell) – Rewrite statt Redirect jau
@@ Zeile 1: / Zeile 1: @@
-====== Installation des VZ auf einem Webhoster ======
+====== Volkszaehler bei einem Webhoster mit Plesk installieren ======
 ===== 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 IOMEGA ICONNECT). 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.
+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-Zugang und somit ist die Einrichtung des Volkszählers nicht über den Standardweg zu erledigen. Dafür bekommt man hübsche Webfrontends und fertige Tools über die man die Einrichtung vornehmen kann.
+<note important>Das ganze hat aber auch Nachteile: Es gibt eine Menge verschiedener Hoster mit diversen Konfigurationen. Sollte es Probleme geben setzt das einiges an Erfahrung voraus und unsere Möglichkeiten zu unterstützen sind da sehr eingeschränkt. Der Support des Hosters ist in der Preisklasse auch keine große Hilfe weil die sich nur um die Bereitstellung kümmern, wenn es an der Anwendung klemmt ist der Kunde zuständig.</note>
 ===== Voraussetzungen =====
+Im folgendem wird die Einrichtung bei [[https://www.netcup.de/]] beschrieben. Stand 2022 nutzen sie zur Administrierung der kleinen Pakete das recht verbreitet "Plesk" in der Version "Onyx". Teilweise findet das auch bei anderen Hoster Anwendung, vielleicht sogar unter anderem Label. Aber je nach Softwarestand unterscheiden sich die verfügbaren Funktionen erheblich.
+Passen die hier erwähnten Schritte nicht haben wir noch eine andere Anleitung für Hosts die mit weniger PHP-Memory und ohne SSH daher kommen: [[/howto/installation_auf_webhoster_2|Volkszaehler bei einem Webhoster ohne SSH installieren]]
 Für unsere Installation auf dem Webhoster gelten die gleichen Bedingungen für den VZ wie für jeden anderen Server. Auf die folgenden Punkte sollte man bei der Auswahl des Hosters achten:
-  * PHP 5.3 (ganz wichtig!, die PHP Version kann zum Glück bei einigen Webhoster frei ausgewählt werden)
+  * PHP (auf die passende [[software/middleware/installation#voraussetzungen|Version]] achten!, die PHP Version kann zum Glück bei einigen Hostern frei ausgewählt werden)
   * MySQL (mindestens eine Datenbank muss erlaubt sein)
-  * phpmyadmin (Vereinfacht das eventuelle Eingreifen in die DB)
+  * PHP Skript Memory Limit min. 512M (sonst gibt es bei composer Probleme)
-  * mysqldumper (dann können wir vorhandene Datenbanken einfacher auf den oder vom Webhoster transferieren)
+  * SSH oder Composer über Plesk
-  * PHP Skript Memory Limit min. 32M (sonst gibt es bei Monats- oder Jahresüberblicken eine PHP Fehlermeldung)
-Meine Wahl fiel auf das Starter XXL Paket von [[http://www.alfahosting.de]]. Die folgenden Schritte beschreiben die Installation dort ist aber sicher auch für andere WebHoster gültig.
-===== Vorbereitungen =====
+===== Subdomain =====
-Falls man nicht schon ein lauffähiges System am Start hat, sollte man z.B. über eine virtuelle Maschine den VZ gemäss der Anleitung [[software:middleware/installation|]] aufsetzen. Schließlich haben wir auf dem Webhoster keinen root Zugang.
+In der Regel wird man auf dem Host noch ein bisschen mehr liegen haben wie nur den Volkszaehler. Daher legen wir uns erstmal eine Subdomain an.\\
-Läuft alles wie erwarten kann der Umzug losgehen.
+{{:howto:webhoster1_1_erstellen.jpg?direct|}}\\
+  * Den Dokumentenstamm lassen wir erstmal wie vorgeschlagen.
+  * SSL aktivieren, etliche Browser zeigen unverschlüsselte Seiten nicht mehr direkt an. Dazu brauchen wir aber auch ein gültiges Zertifikat. [[https://letsencrypt.org/de/|Let's Encrypt]] stellt welche kostenfrei zur Verfügung.
+  * Unterstützung für Git aktivieren, die URL zum VZ-Repositiry ''https://github.com/volkszaehler/volkszaehler.org'' eintragen und Zielverzeichnis angeben (wird direkt angelegt).
+Das Git wird geclont, die Subdomain angelegt.\\
+{{:howto:webhoster1_2_subdomain.jpg?direct|}}\\
+Von hier ab navigieren wir zu den meisten Einstellungen.
-=== Umzug der Daten ===
+===== PHP =====
-Mit Hilfe von ''mysqldumper'' kopieren wir die gesamte Datenbank inkl. der Struktur auf den neuen Webserver. Dazu auf dem 'alten' Server ''mysqldumper'' starten, dann Menupunkt //'Backup'// aufrufen und ein //'Neues Backup erstellen'//. Je nach Datenmenge kann das ein paar Minuten dauern. Das Backup befindet sich dann unter ''mysqldumper/work/backup''. Per FTP geht es dann rüber auf den Webhoster in das gleiche Verzeichnis. Eventuell muss man erst eine leere Datenbank über das Portal des Webhosters anlegen. Dann können wir wiederum ''mysqldumper'' aufrufen und die eben gesicherten Daten auf den neuen Server 'zurückspielen'. Im Menupunkt //'Wiederherstellung'// erscheint jetzt unsere Sicherungsdatei zur Auswahl. Einfach selektieren und Button //'Wiederherstellen'// drücken. Mit Hilfe von ''phpmyadmin'' läßt sich am Ende der Erfolg überprüfen.
+Richten wir direkt PHP passend ein.\\
+{{:howto:webhoster1_3_php.jpg?direct|}}
+  * PHP aktivieren
+  * Version ruhig so hoch wie möglich wählen. Leider ist bei aktuellen Version kein FPM mehr möglich, bei FastCGI gab es schon Probleme beim Redirekt durch den Webserver.
+  * ''open_basedir'' bietet zwei mögliche Voreinstellungen. Bei Netcup die Alternative wählen.
-=== Umzug der Skripte ===
+===== Composer =====
-Bei alfahosting gibt es das Verzeichnis ''/html'', wohin alle http Aufrufe hingehen. Dies ist unser Zielverzeichnis. Nun per FTP die folgenden Directories (inkl. Sub-DIR) kopieren:
+Wir müssen Composer (Paketmanager für PHP) installieren und ausführen. Dafür gibt es zwei Wege (je nach Hoster und Plesk-Version)
-  * ''/var/www/vz/htdocs/* ⇒ /html/htdocs/*''
-  * ''/var/www/vz/etc/* ⇒ /html/etc/*''
-  * ''/var/www/vz/lib/* ⇒ /html/lib/*''
-  * ''/var/www/vz/misc/* ⇒ /html/misc/*''
-  * ''/usr/local/lib/volkszaehler.org/doctrine/* ⇒ /html/volkszaehler.org/doctrine/*''
-  * ''arial.ttf ⇒ /files/fonts/TrueType/arial.ttf'' (wird nur für ''jpGraph'' benötigt)
-===== Anpassungen =====
+==== Plesk ====
-Nun ist ein bisschen Tipp-Arbeit an den Skripten erforderlich.
+Wie schon erwähnt gib es teilweise schon die Möglichkeit Composer per Klick einzubinden.\\
-== ''/html/etc/volkszaehler.conf.php'' ==
+<note>Ist die Website über "hosting-Einstellungen" deaktiviert wird diese Option nicht angeboten.</note>
-<code>
+{{:howto:webhoster1_b_composer.jpg?direct|}}\\
-...
+Ist ziemlich selbsterklärend, einfach den Anweisungen folgen.\\
-// Benutzername (wird vom Webhoster vergeben)
+{{:howto:webhoster1_c_composer.jpg?direct|}}
-$config['db']['user'] = 'webxxx';
+<note important>Falls die Scripte nicht korrekt ausgeführt werden den Composer von "Produktionsumgebung" auf "Entwicklungsumgebung" umstellen.</note>
-...
-// zugehöriges Password
+==== SSH Zugang ====
-$config['db']['password'] = 'password';
+Wir richten uns einen Nutzer für SecureShell ein.\\
-...
+{{:howto:webhoster1_4_zugang.jpg?direct|}}
-// Name der Datenbank (auch vom Webhoster beim Anlegen vergeben)
+  * Name uns sicheres Passwort wählen
-$config['db']['dbname'] = 'usr_webxxx_1';
+  * Am Ende der Seite (auf dem Bild abgeschnitten) stehen die URL über man z.B. per [[https://www.putty.org|Putty]] Zugang bekommt.
-...
+{{:howto:webhoster1_5_ssh.jpg?direct|}}
-// das gleiche noch mal für Admin
+  * Die Zugangsdaten entsprechend eintragen, in dem Fall [[https://winscp.net/|WinSCP]].
-$config['db']['admin']['user'] = 'webxxx';
+  * Einloggen
-$config['db']['admin']['password'] = 'password';
+  * Composer installieren und ausführen:
-...
+<code bash>
-// den absoluten Pfad zum /html Verzeichnis gibt es auch vom Webhoster
+cd /tmp
-$config['lib']['doctrine'] = '/var/www/webxxx/html/volkszaehler.org/doctrine';
+curl -sS https://getcomposer.org/installer | php
-$config['lib']['jpgraph'] = '/var/www/webxxx/html/lib/vendor/jpgraph';
+mkdir /composer
-...
+mv composer.phar /composer
+chmod +x /composer/composer.phar
+cd /volkszaehler
+php /composer/composer.phar install
 </code>
-== ''/html/etc/volkszaehler.conf'' ==
+===== Datenbank =====
-<code>
+Richten wir nun die Datenbank ein.\\
-// Old: Alias /volkszaehler.org /usr/share/volkszaehler.org/htdocs
+{{:howto:webhoster1_6_dberstellen.jpg?direct|}}
-Alias /volkszaehler.org /html/htdocs
+  * Name wählen, der vordere Teil ist vom Hoster fest definiert.
+  * IP notieren, die brauchen wir gleich noch (bei Netcup kann auf die dargestellte IP nur innerhalb der Serverfarm zugegriffen werden, für Zugang von außen die Doku sichten).
+  * Als zugehörige Website die Subdomain wählen
+  * Username wählen, auch hier ist ein Teil vom Hoster definiert
+  * sicheres Passwort wählen
+  * Zugriffsteuerung belassen. Schränkt man auf lokale Verbindungen ein ist bei Netcup gar kein Datenbankzugriff mehr möglich.
+Der automatisch erstellte User hat vollen Schreib- und Lesezugriff auf die neue, ihm zugewiesene Datenbank.\\
+{{:howto:webhoster1_9_datenbank.jpg?direct|}}\\
+Falls ein Abzug einer vorherigen Datenbank verfügbar ist kann man den an der Stelle direkt hochladen und importieren.
-// Old: <Directory /usr/share/volkszaehler.org>
+===== Config =====
-<Directory /html>
+Ist die Datenbank eingerichtet passen wir die VZ-Konfiguration darauf an. Über den Dateimanager ''/volkszaehler/etc/config.dist.yaml'' öffnen.\\
-...
+{{:howto:webhoster1_7_config.jpg?direct|}}
-</code>
+  * IP-Adresse des Datenbankserves eintragen
+  * vollständigen Usernamen eintragen
+  * Passwort im Klartext eintragen
+  * vollständigen Datenbanknamen eintragen
+  * selben User mit Passwort nochmal eintragen für administrative Schreib- und Löschzugriffe
+  * Datei speichern als ''config.yaml''
+{{:howto:webhoster1_8_configspeichern.jpg?direct|}}
-== ''/html/middleware.php'' ==
+===== Datenbank erstellen =====
-<code>
+Ist keine Datensicherung einer vorhergegangen Datenbank vorhanden müssen wir die Struktur noch erstellen.\\
-...
+Dazu nochmal per SSH einloggen und doctrine ausführen.
-// change VZ path
+<code bash>
-// old: define('VZ_DIR', realpath(__DIR__ . '/..'));
+cd /volkszaehler
-define('VZ_DIR', '/var/www/webxxx/html');
+php bin/doctrine orm:schema-tool:create
-...
 </code>
+Schlägt der Schritt fehl liegt ein Fehler in der zuvor erstellten Konfigurationsdatei vor.
-== ''/html/lib/Util/Random.php'' ==
+An der Stelle können wir auch direkt die Tabellen für die Aggregation anlegen lassen
-Der folgende Part muss auskommentiert werden, da ''/dev/urandom'' auf dem WebHoster nicht zur Verfügung steht.
+<code bash>
-Sonst gibt es Probleme bei der Erstellung neuer Kanäle.
+php /volkszaehler/bin/aggregate run -m full -l day -l hour -l minute
-<code>
-...
-	public static function init() {
-//		if (is_readable('/dev/urandom')) {
-//			self::$source = fopen('/dev/urandom', 'rb');
-//			self::$func = 'fRead';
-//		}
-...
 </code>
+<note>Falls hier ein Fehlermeldung wegen falscher PHP-Version kommt direkt auf [[howto:installation_auf_webhoster#aggregation|"Geplante Aufgaben"]] ausweichen. Dort kann man die PHP-Version auswählen, für PHP-CLI ist das nicht möglich.</note>
-== ''jpGraph'' ==
+===== Stammverzeichnis =====
-Falls ''jpGraph'' verwendet wird, muss das Directory ''/files/tmp/jpgraph_cache'' noch angelegt und die folgende Modifikation durchgeführen werden:
+Zum Abschluss passen wir das Stammverzeichnis der Subdomain an unsere Verzeichnisstruktur an.\\
-Datei: ''/htmp/lib/vendor/jpgraph/jpg-config.inc.php''
+{{:howto:webhoster1_a_stamm.jpg?direct|}}\\
-<code>
+Das Frontend sollte nun zur Verfügung stehen und neue Kanäle anlegbar sein, bzw. alte Kanäle sollten abonniert werden können.\\
-...
+Erscheint stattdessen eine Fehlermeldung wie\\
-define('CACHE_DIR','/var/www/webxxx/files/tmp/jpgraph_cache/');
+{{:howto:webhoster1_fehlermeldung.jpg?400|}}\\
-define('TTF_DIR','/var/www/webxxx/files/fonts/TrueType/');
+ist [[howto:installation_auf_webhoster#fehlersuche|Fehlersuche]] notwendig.
-define('MBTTF_DIR','/var/www/webxxx/files/fonts/TrueType/');
-...
+===== Rewrite? =====
+Etwas Schwierigkeiten macht bei Hostern gerne der Rewrite, aus Sicherheitsgründen sind unsere Möglichkeiten da recht eingeschränkt. Ein Ansatz das in Griff zu bekommen war bei PHP den FPM statt FastCGI zu nutzen. Der ist allerdings aus der Mode gekommen und wird teils nicht mehr angeboten.\\
+Funktioniert der Rewrite also nicht wie gewünscht besteht die Möglichkeit die Middleware umzukonfiguriern das sie weitestgehend ohne auskommt. Dazu in ''/volkszaehler/htdocs/js/options.js'' die Zeile 42 von
+<code js | /volkszaehler/htdocs/js/options.js>
+url: 'api'
+</code>
+ändern zu:
+<code js>
+url: 'middleware.php'
 </code>
-===== Ergebnis =====
+===== vzlogger =====
-Das Ergebnis ist dann über
+Jetzt folgt die Anpassung (bzw. Erstellung) der 'vzlogger.conf' auf dem System, das die Daten senden soll.
-<code>
-http://<domain name>/htdocs/frontend
+Falls der ''vzlogger'' schon brav seinen Dienst verrichtet, braucht man lediglich in der Konfigdatei
+<code>"middleware": "http://localhost/middleware.php",</code>
+den Middlewarepfad auf ''<nowiki>http://volkszaehler.domain.tld/middleware.php</nowiki>'' anpassen, den Prozess per ''systemd'' stoppen und neu starten.
+===== Aggregation =====
+Auch wenn beim Hoster die erforderliche Leistung bei Anfragen über große Zeiträume kein Problem darstellt ist es dennoch nicht verkehrt die Aggregation der Middleware einzurichten.\\
+{{:howto:webhoster1_d_geplanteaufgaben.jpg?direct|}}\\
+Die Anzahl der "cronjobs" ist bei Webhostern oft eingeschränkt. Man kann aber Problemlos alle 3 Aggregationsstufen in einen Aufruf packen.
+{{:howto:webhoster1_e_aggregation.jpg?direct|}}\\
+Benachrichtigung (Email) bei Fehler ist ratsam, sonst versickern Störungen unbemerkt im Logfile.
+===== Fehlersuche =====
+Wenn es nun doch nicht wie gewünscht funktioniert:
+  - An die URL das Unterverzeichnis ''/frontend/'' anhängen. z.B. [[http://demo.volkszaehler.org/frontend/]] Wird diese URL nicht aufgelöst liegt ein Problem beim Rewrite vor.
+  - Die Middleware ohne Einfluss von Frontend kann man über direkten Aufruf eines Kanal prüfen: z.B. [[http://demo.volkszahler.org/middleware.php/data/7d3aa8c0-9e87-11e6-878f-b724ca3bd16b.json]]
+  - Ob die Middleware auf die Datenbank zugreifen kann prüft man mit einem Aufruf wie z.B. [[http://demo.volkszaehler.org/middleware.php/capabilities/database.json?]]. Sehr wahrscheinlich ist die Konfiguration der Middleware falsch.
+    - Eine Antwort wie ''{"version":"0.3","capabilities":{"database":{"data":{"rows":0,"size":49152},"aggregation":{"rows":0,"size":49152,"ratio":0}}}}'' ist IO
+    - Sowas ''{"version":"0.3","exception":{"message":"Class \"Doctrine\\Common\\Annotations\\AnnotationRegistry\" not found","type":"Error","code":0}}'' deutet auf Probleme mit Composer hin (Entwicklungsumgebung?).
+    - Bei ''{"version":"0.3","exception":{"message":"An exception occurred in driver: SQLSTATE[HY000] [2002] Connection refused","type":"ConnectionException","code":0}}'' sind die Serverdaten (IP, Port) falsch.
+    - Mit falschen Zugangsdaten bekommt man ''{"version":"0.3","exception":{"message":"An exception occurred in driver: SQLSTATE[HY000] [1045] Access denied for user 'xxxx'@'xxxx' (using password: YES)","type":"ConnectionException","code":0}}''
+  - Zielführendere Diagnose bei DB-Zugriffsfehler erhält man auch wenn man die PHP-Fehlerausgabe über den http aktiviert und die Datenbank mit einem kurzen Skript direkt anspricht:
+<code php>
+<?php
+$servername = "localhost";
+$username = "vz";
+$password = "demo";
+$database = "volkszaehler";
+$conn = new PDO("mysql:host=$servername;dbname=$database", $username, $password);
+$sql = ("SELECT * FROM entities");
+foreach ($conn->query($sql) as $row) {
+   echo $row['uuid']."<br />";
+}
+?>
 </code>
-erreichbar. Zur Vereinfachung kann man eine Sub-Domain anlegen (lassen), die direkt auf ''htdocs'' verweist. Wer das mal auf meinem WebServer ausprobieren will: [[http://vz.rbulla.de]]. Die UUID für die Außentemperatur (in Langenfeld) lautet: ''e62976c0-7109-11e1-a585-8762f86249c1''
+===== Update =====
+Die Aktualisierung aus dem Git über einen der Knöpfe im Webhostingportal anstoßen.\\
+{{:howto:webhoster1_x_gitupdate.jpg?direct|}}\\
+Danach den Composer aktualisieren. Dabei immer bei dem Weg bleiben den man bei der Installation gewählt hatte. Also entweder per Knopfdruck in Plesk oder SSH:
+<code bash>
+cd /volkszaehler
+php /composer/composer.phar update
+</code>