Peakboard hub
Installation
Der Peakboard Hub on premise wird lokal auf deinem Server gehostet und benötigt Windows Server ab mindestens Version 2016. IIS, die ASP.NET Core Runtime und das passende Hosting Bundle musst du nicht vorab installieren — das Setup richtet alles automatisch ein, was der Peakboard Hub on premise zum Laufen braucht. Es wird zu keinem Zeitpunkt eine Kommunikation nach außen hergestellt, sondern ausschließlich zwischen dem Nutzer, den Peakboard Boxen und dem Peakboard Hub on premise. Für die Authentifizierung kann der Windows Domain Controller (Active Directory) oder eine lokale Nutzerverwaltung genutzt werden. Die Datenhaltung des Peakboard Hub on premise findet in einem mitgelieferten SQL Server Express statt. Es kann aber auch ein bereits vorhandener SQL Server ab Version 2017 verwendet werden.
Systemvoraussetzungen
Der Server, auf dem der Peakboard Hub on premise betrieben wird, muss mindestens folgende Voraussetzungen erfüllen:
| Prozessor | 4 Kerne |
| Arbeitsspeicher | 32 GB RAM |
| Festplatte | 128 GB SSD |
| Betriebssystem | Windows Server 2016 oder höher |
Installation
Für die initiale Installation auf einem Windows Server benötigst du nur die Installationsdatei des Peakboard Hub on premise, die du hier herunterladen kannst. Starte die Datei anschließend mit Administratorrechten — der Installer führt dich in vier Schritten durch die Einrichtung.
Schritt 1 — Willkommen
Nach dem Start erscheint der Begrüßungsbildschirm. Klicke auf [Install Peakboard Hub] (1), um den Assistenten zu öffnen.
Schritt 2 — Komponenten auswählen
Im Schritt Choose components legst du fest, welche Bestandteile installiert werden sollen. Bereits installierte Komponenten sind standardmäßig abgewählt, sodass du sie bei einem Update überspringst.
- Peakboard Hub (web application) (1) — Die zentrale Webanwendung des Peakboard Hub. Bei einer Erstinstallation immer aktiviert lassen.
- Install Microsoft SQL Server Express (2) — Aktiviere die Option, wenn du noch keinen SQL Server zur Verfügung hast. Der Installer richtet dann eine lokale SQL Server Express Instanz ein. Wenn du einen bereits vorhandenen SQL Server nutzen möchtest, lass die Option abgewählt.
- Peakboard Hub Public API (3) — Optionale REST-Schnittstelle, mit der du den Peakboard Hub aus anderen Systemen heraus ansprechen kannst.
Klicke anschließend auf [Next].
Schritt 3 — User Authentication
In diesem Schritt legst du fest, gegen welches Backend der Peakboard Hub on premise die Logins prüft. Die Wahl entscheidet, woher die Identitäten deiner Anwender kommen — vom lokalen Windows des Servers oder aus dem Active Directory deiner Domäne.
- Local Users (1) — Die Anmeldung erfolgt gegen die lokalen Windows-Benutzerkonten des Servers, auf dem der Peakboard Hub on premise installiert ist. Diese Konten und ihre Passwörter werden in Windows verwaltet (zum Beispiel über die Windows-Computerverwaltung), nicht im Peakboard Hub. Es besteht keine Abhängigkeit zu einem Active Directory; der Server muss kein Domänenmitglied sein. Beim Login gibst du den Windows-Benutzernamen sowie das zugehörige Windows-Passwort ein. Empfehlenswert für eigenständige Server, Evaluierungs- und Testumgebungen sowie kleine Teams ohne eigene Domäne.
- AD Users (2) — Anmeldung über den Windows Domain Controller deiner Umgebung (Active Directory). Vorausgesetzt, der Server, auf dem der Peakboard Hub on premise installiert wird, ist Mitglied derselben Domäne. Beim Login gibst du den Windows Nutzernamen ohne Domänenpräfix sowie das Windows Passwort ein, sodass deine Anwender mit ihren gewohnten Unternehmenszugangsdaten arbeiten.
In beiden Varianten gilt: Der Peakboard Hub on premise speichert selbst keine Passwörter und legt in der Nutzerverwaltung keine Konten mit Initialpasswort an. Das Benutzerkonto im Peakboard Hub entsteht automatisch beim ersten erfolgreichen Login. Der erste Nutzer, der sich anmeldet, wird dabei automatisch zum Administrator. In der Hub-Nutzerverwaltung pflegst du anschließend ausschließlich Gruppen und Berechtigungen — die eigentlichen Zugangsdaten verbleiben bei Windows beziehungsweise im Active Directory.
Wähle die passende Option und klicke auf [Next].
Schritt 4 — Installationsordner
Im Schritt Hub installation folder legst du fest, wohin der Peakboard Hub installiert wird. Standardmäßig ist C:\inetpub\PeakboardHub voreingestellt (1) — dieser Ordner wird später als IIS-Seite eingebunden. Über [Browse…] (2) kannst du einen anderen Pfad wählen.
Bestätige deine Auswahl mit [Next].
Schritt 5 — Datenbank
Im Schritt Database verbindest du den Peakboard Hub mit seiner SQL-Datenbank.
- Create a new database and user (1) — Der Installer legt eine neue Datenbank und einen neuen SQL-Nutzer für dich an.
- Use an existing database and user (2) — Wähle diese Option, wenn du eine bereits vorhandene Datenbank weiterverwenden möchtest (zum Beispiel bei einem Update oder einer Migration).
- SQL Server instance (3) — Adresse und Instanzname deines SQL Servers. Bei der mitgelieferten Express-Instanz lautet die Voreinstellung
localhost\SQLEXPRESS. - Database name (4) — Name der Datenbank. Standardmäßig
PeakboardHub.
Im unteren Bereich des Dialogs gibst du die Anmeldedaten für den SQL-Nutzer an:
- Username (1) — Loginname des SQL-Nutzers (standardmäßig
pbhub). - Password (2) und Confirm password (3) — Vergib ein sicheres Passwort und wiederhole es zur Bestätigung. Die Eingabe wird ausgeblendet.
Mit [Next] startet die eigentliche Installation.
Schritt 6 — Installation
Der Assistent zeigt nun den Fortschritt an und führt nacheinander folgende Aufgaben aus: Bereitstellen der Voraussetzungen, Einrichten des SQL Servers, Anlegen der Datenbank, Kopieren der Dateien in den Installationsordner sowie das Eintragen der IIS-Seite. Die aktuell laufende Aufgabe wird über dem Fortschrittsbalken angezeigt.
Schritt 7 — Fertig
Wenn alle Aufgaben erfolgreich abgeschlossen sind, wechselt der Assistent zum Schritt Installation finished.
- Zusammenfassung (1) — Eine Übersicht über das, was eingerichtet wurde: der Installationsordner, der Datenbankname samt SQL Server Instanz und der Port der IIS-Seite. Darunter findest du den Pfad zur Setup-Logdatei, in der jeder Schritt im Detail nachvollziehbar ist.
- Finish (2) — Schließt den Assistenten. Der Peakboard Hub on premise ist anschließend über den angezeigten Port in deinem Browser erreichbar und taucht in der IIS-Verwaltung als eigene Seite auf.
Du findest den Peakboard Hub on premise nun in deiner IIS-Verwaltung unter den Seiten und kannst ihn dort wie gewohnt weiter konfigurieren, zum Beispiel eine sichere Kommunikation mit Zertifikaten deines Unternehmens hinterlegen.
Nach der ersten Anmeldung eines Benutzers im Peakboard Hub on premise wird dieser Benutzer automatisch zum Administrator. Zukünftig kannst du weitere Benutzer in der Benutzerverwaltung des Peakboard Hub on premise zu Admins ernennen.
Beachte:
- Wenn du Updates der Peakboard Boxen über den Peakboard Hub on premise durchführen willst, musst du den IIS Prozess dazu berechtigen, in den Installationsordner (zum Beispiel
C:\inetpub\PeakboardHub) zu schreiben. - Wenn MQTT zur Kommunikation zwischen Peakboard Boxen genutzt werden soll, muss der MQTT Port (standardmäßig 1883) geöffnet werden.
Hier siehst du, wo du die Berechtigungen setzen musst:
Wenn die Installation fehlschlägt
Tritt während der Installation ein Fehler auf, zeigt der Assistent den Schritt Installation failed mit einer Fehlermeldung und dem Pfad zur Setup-Logdatei an. Die Logdatei findest du unter C:\ProgramData\Peakboard\LocalState\Logs\Setup\. Häufige Ursachen sind eine nicht erreichbare SQL Server Instanz oder fehlende Schreibrechte auf den Installationsordner. Behebe die Ursache und starte den Installer anschließend erneut.
Updates
Um ein Update durchzuführen, lädst du dir die aktuelle Installationsdatei des Peakboard Hub on premise herunter und startest den Installer auf demselben Server wie die bestehende Installation. Im Schritt Choose components sind alle bereits installierten Komponenten automatisch abgewählt, sodass du nur den Haken bei Peakboard Hub (web application) gesetzt lässt. Den weiteren Verlauf des Assistenten durchläufst du wie bei der Erstinstallation; deine bestehende Datenbank bleibt dabei erhalten.
Deinstallation
Den Peakboard Hub on premise wieder los wirst du über den mitgelieferten Uninstaller. Die Schritt-für-Schritt-Anleitung dazu findest du im Artikel Deinstallation.
