Questa procedura contribuisce a garantire una transizione senza intoppi, con tempi di inattività minimi e preservando l'integrità dei dati. Quando possibile, eseguire sempre un test in un ambiente non di produzione.
Procedure di backup, disinstallazione, reinstallazione e ripristino
Note importanti prima di iniziare:
- La fase di backup e ripristino del database è la più critica. Assicurarsi che venga completata correttamente prima di procedere.
- Eseguire tutti i prompt dei comandi come amministratore.
- Queste istruzioni si basano sulle procedure standard di implementazione on-premise di JMP Live (che prevedono JMP Pro, un database PostgreSQL tramite il programma di installazione di JMP Live Database, Keycloak e i servizi JMP Live).
- Pianificate questa operazione durante una finestra di manutenzione, poiché i servizi saranno offline.
Fase 1: Preparazione e backup
1. Eseguire il backup dei file di configurazione in una nuova cartella (ad esempio C:\Backup)
- Individua e copia i file .env presenti nelle directory di installazione di JMP Pool e JMP Live. Questi due file verranno riutilizzati.
- Eseguire un backup del file .conf di Keycloak (solo a scopo di riferimento; non può essere riutilizzato direttamente).
- Importante: assicurarsi che i certificati non siano memorizzati nella cartella predefinita Programmi, poiché verranno rimossi durante la disinstallazione. Se necessario, spostarli in una posizione sicura.
2. Interrompere tutti i servizi JMP Live
- Aprire Servizi (services.msc) e arrestarli:
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
Passaggio 2: Backup del database
1. Apri un prompt dei comandi con privilegi elevati (Esegui come amministratore).
2. Spostarsi (cd) nella cartella Backups
3. Eseguire il seguente comando di backup del database:
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
- Aggiorna il percorso del file nel comando in modo che corrisponda alla tua installazione.
4. Monitorare i progressi, poiché questa operazione potrebbe richiedere molto tempo a seconda delle dimensioni del database.
5. Prima di continuare, verificare che il file di backup esista e non sia vuoto o danneggiato.
- Questo passaggio è fondamentale, poiché un backup non riuscito può comportare la perdita di dati.
- L'intero database JMP Live deve essere sottoposto a backup e ripristinato, altrimenti non è garantito il corretto funzionamento della nuova installazione.
Passaggio 3: Disinstallare i componenti esistenti
Disinstallare i seguenti programmi in qualsiasi ordine (tramite Pannello di controllo > Programmi e funzionalità o Installazione applicazioni):
- JMP Live
- JMP Pro
- JMP Live Database (istanza PostgreSQL)
- Keycloak
Passaggio 4: Installazione e ripristino del database
1. Installa il componente JMP Live Database presente nell'eseguibile autoestraente di JMP Live.
2. Utilizzando lo stesso prompt dei comandi con privilegi elevati e la stessa cartella Backup, eseguire il seguente comando di ripristino.
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
- Aggiorna il percorso del file nel comando in modo che corrisponda alla tua installazione.
3. Verificare che il ripristino sia stato completato correttamente (controllare i log o interrogare il database).
Passaggio 5: Installare gli altri componenti live di JMP
Installare seguendo esattamente questa sequenza:
1. JMP Pro
2. Keycloak
- Durante l'installazione, inserire le impostazioni di amministratore e del database richieste.
- Apri il file .conf di Keycloak di cui hai effettuato il backup con Blocco note per utilizzarlo come riferimento per i valori di configurazione (ad esempio, porte, credenziali di amministratore, connessione al database).
3. JMP Live
- Durante l'installazione, le richieste non devono essere del tutto accurate se si prevede di sovrascrivere i file .env dopo l'installazione.
- Assicurarsi che il percorso di installazione di JMP Pro sia specificato correttamente quando richiesto (oppure aggiornarlo in seguito nel file .env del pool JMP; ovvero modificare tutti i riferimenti da 18 a 19).
Passaggio 6: Configurazione post-installazione
1. Interrompere nuovamente i servizi (se avviati automaticamente):
- Aprire Servizi (services.msc) e arrestarli:
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
2. Sovrascrivi i file di configurazione
- Sostituisci i nuovi file .env nelle directory JMP Pool e JMP Live con le copie di backup che hai creato.
- Rivedi e aggiorna i percorsi specifici della versione (ad esempio, il percorso 18 → 19 di JMP Pro). Questi possono essere modificati con Blocco note.
- Salva le modifiche.
3. Avviare JMP Live
- Accedere al percorso: `C:\Program Files\JMP\JMP Live\` (o al percorso di installazione).
- Eseguire `launch.cmd` come amministratore.
- Attendere che entrambe le finestre del prompt dei comandi completino l'inizializzazione, quindi chiuderle.
4. Avviare i servizi
- Aprire Servizi (services.msc) e avviarli (in quest'ordine):
- JMP Live Keycloak
- webjmpsvc
- jmppoolsvc
Fase 7: Verifica finale e riautorizzazione
1. Accedere all'interfaccia web di amministrazione di JMP Live.
- https://URL/admin/login
2. Accedi come amministratore.
3. Vai alla scheda Amministrazione.
4. Riautorizzare JMP Live (seguire le istruzioni visualizzate sullo schermo per completare la convalida della licenza/connessione).
5. Testare le funzionalità chiave: pubblicare un report di esempio da JMP Pro desktop, verificare l'accesso dell'utente, controllare l'aggiornamento dei dati, ecc.
In caso di problemi:
- Verificare lo stato del servizio e i registri.
- Verificare la connettività del database e le impostazioni del realm di Keycloak.
- Consultare le istruzioni ufficiali per l'installazione di JMP Live o contattare l'assistenza tecnica di JMP.
