Peakboard hub
Migration von IIS zu einem Windows-Dienst
Frühere Versionen des Peakboard Hub on premise liefen als Seite im IIS (Internet Information Services). Das aktuelle Setup installiert den Peakboard Hub stattdessen als eigenen Windows-Dienst. Wenn du eine Installation aktualisierst, die noch im IIS läuft, migriert das Setup sie: Die IIS-Seite wird durch den Windows-Dienst ersetzt, Datenbank, Einstellungen und Daten bleiben erhalten.
Dieser Artikel erklärt, was sich ändert, wie du dich vorbereitest und wie du die Migration mit dem Setup-Assistenten oder über die Kommandozeile durchführst.
Was sich ändert
| Vorher (IIS) | Nachher (Windows-Dienst) | |
|---|---|---|
| Hosting | IIS-Seite und Anwendungspool PeakboardHub |
Windows-Dienst PeakboardHub (Anzeigename Peakboard Hub), läuft als Lokales System, startet automatisch (verzögert), startet nach einem Fehler neu |
| Programmordner | C:\inetpub\PeakboardHub |
C:\Program Files\Peakboard\PeakboardHub (empfohlen — du kannst auch im alten Ordner bleiben) |
| Datenordner | Im Programmordner | C:\ProgramData\Peakboard\PeakboardHub |
| Ports und HTTPS-Zertifikat | Bindungen der IIS-Seite | Endpunkte in der appsettings.json im Programmordner |
| Ports oder Zertifikat ändern | IIS-Manager | Peakboard Hub Configurator (Windows-Startmenü) |
| Public API | IIS-Seite PeakboardHubApi |
Windows-Dienst PeakboardHubApi |
IIS selbst wird nicht mehr benötigt. Das Setup deinstalliert das Windows-Feature IIS nicht — wenn keine andere Anwendung auf dem Server es nutzt, kannst du es anschließend entfernen.
Bevor du beginnst
- Plane ein Wartungsfenster ein. Während das Setup läuft, ist der Peakboard Hub nicht erreichbar.
- Notiere dir die Bindungen der IIS-Seite. Öffne den IIS-Manager, wähle die Seite des Peakboard Hub aus und notiere dir ihre Ports und HTTPS-Zertifikate (Bindungen). Während der Migration entscheidest du, ob der Windows-Dienst sie übernimmt.
- Prüfe dein HTTPS-Zertifikat. Der Windows-Dienst kann nur Zertifikate aus dem Zertifikatspeicher Eigene Zertifikate des lokalen Computers nutzen. Eine Bindung, deren Zertifikat im zentralen Zertifikatspeicher des IIS liegt oder nicht mehr im Zertifikatspeicher vorhanden ist, kann nicht übernommen werden — der Peakboard Hub ist dann nur über HTTP erreichbar, bis du mit dem Peakboard Hub Configurator ein Zertifikat hinzufügst.
- Prüfe auf gemeinsam genutzte Ports. Teilt sich die Seite des Peakboard Hub einen Port mit einer anderen IIS-Seite (zum Beispiel Port 80 oder 443 neben der Default Web Site), bleibt dieser Port beim IIS. Der Windows-Dienst kann ihn nicht nutzen.
- Sichere deine Datenbank. Das Setup bietet vor dem Update eine Sicherung der Datenbank an (standardmäßig aktiviert). Eine eigene Sicherung schadet trotzdem nicht.
- Starte das Setup mit Administratorrechten.
Migration mit dem Setup-Assistenten
Lade die aktuelle Installationsdatei des Peakboard Hub on premise herunter und starte sie auf dem Server deiner bestehenden Installation. Wähle auf der ersten Seite Peakboard Hub (und Peakboard Hub Public API, falls sie auf diesem Server installiert ist) und klicke auf [Next].
Schritt 1 — Bestehende Installation auswählen
Wähle auf der Seite Installation Folders den Ordner deiner bestehenden Installation, standardmäßig C:\inetpub\PeakboardHub. Ist es der alte Standardordner, weist dich ein Hinweis darauf hin, dass dies der IIS-Speicherort der Installation ist und dass dir nach einem Klick auf [Next] das Verschieben angeboten wird.
Wichtig: Gib hier keinen neuen, leeren Ordner ein, um die Installation zu „verschieben“. Ein anderer Ordner legt einen zweiten, unabhängigen Peakboard Hub neben dem bestehenden an, und die bestehende Installation bleibt unverändert. Wähle den bestehenden Ordner und lass das Setup die Installation verschieben, wie unten beschrieben.
Schritt 2 — An den empfohlenen Speicherort verschieben
Wenn du auf [Next] klickst, fragt das Setup Move to the recommended location?:
- [Yes] — Die Programme werden nach
C:\Program Files\Peakboard\PeakboardHubverschoben und die Daten (hochgeladene Dateien, Hub Flows, Update-Pakete für Boxen, gehostete Web Runtimes) in einen Datenordner unterC:\ProgramData\Peakboard. Die Ordner werden auf der Seite hinter dem Dialog eingetragen und können noch geändert werden. - [No] — Der Peakboard Hub bleibt in
C:\inetpub\PeakboardHub. Er wird trotzdem in einen Windows-Dienst umgewandelt.
In beiden Fällen behält die Installation ihren Dienstnamen, ihre Ports, ihre Zertifikate und ihre Datenbank.
Der Datenordner ist normalerweise C:\ProgramData\Peakboard\PeakboardHub. Wird dieser Ordner bereits von einer anderen Installation genutzt, hängt das Setup eine Nummer an, zum Beispiel PeakboardHub_2 (der Screenshot stammt von einem Testserver mit mehreren Installationen).
Hinweis: Das Verschieben wird nur für den alten Standardordner C:\inetpub\PeakboardHub angeboten. Eine Installation in einem eigenen Ordner wird in diesem Ordner aktualisiert. Über die Kommandozeile kannst du jede Installation aus der IIS-Zeit verschieben, siehe Migration über die Kommandozeile. Der neue Ordner muss auf demselben Laufwerk liegen wie C:\ProgramData.
Hast du [Yes] gewählt, fragt das Setup anschließend Remove the old folder?:
- [Yes] — Nach dem Verschieben wird der alte Ordner gelöscht, einschließlich aller Dateien, die du selbst dort abgelegt hast.
- [No] — Der alte Ordner bleibt erhalten. Du kannst ihn später jederzeit löschen. Das Setup sorgt dafür, dass der behaltene Ordner nicht mehr für eine Installation gehalten werden kann.
Die Seite Installation Folders zeigt jetzt, wohin der Peakboard Hub verschoben wird (1), den neuen Programmordner (2) und den neuen Datenordner (3). Datenordner, die du früher an einen anderen Ort umgeleitet hast, werden nicht verschoben. Klicke auf [Next].
Schritt 3 — Komponenten
Die Seite Update Peakboard Hub nennt den alten und den neuen Ordner:
- Update Hub program files (1) — Gehört bei einer Migration immer dazu.
- Create backup (2) — Sichert die Datenbank, bevor die neuen Programmdateien kopiert werden. Lass die Option aktiviert.
- Set up database (3) — Lass die Option abgewählt. Der Peakboard Hub behält seine aktuelle Datenbankverbindung.
- Configure Hub Windows service (ports & firewall) (4) — Bei einer Installation, die noch im IIS läuft, immer aktiviert, weil die IIS-Seite durch den Windows-Dienst ersetzt wird.
Klicke auf [Next].
Schritt 4 — Sicherungsordner
Auf der Seite Backup Peakboard Hub wählst du, wohin die Sicherung der Datenbank geschrieben wird. Die Sicherungsdatei schreibt der SQL Server, deshalb muss der Ordner auf dem Datenbankserver liegen und für das Dienstkonto des SQL Servers beschreibbar sein. Lässt du das Feld leer, wird der Standard-Sicherungsordner der SQL-Server-Instanz genutzt. Klicke auf [Next].
Schritt 5 — Endpunkte des Windows-Dienstes
Auf der Seite Service Configuration zeigt das Setup, welche IIS-Seite den Ordner aktuell bereitstellt, und fragt, woher die Endpunkte des Windows-Dienstes kommen:
- Add new endpoints (configure below) (1) — Vorausgewählt. Aus dem IIS wird nichts automatisch übernommen; der Windows-Dienst bekommt nur den HTTP port und die optionalen HTTPS-Einstellungen, die du darunter einträgst.
- Take endpoints from the current IIS site (2) — Listet alle Bindungen der IIS-Seite auf (3). Wähle die aus, die der Windows-Dienst übernehmen soll. Jede Bindung hat einen Link (4), der sie im Browser öffnet, damit du prüfen kannst, was dort erreichbar ist. Bindungen, die nicht übernommen werden können, werden deaktiviert mit dem Grund angezeigt — zum Beispiel ein Port, den eine andere IIS-Seite nutzt, oder ein Zertifikat, das im Zertifikatspeicher nicht gefunden wird.
Die erste ausgewählte HTTP-Bindung wird zum Hauptport des Windows-Dienstes, jede weitere Auswahl zu einem zusätzlichen Endpunkt. Es können höchstens 5 HTTP- und 4 HTTPS-Endpunkte übernommen werden. Eine HTTPS-Bindung behält ihr Zertifikat.
Bitte beachten: Die IIS-Seite und ihr Anwendungspool werden in beiden Fällen gelöscht. Wählst du Add new endpoints mit einem anderen Port als dem der IIS-Seite, ist der Peakboard Hub danach nur noch auf dem neuen Port erreichbar — passe alle Clients an, die sich mit ihm verbinden, zum Beispiel Peakboard Boxen.
Schritt 6 — Update ausführen
Der Button der letzten Seite heißt [Update]. Klicke darauf, um die Migration zu starten. Das Setup stoppt die IIS-Seite, kopiert die neuen Programmdateien, verschiebt die Ordner (falls gewählt), legt den Windows-Dienst an und startet ihn, übernimmt die ausgewählten Endpunkte, öffnet die Ports in der Windows-Firewall und löscht zum Schluss die IIS-Seite und ihren Anwendungspool.
Nach Abschluss der Migration zeigt die Seite Installation finished, was installiert wurde und — nach einem Verschieben — was wohin verschoben wurde, zusammen mit einer Erinnerung, was du selbst anpassen musst.
Was das Setup übernimmt
- Die Datenbankverbindung, die Art der Authentifizierung und alle weiteren Einstellungen in der
appsettings.json. - Die Identität des Dienstes, die Ports und die ausgewählten HTTPS-Zertifikate.
- Alle Datenordner. Das Setup passt auch die zugehörigen Einstellungen in der Datenbank an.
- Einen Eintrag unter Windows Apps & Features.
Nach der Migration
Was außerhalb der Installation liegt, kann das Setup nicht erreichen. Passe nach einem Verschieben alles an, was auf den alten Ordner C:\inetpub\PeakboardHub verweist:
- Sicherungsjobs und ihre Ziel- und Ausschlusspfade
- Ausnahmen in Virenschutz oder EDR
- Netzwerkfreigaben und eigene Ordnerberechtigungen
- Eigene Skripte, geplante Aufgaben und Überwachungen
Um die Ports oder das HTTPS-Zertifikat später zu ändern, nutzt du den Peakboard Hub Configurator aus dem Windows-Startmenü, siehe Installation.
Hinweis: Ein Browser, der den Peakboard Hub auf einem Port geöffnet hat, den der Windows-Dienst nicht mehr nutzt, kann die Anmeldeseite weiterhin aus seinem Cache anzeigen, obwohl auf diesem Port nichts mehr antwortet (zum Beispiel mit der Meldung „Gateway Timeout“ nach der Anmeldung). Lösche im Browser die Websitedaten dieser Adresse.
Migration über die Kommandozeile
Die Migration lässt sich auch unbeaufsichtigt ausführen. Alle Argumente beschreibt der Artikel Silent-Installation.
Update am bisherigen Ort — der Peakboard Hub bleibt in seinem Ordner und wird zum Windows-Dienst:
PeakboardHubSetup.exe -Silent True -InstallPath "C:\inetpub\PeakboardHub"
Die Installation in die empfohlenen Ordner verschieben und die alten Ordner anschließend löschen:
PeakboardHubSetup.exe -Silent True ^
-InstallPath "C:\Program Files\Peakboard\PeakboardHub" ^
-ApiInstallPath "C:\Program Files\Peakboard\PeakboardHubApi" ^
-HubMigrateFrom "C:\inetpub\PeakboardHub" ^
-ApiMigrateFrom "C:\inetpub\PeakboardHubApi" ^
-RemoveOldFolders True
Wichtig: Kommandozeile und Assistent gehen unterschiedlich mit den IIS-Bindungen um. Über die Kommandozeile werden standardmäßig alle wiederverwendbaren Bindungen der IIS-Seite übernommen. Mit -HubEndpointsFromIis False (Public API: -ApiEndpointsFromIis False) wird nichts aus dem IIS übernommen, und es gelten nur die Ports aus der Kommandozeile.
Zur vorherigen Version zurückkehren
Führe kein älteres Setup aus, um eine Migration rückgängig zu machen. Es erkennt die migrierte Installation nicht und würde eine zweite IIS-Seite auf denselben Ports anlegen. So kehrst du zurück:
- Deinstalliere den migrierten Peakboard Hub mit seinem Uninstaller (Daten behalten).
- Installiere die vorherige Version.
- Stelle die Datenbanksicherung von vor dem Update wieder her.
Fehlerbehebung
| Problem | Ursache und Lösung |
|---|---|
| Der Peakboard Hub ist nach der Migration nur über HTTP erreichbar | Das Zertifikat der HTTPS-Bindung lag im zentralen Zertifikatspeicher des IIS oder war nicht mehr im Zertifikatspeicher vorhanden. Das Setup-Protokoll nennt die Bindung. Lege das Zertifikat im Speicher Eigene Zertifikate des lokalen Computers ab und wähle es im Peakboard Hub Configurator aus. |
| Ein Port der IIS-Seite wurde nicht übernommen | Eine andere IIS-Seite nutzt denselben Port. Das Setup-Protokoll nennt diese Seite. Nutze für den Peakboard Hub einen anderen Port. |
| Das Setup meldet unvollständige Programmdateien und einen deaktivierten Dienst | Das Update ist beim Kopieren der Dateien fehlgeschlagen. Starte dasselbe Setup noch einmal, um es abzuschließen. |
Die Protokolldateien des Setups liegen unter C:\ProgramData\Peakboard\LocalState\Logs\Setup\.
