Documentation procédure de migration V5
Prérequis
Avant toute intervention, il est nécessaire d’avoir validé un contrat de licences dédiées à la version 5 de Diapason auprès du service Commercial ELCIA ERP.
Un nouveau serveur d’applications, respectant les prérequis, doit être mis à disposition pour recevoir la version 5 de Diapason.
Avant toute intervention :
rapprochez-vous des chefs de projet dédiés à la migration V5,
contactez le service Exploitation ELCIA ERP afin de connaître les préconisations (certificats, partitions, ...) et les actions qui doivent être menées par ELCIA ERP en amont sur le nouveau serveur mis à disposition
Les derniers setups mis à disposition sur les FTP doivent être récupérés avant la réalisation de la migration.
L’exécution interactive des setups déroule des traces explicites à l'écran : il faut attendre que le script rende la main.
Comment lire ce document ?
Les commandes à exécuter sur le serveur d’applications, citées ci-après, sont indiquées en bleu. Le “$” présent avant chaque commande correspond au prompt et ne doit en aucun cas être saisi.
La valeur “XXXX” devra être remplacée par la valeur du numéro du setup à utiliser.
La valeur “nom_env” devra être remplacée par le nom donné à l’environnement V5 installé (ex : PROD ou DEV)
La valeur “serveurLINUX“ devra être remplacée par l’adresse IP ou le nom du serveur d’applications V5 concerné.
La valeur “XX.XX.XX” devra être remplacé par le numéro de la dernière révision installée sur le serveur d’applications V16.
Les étapes de la migration en V5
ETAPE 1 - Migrer dans la dernière révision de 04.16
Ces actions sont à réaliser sur le serveur d’application (V16).
Il faut OBLIGATOIREMENT migrer l’environnement Diapason V16 dans la toute dernière révision valide de la version 04.16 en suivant les instructions de la procédure d’installation de la révision correspondante.
ETAPE 2 - Préparer la migration V5
Ces actions sont à réaliser sur le serveur d’application (V5).
Se connecter en diapdba
Contrôler que la version du serveur LINUX correspond à la version Red Hat compatible avec la version 5 (Red Hat 9.2)
$ more /etc/redhat-release
Télécharger le setup dans un sous-dossier créé dans le dossier temporaire (ex : /tmp) du SAP (V5)
$ cd /tmp ; mkdir V05
$ tar -xvzf setup_05.00.00.XXXX.gz -C /tmp/V05 (l’option “v” peut être enlevée pour un gain de temps)
Récupérer le paquet dumpAndLoad.tar.gz téléchargé dans le répertoire ./Server/Shell du sous-dossier temporaire (ex : /tmp/V05)
Déposer le paquet dumpAndLoad.tar.gz dans un sous-dossier temporaire (ex : /tmp/V05) du serveur d’applications dédié à l’environnement Diapason V16 à dumper
ETAPE 3 - Réaliser le dump des données V16
Ces actions sont à réaliser sur le serveur d’application (V16).
Avant intervention, il faut réaliser une sauvegarde du serveur d’applications (V16)
Se connecter en isia (ou en diapdba)
Arrêter le Diapason V16 devant être dumpé et s’assurer que toutes les bases soient bien arrêtées
Contrôler la version de l’outil powershell
$ pwsh --version (version 7.3.10)
Si besoin, la commande pour l’installer est la suivante :
$ sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v7.3.10/powershell-7.3.10-1.rh.x86_64.rpm
Nécessaire de récupérer/créer un dossier pour télécharger les outils du dump
$ cd /tmp ; mkdir /tmp/V05
$ tar -xvzf dumpAndLoad.tar.gz -C /tmp/V05 (l’option “v” peut être enlevée pour un gain de temps)
Dumper les données (en interactif)
Prévoir suffisamment d’espace disque pour le dossier renseigné dans le paramètre DUMP_TARGET_PATH.
$ pwsh /tmp/V05/dumpAndLoad/dumpEnv.ps1 -DUMP_TOOL /tmp/V05 -TMP_PATH /tmp/V05/LOG -DUMP_PROJECT_PATH /Diap1 -DUMP_TARGET_PATH /Dump -DLC_ENV /Outils/d117
Compléments informations sur les paramètres
DUMP_TOOL : le répertoire indiqué sera créé automatiquement si cela n’a pas été réalisé lors du téléchargement des outils liés au dump
TMP_PATH : le répertoire indiqué sera créé automatiquement (pas nécessaire de le créer en amont)
DUMP_TARGET_PATH : le répertoire indiqué sera créé au moment du dump (pas nécessaire de le créer en amont)
DUMP_PROJECT_PATH : doit exister vu qu’il contient le dossier des bases à dumper
Transférer les données sur le serveur d’applications (V5) en se positionnant sur le répertoire indiqué dans le paramètre DUMP_TARGET_PATH
Prévoir un dossier comprenant suffisamment d’espace disque pour réceptionner le DUMP sur le serveur d’applications V5
$ cd /Dump
$ scp -r result diapdba@serveurLINUX:/DumpV5/result
sur l’exemple ci-dessus le répertoire “/DumpV5/result” est créé directement sur le serveur d’applications (V5)
Astuce pratique
Il est possible d’avoir une partition partagée entre le serveur d’applications (V16) et le serveur d’applications (V5) pour gain de temps.
ETAPE 4 - Réaliser le load des données/migration en V5
Ces actions sont à réaliser sur le serveur d’application (V5).
Se connecter en diapdba
Lancer la migration dans le dossier “/Diap”
$ pwsh /tmp/V05/install.ps1 -ENV_NAME nom_env -ENV_PATH /Diap -DUMP_DATA_PATH /DumpV5/result -TMP_PATH /tmp/V05/LOG -TOOL_HOME /tmp/V05 -HTTP_PORT 8080 -HTTPS_PORT 8443 -ADMIN_PORT 8090
Divers contrôles sont réalisés par le script : des messages explicites seront présentés au fur et à mesure de la migration.
Quels sont les principaux messages qui peuvent s’afficher durant la procédure ?
“Effacer l’environnement cible (Y/N) /Diap ?” ( Message affiché si l’installation détecte un fichier “databases.json” dans les sous répertoires ) |
|
“Voulez-vous changer les chemins des bases ? (Y/N) | Des chemins sont proposés par défaut pour chacune des bases détectées par la migration.
|
( si vous avez répondu Y à la question précédente ) “Validez-vous les nouveaux chemins ? (Y/N)“ | Cette question permet une dernière validation pour modifier les chemins
|
Un avertissement est renvoyé “WARNING: The specified port is in use by another process - xxxx” et la migration s’arrête. | Ce message s’affiche si la migration détecte l’utilisation d’un des ports indiqués. Il est nécessaire de relancer la migration avec des ports non utilisés |
En cas d’erreur, pour relancer la migration et ne pas avoir de blocage, il faut suivre les instructions indiquées par le warning (en jaune).
ETAPE 5 - Démarrer l’environnement V5
Ces actions sont à réaliser sur le serveur d’application (V5).
Se connecter en diapdba
Modifier le fichier de configuration du tomcat dans le fichier “/Diap/devt/Diap/PASOE/conf/server.xml”
Ajouter une ligne dans le bloc “Connector” lié à l’HTTP pour indiquer que la connexion est uniquement autorisée pour le “localhost”
address=”127.0.0.1”
Démarrer le nouveau Diapason
$ ./diapason.sh start
Contrôler le statut du nouveau Diapason : tous les statuts doivent être “OK”
$ ./diapason.sh status
Mettre à jour les certificats
$ ./diapason.sh installcert
Il faut renseigner :
renseigner le chemin et le fichier de la clé privé (.key) (ex : /tmp/cleXX.key)
renseigner le chemin et le fichier du certificat SSL (.pem) (ex : /tmp/certifXX.pem)
définir un mot de passe
renseigner le chemin et le fichier du certificat SSL racine (.pem) (ex : /tmp/certifZZZ.pem)
Il ne faut pas mettre d’espace dans les noms de répertoires et fichiers utilisés.
Il ne doit pas y avoir d’erreur remontée par la mise à jour.
Contrôler et modifier si nécessaire le fichier “/Diap/devt/Diap/properties/config.json” pour configurer correctement l’URL Externe
Contrôler le statut du nouveau Diapason : tous les statuts doivent être “OK”
$ ./diapason.sh status
ETAPE 6 - Finaliser
Ces actions sont à réaliser sur le serveur d’application (V5).
Contacter le service Exploitation pour activer les licences. Il faudra qu’Elcia ERP affecte la 1ere licence à un administrateur Client.
Lancer l’action de génération des requêtes (INS-REQ)
Relancer l’action de génération et récupération de la traduction
Dans Diapason, se connecter avec “isia” et dans l’explorateur Outils DIAPASON → Paramétrage Traduction → Objets à Traduire, lancer successivement les actions → Génération Français Standard puis Récupération Traduction.
Réinitialiser les mots de passe des utilisateurs (obligatoire)
Que faire si vous n'êtes pas certain d’avoir migré en V5 ?
Ces actions sont à réaliser sur le serveur d’application (V5).
Vous doutez d’avoir migré un environnement client ? 🧐
Il est possible de relancer la migration !
Deux alertes sont renvoyées si la migration a déjà été réalisée :
une alerte indiquant que les fichiers temporaires sont toujours là via le WARNING en jaune “WARNING : Chemin des fichiers et dossiers temporaires à supprimer si on souhaite tout reprendre à zéro : … “
une alerte indiquant que l’installation s’est bien terminée via le WARNING en jaune “WARNING : L’installation n’a pas besoin de reprendre elle est terminée“