Dieses Verfahren trägt zu einem reibungslosen Übergang mit minimalen Ausfallzeiten und erhaltener Datenintegrität bei. Testen Sie nach Möglichkeit immer zuerst in einer Nicht-Produktionsumgebung.
Sicherungs-, Deinstallations-, Neuinstallations- und Wiederherstellungsverfahren
Wichtige Hinweise vor dem Start:
Der Schritt der Datensicherung und -wiederherstellung ist der wichtigste. Stellen Sie sicher, dass er erfolgreich abgeschlossen wurde, bevor Sie fortfahren.
- Führen Sie alle Eingabeaufforderungen als Administrator aus.
Diese Anweisungen basieren auf den üblichen Vorgehensweisen bei der lokalen Bereitstellung von JMP Live (einschließlich JMP Pro, PostgreSQL-Datenbank über den JMP Live Database Installer, Keycloak und JMP Live-Dienste).
- Planen Sie dies während eines Wartungsfensters ein, da die Dienste offline sein werden.
Schritt 1: Vorbereitung und Datensicherung
1. Sichern Sie die Konfigurationsdateien in einem neuen Ordner (z. B. C:\Backup).
Suchen und kopieren Sie die .env-Dateien aus den Installationsverzeichnissen von JMP Pool und JMP Live. Diese beiden Dateien werden wiederverwendet.
- Sichern Sie die Keycloak .conf-Datei (nur zu Referenzzwecken; sie kann nicht direkt wiederverwendet werden).
Wichtig: Stellen Sie sicher, dass sich keine Zertifikate im Standardordner „Programme“ befinden, da dieser bei der Deinstallation gelöscht wird. Verschieben Sie sie gegebenenfalls an einen sicheren Ort.
2. Alle JMP Live-Dienste beenden.
- Öffnen Sie die Dienste (services.msc) und beenden Sie:
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
Schritt 2: Datenbanksicherung
1. Öffnen Sie eine Eingabeaufforderung mit Administratorrechten (Als Administrator ausführen).
2. Navigieren Sie zum Ordner „Backups“ (cd).
3. Führen Sie den folgenden Befehl zur Datenbanksicherung aus:
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
- Aktualisieren Sie den Dateipfad im Befehl, sodass er zu Ihrer Installation passt.
4. Überwachen Sie den Fortschritt, da dies je nach Datenbankgröße erhebliche Zeit in Anspruch nehmen kann.
5. Überprüfen Sie vor dem Fortfahren, ob die Sicherungsdatei vorhanden und nicht leer/beschädigt ist.
Dieser Schritt ist von entscheidender Bedeutung, da ein fehlgeschlagenes Backup zu Datenverlust führen kann.
- Die gesamte JMP Live-Datenbank muss gesichert und wiederhergestellt werden, andernfalls kann nicht garantiert werden, dass die neue Bereitstellung ordnungsgemäß funktioniert.
Schritt 3: Vorhandene Komponenten deinstallieren
Deinstallieren Sie die folgenden Programme in beliebiger Reihenfolge (über Systemsteuerung > Programme und Funktionen oder Programme hinzufügen/entfernen):
- JMP Live
- JMP Pro
- JMP Live-Datenbank (PostgreSQL-Instanz)
- Schlüsselmantel
Schritt 4: Installation und Wiederherstellung der Datenbank
1. Installieren Sie die JMP Live-Datenbankkomponente, die sich in der selbstextrahierenden JMP Live-Datei befindet.
2. Verwenden Sie dieselbe Eingabeaufforderung mit Administratorrechten und denselben Sicherungsordner und führen Sie den folgenden Wiederherstellungsbefehl aus.
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
- Aktualisieren Sie den Dateipfad im Befehl, sodass er zu Ihrer Installation passt.
3. Vergewissern Sie sich, dass die Wiederherstellung erfolgreich abgeschlossen wurde (überprüfen Sie die Protokolle oder fragen Sie die Datenbank ab).
Schritt 5: Installieren Sie weitere JMP Live-Komponenten
Installieren Sie die Installationsreihenfolge genau so:
1. JMP Pro
2. Schlüsselmantel
- Geben Sie während der Installation die erforderlichen Administrator- und Datenbankeinstellungen ein.
- Öffnen Sie die gesicherte Keycloak .conf-Datei im Editor, um sie als Referenz für die Konfigurationswerte (z. B. Ports, Administratoranmeldeinformationen, Datenbankverbindung) zu verwenden.
3. JMP Live
- Während der Installation müssen die Eingabeaufforderungen nicht vollständig korrekt sein, wenn Sie planen, die .env-Dateien nach der Installation zu überschreiben.
- Stellen Sie sicher, dass der Installationspfad von JMP Pro korrekt angegeben wird, wenn Sie dazu aufgefordert werden (oder aktualisieren Sie ihn später in der JMP Pool .env-Datei; d.h. ändern Sie alle Verweise von 18 auf 19).
Schritt 6: Konfiguration nach der Installation
1. Dienste erneut beenden (falls automatisch gestartet):
- Öffnen Sie die Dienste (services.msc) und beenden Sie:
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
2. Konfigurationsdateien überschreiben
- Ersetzen Sie die neuen .env-Dateien in den Verzeichnissen JMP Pool und JMP Live durch Ihre Sicherungskopien.
- Überprüfen und aktualisieren Sie alle versionsspezifischen Pfade (z. B. JMP Pro Pfad 18 → 19). Diese können im Editor bearbeitet werden.
- Änderungen speichern.
3. JMP Live starten
- Navigieren Sie zu: `C:\Program Files\JMP\JMP Live\` (oder Ihrem Installationspfad).
- Führen Sie `launch.cmd` als Administrator aus.
- Warten Sie, bis beide Eingabeaufforderungsfenster initialisiert sind, und schließen Sie sie dann.
4. Dienste starten
- Öffnen Sie die Dienste (services.msc) und starten Sie sie (in dieser Reihenfolge):
- JMP Live Keycloak
- webjmpsvc
- jmppoolsvc
Schritt 7: Abschließende Überprüfung und erneute Autorisierung
1. Greifen Sie auf die Weboberfläche des JMP Live Administrators zu.
- https://URL/admin/login
2. Melden Sie sich als Administrator an.
3. Wechseln Sie zur Registerkarte „Admin“.
4. JMP Live erneut autorisieren (folgen Sie den Anweisungen auf dem Bildschirm, um die Lizenzierung/Verbindungsvalidierung abzuschließen).
5. Testen Sie die wichtigsten Funktionen: Veröffentlichen Sie einen Beispielbericht aus JMP Pro Desktop, überprüfen Sie den Benutzerzugriff, prüfen Sie die Datenaktualisierung usw.
Falls Probleme auftreten:
- Servicestatus und Protokolle prüfen.
- Überprüfen Sie die Datenbankverbindung und die Keycloak-Realm-Einstellungen.
- Konsultieren Sie die offizielle JMP Live Installationsanleitung oder wenden Sie sich an den technischen Support von JMP.
