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. Vous pouvez éviter tout conflit entre l'exécution de ces
scanners et la remontée dans le serveur Rational Team Concert de la
façon suivante :
- A partir de Rational
Team Concert V6.0.1, effectuez les actions suivantes :
- Dans la vue Artefacts de l'équipe, sous
votre zone de projet, sélectionnez .
- Sélectionnez Ouvrir des configurations d'examen pour
configurer l'analyse des données du code source du flux.
- Désélectionnez l'option Activé pour l'examen en arrière-plan.
- Avec Rational
Team Concert V5.0.2 ou V6.0, 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 .
A partir de Rational Team Concert V6.0.1,
vous configurez l'analyse des données du code source du flux avec
le choix Ouvrir des configurations d'examen.
Pour savoir comment faire, suivez les instructions de la documentation Rational Team Concert : Création d'une configuration d'examen pour le flux.
Avec Rational Team Concert V5.0.2
ou V6.0, sélectionnez Sélectionner des flux pour l'analyse et
sélectionnez le flux. Pour lancer la construction des index, sélectionnez
le choix Réinitialiser 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 .
A partir de Rational Team Concert V6.0.1,
vous configurez l'analyse des données du code source du flux avec
le choix Ouvrir des configurations d'examen.
Pour savoir comment faire, suivez les instructions de la documentation Rational Team Concert : Création d'une configuration d'examen pour le flux.
Avec Rational Team Concert V5.0.2
ou V6.0, sélectionnez Sélectionner des flux pour l'analyse et
sélectionnez le flux. 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.