Commande WASMigrationAppInstaller
La commande WASMigrationAppInstaller pour WebSphere Application Server Version 9.0 fait migrer des applications à partir d'une version précédemment installée de WebSphere Application Server dans la nouvelle version. Seules les applications qui ne sont pas déjà installées sont migrées.
Emplacement
Le fichier de commande est situé dans le répertoire Version 9.0 profile_root/bin et doit être exécuté à partir de ce répertoire.Pour un gestionnaire de déploiement avec des noeuds fédérés, exécutez la commande uniquement à partir du répertoire profile_root/bin du gestionnaire de déploiement et jamais à partir du profil de noeud fédéré. Pour les nœuds autonomes, exécutez la commande à partir du répertoire des noeuds profile_root/bin.
Autorité
Pour exécuter ce script de commandes, votre profil utilisateur doit avoir l'autorisation *ALLOBJ.
Syntaxe
WASMigrationAppInstaller backupDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
Paramètres
Les paramètres de la commande sont les suivants :
- Il s'agit d'un paramètre obligatoire que vous devez spécifier en premier. La valeur
backupDirectory spécifie le nom du répertoire à partir duquel la commande charge les données de configuration et exécute des scripts qui installent les applications.
Eviter les incidents: Les répertoires racine WAS_INSTALL et USER_INSTALL ne sont pas des répertoires valides pour l'emplacement du répertoire de sauvegarde de WebSphere Application Server.gotcha
C'est également le répertoire à partir duquel la commande WASPostUpgrade lit la configuration.
- Paramètre facultatif. La valeur properties_file_name spécifie le chemin d'accès vers un fichier de propriétés contenant les propriétés de paramètres qui définissent la façon dont les outils de migration tels que WASMigrationAppInstaller fonctionnent.
Vous pouvez définir les propriétés des paramètres dans le fichier de propriétés de migration, plutôt que de spécifier la plupart des paramètres facultatifs sur la ligne de commande. Si les paramètres sont définis dans le fichier de propriétés et spécifiés sur la ligne de commande, les paramètres spécifiés sur la ligne de commande ont priorité.
Remarque : Certains paramètres ne peuvent pas être spécifiés dans le fichier de propriétés, tels que le paramètre lui-même -properties et -javaoption. Pour une liste des paramètres qui ne peuvent pas être définis comme une propriété, consultez le fichier modèle migration.properties dans le répertoire app_server_root/bin. - Paramètre facultatif. La valeur spéc_trace spécifie
les informations de trace que vous voulez collecter.
Pour rassembler toutes les informations de trace, indiquez "*=all=enabled" (avec des guillemets).
Si vous n'indiquez pas les paramètres -traceString ou -traceFile,la commande crée un fichier de trace par défaut et le place dans le répertoire RépertoireSauvegarde/logs.
- Paramètre facultatif. La valeur nom_fichier spécifie
le nom du fichier de sortie pour les informations de trace.
Si vous n'indiquez pas les paramètres -traceString ou -traceFile,la commande crée un fichier de trace par défaut et le place dans le répertoire RépertoireSauvegarde/logs.
- Paramètre facultatif. Utilisez ce paramètre pour indiquer des tailles de mémoire du segment de mémoire Java™ utilisé par la commande WASPreUpgrade.
La valeur "-Xms...m" est le paramètre spécifié pour indiquer la taille de segment de mémoire de départ. Remplacez le "..." par la taille en mégaoctets que vous prévoyez d'utiliser. Par exemple, si la taille de segment de mémoire de départ doit être 128 Mo, spécifiez le paramètre comme suit : -javaoption -Xms128m
La valeur "-Xmx...m" est le paramètre spécifié pour indiquer la taille de segment de mémoire maximale. Remplacez le "..." par la taille en mégaoctets que vous prévoyez d'utiliser. Par exemple, si la taille de segment de mémoire maximale doit être 1024 Mo, spécifiez le paramètre comme suit : -javaoption -Xmx1024m
Journalisation
L'outil WASMigrationAppInstaller affiche le statut à l'écran au cours de l'exécution. L'outil sauvegarde également un ensemble d'informations de consignation plus détaillées dans le fichier WASMigrationAppInstaller.horodatage.log écrit dans le répertoire RépertoireSauvegarde, où RépertoireSauvegarde est la valeur définie pour le paramètre RépertoireSauvegarde. Vous pouvez afficher le fichier WASMigrationAppInstaller.time_stamp.log avec un éditeur de texte.
Ressources migrées
L'outil WASMigrationAppInstaller migre uniquement les applications qui ne sont pas déjà installées dans la version cible. Si des applications ne sont pas installées avec succès, vous pouvez exécuter l'outil autant de fois que nécessaire sans avoir à réinstaller à plusieurs reprises les mêmes applications.
L'outil installe également automatiquement des applications de niveau métier (BLA).