L'outil de migration peut être exécuté à partir de la ligne de commande : à partir du répertoire EJBServer, exécutez la commande suivante :
build migrateiegscript -Dscriptfilename=myscript.sx
-Dinputdir=C:\mydir -Doutputdir C:\mydir\output
Les trois paramètres suivants sont obligatoires :
- scriptfilename : nom du fichier de définition de script IEG obsolète à migrer, sans spécifier son emplacement.
- inputdir : chemin d'accès complet au répertoire dans lequel se trouvent les artefacts IEG obsolètes à migrer. Il contiendra la définition de script indiquée dans scriptfilename, et tous les groupes de question et indices qu'il référence.
- outputdir : chemin d'accès complet au répertoire dans lequel les nouveaux artefacts de définition seront créés. Si l'outil est exécuté plusieurs fois, le contenu doit être supprimé pour éviter les surprises.
Les artefacts générés seront comme suit :
- La nouvelle définition de script se situera dans le répertoire clob, sous outputdir. Grâce à l'ID du script d'origine, il sera nommé scriptID.xml. Les indices se trouveront au même emplacement.
- Le schéma de magasin de données se situera dans le répertoire clob, sous outputdir. Il sera nommé scriptID.xsd.
- Tous les textes des scripts d'origine seront insérés dans les nouveaux fichiers de propriétés qui se trouvent dans le répertoire blob, sousoutputdir. Il sera généré un fichier par script et un fichier par page. Un fichier par page d'indice sera également ajouté. Les noms de fichier seront IDscript_version_type.properties ou IDscript_version_type_pageID.properties.
- Différents fichiers DMX seront automatiquement créés, de façon à ce que les artefacts générés puissent être insérés facilement dans une base de données. Les fichiers suivants sont créés :
- APPRESOURCE.dmx
- Ce fichier DMX va insérer une ligne par fichier de propriétés contenu dans le répertoire blob dans la table AppResource. Chaque ligne possède un ID ressource. Cet ID commence à 0, mais il doit être unique car il s'agit d'une clé pour la table. Si votre table contient déjà des enregistrements, vous aurez probablement à modifier ces ID manuellement avant d'exécuter le gestionnaire de données, afin que les ID restent uniques. Les propriétés s'appliqueront à la valeur par défaut (vide) de l'environnement local.
- IEGSCRIPTINFO.dmx
- Ce fichier DMX va insérer le script et les définitions d'indices figurant dans le répertoire clob dans la table IEGScriptInfo. Le nom du script sera identique à celui de l'ID du script.
- IEGSCRIPTRELS.dmx
- Ce fichier DMX va insérer les relations entre le script et ses indices dans la table IEGScriptRels. S'il n'existe aucun indice, ce fichier ne contient aucune ligne.
- DATASTORESCHEMA.dmx
- Ce fichier DMX va insérer le schéma de magasin de données figurant dans le répertoire clob dans la table DatastoreSchema.
- Un fichier journal généré par le système, nommé migration-log.txt, contient toutes les informations, avertissements et erreurs qui ont été rencontrés dans le processus de migration. Ce fichier doit être révisé après l'exécution de l'outil. Les contenus possibles de ce fichier sont les suivants :
- INFO : fournit des informations sur les étapes réalisées par l'outil : les scripts et indices migrés, les fichiers créés.
- WARNING : certaines étapes manuelles peuvent être requises pour exécuter la migration du script, ou une partie du contenu de l'ancien script n'a pas pu être introduite dans le nouveau script.
- SEVERE : si un événement imprévu survient lors de la migration, certaines informations sur le problème peuvent être trouvées ici.