Sommaire
2.5.1. Introduction
Cette fonctionnalité permet de déclarer où se trouvent vos environnements ERP de production et de test et dans quelles versions de l’ERP vous travaillez. Le but est de vous proposer les mises à jours compatibles avec votre version de l’ERP et de vous permettre d’effectuer les mises à jour. Le but est aussi de préparer les passages de version en vous permettant de mettre en place votre environnement de test grâce à l’utilitaire « ForterroAdminVersion.exe ».
Déclaration des répertoires des environnements :
Les boutons « Nouveau » et « Modifier » permettent de créer et modifier un environnement. Le bouton « Supprimer » permet de supprimer l’environnement sélectionné.
Il est conseillé de déclarer d’abord l’environnement de test, puis l’environnement de production, car lors de la création de l’environnement de production, il est demandé de lui associer l’environnement de test.
Exemple de Création/Modification d’un environnement de Production.
Titre : Saisir le nom de l’environnement.
Version : Sélectionner la version de l’ERP de l’environnement en cours de saisie.
Type : S’agit-il d’un répertoire de test ou de production ?
Répertoire de test : Pour un environnement de production, sélectionner l’environnement de test associé. Ce répertoire doit contenir une version de l’ERP de test. S’il ne contient pas de versions, la mise à jour de ce répertoire ne fonctionnera pas.
Répertoire de l’ERP : Saisir le chemin réseau partagé ou se trouve cet environnement.
Répertoire de sauvegarde de l’ERP : Si vous souhaitez créer une copie de cet environnement avant de lancer les mises à jour, sélectionner le chemin réseau ou il faut installé cette sauvegarde.
Répertoire de sauvegarde de la base de données : Désigner le chemin réseau partagé de sauvegarde des bases de données. Lors de la mise à jour si l’environnement est désigné comme devant sauvegarder les bases de données alors les bases de données des profils de l’environnement seront sauvegardés.
Le tableau de paramétrage des sauvegardes : Il permet de préciser pour les types de mises à jour suivant, Version Majeure, Correctif unitaire ou Correctif cumulatif, ce qu’il faut sauvegarer base de données et/ou ERP.
Dans chaque profil de base de données de chaque environnement, il est possible de désigner les bases de données devant être migrées automatiquement par « ForterroAdminVersion.exe ». Il est également possible de désigner les bases de données devant être répliquées en environnement de test (serveur SQL et nom de la base de test avec neutralisation possible).
Une fois les environnements de tests et de production créés, arborescence permet d’identifier les couples « répertoire de production » (1) et « répertoire de test « (2).
Mettre à jour un répertoire :
L’abonnement aux notifications de mises à jour ou la consultation des journaux, vous permet d’être informé de la mise à la disposition d’un patch ou de la mise à disposition d’une version majeure par votre éditeur. Le bouton « Mettre à jour le répertoire » vous permet de lancer « ForterroAdminVersion.exe » pour le répertoire sélectionné dans l’arborescence.
2.5.2. Processus de mise à jour
L’écran de « ForterroAdminVersion.exe » se présente de la façon suivante :
Dans cet exemple, 2 mises à jour disponibles.
Le nombre de versions disponibles peux varier en fonction de la version de départ.
Dans ce cas 4 mises à jour.
Dans le cas où la version est à jour, aucune mise à jour n’est proposées.
2.5.1.1. Etape 1 : Prérequis
Le répertoire de test :
Le répertoire de test doit exister, il doit contenir une copie de la version de production avec vos personnalisations.
A T0, la version du répertoire de test doit être la même que celle de l’environnement de production.
Le fichier des profils de base de données de cet environnement de test ne doit contenir que les profils de test. Dans ces profils, il n’est pas nécessaire d’activer les paramètres suivants.
Ces paramètres sont surtout important pour le répertoire de production, pour indiquer les bases de données à mettre à jour en automatique lors d’un passage de version en production et pour indiquer les bases de données de production à répliquer en environnement de test.
S’il s’agit de la première mise en place de cet environnement de test ou en cas de doutes, le plus sûre est de supprimer le fichier d’extension « ProfilsERP.prf » s’il est présent dans le répertoire « Utilisateurs\Communs\Menu » du répertoire de test. L’étape de préparation de l’environnement de test regénérera ce fichier avec seulement les profils concernés par les tests et aucun paramètre activé.
Le répertoire de production :
Chaque profil de base de données de production doit être correctement paramétré :
« Migration automatique par ForterroAdminversion » : Ce paramètre permet de déclencher la mise à jour de la base de données concernée automatiquement après avoir fait la mise à jour du répertoire (Etape 2).
« Répliquer en environnement de tests » : Cette option désigne les profils de production à répliquer en environnement de test. Il faut pour chaque profil concerné par les tests saisir le serveur SQL et le nom de la base de données de test à créer.
Si l’option « Neutraliser la base de test » est activée, alors la base de test sera neutralisée. La neutralisation consiste à verrouiller les communications avec l’extérieure pour éviter l’envoi de notifications à la destination de tiers lors de la phase de test.
=>Recodification des serveurs d’envoi de mail avec le prefixe suivant 'EnvTest_' pour éviter la diffusion des mails dans l’ERP de test.
=>Désactivation des Job EDI, la zone « Actif » prend la valeur 0.
=>Désactivation des transferts en comptabilité, la zone « RepertoireFTransf » est blanchie.
=>Désactivation du service Workflow.
2.5.1.2. Etape 2 : Mettre à jour un répertoire dans la dernière version de l’ERP
Cette étape permet de mettre à jour le repertoire désiré dans une des mises à jour proposée par « ForteroAdminVersion.exe »
L’exemple suivant concerne un répertoire de test :
Sélectionner la version d’arrivée désirée dans l’écran de « ForterroAdminVersion.exe » (1) puis faire « Lancer le traitement » (2).
La mise à jour dans une version, passe automatiquement toutes les version intermédiares. Il est donc inutile de faire cette opération pour toutes les versions listées.
Une confirmation est demandée.
Valider la confirmation
Une fenêtre est affichée avant mise à jour des répertoires de tests ou de production, cette fenêtre affiche les profils de bases de données qui seront mis à jour en fonction des options côchées dans les profils.
Cela permet de confirmer les bases de données à migrer avant mise à jour.
Si vous n'êtes pas d’accord avec la mise à jour des profils affichés, il est possible d’annuler la mise à jour.
Vous devrez alors configurer correctement les profils des bases de données dans les répertoires ERP de production et/ou de test.
Une jauge de progression du traitement est affichée.
Suivant les options demandées lors de la déclaration des répertoires, les sauvegardes sont effectuées, répertoires puis bases de données.
Un zip est créé dans le répertoire désigné comme sauvegarde du répertoire si cette option est activée. Ce zip est préfixé par le nom du répertoire.
Tous les autres fichiers d’extension « zip » (avec le même préfixe) présent sont supprimés si la sauvegarde a fonctionné.
Si vous désirez conserver une sauvegarde (zip), il suffit de changer le préfixe.
Idem pour les bases de données. Les bases désignées dans les profils du répertoire comme devant être migrées automatiquement par « ForteroAdminVersion » sont sauvegardées. Le principe est similaire au cas précédent, Le préfixe est le nom du serveur + nom de la base de données. Pour conserver une sauvegarde, il suffit de renommer le préfixe, car les suvegardes antérieurs sont supprimées automatiquement.
A la fin du traitement, un message est affiché.
En cas d’erreur un message est affiché.
Pour consulter le détail des erreurs, valider le message, puis sélectionner le bouton « Consulter les logs »
Chaque traitement lancé dispose d’un log. L’écran suivant présente la liste des log.
Un double clic sur un élément permet de consulter le détail du traitement.
A la fin du traitement la version de l’ERP du répertoire est mise à jour après réactualisation de l’affichage.
Remarque : Les bases de données mises à jour sont les bases qui ont le paramètre de leur profil « Migration automatique par ForterroAdminversion » activé. Comme indiqué précédemment, il n’est pas utile de d’activer ce paramètre pour le répertoire de test car l’étape suivante va mettre à jour les profils de test.
2.5.1.2. Etape 3 : Préparer l’environnement de test
Cette étape ne concerne que l’environnement de test. Elle permet de préparer l’environnement de test avec les copies des bases de données de production migrées dans la version de l’ERP de test.
Seules les bases de données de production configurées dans les profils de production comme devant être répliquées en environnement de test seront répliquées en base de test.
La mise à jour des bases de données de tests est effectuée systématiquement par ce traitement, quelle que soit la valeur du paramètre « Migration automatique par ForterroAdminVersion » du profil dans le répertoire de test. C’est pourquoi il est important d’avoir réalisé l’étape précédente.
Si les profils n’existent pas ils sont créés, sans aucun paramètre activé concernant la mise à jour ou la réplication.
Cette préparation s’effectue à partir de l’environnement de production :
Dans l’arborescence des environnements, sélectionner la version de production concernée (1),
Sélectionner ensuite le bouton « Mettre à jour le répertoire ».
Puis cliquer sur l’option présente dans la liste nommée « Préparer l’environnement de test » (1) et enfin sélectionner le bouton « Lancer le traitement » (2).
Ce-dernier va créer les bases de données de tests et les profils pour le répertoire de test associé au répertoire de production. Les bases de production concernées sont désignées dans les profils de l’ERP de production. Les bases de données de tests sont migrées dans la version de l’ERP de test.
Une validation est proposées. Répondre « OUI ».
Les étapes du traitements sont affichées.
A la fin du traitement la fenêtre est fermée s’il n’y a pas d’erreur.
En cas d’erreur, un message est affichée.
Pour consulter le détail des erreurs, valider le message, puis sélectionner le bouton « Consulter les logs »
Chaque traitement lancé dispose d’un log. L’écran suivant présente la liste des log.
Un double clic sur un élément permet de consulter le détail du traitement.
2.5.3. Bilan de la mise à jour
Dans le répertoire où la version a été mise à jour, plusieurs sous répertoires
« ForterroAdminVersionSilog » : Il contient la version d’admin version compatible avec la dernière mie à jour.
« LOGS_ForterroAdminVersion » : Il contient les logs de mises à jour
« InstallSauvegarde » : Il contient les sauvegardes des fichiers remplacés et des scripts passés pour chaque mise à jour.
2.5.4. Lancer les mises à jour en ligne de commande
Il est possible de programmer les mises à jour automatiques de l’ERP dans le planificateur de tâches.
La ligne de commande est la suivante.
Pour préparer un environnement de test :
« Chemin de l’erp à mettre en test../ForterroAdminVersion.exe" /MaJAuto=TEST2
Pour mettre à jour un répertoire ERP avec un patch ou CS (ne fonctionne pas pour passer dans une version majeur) :
« Chemin de l’erp à mettre à Jour/ForterroAdminVersion.exe" /MaJAuto=MAJ