Les étapes de l’extraction et de la migration

Vous pouvez extraire et migrer les utilisateurs et les bases de développement Pacbase. Jazz peut s'interconnecter avec un LDAP ou un système de sécurité tel que RACF. Dans ce cas, il n'y aura pas de migration des utilisateurs Pacbase.

Pourquoi et quand exécuter cette tâche

Voici le schéma général des actions d'extraction et de migration des données Pacbase.
Figure 1. Schéma général de la migration
Ce schéma montre l'extraction des utilisateurs et des instances depuis Pacbase, la génération des Macros et des Programmes et leur transfert vers l'espace de travail local. Il montre aussi la génération locale et le transfert des utilisateurs et des instances (modèles et fichiers générés) dans Rational Team Concert

Procédure

  1. Migration des utilisateurs
    1. Extraction

      Extrayez et transférez, depuis la base d'administration, tous les utilisateurs avec la procédure Pacbase MIUS.

      Cette procédure permet d'extraire les identifiants, noms et adresses de courrier électronique des utilisateurs.
      Remarque : Cette procédure est détaillée dans le guide d'installation Pacbase spécifique à votre plateforme.

      Les administrateurs Pacbase auront le droit JazzAdmins, tous les autres auront le droit JazzUsers.

    2. Chargement dans Rational Team Concert

      Importez les utilisateurs dans Rational Team Concert. Le serveur Jazz Team Server doit être ouvert.

      Vous devez transférer le fichier des utilisateurs extraits avec la procédure MIUS vers la machine sur laquelle est installé le serveur Jazz..

      Vous devez tout d'abord transformer le fichier ASCII, issu de l'extraction Pacbase, au format UTF-8. Pour ce faire, vous devez exécuter le fichier AsciiToUTF8.bat, situé sous la racine rpp de la Software Delivery Platform,. Saisissez la ligne de commande suivante :

      AsciiToUTF8 AsciiInputFile Utf8OutputFile

      où :
      • AsciiInputFile est le chemin complet du fichier issu de la procédure MIUS. Ce fichier est au format ASCII.
      • Utf8OutputFile est le chemin complet du fichier qui sera utilisé en entrée de -createUsers, la commande standard de création des utilisateurs de Rational Team Concert. Ce fichier est au format UTF-8.
      Remarque : Le fichier AsciiToUTF8.bat a été conçu pour fonctionner à l'emplacement où il est livré. Il est donc souhaitable de le conserver à cet endroit. Si vous le déplacez, vous devez le modifier.
      Pour charger les utilisateurs, vous devez ensuite saisir la commande -createUsers de la façon suivante :
      Figure 2. Lignes de commande de création des utilisateurs
      C:\...\IBM\JazzTeamServer\server\repotools-ccm -createUsers 
      	fromFile=C:\...\MIUSFILE (après conversion au format UTF-8)
       	repositoryURL=https://…:9443/ccm 
      	adminUserId=xxxx 
      	adminPassword=xxxx
      Remarque : Consultez l'aide Rational Team Concert pour des explications sur la commande -createUsers.

      Le journal repotools-ccm_createUsers.log permet de voir les erreurs éventuelles.

      Un utilisateur déjà créé est modifié.
      Avertissement : La tentative de mise à jour de l'utilisateur ADMIN peut entraîner l'erreur de mise à jour CRJAZ1350E. Ce code ne peut être réutilisé.
  2. Migration d'une base de développement
    1. Analyse préalable de la base Pacbase
      La procédure MIAM reprend et complète certaines fonctionnalités de l'analyse du référentiel :
      • Recherche des codes d'instances contenant des caractères spéciaux ou correspondant à un mot réservé Windows (LPT1 par exemple) : Alimentation du fichier CS.
      • Recherche des Programmes (P) qui sont à transformer en Macros : Alimentation du fichier PM.
      • Recherche des instances à ne pas reprendre (exemple : Etats pour maquette GDP) : Alimentation du fichier NR.
      • Alimentation du fichier RQ avec le détail des différentes recherches (exemple : liste des entités contenant un caractère spécial). Ce fichier peut être édité avec un tableur. Sa description est indiquée dans le guide d'installation Pacbase.
      Remarque : Référez-vous au guide d'installation Pacbase pour la liste complète des recherches.

      Vous devez analyser les résultats de cette procédure et effectuer toutes les actions indiquées dans le guide d'installation Pacbase avant de procéder à l’extraction. Vous devez, par exemple, gérer les caractères spéciaux et les instances ayant le même nom externe. Si la base contient des Blocs Bases de Données de type DB, vous devez exécuter la procédure TRDQ pour transformer leur type en Q2 avant la migration.

    2. Extraction de Pacbase
      Extrayez les données avec une des procédures d'extraction de Pacbase MIBA ou MIBR.
      MIBA permet une extraction chevelue d'une liste d'instances tandis que MIBR extrait toutes les instances du réseau ou sous-réseau sélectionné dans un contexte (une fois pas session).
      Remarque : La procédure MIBR peut être complétée par la procédure MIBU pour personnaliser la migration en prenant en compte des modifications de design (modification de la sélection des Segments dans l'appel d'une Structure de Données par exemple).

      Vous pouvez utiliser par la suite la procédure MIBJ pour extraire des mouvements du journal archivé Pacbase.

      Mettez en entrée deux fichiers issus de la procédure MIAM : le fichier PM des Programmes à transformer en Macros et le fichier NR des instances à ne pas reprendre.

      Ces procédures permettent également de transformer les caractères spéciaux non reconnus dans un code instance par un autre caractère. Pour cela, utilisez le fichier des caractères spéciaux issu de la procédure MIAM et complétez-le.

      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. Pensez à indiquer le code des cartes de contrôle optionnelles pour insérer des séparateurs dans les procédures MIAn.

      Remarque : Ces procédures sont détaillées dans le guide d'installation Pacbase spécifique à votre plateforme.
    3. Transfert des fichiers
      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 des procédures dans un même répertoire :
      • MIBA, MIBR ou MIBJ dans le fichier MIBR.ta2. Transférez aussi les listes d'entités générées dans les fichiers MIA1.txt, MIA2.txt, MIA3.txt et MIA4.txt.
      • MIMA dans le fichier MIMA.cblgen.
      • MIA1 dans les fichiers COBOL_MIA1.txt et CONTROL_COBOL_MIA1.txt
      • MIA2 dans les fichiers COBOL_MIA2.txt et CONTROL_COBOL_MIA2.txt
      • MIA3 dans les fichiers COBOL_MIA3.txt et CONTROL_COBOL_MIA3.txt
      • MIA4 dans les fichiers COBOL_MIA4.txt et CONTROL_COBOL_MIA4.txt
      Important : Vous devez faire attention aux pages de code utilisées lors du transfert.
      Pour transférer, par FTP, un fichier d'un environnement System z (EBCDIC français) vers le poste, vous devez saisir les informations suivantes dans un fichier file.scr :
      Tableau 1. Commandes de transfert FTP à saisir
      Commandes à saisir Explications
      open hostname Changez hostname par l'adresse de l'hôte origine.
      tsouid Changez tsouid par l'utilisateur TSO.
      tsopwd Changez tsopwd par le mot de passe TSO.
      quote site sbdataconn=(IBM-1147,ISO8859-1) Paramètres du transfert EBCDIC français vers ASCII.
      get 'NomFichierSurz' c:\NomFichierLocal Encadrez le nom du fichier System z par des guillemets simples (par défaut, il se positionne sur tsouid).
      quit  
      Vous lancez le transfert avec la commande : ftp -s:file.scr.
    4. Alimentation de l'espace de travail local
      1. Préparation des commandes de migration

        Exécutez d’abord la commande de migration automatique rpp --automaticMigration. Cette commande crée le fichier de commandes qui permet d’enchaîner l’import, la répartition des Macros et l’aide à la migration. Elle crée les répertoires des sources de migration en éclatant les différents programmes. Vous devez respecter la structure du répertoire contenant les fichiers transférés. Voir le paragraphe Transfert des fichiers.

        Veillez à bien utiliser les paramètres pour la création des projets contenant les sources COBOL. Ces projets peuvent être de type zComponent ou standard.

        Cette action crée deux fichiers de script pour les commandes SCM, localisés par défaut dans le répertoire .metadata de l'espace de travail :
        • scmtools_entries.bat, à utiliser lors du partage initial des fichiers produits par les procédures de migration Pacbase,
        • scmtools_entries_update.bat, à utiliser lorsque les projets de l'espace de travail local sont déjà partagés.

        La migration automatique produit un fichier location.txt (où location représente le nom du référentiel).

        Exemple d’une commande de migration automatique qui crée un projet de type zComponent et sépare les fichiers de source COBOL et les fichiers de métadonnées Rational Programming Patterns. Les fichiers de métadonnées seront stockés dans le répertoire design :

        rpp.bat --automaticMigration --data "C:\Migration\Workspace" --log "C:\Migration\automatic.log" --from "C:\Migration\Input" --location XXXX --separateCobolProject --cobolProjectType Z --separateMetadataFiles --pdpRootPath design --scmtoolsEntriesFile "C:\Migration\Commandes\scmtoolsEntries.bat"

        Important : La commande de migration automatique crée un espace de travail. Cet espace de travail n'étant pas indexé, il n'est pas recommandé de l'ouvrir avant de le remonter dans Rational Team Concert. Cependant, vous pouvez être amené à l'ouvrir dans certains cas. Si Rational Programming Patterns est installé par-dessus Rational Developer for System z, vous devez ouvrir l'espace de travail après l'exécution de la migration automatique car Rational Developer for System z copie automatiquement l'espace de travail lors de son ouverture. Comme l'espace de travail contient peu d'informations à ce moment-là, le temps de copie est limité. Si vous ouvrez l'espace de travail après l'exécution du fichier de commandes, le temps de copie sera beaucoup plus long.

        A l'issue de la migration automatique, vous devez lancer Rational Programming Patterns en mode graphique (Démarrer > Tous les programmes > IBM Software Delivery Platform > IBM Rational Programming Patterns par défaut). Indiquez le nom de l'espace de travail qui sera utilisé pour la migration.

      2. Exécution du fichier de commandes

        Lancez la commande rpp --commands en indiquant le fichier location.txt comme option.
        Figure 3. Syntaxe de rpp.bat
        Syntaxe: rpp.bat --commands [options]
                --data - Espace de travail. (obligatoire)
                --log - Nom du fichier de consignes. (défaut trace.log)
                --file - Fichier contenant la liste des commandes batch. (obligatoire)
                --exitOnError - Sortie en cas d'erreur d'une commande.
        Les étapes suivantes sont exécutées :
        1. Conversion des fichiers de design

          Cette étape initialise un espace de travail local contenant une hiérarchie de projets. Chaque projet contient les instances d'une Bibliothèque Pacbase.

          Pour valider l'import, vous pouvez analyser les erreurs contenues, par défaut, dans le fichier .pacmigration.log du répertoire .metadata de l'espace de travail. Ce fichier synthétise le contenu du fichier .ta2 importé en affichant les informations suivantes :
          • Le contexte de l'import comme la base, l'utilisateur, la session, la Bibliothèque et la date.
          • Le remplacement des caractères spéciaux.
          • Les statistiques des instances présentes dans le fichier .ta2. Ces chiffres incluent les instances dupliquées par les procédures de migration.
          • Les erreurs détectées lors de l'import.
          • Les Structures de Données et les Dialogues dupliqués par l'import.
        2. Répartition des fichiers sources des Macros

          Cette étape prend en entrée le fichier issu de la procédure MIMA et répartit les sources des Macros dans les Macros correspondantes des différents projets de votre espace de travail.

          Si des erreurs sont apparues au cours de la répartition, vous pouvez consulter le rapport d'erreurs .pacdispatchmacro.log dans le dossier .metadata de l'espace de travail.

        3. Aide à la migration

          Cette étape prend en compte les sources générés par MIAn et migre les fichiers COBOL des Programmes, Ecrans et Serveurs dans l'espace de travail.


Vos commentaires