![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
WASPostUpgrade command
The WASPostUpgrade command for WebSphere Application Server retrieves the saved configuration that was created by the WASPreUpgrade command from the backupDirectory that you specified. The WASPostUpgrade script for WebSphere Application Server reads the configuration from this directory to migrate to WebSphere Application Server Version 9.0 and adds all migrated applications into the app_server_root/installedApps directory for the Version 9.0 installation.
Location

Cet article traite de la migration de configuration de profil. Pour faire migrer vos applications vers la dernière version, utilisez le kit d'outils de migration de WebSphere Application Server. Pour plus d'informations, voir Migration Toolkit on WASdev.
sptcfgThe command file is located in and must be run from the app_server_root/bin directory.
![[IBM i]](../images/iseries.gif)
Authority
To run this command script, your user profile must have *ALLOBJ authority.
Syntax
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname host_name]
[[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] |
[-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname host_name]
[[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] |
[-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[IBM i]](../images/iseries.gif)
WASPostUpgrade backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] |
[-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
![[IBM i]](../images/iseries.gif)
WASPostUpgrade backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
Paramètres
Les paramètres de la commande sont les suivants :
- Paramètre obligatoire. La valeur répertoire_sauvegarde spécifie le nom du répertoire dans lequel l'outil WASPreUpgrade garde la configuration et les fichiers sauvegardés et à partir duquel l'outil WASPostUpgrade lit la configuration et les fichiers.
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 WASPostUpgrade 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 ID utilisateur indique le nom d'administrateur de l'installation WebSphere
Application Server Version 7.0 ou ultérieures en cours. Ce paramètre est obligatoire dans les conditions suivantes :
- Ce paramètre est facultatif. La valeur mot de passe indique le mot de passe du nom d'administrateur de l'installation WebSphere
Application Server Version 7.0 ou ultérieures en cours.Ce paramètre est obligatoire dans les conditions suivantes :
Conseil : Si vous devez spécifier un mot de passe dans l'assistant de migration ou que vous utilisez la commande WASPostUpgrade avec le paramètre -password sur la ligne de commande, vous pouvez entrer le mot de passe en texte en clair ou utiliser la valeur chiffrée par xor. Pour utiliser la valeur chiffrée par xor, entrez l'intégralité du chiffrement, y compris le préfixe {xor}, comme valeur du paramètre. Cette valeur chiffrée par xor peut être spécifiée dans plusieurs fichiers de configuration de WebSphere Application Server de votre configuration précédente, notamment dans les fichiers soap.client.props, ssl.client.props et security.xml .
Conseil : Si vous utilisez la commande WASPostUpgrade avec le paramètre -password sur la ligne de commande, vous pouvez entrer le mot de passe en texte en clair ou utiliser la valeur chiffrée par xor. Pour utiliser la valeur chiffrée par xor, entrez l'intégralité du chiffrement, y compris le préfixe {xor}, comme valeur du paramètre. Cette valeur chiffrée par xor peut être spécifiée dans plusieurs fichiers de configuration de WebSphere Application Server de votre configuration précédente, notamment dans les fichiers soap.client.props, ssl.client.props et security.xml .
Il s'agit d'un paramètre facultatif utilisé pour migrer les instances ou les profils de versions WebSphere Application Server antérieures. L'instance ou le profil doit déjà exister dans le répertoire de sauvegarde de la migration avant d'exécuter cette commande.
Si le paramètre -oldProfile n'est pas spécifié, le profil par défaut est utilisé. Si aucun profil par défaut n'est détecté, le système signale une erreur.Eviter les incidents: Si vous n'indiquez aucun nom de profil spécifique pour -oldProfile, le profil "par défaut" désigné sera migré. Il peut être nécessaire de migrer chaque profil de la sauvegarde exécutée sur la pré-migration. Pour cela, utilisez la commande post-migratoire WASPostUpgrade en indiquant les paramètres -oldProfile et -profileName pour chaque profil dont le client a besoin dans le nouvel environnement Version 9.0. Si l'ancien profil contient, outre l'exemple d'application et les applications système, des applications installées (installedApps), le processus de migration migre automatiquement ces applications.gotcha
- Il s'agit d'un paramètre facultatif utilisé pour la
migration vers des profils spécifiques de WebSphere
Application Server Version 9.0. La valeur nom_profil spécifie le nom du profil Version 9.0 vers lequel le script fait migrer votre configuration. Vous devez avoir créé ce profil avant d'appeler la commande WASPostUpgrade. Si le paramètre -profileName n'est pas indiqué, le profil par défaut est utilisé. Si aucun profil par défaut n'est détecté, le système signale une erreur.
Eviter les incidents: Si vous n'indiquez aucun nom de profil spécifique pour -profileName, le profil "par défaut" désigné sera migré. Vous risquez de devoir migrer chaque profil de la sauvegarde exécutée sur la pré-migration. Pour cela, utilisez la commande post-migratoire WASPostUpgrade en indiquant les paramètres -oldProfile et -profileName pour chaque profil que le client souhaite dans le nouvel environnement. Si l'ancien profil contient, outre l'exemple d'application et les applications système, des applications installées (installedApps), le processus de migration migre automatiquement ces applications.gotcha
Remarque : Lors de la migration d'un serveur d'applications autonome à partir de la Version 9.0, vous pouvez sélectionner un noeud de serveur d'application autonome déjà enregistré auprès de l'agent d'administration en tant que cible de la migration. - Il s'agit d'un paramètre facultatif utilisé pour indiquer si la configuration existante de WebSphere
Application Server Version 9.0 doit être sauvegardée avant toute modification par l'outil WASPostUpgrade.
La valeur par défaut est "true" : la commande backupConfig est utilisée pour sauvegarder une copie de la configuration actuelle dans le répertoire nom_profil/temp.
Utilisez la commande restoreConfig pour restaurer cette configuration lorsque cela est nécessaire. Pour plus d'informations, voir Commande restoreConfig.
- Il s'agit d'un paramètre facultatif qui indique comment définir les ports pour le nouveau profil. Le paramètre adopte les valeurs suivantes :
Si une valeur est indiquée pour ce paramètre, tous les nouveaux ports affectés sont définis en fonction de cette valeur. Chaque fois qu'une nouvelle valeur de port est nécessaire, le port est créé en fonction de cette valeur et la valeur de départ est incrémentée pour la prochaine utilisation. Aucun port en double n'est affecté.
- Ce paramètre facultatif permet d'indiquer comment mapper les valeurs de port. Lorsqu'un port ne peut pas être utilisé, sa valeur de début est incrémentée jusqu'à ce qu'un port disponible soit trouvé.
- Vous pouvez inclure des applications
de niveau métier, des actifs et des unités de composition dans le cadre de la migration. Vous avez la possibilité de faire migrer ces éléments en utilisant le paramètre -IncludeApps avec la commande WASPostUpgrade.
Il s'agit d'un paramètre facultatif que vous pouvez spécifier selon les façons suivantes :
Les applications système WebSphere Application Server sont migrées quelle que soit la valeur de ce paramètre.
Ce paramètre facultatif indique si vous souhaitez effectuer une migration clone, ce qui signifie que vous pouvez continuer à utiliser le profil source après l'avoir migré vers l'environnement Version 9.0. La valeur par défaut est false.
Lorsque le paramètre -clone est true, vous ne pouvez pas spécifier -setPorts useold. La configuration du nouveau profil doit utiliser des numéros de port uniques afin que les configurations coexistantes nouvelles et anciennes ne rencontrent pas de conflits de ports.
Si vous clonez un gestionnaire de déploiement, vous devez également cloner ses noeuds fédérés, et vous ne pouvez pas cloner les noeuds fédérés sans cloner le gestionnaire de déploiement. Les migrations clones de noeuds fédérés exigent que vous définissiez le nouveau nom d'hôte et le port SOAP de noeud ou le port RMI sur les paramètres suivants.- -newDmgrHostname
- Nom d'hôte du gestionnaire de déploiement Version 9.0
- -newDmgrSoapPort
- Port SOAP (Simple Object Access Protocol) du gestionnaire de déploiement Version 9.0
- -newDmgrRmiPort
- Port Remote Method Invocation (RMI) du gestionnaire de déploiement Version 9.0
- Il s'agit d'un paramètre facultatif utilisé pour spécifier si le gestionnaire de déploiement WebSphere
Application Server
Version 7.0 ou ultérieures existant doit être désactivé.
La valeur par défaut est false.
La valeur par défaut est false sauf si le paramètre -clone est true, dans ce cas, -keepDmgrEnabled est également défini sur true.
Si ce paramètre a pour valeur true, vous pouvez utiliser le gestionnaire de déploiement Version 7.0 ou ultérieures existant pendant la migration. Il n'est valide que lors de la migration d'un gestionnaire de déploiement ; il est ignoré pour toutes les autres migrations.
Attention : Vous devez utiliser cette limite avec précaution. - Il s'agit d'un paramètre facultatif utilisé pour
spécifier si les applications doivent être installées dans les répertoires où elles se trouvent actuellement. La valeur par défaut est false.
Si ce paramètre est true, chaque application individuelle conserve son emplacement.
Si vous indiquez ce paramètre, vous ne pouvez pas spécifier le paramètre -appInstallDirectory.
Restrictions : Si ce paramètre a pour valeur true, l'emplacement est partagé par l'installation WebSphere Application Server Version 7.0 ou ultérieures existante et l'installation Version 9.0. Si vous conservez les applications migrées aux mêmes emplacements que ceux de la version précédente, les restrictions suivantes s'appliquent : - Il s'agit d'un paramètre facultatif utilisé pour transmettre le nom du répertoire à utiliser lors de l'installation
de toutes les applications au cours de la migration. La valeur par défautnom_profil\installedApps est utilisée si aucun paramètre n'est spécifié.
Si vous indiquez ce paramètre, vous ne pouvez pas indiquer le paramètre -keepAppDirectory.
Il est nécessaire de placer le nom du répertoire entre guillemets s'il comporte un ou plusieurs espaces.
Si vous utilisez ce paramètre, les outils de migration analysent les variables de niveau noeud du noeud migré dans le répertoire de sauvegarde (variables de l'ancienne version) et dans le profil de destination (variables de la nouvelle version). Si le chemin fait partie de l'une des variables suivantes dans l'une de ces versions, les outils contractent les informations du chemin pour utiliser la variable connexe :
Exemple :MIGR0341W: Application install directory has been updated to {0}.
ouMIGR0341W: Application install directory has been updated to ${USER_INSTALL_ROOT}\customAppDirectory.
MIGR0341W: Application install directory has been updated to ${APP_INSTALL_ROOT}\ cellName\customAppDirectory\.
- 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épertoire_sauvegarde/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épertoire_sauvegarde/logs.
- Ce paramètre est facultatif. La valeur secondes désigne le délai d'attente, en secondes, avant l'échec des tentatives de connexion wsadmin effectuées par la migration.
Cette valeur sert également de paramètre de délai d'attente lors de la migration d'application.
- Ce paramètre est facultatif. La valeur chemin d'accès à l'ancien agent admin désigne le chemin de système de fichier du répertoire de profil pour l'agent d'administration d'origine.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration.
- Ce paramètre est facultatif. La valeur port soap de l'ancien agent admin désigne le port SOAP utilisé par l'agent d'administration d'origine pour les connexions administratives.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration.
- Ce paramètre est facultatif. La valeur nom d'hôte de l'ancien agent admin désigne l'emplacement de nom d'hôte de l'agent d'administration d'origine. Si ce paramètre n'est pas spécifié, la valeur "localhost" est affectée par défaut.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration.
- Ce paramètre est facultatif. La valeur nom de connexion de l'ancien agent admin désigne le nom d'utilisateur de l'agent d'administration d'origine.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration dont la sécurité administrative est activée.
- Ce paramètre est facultatif. La valeur chemin d'accès au nouvel agent admin désigne le chemin de système de fichier du répertoire de profil pour l'agent d'administration nouvellement migré.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration.
- Ce paramètre est facultatif. La valeur port soap du nouvel agent admin désigne le port SOAP utilisé par l'agent d'administration nouvellement migré pour les connexions administratives.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration.
- Ce paramètre est facultatif. La valeur nom d'hôte du nouvel agent admin désigne l'emplacement de nom d'hôte du nouvel agent d'administration. Si ce paramètre n'est pas spécifié, la valeur "localhost" est affectée par défaut.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration.
- Ce paramètre est facultatif. La valeur nom de connexion du nouvel agent admin désigne le nom d'utilisateur du nouvel agent d'administration.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration dont la sécurité administrative est activée.
- Ce paramètre est facultatif. La valeur mot de passe de connexion du nouvel agent admin désigne le mot de passe associé au nom d'utilisateur du nouvel agent d'administration.
Ce paramètre n'est requis que si le serveur d'applications en cours de migration est géré par un agent d'administration dont la sécurité administrative est activée.
- Ce paramètre est facultatif. Utilisez ce paramètre pour indiquer des tailles de mémoire pour le segment de mémoire Java utilisé par
WASPostUpgrade.
La valeur "-Xms...m" indique la taille de segment de mémoire de départ. Remplacez le "..." par la taille en mégaoctets dont vous avez besoin. 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" indique la taille de segment de mémoire maximale. Remplacez le "..." par la taille en mégaoctets dont vous avez besoin. Par exemple, si la taille de segment de mémoire maximale doit être 1024 Mo, spécifiez le paramètre comme suit : -javaoption -Xmx1024m
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Consignation
L'outil WASPostUpgrade affiche le statut à l'écran au cours de l'exécution. Cet outil sauvegarde également un ensemble d'informations de journalisation plus détaillées dans le fichier WASPostUpgrade.horodatage.log stocké dans le répertoire répertoire_sauvegarde/logs. Vous pouvez afficher le fichier WASPostUpgrade.horodatage.log avec un éditeur de texte.
Remarques relatives à la sécurité
La sécurité doit être désactivée sur le système cible avant la migration. Si vous migrez à partir d'une configuration source dans laquelle la sécurité est activée, la commande WASPostUpgrade active automatiquement lors de la migration la sécurité pour la configuration Version 9.0 cible.