Client benutzen und typische Konfigurationsfehler bei Server und Clients

Nach Download und Installation des Clients kann's endlich praktisch werden!

Anwendung starten

Der Client sieht beim ersten Öffnen so aus:

Mit Server(n) 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 (SCAN 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
• eine IPv6-Adresse, ohne Port, z.B. [2003:f3:1736:db00:3e10:77ba:cb8b:6633]
• eine IPv6-Adresse, mit Port, z.B. [2003:f3:1736:db00:3e10:77ba:cb8b:6633]:59661

Die stabilste Art und Weise der Verbindung kann dir dein FabAccess-Administrator des Vertrauens mitteilen. Wir verbinden uns mit dem Button CONNECT TO SERVER. Das Verbinden dauert in der Regel ein paar Sekunden - je nach Leistungsfähigkeit des Servers, des Clients, des Netzwerks und der Komplexität der Gesamtkonfiguration des Systems.

Nach dem Verbinden: 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 (LOGIN WITH PASSWORD)
  
• mit Karte einloggen (LOGIN WITH CARD) - aktuell nicht funktional ???
  
• Account anlegen, also neu registrieren (REGISTER) - aktuell nicht funktional ???
  

 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 (genauer gesagt Ressourcen) 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.

Ein praktischer Button ist der große ganz oben: es ist möglich eine Ressource direkt aufzurufen, indem wir einen speziell formatierten QR-Code beispielsweise von einem gedruckten Sticher scannen (SCAN QR-CODE).

Eine Ressource bedienen

Nach Auswahl einer Ressource aus der Maschinenübersicht gibt es verschiedene Handlungen, die ein Nutzer ausführen kann:

• Benutzen (USE) oder zurückgeben, falls gerade in der eigenen Benutzung (GIVEBACK)
• Wiki-Link öffnen (falls eine URL hinterlegt wurde) - hier öffnet sich ein Browser im Vollbildmodus
  
• Falls die Manager-Rolle zur Verfügung steht:
  • Maschine freigeben (erzwungene Rückgabe) (FREE MACHINE)
  • Maschine reservieren (BLOCK MACHINE)
    
  • Maschine blockieren (z.B. für eine anstehende Wartung oder weil ein Defekt eingetreten ist) (DISABLE MACHINE)

In der rechten oberen Ecke ist zudem der aktuelle Zustand der Ressource erkennbar, z.B. Free, In Use, Blocked, Disabled

Eine hilfreiche Information ist außerdem auch die Anzeige, welcher Nutzer die Ressource zuletzt benutzt hat (Last User).

Benutzer verwalten

Dieses Menü obliegt der Rolle des Administrators bzw. Managers und erlaubt das Filtern (Search User), sowie das Anpassen oder Löschen (DELETE) bestehender Nutzer (Rollen zuweisen, Passwort zurücksetzen per FORCE PASSWORD RESET) und das Anlegen neuer Nutzer (ADD NEW USER). Beim Anlegen eines neuen Nutzers können lediglich Benutzername und Passwort konfiguriert werden. Etwaige Keycard-Codes müssen durch den Administrator in der users.toml Konfiguration hinterlegt werden. Das Löschen bestehender Nutzer erfolgt mit Bestätigungsdialog.

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.Selbstverständlich können unbenötigte Verbindungen entfernt werden (DELETE). Das Löschen erfolgt mit Rückvergewisserungsdialog zur Bestätigung des Vorgangs.

 

Profil verwalten

Die eigene Profilverwaltung ist relativ übersichtlich. Hier kann lediglich das Passwort neu gesetzt werden. Das Ändern des Namens muss vom Administrator beauftragt werden.

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.