Client benutzen und typische Konfigurationsfehler bei Server und Clients
Mit Servern verbinden (Connect to Server)
Das Verbinden mit einem FabAccess BFFH Server kann durch Eingabe des Hosts erfolgen. Entweder ist die Adresse bekannt und wird manuell angegeben oder ein QR-Code wird gescannt. Der QR-Code enthält den Host im Plaintext-Format (keine URN-Syntax wie bei Ressourcen notwendig). Die Hostadresse erlaubt verschiedene, übliche Formate. Zum Beispiel:
- FQDN, ohne Port (z.B.
demo.fab-access.org
) - FQDN, mit Port (z.B.
demo.fab-access.org:59661
) - ein Hostname aus dem lokalen Netzwerk, ohne Port, z.B.
fabaccess.local
- ein Hostname aus dem lokalen Netzwerk, inkl. Port, z.B.
fabaccess.local:59661
- eine IPv4-Adresse, ohne Port, z.B.
192.168.188.31
- eine IPv4-Adresse, mit Port, z.B.
192.168.188.31:59661
Die stabilste Art und Weise der Verbindung kann dir dein FabAccess-Administrator des Vertrauens mitteilen.
Nach dem VerbindenVerbinden: (Einloggen
Nach erfolgreicher Verbindung zum Server erfolgt der nächste Screen, der nach Login-Daten fragt. Hier gibt es drei Interaktionsmöglichkeiten:
- Mit Passwort einloggen
- mit Karte einloggen
- Account anlegen, also neu registrieren
Hauptmenü)
Ist der Nutzer mit dem Server verbunden, so hat er verschiedene Möglichkeiten der Interaktion. Zum einen kann die Maschinenübersicht (MACHINES
) aufgerufen werden. Ist der Nutzer Administrator, so können auch serverweit die Benutzer verwaltet werden (USERS
). Außerdem kan das eigene Profil angepasst werden (MY PROFILE
). Zudem gibt es eine Übersicht über alle auf dem Endgerät aktuell konfigurierten Serververbindungen (SERVERS
: Borepin kann mit mehreren Servern bzw. auch je Server mit verschiedenen Benutzern verbunden werden).
Maschinenübersicht
Die Maschinenübersicht zeigt alle für den Nutzer sichtbaren Geräte an (Berechtigung disclose
), getrennt nach Kategorie bzw. Raum, Zone oder Sektor. Die Übersicht zeigt an, welche Geräte vom Benutzer gerade in Benutzung sind (In Use by Me
), sowie welche Ressourcen noch frei (Free
) oder durch jemand anderen gerade in Benutzung sind (In Use
). Die Ansicht aktualisiert sich nicht automatisch - dafür gibt es den Button REFRESH
.
Servers - Verbindungen managen
In diesem Menü werden alle Verbindungen (Server + Login) angezeigt, die erfolgreich zum Borepin Client hinzugefügt wurden (Historie). Es wird auch die aktuell genutzte Verbindung angezeigt. Hier kann eine Verbindung ausgewählt und als Standardverbindung gesetzt werden. Außerdem können wir uns hier auch vom aktuellen Server abmelden.
Probleme mit dem Client
"Connection failed. Connection time exceeded."
Ein Typischer Fehler und dieser kann verschiedene Gründe haben. Prüfen:
- läuft der BFFH Server? Log bzw. Journal überprüfen!
- läuft der MQTT Server? Log bzw. Journal überprüfen!
- Laufen MQTT und BFFH auf den korrekten Netzwerk-Interfaces?
- ist die Client Version mit dem Server kompatibel?
- möglicherweiser gibt es ein Port-Problem auf dem Client (Firewall überprüfen!)
- Tipp: Verbindung mit telnet prüfen:
telnet fabaccess.local 59661
"Connection failed. Unable to connect to server."
Dieser Fehler drückt aus, dass der Server nicht per DNS auflösbar ist. Hier ist es sinnvoll verschiedene Verbindungskonstellationen durchzuprobieren, zum Beispiel:
- fabaccess
- fabaccess.local
- fabaccess:59661
- fabaccess.local:59661
- 192.168.188.1:59661
- sonstige FQDNs
- Tipp: Verbindung mit telnet prüfen:
telnet fabaccess.local 59661
Unter Umständen wird der Fehler auch hervorgerufen, weil der Client mit einem VPN-Netwerk verbunden ist und es Konflikte in der DNS-Auflösung oder IP-Adressbereich gibt.