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
Procédure
- Migration des utilisateurs
- 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.
- 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
utilisateursC:\...\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é.
- Migration d'une base de développement
- 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.
- 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.
- 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 à saisirCommandes à 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.
- Alimentation de l'espace de travail local
- 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
( par défaut).
Indiquez le nom de l'espace de travail qui sera utilisé pour la migration.
Exécution du fichier de commandes
Lancez la commande
rpp --commands en
indiquant le fichier
location.txt comme option.
Figure 3. Syntaxe de rpp.batSyntaxe: 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 :
- 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.
- 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.
- 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.