Commande WASPreUpgrade
La commande WASPreUpgrade pour WebSphere Application Server Version 9.0 enregistre dans un répertoire de sauvegarde spécifique à la migration la configuration d'une version WebSphere Application Server installée précédemment.
Emplacement
Le fichier de commande est situé dans le répertoire Version 9.0 racine_serveur_app/bin et doit être exécuté à partir de ce répertoire.
Syntaxe
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPreUpgrade.sh backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-machineChange true | false]
[-oldProfile profile_name]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name >]
[-password < password >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
![[Windows]](../images/windows.gif)
WASPreUpgrade.bat backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-machineChange true | false]
[-oldProfile profile_name]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name >]
[-password < password >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
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 répertoireSauvegarde spécifie le nom du répertoire où le script de commandes conserve la configuration sauvegardée.
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.
Si le répertoire n'existe pas, le script de commandes WASPreUpgrade le crée.
- Il s'agit d'un paramètre obligatoire que vous devez spécifier en deuxième. Il peut s'agir de n'importe quelle édition de WebSphere
Application Server
Version 7.0 ou ultérieures pour laquelle la migration est prise en charge.
La valeur currentWebSphereDirectory spécifie le nom du répertoire racine de l'installation pour l'installation de WebSphere Application Server de source.
- Ce paramètre est 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 WASPreUpgrade 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 -username et -password. 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. - Ce paramètre est 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.
- Ce paramètre est 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.
- Ce paramètre est un paramètre facultatif utilisé pour une migration incluant différents systèmes d'exploitation et systèmes. Si la valeur indiquée est true, ce paramètre permet de changer de configuration matérielle physique
lors de la migration en effectuant une sauvegarde des éléments stockés en dehors de l'installation ou de la hiérarchie de dossiers de profil WebSphere
Application Server. Si ce paramètre reçoit la valeur false, seuls les fichiers stockés sous le dossier d'installation ou les dossiers de profil de WebSphere
Application Server sont copiés vers le répertoire de sauvegarde lors de la migration.
La valeur par défaut est false.
Si la valeur de ce paramètre est false, la migration suppose que la nouvelle et les anciennes installations de WebSphere Application Server résident sur la même machine physique avec un accès partagé au système de fichiers. Par conséquent, les fichiers qui ne se trouvent pas dans les répertoires WebSphere sont communs et peuvent être partagés. La migration ne copie pas dans le répertoire de sauvegarde les fichiers situés en dehors de l'arborescence de WebSphere Application Server lorsque la valeur de -machineChange est false. False est la seule option lorsque vous utilisez l'assistant de migration. Si vous sélectionnez -machineChange=false, vous devez exécuter la commande WASPostUpgrade sur le même matériel.
Si vous envisagez d'exécuter la commande WASPostUpgrade sur une machine ou un système de fichiers différent, vous devez exécuter la commande WASPreUpgrade en spécifiant -machineChange=true. Si vous sélectionnez -machineChange=true, la migration crée un sous-répertoire supplémentaire (/migrated/) dans le répertoire de sauvegarde de la migration pour héberger les fichiers référencés par la configuration WebSphere Application Server et résidant en dehors des répertoires du produit ou de profils. Lorsque vous exécutez la commande WASPostUpgrade, ces fichiers sont replacés dans leur chemin d'origine sur la nouvelle machine.
Remarques sur les performances :Si vous procédez à la migration à l'aide des bus d'intégration de service (SIB) configurés avec les référentiels de stockage de fichiers du système de fichiers, il se peut que vous nécessitiez de l'espace supplémentaire dans votre répertoire de sauvegarde et de segment de mémoire pour la migration. Chaque bus est associé à trois valeurs de stockage de fichiers : un journal, un espace temporaire et un référentiel. La taille de ces trois fichiers varie et chaque fichier peut atteindre entre 100 et 500 Mo. lorsque la migration est en cours, elle sauvegarde les magasins de fichiers situés sous l'arborescence de WebSphere Application Server lors du processus préalable à la mise à niveau. L'espace disponible dans le système de fichiers doit être suffisant pour permettre cette opération. Si des magasins de fichiers existent déjà à l'emplacement cible lors du processus post-mise à niveau, la migration les sauvegarde en mémoire afin de permettre la restauration.
Si vous exécutez la commande WASPreUpgrade en spécifiant -machineChange=true, qui crée un répertoire de sauvegarde contenant les objets des magasins de fichiers partagés, il se peut que des exceptions de saturation de mémoire soient émises lors du processus de post-mise à niveau car la taille maximale du segment de mémoire est trop petite pour contenir les sauvegardes des magasins de fichiers en vue d'une restauration. Pour résoudre cet incident, effectuez l'une des trois tâches suivantes : - Il s'agit d'un paramètre facultatif utilisé pour faire migrer une instance ou un profil spécifique depuis une version antérieure de WebSphere Application Server.
- Ce paramètre est facultatif. La valeur nom_dossier_espace_travail_utilisateur_x indique l'emplacement des paramètres personnalisés "Mes tâches" de la console d'administration pour un ou plusieurs profils.
- Ce paramètre est facultatif. la valeur nom utilisateur indique le nom d'administrateur de l'installation
WebSphere
Application Server
actuelle.Ce paramètre est obligatoire dans les conditions suivantes :
- Lorsque vous migrez un gestionnaire de déploiement.
- La sécurité d'administration ou la sécurité globale est activée dans l'installation source.
- Lorsque vous migrez l'installation de WebSphere Application Server à partir de la version 8.0 ou versions ultérieures.
- Ce paramètre est facultatif. La valeur password indique le mot de passe
d'administration de l'installation WebSphere
Application Server en cours.Ce paramètre est obligatoire dans les conditions suivantes :
- Lorsque vous migrez un gestionnaire de déploiement.
- La sécurité d'administration ou la sécurité globale est activée dans l'installation source.
- Lorsque vous migrez l'installation de WebSphere Application Server à partir de la version 8.0 ou versions ultérieures.
- Ce paramètre est 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 maximale est de 1 024 Mo, définissez le paramètre -javaoption -Xmx1024m
- Il s'agit d'un paramètre facultatif utilisé pour la migration de bases de données imbriquées.
Si la valeur true est spécifiée, les exceptions qui se produisent lorsque vous migrez des bases de données imbriqués entraînent l'échec de la commande WASPreUpgrade. Si la valeur false est spécifiée, les exceptions qui se produisent lorsque vous migrez des bases de données imbriqués sont consignées dans le fichier de trace et la commande WASPreUpgrade continue.
La valeur par défaut est true.
- Il s'agit d'un paramètre facultatif utilisé pour la migration d'un profil de gestionnaire de déploiement version 8.0.
Lorsque WASPreUpgrade s'exécute, les profils de gestionnaire de déploiement version 8.0 sont arrêtés. Par défaut, le gestionnaire de déploiement reste arrêté. Si la valeur true est spécifiée, WASPreUpgrade démarre le gestionnaire de déploiement avant la fin de l'exécution de la commande.
La valeur par défaut est false.
Consignation
L'outil WASPreUpgrade 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 WASPreUpgrade.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 WASPreUpgrade.horodatage.log avec un éditeur de texte.
Ressources migrées
WASPreUpgrade sauvegarde toutes vos ressources mais ne fait pas migrer les entités dans votre répertoire classes.