Chapitre 4. Migration
La migration de vos projets de Red Hat JBoss BPM Suite 5 à Red Hat JBoss BPM Suite 6 exige une planification minutieuse et une évaluation étape par étape des différentes questions. Vous pouvez planifier des migrations, soit manuellement, soit en utilisant des processus automatiques. La plupart des migrations nécessiteront une combinaison des deux.
Comme JBoss BPM Suite 6 utilise GIT pour le stockage des ressources, des artefacts et des référentiels de code comprenant des procédures et des règles, vous devez commencer par créer un projet vide dans JBoss BPM Suite 6 comme base pour votre migration avec des fichiers factices comme espaces réservés pour vos différentes ressources et artefacts. En exécutant un clone GIT de ce projet vide dans votre IDE préféré, vous initierez le procesus de migration.
Sur la base des fichiers d'espace réservé dans votre projet cloné, vous pouvez commencer à ajouter des ressources dans les emplacements corrects. Le système de JBoss BPM Suite 6 est assez intelligent pour prendre ces changements en compte et les appliquer correctement. Assurez-vous bien que, lorsque vous importez des vieux fichiers de règles, qu'ils soient importés avec la bonne structure de nommage de package.
Comme Maven est utilisé pour créer des projets, les ressources de projets comme les règles, processus et modèles sont accessibles sous forme de simple fichier jar.
Cette section fait la liste des manières de migrer votre projet étape par étape. Cependant, il ne s'agit là que de lignes directrices, et la migration peut varier sérieusement de ce modèle.
En général, vous devez...
- Commencer par migrer les données : ce sont vos ressources d'entreprise.
- Puis, migrer vos processus de runtime.
- Enfin, convertissez vos anciens appels d'API en nouveaux, l'un après l'autre.
Voyons ces étapes en détail dans les prochaines sections.
4.1. Migration des données Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
Pour migrer des données de Red Hat JBoss BPM Suite, procédez ainsi :
- Télécharger l'outil de migration en vous connectant sur le Portail client de Red Hat, puis naviguer vers la section de téléchargements des logiciels Red Hat JBoss BPM Suite. Cliquer sur Red Hat JBoss BPM Suite Migration Tool pour télécharger l'archive zip.
- Décompresser l'archive zip téléchargée dans un répertoire de votre choix, et naviguer vers ce répertoire par l'intermédiaire d'une invite de commande. Ce répertoire contient quatre dossiers :
bin
- contient les scripts de lancement.jcr-exporter-libs
- contient les fichiers libs spécifiques à la partieexport-from-JCR
de la migration.jcr-importer-libs
- contient les fichiers libs spécifiques à la partieimport-from-Git
de la migration.conf
- contient la configuration de l'outil de migration global.
- Pour les bases de données de production, copier le pilote JDBC pour la base de données utilisée par le référentiel JCR du répertoire
jcr-exporter-libs
de l'outil de migration. - Exécuter la commande suivante :
./bin/runMigration.sh -i <source-path> -o <destination-path> -r <repository-name>
./bin/runMigration.sh -i <source-path> -o <destination-path> -r <repository-name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Où :
- <source-path> est un chemin d'accès vers le référentiel JCR source.
- <desintation-path> est un chemin d'accès vers une destination GIT VFS. Ce dossier ne doit pas être déjà existant.
- <repository-name> un nom arbitraire de nouveau référentiel.
Le référentiel est ensuite migré vers l'emplacement spécifié.
En plus de la commande
-i
, vous pouvez également utiliser -h
pour imprimer un message d'aide et -f
qui oblige un écrasement du répertoire de sortie, éliminant ainsi le besoin de suppression manuelle de ce répertoire.
Comment importer un référentiel de Business Central
Le référentiel peut être importé dans Business Central en le clonant. Dans la perspective Administration, cliquer sur le menu
, puis cliquer sur le menu pour démarrer le processus.
Note
Les ressources peuvent être migrées manuellement. Après tout, ce ne sont que des fichiers de texte. La spécification BPMN2 et la syntaxe DRL n'ont pas changé entre les versions.
Importer le référentiel dans JBDS
Pour importer le référentiel dans JBoss Developer Studio, proécéder ainsi
- Démarrer JBoss Developer Studio
- Démarrer le serveur Red Hat JBoss BPM Suite (s'il n'est pas déjà en cours d'exécution) en sélectionnant le serveur à partir de l'onglet serveur et en cliquant sur l'icône de démarrage.
- Sélectionner
et naviguer dans le fichier Git. Ouvrir le dossier Git et sélectionner puis cliquer Suite. - Sélectionner la source du référentiel en tant queet cliquer sur Suite.
- Sélectionner le référentiel qui doit être configuré à partir de la liste de référentiels disponibles.
- Importer le projet en tant que projet général dans la prochaine fenêtre et cliquer sur Suite. Nommer ce projet et cliquer sur Terminer.