Pour migrer plusieurs sessions Pacbase, vous devez utiliser
le même espace de travail en liaison avec un seul flux Rational Team Concert réservé
à la migration.
Avant de commencer
Créez le flux de migration dans Rational Team Concert. Ce flux
doit prendre en compte les scanners Rational Programming
Patterns. Pour éviter tout conflit entre l'exécution de ces scanners
et la remontée dans le serveur Rational Team Concert, positionnez
le délai d'exécution à
-1 durant toute la migration.
Pour cela, effectuez les actions suivantes :
- Connectez-vous en tant qu’administrateur à https://[nom
de système hôte qualifié complet]:9443/ccm/admin.
- Sous l’entrée Configuration, cliquez sur Propriétés
avancées.
- Déroulez les propriétés jusqu’à la catégorie Collecte
de données du code source. Déroulez cette catégorie jusqu’à
la ligne com.ibm.team.enterprise.internal.metadata.collection.service.MetadataCollectionLoopTaskService.
- Modifiez la valeur de la propriété Source Code Data
Scanning Fixed Delay (seconds). Cliquez sur sa valeur
en cours et indiquez -1 à la place.
Le déroulement de la migration de chaque session est identique.
Vous devez enchaîner les étapes suivantes :
Procédure
- Extrayez les données avec les procédures MIBA ou MIBR.
Ces procédures fournissent la liste des Macros à générer par la procédure MIMA et
les entrées des procédures MIA1, MIA2, MIA3 et MIA4.
- Transférez les fichiers vers le poste sur
lequel sont installées les parties clientes de Rational Programming Patterns et des produits
requis. Vous devez transférer les fichiers issus de la migration dans
un même répertoire.
Avertissement : Le fichier .ta2 qui
reçoit les mouvements du journal depuis la précédente migration ne
doit pas être nommé MIBR.ta2. Nommez-le, par
exemple MIBJ.ta2 pour le distinguer du résultat
d'une migration initiale.
- Exécutez la commande de migration automatique rpp
--automaticMigration.
Indiquez le paramètre --validationFile dans
la commande de migration automatique pour lancer la validation de
la migration en même temps que l'aide à la migration. L'aide à la
migration migre alors les fichiers COBOL ne comportant plus de différences
après l'application des types de validation et valide leur migration
en même temps. Elle produit un fichier .log indiquant
le nombre de fichiers COBOL validés. Cependant, avant d'indiquer le
paramètre --validationFile sur la commande de migration
automatique, il est conseillé de vérifier que les types de validation
contenus dans le fichier validation.xml sont
adaptés. Lancez la validation de la migration depuis la vue Gestionnaire
de validation sur un nombre significatif de fichiers COBOL.
Si les résultats de la validation vous conviennent, vous pouvez alors
lancer la migration automatique avec le paramètre --validationFile.
- Exécutez le fichier de commandes résultat. Ce fichier doit
comporter les commandes suivantes :
- La commande d'import du fichier .ta2 produit
par les procédures Pacbase : rpp
--import.
- La commande de répartition du code source des Macros : rpp
--dispatchMacro.
- La commande d'aide à la migration : rpp --migrationHelp.
Cette commande est lancée automatiquement avec le paramètre --validationFile indiqué
dans la commande de migration automatique.
- Sauvegardez les données dans Rational Team Concert.
- Prenez une image instantanée du flux de migration. Depuis
la vue Artefacts de l'équipe, faites un clic
droit sur le flux et sélectionnez .
- Construisez les index serveur.
Dans la perspective Eléments
de travail, vous devez sélectionner le flux de migration
afin qu'il soit analysé. Pour cela, dans la vue Artefacts
de l'équipe, sous votre zone de projet, sélectionnez .
Pour lancer la construction des index, sélectionnez
le choix Mettre à jour les données de code source sur
le flux de migration.
- Dupliquez le flux de migration. Depuis la vue Artefacts
de l'équipe, faites un clic droit sur le flux et sélectionnez Dupliquer.
- Mettez à jour les index serveur.
Dans la
perspective Eléments de travail, vous devez
sélectionner le flux dupliqué pour qu'il soit analysé. Pour cela,
dans la vue Artefacts de l'équipe, sous votre
zone de projet, sélectionnez .
Pour lancer
la mise à jour des index, sélectionnez le choix Mettre
à jour les données de code source sur le flux dupliqué.
Résultats
A la fin de la migration de chaque session, copiez l'espace
de travail local. Cet espace de travail peut servir dans le cadre
d'une migration progressive.
A partir de la migration de la
deuxième session, certains traitements diffèrent, même si les étapes
sont identiques.
En effet, vous devez indiquer le paramètre --previousSessionFolder dans
la commande de migration automatique pour chaque nouvelle session.
Ce paramètre réduit le temps de migration car les fichiers COBOL identiques
dans les deux sessions (hormis les constantes Pacbase et la date de génération)
ne sont pas réimportés. De plus, les commandes rpp --import et rpp
--dispatchMacro ne prennent alors en compte que les instances
ayant évolué.
Seules les vraies différences sont ainsi remontées
dans le serveur Rational
Team Concert.