====== System - Realtime Server ======
<WRAP center round important 90%>
Ab X2 12.10 ist dieser nicht mehr notwendig und wird auch nicht mehr genutzt.
</WRAP>

:!r: Der Server ist in untermStrich X.1 ab Version 11.5 bis X2 Version 12.6 verfügbar. 

Der Realtime Server wird auf dem selben Rechner gestartet auf dem auch untermStrich X installiert ist. Er basiert auf :html: [[https://de.wikipedia.org/wiki/Node.js|Node.js]] und bietet verschiedene Funktionen zur Echtzeit Kommunikation zwischen PHP und den in untermStrich X eingeloggten Browsern der Clients.
== Installation ==
Nachdem der Butler installiert wurde muss die Node.js Komponente für das jeweilige Server Betriebssystem installiert werden. Dies kann direkt über den Bulter durchgeführt werden.
{{ :de:basics:basics:butler:download_install_nodejs.png?500 |}}

Ist Node.js installiert muss der Realtime Server noch konfiguriert werden.
Auch das passiert direkt über den Butler indem Sie in die Konfiguration des Butlers wechseln.
{{ :de:basics:basics:butler:config_nodejs.png?330 |}}
  * Beim Speichern wird die für den Zugriff auf den Webserver genutzte IP-Adresse in der Konfiguration abgelegt. Wenn sich die IP Adresse ändert oder beim ersten Speichern der Zugriff über localhost erfolgte, öffnen Sie nochmals die Konfiguration und Speichern sie diese.
  * :!: Als Port ist standardmäßig 3000 eingestellt. Der Port kann beliebig geändert werden. Stellen Sie sicher, dass der Port in Ihrer **Firewall** entsprechend freigegeben ist. Die Clients kommunizieren mit dem Server über diesen Port. Sind auf einem Server mehrere untermStrich X Installationen vorhanden, muss der Realtime Server für jede Installation auf einem eigenen Port gestartet werden.\\ 
  * Wenn Sie untermStrich mit HTTPS betreiben und das SSL Zertifikat direkt am Apache Server eingerichtet haben (also keinen ReverseProxy vorgeschaltet haben), müssen die Pfade zur SSL-Key und SSL-Cert Datei eingetragen werden. [[de:installation:ssl|Informationen zur SSL Konfiguration finden Sie hier.]]
  * Das LogLevel sollte standardmäßig auf "Error" eingestellt bleiben.

== Realtime Server starten ==
Der Server sollte einfach über die "Server starten" Schaltfläche gestartet werden. Bei einem untermStrich X Update wird er automatisch neu gestartet.
{{ :de:basics:basics:butler:start_nodejs.png?500 |}}
Alternativ kann der Realtime Server auch mit dem angezeigten Befehl am Server gestartet werden.

== Auf Realtime Server basierende Funktionen ==
  * Butler: [[de:basics:basics:butler:chat|Chat]]
  * Butler: [[de:basics:basics:butler:list_of_employees#auf_realtime_server_basierende_funktionen|Mitarbeiterliste]]
  * Butler: [[de:basics:basics:butler:crm#auf_realtime_server_basierende_funktionen|CRM]]