Cette procédure permet d'assurer une transition en douceur avec un temps d'arrêt minimal et la préservation de l'intégrité des données. Il est toujours recommandé de tester d'abord dans un environnement hors production, lorsque cela est possible.
Procédures de sauvegarde, de désinstallation, de réinstallation et de restauration
Remarques importantes avant de commencer :
L'étape de sauvegarde et de restauration de la base de données est cruciale. Assurez-vous qu'elle se déroule correctement avant de poursuivre.
- Exécutez toutes les invites de commandes en tant qu'administrateur.
- Ces instructions sont basées sur les pratiques de déploiement standard de JMP Live sur site (impliquant JMP Pro, la base de données PostgreSQL via l'installateur de base de données JMP Live, Keycloak et les services JMP Live).
- Planifiez cette opération pendant une période de maintenance, car les services seront hors service.
Étape 1 : Préparation et sauvegarde
1. Sauvegardez les fichiers de configuration dans un nouveau dossier (par exemple C:\Backup).
- Localisez et copiez les fichiers .env situés dans les répertoires d'installation de JMP Pool et JMP Live. Ces deux fichiers seront réutilisés.
- Sauvegardez le fichier .conf de Keycloak (à titre de référence uniquement ; il ne peut pas être réutilisé directement).
Important : Assurez-vous qu’aucun certificat (certs) ne soit stocké dans le dossier Program Files par défaut, car il sera supprimé lors de la désinstallation. Déplacez-les vers un emplacement sûr si nécessaire.
2. Arrêtez tous les services JMP Live
- Ouvrez Services (services.msc) et arrêtez :
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
Étape 2 : Sauvegarde de la base de données
1. Ouvrez une invite de commandes avec privilèges élevés (Exécuter en tant qu'administrateur).
2. Accédez au dossier Backups (cd).
3. Exécutez la commande de sauvegarde de base de données suivante :
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
- Mettez à jour le chemin d'accès au fichier dans la commande pour qu'il corresponde à votre installation.
4. Surveillez l'avancement, car cela peut prendre un temps considérable en fonction de la taille de la base de données.
5. Vérifiez que le fichier de sauvegarde existe et qu'il n'est ni vide ni corrompu avant de continuer.
- Cette étape est cruciale car une sauvegarde défaillante peut entraîner une perte de données.
- L'intégralité de la base de données JMP Live doit être sauvegardée et restaurée, faute de quoi le bon fonctionnement du nouveau déploiement n'est pas garanti.
Étape 3 : Désinstaller les composants existants
Désinstallez les éléments suivants dans n'importe quel ordre (via Panneau de configuration > Programmes et fonctionnalités ou Ajout/Suppression de programmes) :
- JMP Live
- JMP Pro
- Base de données JMP Live (instance PostgreSQL)
- Keycloak
Étape 4 : Installation et restauration de la base de données
1. Installez le composant JMP Live Database qui se trouve dans l'exécutable auto-extractible de JMP Live.
2. En utilisant la même invite de commandes élevée et le même dossier de sauvegarde, exécutez la commande de restauration suivante.
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
- Mettez à jour le chemin d'accès au fichier dans la commande pour qu'il corresponde à votre installation.
3. Vérifiez que la restauration s'est bien déroulée (consultez les journaux ou interrogez la base de données).
Étape 5 : Installez les autres composants JMP Live
Installez-les dans cet ordre précis :
1. JMP Pro
2. Keycloak
- Lors de l'installation, saisissez les paramètres d'administrateur et de base de données requis.
- Ouvrez le fichier .conf Keycloak sauvegardé dans le Bloc-notes pour l'utiliser comme référence pour les valeurs de configuration (par exemple, les ports, les identifiants d'administrateur, la connexion à la base de données).
3. JMP Live
- Lors de l'installation, les invites n'ont pas besoin d'être parfaitement exactes si vous prévoyez d'écraser les fichiers .env après l'installation.
- Assurez-vous que le chemin d'installation de JMP Pro est correctement spécifié lorsque vous y êtes invité (ou mettez-le à jour ultérieurement dans le fichier .env du pool JMP ; c'est-à-dire modifiez toutes les références 18 → 19).
Étape 6 : Configuration post-installation
1. Arrêtez à nouveau les services (s'ils ont démarré automatiquement) :
- Ouvrez Services (services.msc) et arrêtez :
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
2. Écraser les fichiers de configuration
- Remplacez les nouveaux fichiers .env dans les répertoires JMP Pool et JMP Live par vos copies de sauvegarde.
- Vérifiez et mettez à jour les chemins d'accès spécifiques à chaque version (par exemple, chemin JMP Pro 18 → 19). Vous pouvez les modifier dans le Bloc-notes.
- Enregistrer les modifications.
3. Lancez JMP Live
- Accédez à : `C:\Program Files\JMP\JMP Live\` (ou votre chemin d'installation).
- Exécutez `launch.cmd` en tant qu'administrateur.
- Laissez les deux fenêtres d'invite de commandes terminer leur initialisation, puis fermez-les.
4. Démarrer les services
- Ouvrez les Services (services.msc) et démarrez-les (dans cet ordre) :
- JMP Live Keycloak
- webjmpsvc
- jmppoolsvc
Étape 7 : Vérification finale et réautorisation
1. Accédez à l'interface web de l'administrateur JMP Live.
- https://URL/admin/login
2. Connectez-vous en tant qu'administrateur.
3. Accédez à l'onglet Admin.
4. Réautorisez JMP Live (suivez les instructions à l'écran pour terminer la validation de la licence/connexion).
5. Tester les fonctionnalités clés : publier un exemple de rapport depuis JMP Pro de bureau, vérifier l’accès de l’utilisateur, vérifier l’actualisation des données, etc.
En cas de problème :
- Vérifier l'état du service et les journaux.
- Vérifiez la connectivité à la base de données et les paramètres du domaine Keycloak.
- Consultez les instructions d'installation officielles de JMP Live ou contactez le support technique de JMP.
