EisBär 4.0 - Server Konsole
Der EisBär Server läuft als Systemdienst auf dem installierten Rechner. Der Dienst ist auf "Automatisch (Verzögerter Start)" voreingestellt, d.h. bei Rechnerstart, wird der EisBär Server automatisch ca. 2 Minuten verzögert gestartet. Dies geschieht auch ohne Benutzeranmeldung. Der verzögerte Start ist nötig, um die Netzwerkverbindung vor Start des EisBär-Dienst zu etablieren.
Meldungen in Zusammenhang mit dem EisBär Server werden in der Windows Ereignisanzeige unter Windows-Protokolle\Anwendung gespeichert. Als Quelle wird EisbaerServerWindowsService verwendet.
Hinweis: Bei virtuellen Umgebungen bitte die Hinweise im Kapitel USB-Dongleserver beachten.
Mappe:
Der EisBär Serverdienst wird mit der EisBär - Server Konfigurationskonsole eingerichtet. Zum Öffnen der Konsole werden Administratorrechte benötigt. Einstellungen in der Konsole sind nur bei gestopptem Service möglich.
Bezeichnung |
Beschreibung |
|---|---|
IP-Adresse |
Im Server-PC muss eine feste IP-Adresse eingestellt sein, damit die Clients (Windows, WebApp und MobileApp) jederzeit auf den Server zugreifen können. Falls der Server und der Client die selbe Maschine ist und keine weitere Clients benötigt werden, kann auch die IP 127.0.0.1 (lokal Host) eingestellt werden. Damit kann aber kein anderer Client den Server erreichen. |
Mappe / Projekt |
Speicherpfad zum Projekt, welches der Dienst laden soll. Bei Projekt wird die ".EisbaerV4Solution" Datei des Projektes ausgewählt. |
System Zustand speichern und laden |
Ist diese Option gesetzt, wird nach einem Neustart des Dienstes der letzte Zustand der Komponenten geladen. Ohne, werden alle Komponenten mit ihrem "undefiniert" Zustand angezeigt. |
Netzwerte speichern |
Durch das Speichern der Netzwerte ist es möglich durch einen rechten Mausklick auf eine beliebige Komponente im Client alle historischen Netzwerte abzurufen. |
Debug Daten speichern |
Für die Funktion, die Visualisierung auf einen bestimmten Zeitpunkt zurück setzen zu können, muss der Debug Speicher aktiv sein. |
Leere Netze speichern |
Hierdurch werden zusätzlich alle Netze mit einem Datenpunkt aufgezeichnet. Dadurch können historische Netzwerte mit der DS-Funktion des Plotters abgerufen werden obwohl diese nicht visualisiert sind. |
Nur umbenannte Netze |
Es werden nur Netzwerte von umbenannten Netzen gespeichert, manuell oder per Rechtsklick-Menü. Dies reduziert die Aufzeichnungsmenge und es werden nur die gewünschten Werte zur Analyse angezeigt. |
Ladestatus / Server Status |
Es gibt 3 Zustände: Server ist nicht gestartet, Start pending und Server ist gestartet. Ist der Server nicht gestartet (Projekt nicht geladen), kann die Visualisierung nicht im Client angezeigt werden. Wird der Dienst, durch drücken der Schaltfläche "Start Dienst", gestartet und das Projekt geladen, wechselt der Status zu "Start pending". Daneben werden die durchgeführten Schritte bis zum Start angezeigt. Dieser Vorgang darf nicht unterbrochen werden. Ist der Server fertig, wechselt die Anzeige auf "Projekt geladen". Projekte werden automatisch beim Starten des EisBär-Dienstes auf die installierte EisBär-Version aktualisiert, sofern der Projektstand mit einer älteren EisBär Version erstellt wurde. Dabei wird eine Sicherheitskopie im Projektordner unter dem Namen .../Backup erstellt (ZIP-Datei). Im EisBär Editor ist diese Funktionsweise identisch. Über Stopp Dienst wird das Projekt wieder entladen. Mit Restart Dienst wird der Dienst neu gestartet. Das Verhalten ist gleich mit Stopp und Start Dienst. |
Datenbank Status |
Beim Starten des Server-Dienst werden Datenbanken initialisiert und geladen. Der Zustand wird hier angezeigt. |
Verbindung Service |
Zeigt an, ob die Server Konsole mit dem Dienst selbst verbunden ist. |
Lizenz |
Zeigt an, ob die Lizenz gültig ist oder nicht. Die Lizenzdatei kann hier auch heruntergeladen werden. Es sind dann keine weiteren Maßnahmen erforderlich. Alternative manuelle Installation: Installieren Sie die „Eisbaer.EisD“-Datei über die Schaltfläche „Lizenz installieren“; hierzu den Dateityp *.* auswählen. Mit Dongle anzeigen wird die Lizenz-Nummer angezeigt. |
Server Ports:
Die Windows-Client Ports sind für den Zugriff des Eisbär Windows-Clients zuständig. Der Downloadport wird zusätzlich für den Up- und Download im Eisbär Editor verwendet. Bei Änderungen müssen diese Ports im Windows-Client und im Editor ebenfalls geändert werden.
Smart-Client Ports sind für den Zugriff der Eisbär Mobile-Apps unter IOS bzw. Android zuständig. Zusätzlich werden sie für den WebApp-/HTML-Zugriff per Webbrowser verwendet. Die Ports werden bei der Installation automatisch in der Firewall eingetragen/freigegeben. Bei Änderungen müssen diese in der Firewall oder bei Portweiterleitungen, usw. konfiguriert werden.
Hinweis:
Der EisBaer Dienst benötigt die Ports 808 und 3702 als "Listener" und "Discovery" Port für die Client/Server-Suche. Ohne den Port 808 lässt sich der Dienst nicht starten und ohne den 3702 findet kein Client den Server über die Suche. Alle Ports, welche in der Firewall eingetragen werden, sind unter Software-Setup aufgeführt.
http secure muss aktiviert werden, um eine verschlüsselte Übertragung zu verwenden. Durch anklicken von "http secure" wird der Dialog zum einbinden des Zertifikats geöffnet. Es gibt ein selbstsigniertes "EisBaer Default Zertifikat" alternativ können eigene private Zertifikate (mit Schlüssel-Icon) verwendet werden. Hierzu muss der Fingerabdruck/Thumbprint des verwendeten Zertifikats angegeben werden. Nach dem drücken der "Bind" Taste wird angezeigt, ob das Binden erfolgreich war.
Alternative Kontrolle über die Windows Eingabeaufforderung (cmd) : z.B. netsh http show sslcert ipport=0.0.0.0:8003
So rufen Sie den Fingerabdruck/Thumbprint eines Zertifikats ab
1. Öffnen Sie "Computerzertifikate verwalten"
2. Klicken Sie im linken Bereich des Fensters Konsolenstamm auf Zertifikate (Lokaler Computer).
3. Klicken Sie auf den Ordner Eigene/Persönlich Zertifikate, um ihn zu erweitern. Hier muss das Zertifikat installiert sein.
4. Klicken Sie auf den Ordner Zertifikate , um ihn zu erweitern.
5. Suchen Sie in der Liste der Zertifikate ihr Zertifikat. In der Spalte "Beabsichtigter Zweck" muss "Serverauthentifizierung" stehen.
6. Doppelklicken Sie auf das Zertifikat.
7. Klicken Sie im Dialogfeld Zertifikat auf die Registerkarte Details.
8. Verschieben Sie den Inhalt der Feldliste, und klicken Sie auf Fingerabdruck.
9. Kopieren Sie die hexadezimalen Zeichen aus dem Feld (Strg-C).
Die Portalserververbindung ist im Kapitel Portalserver beschrieben. Wenn kein Portalzugang vorhanden ist, muss der Autostart deaktiviert werden.
Server Monitor:
Im Server Monitor können alle Clients, welche mit dem EisBär Server Dienst verbunden sind, angezeigt werden. Die Anzeige besteht aus Computer-Name und dessen IP-Adresse.
Über "Start net traffic monitor" werden alle Netz-Kommunikationen aufgezeichnet. Die Anzeige besteht aus dem Zeitstempel, Netz-Name, interner Nummer und dem Wert, welches auf das Netz gesendet wurde.
Update:
In diesem Reiter wird die aktuelle und die verfügbare EisBär Version angezeigt. Über "Zeige Changelog" werden alle Neuerungen der EisBär Versionen angezeigt. Am Ende des Changelogs sind die Downloadlinks der bisherigen EisBär-Versionen hinterlegt.
Wird nach "Prüfe auf Updates" eine neuere Version gefunden, kann diese heruntergeladen und installiert werden.
Debug Dienst:
Mit diesem Dienst wird das ausgewählte Projekt im Debug-Mode gestartet. Somit ist es möglich, mit dem Client das Projekt zu laden (Achtung: andere Ports!) und die Zustände der Anlage zu gewisse Zeiten anzeigen zu lassen. Für den regulären Betrieb des Projektes wird dieser aber nicht benötigt.
QR Code:
Anzeige des QR-Codes, um mit der Android oder iOS App die Verbindungsdaten zu übernehmen. Dieser muss nur bei Änderung der IP-Adresse oder der Ports gescannt werden. Nicht bei Änderung des EisBär-Projekts.
Datenbank Konfiguration:
Im Reiter Backup werden die Backup Einstellungen für die Datenbank eingestellt.
"Starte Backup" erzeugt ein Backup. Während des Backups wird der Datenbank-Status "rot" (offline) angezeigt. Daten werden aber weiterhin gespeichert.
"Archiv (eine Datei)" bedeutet, dass das ganze Backup in eine Datei gespeichert wird.
Ist "Archiv (eine Datei)" nicht ausgewählt, besteht das Backup aus vielen Dateien, d.h. jede Collection, jeder Index usw.. wird als eigene Datei gespeichert. Diese werden in einem Unterordner gespeichert.
Bei "Überschreiben" wird das letzte Backup immer überschrieben und kein Zeitstempel an den Dateinamen, bzw. Ordnernamen angehängt. Es wird nur ein Stand gesichert.
Ohne "Überschreiben" wird ein Zeitstempel an die Namen angehängt. Wenn es mehr als die eingestellte Anzahl an Backups gibt, werden die ältesten gelöscht. Mehrere Backupstände sind möglich.
Unter "Automatisch alle x Tage" wird festgelegt ob oder in welchem Zeitabstand automatisch Backups angelegt werden.
Mit "Anzahl Backups"=0 wird die automatische Backupfunktion deaktiviert.
Speicherzeitpunkt ist um Mitternacht.
Einstellungen im Reiter Backup werden erst nach Serverneustart wirksam.
Reiter TTL
Hier wird das maximale Alter der gespeicherten Daten eingestellt.
Ältere Daten werden dadurch aus der Datenbank entfernt.
Einstellungen im Reiter TTL werden erst nach Server-Neustart wirksam.
Diagnose:
Im TAB Diagnose ist das Server-Logging aktivierbar. Nur im Fehlerfall und mit Rücksprache des Supports aktivieren! Darunter befindet sich die Auswahl für den Speicherort und das Log Level.
Zusätzlich ist hier die Installation des EisBär Dongle Fix und des KNX USB Fix möglich. Hierdurch werden die Energiespareinstellungen von Windows 10/11 geändert um den dauerhaften Zugriff auf KNX/USB Schnittstellen und den EisBär-Dongle zu gewährleisten.
Ist DB Logging eingeschaltet, wird eine Logdatei der Mongo Datenbank erstellt. Die Logdatei wird im Projektordner unter \PRJ0001\DBs\log\ angelegt.
MongoDB externer Benutzer Login:
User: Extern
Password: gNNMn05w