Commande WASPreUpgrade

Emplacement

Le fichier de commande se trouve dans le répertoire Version 9.0app_server_root/bin et doit être exécuté à partir de ce répertoire.

Syntaxe

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]
                 [-allowSameRelease < true | false >]

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]
                  [-allowSameRelease < true | false >]

Paramètres

Les paramètres de la commande sont les suivants :

backupDirectory

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.

À éviter : les WAS_INSTALL répertoires racine et USER_INSTALL ne sont pas des emplacements valides pour le répertoire de sauvegarde de WebSphere Application Server.

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.

currentWebSphereDirectory

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 d' WebSphere Application Server, version 7.0 ou ultérieure, pour laquelle la migration est prise en charge.

La valeur « currentWebSphereDirectory » indique le nom du répertoire racine d'installation pour l'installation de l' WebSphere Application Server.

-propriétés

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 définis dans le fichier de propriétés, tels que le -properties paramètre lui-même, ainsi que -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.

-traceString

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.

-traceFile

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.

-machineChange

Ce paramètre est un paramètre facultatif utilisé pour une migration incluant différents systèmes d'exploitation et systèmes. Si ce paramètre est défini sur « true », il permet de prendre en charge le changement de matériel physique lors d'une migration en sauvegardant les éléments stockés en dehors de la hiérarchie des dossiers d'installation ou de profil d' WebSphere Application Server. Si cette option est définie sur « false », seuls les fichiers stockés dans le dossier d'installation d' WebSphere Application Server ou dans les dossiers de profil sont copiés dans le répertoire de sauvegarde lors de la migration.

La valeur par défaut est False.

Lorsque cette valeur est définie sur « false », la migration part du principe que les anciennes et nouvelles installations d' WebSphere Application Server s se trouvent sur la même machine physique et partagent l'accès 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 les fichiers situés en dehors de l'arborescence WebSphere Application Server vers le répertoire de sauvegarde lorsque la valeur de l'option ` -machineChange ` est définie sur `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 des migrations, qui contient tous les fichiers référencés par la configuration de l' WebSphere Application Server, mais qui se trouvent en dehors des répertoires du produit ou du profil. Lorsque vous exécutez la commande WASPostUpgrade, ces fichiers sont replacés dans leur chemin d'origine sur la nouvelle machine.

Considérations relatives aux 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 tous les magasins de fichiers présents dans l'arborescence « WebSphere Application Server » au cours du processus de pré-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 :

• Si les magasins de fichiers à l'emplacement du système sont valides, supprimez les copies à partir du répertoire de sauvegarde avant d'exécuter la commande WASPostUpgrade.

  Si vous supprimez l'intégralité du sous-répertoire /migrated/ à partir du répertoire de sauvegarde de la migration avant d'exécuter la commande WASPostUpgrade, vous remplacez principalement -machineChange=true par -machineChange=false pour la sauvegarde préalable à la mise à niveau.

• Si les copies des magasins de fichiers qui se trouvent dans le répertoire de sauvegarde sont valides, supprimez les versions à l'emplacement cible.

  Cette opération modifie la prise en charge de la restauration pour que les fichiers cible ne soient pas créés et n'occupent pas d'espace en mémoire lors de la migration.

• Si vous voulez prendre en charge la restauration et avez besoin des fichiers dans le répertoire de sauvegarde ainsi que des fichiers dans le système de fichiers, augmentez la taille maximale de votre segment de mémoire pour le processus post-mise à niveau en indiquant une valeur suffisamment élevée pour la prise en charge de tous les fichiers SIB conflictuels.

-oldProfile

Il s'agit d'un paramètre facultatif utilisé pour migrer une instance ou un profil spécifique depuis une version antérieure d' WebSphere Application Server.

-workspaceRoot

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.

-username

Ce paramètre est facultatif. La valeur « user name » indique le nom d'utilisateur administrateur de l'installation actuelle d' WebSphere Application Server.

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.
• L'installation d' WebSphere Application Server, à partir de laquelle vous effectuez la migration, est de version 8.0 ou ultérieure.

-password

Ce paramètre est facultatif. La valeur « password » correspond au mot de passe administrateur de l'installation actuelle d' WebSphere Application Server.

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.
• L'installation d' WebSphere Application Server, à partir de laquelle vous effectuez la migration, est de version 8.0 ou ultérieure.

-javaoption

Ce paramètre est facultatif. Utilisez ce paramètre pour définir la taille de la mémoire allouée au tas Java™ utilisé par la WASPreUpgrade commande.

La valeur "-Xms...m" est le paramètre défini pour indiquer la taille de segment de départ. Remplacez le "..." par la taille en mégaoctets que vous voulez utiliser. Par exemple, si la taille de segment de départ est de 128 Mo, définissez le paramètre -javaoption -Xms128m

La valeur "-Xmx...m" est le paramètre défini pour indiquer la taille de segment maximale. Remplacez le "..." par la taille en mégaoctets que vous voulez utiliser. Par exemple, si la taille de segment maximale est de 1 024 Mo, définissez le paramètre -javaoption -Xmx1024m

-requireEmbeddedDBMigration

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.

-keepDmgrEnabled

Il s'agit d'un paramètre facultatif utilisé pour la migration d'un profil de gestionnaire de déploiement.

Lorsque WASPreUpgrade s'exécute, les profils du gestionnaire de déploiement 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.

-allowSameRelease

Ce paramètre est facultatif. Lorsque ce paramètre est défini sur true, vous pouvez migrer un profil d' WebSphere Application Server, version 9.0, d'une installation d' WebSphere Application Server, version 9.0, vers une autre, y compris vers une installation sur une autre machine. Lorsque le -allowSameRelease paramètre est défini sur true, le -clone paramètre de la WASPostUpgrade commande doit être défini sur true.

Journalisation

L'outil WASPreUpgrade affiche le statut à l'écran au cours de l'exécution. L'outil enregistre également un ensemble plus complet d'informations de journalisation dans le WASPreUpgrade.time_stamp.log fichier situé dans le backupDirectory répertoire, où « backupDirectory » correspond à la valeur spécifiée pour le paramètre « backupDirectory ». Vous pouvez ouvrir le WASPreUpgrade.time_stamp.log fichier à l'aide d'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.