====== Push-Server ======
{{ :software:middleware:pushserver_comparison.jpg?250|}}
Der Push-Server (PS) ist ein Dienst der Teile der Middleware nutzt um Echtzeitwerte an Clients auszuliefern. Quelle für die Rohdaten ist der vzlogger. Ausgeliefert werden aber nur Daten von Kanälen die in der Middleware konfiguriert sind.\\
Im Git ist eine tiefer gehende Beschreibung verfügbar: [[https://github.com/volkszaehler/volkszaehler.org/blob/master/bin/README.md|./bin/README.md]]

Ziel der Daten können das Frontend oder andere Clientanwendungen wie z.B. [[https://nodered.org|Node-RED]] sein.\\
Beim VZ-Frontend liegt der Mehrwert darin hochauflösende Daten darzustellen ohne die Datenbank mit diesen Daten zu "belasten". In der Regel ist eine solche Detailtiefe ein Jahr später nicht mehr von Interesse, von daher brauchen sie auch nicht gespeichert werden.

<note warning>**Sicherheitshinweis:** Der Push-Server liefert die Daten **aller** Kanäle an die verbunden Clients aus. Unabhängig davon ob sie abonniert, nicht abonniert, als öffentlich oder privat konfiguriert sind.</note> 
===== Konfiguration =====
Um den PS zu nutzen sind ein paar Änderungen an (alter) Middleware, PS-Systemdienst, vzlogger und Frontend nötig.

==== Middleware ====
Seit Version 2.0 der Middleware ist der Empfang vom PS-Daten schon standardmäßig eingerichtet, dieser Punkt kann daher übersprungen werden.

In älteren Versionen muss er noch aktiviert werden:
<code | volkszaehler.conf.php>
/**
 * Push server settings
 */
$config['push']['enabled'] = true;
</code>

Die übrigen Parameter kurz erläutert:
<code | volkszaehler.conf.php>
$config['push']['server'] = 5582;                       // vzlogger sendet an diesen Port (angebunden an IP 0.0.0.0)
$config['push']['broadcast'] = 8082;                    // frontend abonniert an diesem Port (angebunden an IP 0.0.0.0)
$config['push']['routes']['wamp'] = array('/', '/ws');  // Route für WAMP-Zugriff (Frontend)
$config['push']['routes']['websocket'] = array();       // Route für einfache Websockets (z.B. Note-RED), Empfehlung: array('/socket')
</code>

Gestartet wird der PS an der Konsole mit:
<code>php /var/www/volkszaehler.org/bin/push-server</code>
Es ist aber besser stattdessen einen vollwertigen Hintergrunddienst (z.B. über Systemd) einzurichten.

==== Systemd ====
Für Debian (Raspberry-Image) ist der Hintergrunddienst folgendermaßen einzurichten:
<code>sudo nano /etc/systemd/system/push-server.service</code>
Inhalt der Datei:
<code | push-server.service>
[Unit]
Description=Volkszaehler.org Push-Server
After=syslog.target network.target
Requires=

[Service]
ExecStart=/usr/bin/php /var/www/volkszaehler.org/bin/push-server
ExecReload=/bin/kill -HUP $MAINPID
StandardOutput=journal
Restart=always

[Install]
WantedBy=multi-user.target
</code>

Den Dienst beim Boot aktivieren:
<code>sudo systemctl enable push-server</code>
Den Dienst starten:
<code>sudo systemctl start push-server</code>

==== Vzlogger ====
Die folgenden Zeilen in die vzlogger-Konfiguration einfügen:
<code | vzlogger.conf>
"push": [
  {
    "url": "http://127.0.0.1:5582"
  }
],
</code>

Vzlogger neu starten:
<code>sudo systemctl restart vzlogger</code>

==== Frontend ====
Nun muss das Frontend die Daten nur noch entgegen nehmen. 
<code>sudo nano /var/www/volkszaehler.org/htdocs/js/options.js</code>
Die entsprechend Option ist bereits vorbereitet, die Kommentarzeichen entfernen und auf korrekte Syntax achten. 
<note important>Die Zeile vorher muss mit einem Komma abschließen!</note>
<code | options.js>
	middleware: [
		{
			title: 'Local (default)',
			url: 'api',
			live: 8082
</code>

===== Hinweise =====
Angezeigt werden die empfangenen Werte im Zuge der automatischen Aktualisierung.

Daten, die der PS ausliefert werden vom Frontend nicht gespeichert. Wird das Browserfenster geschlossen oder die Darstellung manipuliert sind die Werte verloren und es wird auf Daten zurückgegriffen, die in der Datenbank hinterlegt sind.