FrontFace 5 Benutzerhandbuch

Für die Installation der FrontFace Player App auf den verschiedenen Betriebssystemen stehen entsprechende Installationspakete bereit.

Generell wird jede Installation der FrontFace Player App über eine automatisch vergebene Player-ID identifiziert, welche zusammen mit der ebenfalls automatisch generierten Player-PIN (sollte geheim gehalten werden) für die Publizierung verwendet wird.

Nach dem Abschluss der Installation auf der jeweiligen Plattform (s.u.) starten Sie die FrontFace Player App und führen die Ersteinrichtung durch.

Windows

Führen Sie die Installationsdatei (für Windows) aus und wählen Sie im Installations-Assistenten die Variante „Standard-Installation“ und zusätzlich die Option „Nur die FrontFace Player App installieren“ aus.

Android

Stellen Sie das Installationspaket (APK-Datei) auf dem Android-Gerät bereit, z.B. mit einer SD-Karte oder einem USB- Stick. Öffnen Sie eine Datei-Explorer-App und führen Sie die APK-Datei aus. Je nach Android-Version kann es erforderlich sein, zunächst die Installation aus externen Quellen (das sog. Sideloading) zu aktivieren.

Linux

Wir empfehlen die Verwendung der Linux-Distribution „Ubuntu“. Stellen Sie sicher, dass die .NET 10 Core Runtime installiert ist. Falls dies nicht der Fall ist, verwenden Sie folgenden Befehl, um diese zu installieren:

sudo apt-get install -y dotnet-runtime-10.0

Voraussetzung: Benutzer-Namespaces aktivieren (Ubuntu/Debian)

Die Browser-Engine wird aus Sicherheitsgründen in einer Sandbox ausgeführt, wofür User Namespaces benötigt werden. Ab Debian 10 und ab Ubuntu 23.10 sind diese standardmäßig deaktiviert und müssen einmalig aktiviert werden:

Führen Sie die folgenden Befehle passend für Ihre Plattform einmalig aus, damit FrontFace korrekt startet:

Ubuntu 23.10 oder höher:

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
echo 'kernel.apparmor_restrict_unprivileged_userns=0' | sudo tee -a
/etc/sysctl.d/99-enable-unprivileged-userns.conf

Debian 10 oder höher:

sudo sysctl -w kernel.unprivileged_userns_clone=1
echo 'kernel.unprivileged_userns_clone=1' | sudo tee -a
/etc/sysctl.d/99-enable-unprivileged-userns.conf

Entpacken Sie das FrontFace-Installationspaket (.tar.gz-Datei) an einem geeigneten Ort (e.g., “/home/<username>/frontface”):

tar -xzf frontface5-onprem.tar.gz

Zum Starten der FrontFace Player App, führen Sie folgenden Befehl aus:

./FrontFace.Player.Linux

Kiosk Mode

Bevor Sie die GNOME Kiosk-Umgebung installieren, sollten Sie zunächst den SSH-Zugriff auf das System aktivieren, da dies die weitere Konfiguration und Fehlerbehebung erheblich erleichtert.

Um FrontFace im Kiosk-Modus auszuführen, müssen Sie zunächst die Gnome-Kioskumgebung installieren:

sudo apt install gnome-kiosk gnome-kiosk-script-session

Bearbeiten Sie dann die Accounts-Service-Datei des Users, welcher für den Kiosk-Modus verwendet werden soll:

sudo nano /var/lib/AccountsService/users/<username>

[User]
#Session=ubuntu
Session=gnome-kiosk-script-wayland
Icon=/home/<username>/.face 
SystemAccount=false

[InputSource0] 
xkb=de

Um den Kiosk-Modus zu verlassen und zur GNOME-Shell zurückzukehren, kommentieren Sie die Zeile Session=gnome-kiosk-script-wayland aus, indem Sie am Anfang ein # hinzufügen, und aktivieren Sie Session=ubuntu wieder, indem Sie das führende # entfernen. Anschließend muss das System über SSH neu gestartet werden, damit die Änderung wirksam wird.

Passen Sie dann das Gnome Kiosk Script so an, dass FrontFace automatisch gestartet wird und im Fehlerfall auch automatisch neugestartet wird:

nano ~/.local/bin/gnome-kiosk-script

#!/bin/sh

DOTNET="/usr/bin/dotnet"  
APP_DIR="/home/<username>/frontface" 
APP_DLL="FrontFace.Player.Linux.dll" 
LOGFILE="/home/user/kiosk-dotnet.log"

cd "$APP_DIR" || exit 1

"$DOTNET" "$APP_DLL" >> "$LOGFILE" 2>&1

sleep 1  
exec "$0" "$@"

Sollte der Ordner ~/.local/bin oder die darin enthaltene Datei gnome-kiosk-script nicht existieren, müssen Sie diese manuell anlegen. In der Regel wird der Ordner samt Beispielskript beim erstmaligen Ausführen des Kiosk-Modus automatisch erstellt. Nutzen Sie andernfalls folgenden Befehl: mkdir -p ~/.local/bin && touch ~/.local/bin/gnome-kiosk-script && chmod +x ~/.local/bin/gnome-kiosk-script

Zurücksetzen

Wenn Sie Probleme mit FrontFace haben, können Sie die Einstellungen über das Maintenance-Menü zurücksetzen, sodass die Anwendung komplett neu/leer startet. Sollte das Problem jedoch so schwerwiegend sein, dass die FrontFace Player App gar nicht mehr startet, müssen Sie folgende Verzeichnisse löschen:

Windows:

C:\ProgramData\mirabyte\FrontFace Player
C:\ProgramData\mirabyte\FrontFace Server

Android:
Bitte beachten Sie, dass diese Ordner unter Android nicht manuell gelöscht werden können. In diesem Fall besteht die einzige Möglichkeit darin, die APK neu zu installieren.

Linux:
~/.local/share/mirabyte

Sollten Sie den externen Server auf demselben PC wie den Player nutzen, achten Sie darauf, den Ordner "FrontFace Server" nicht zu löschen.