Utilisez la commande WBIPostUpgrade pour que WebSphere ESB extraie la configuration de profil sauvegardée par la commande WBIPreUpgrade
au niveau du répertoire de sauvegarde répertoire_sauvegarde spécifié.
Important : i5/OS est pris en charge uniquement si vous effectuez la migration de
version 6.1.x vers
version 6.2.
Remarque : Si vous effectuez la migration sur une plateforme i5/OS, le nom du profil cible
doit correspondre à celui du profil source que vous faites migrer.
Détails
Le script WBIPostUpgrade pour
WebSphere ESB lit les données de configuration dansrépertoire_sauvegarde pour effectuer la migration vers WebSphere ESB version 6.2 et ajoute toutes les applications migrées dans le répertoire racine_profil/installedApps de la nouvelle installation de WebSphere ESB.
Emplacement
Le fichier de commandes se trouve
et doit être exécuté dans le répertoire racine_installation/bin.
Syntaxe
La syntaxe est la suivante :
WBIPostUpgrade répertoire sauvegarde
[-username ID_utilisateur]
[-password mot de passe]
[-scriptCompatibility true | false]
[-portBlock numéro_port_début]
[-backupConfig true | false]
[-replacePorts true | false]
[-keepDmgrEnabled true | false]
[-keepAppDirectory true | false]
[-appInstallDirectory répertoire_défini_par_utilisateur]
[-traceString spéc_trace [-traceFile nom_fichier]]
[-createTargetProfile]
Remarque : Le paramètre -profileName n'est pas pris en charge sur la plateforme i5/OS. S'il est utilisé, une exception de paramètre incorrect est générée.

WBIPostUpgrade.sh répertoire_sauvegarde
[-username ID_utilisateur]
[-password mot de passe]
[-oldProfile nom_profil]
[-profileName nom_profil]
[-scriptCompatibility true | false]
[-portBlock numéro_port_début]
[-backupConfig true | false]
[-replacePorts true | false]
[-keepAppDirectory true | false]
[-keepDmgrEnabled true | false]
[-appInstallDirectory répertoire_défini_par_utilisateur]
[-traceString spéc_trace [-traceFile nom_fichier]]
[-createTargetProfile]
WBIPostUpgrade.bat répertoire_sauvegarde
[-username ID_utilisateur]
[-password mot de passe]
[-oldProfile nom_profil]
[-profileName nom_profil]
[-scriptCompatibility true | false]
[-portBlock numéro_port_début]
[-backupConfig true | false]
[-replacePorts true | false]
[-keepAppDirectory true | false]
[-keepDmgrEnabled true | false]
[-appInstallDirectory répertoire_défini_par_utilisateur]
[-traceString spéc_trace [-traceFile nom_fichier]]
[-createTargetProfile]
Remarque : Le paramètre -oldProfile doit précéder le paramètre -profileName (nouveau profil).
Paramètres
Les paramètres utilisés sont les suivants :
- backupDirectory
- Ce paramètre est obligatoire. La valeur répertoire_sauvegarde indique le chemin du répertoire de sauvegarde dans lequel l'outil WBIPreUpgrade a stocké la configuration et les fichiers sauvegardés, et dans lequel l'outil WBIPostUpgrade lit la configuration et les fichiers.
- -username
- Il s'agit d'un paramètre facultatif qui est requis si la sécurité administrative est configurée dans la version précédente de WebSphere ESB. La valeur ID_utilisateur correspond au nom de l'administrateur de l'installation WebSphere ESB en cours (avant
migration).
- -password
- Il s'agit d'un paramètre facultatif qui est requis si la sécurité administrative est configurée dans la version précédente de WebSphere ESB. La valeur mot de passe correspond au mot de passe de l'administrateur de l'installation WebSphere ESB en cours (avant
migration).
- -oldProfile
Restriction : Ce paramètre n'est pas disponible sur les plateformes i5/OS.
Paramètre facultatif pour la migration d'instances ou de profils à partir de versions antérieures. L'instance ou le profil doit déjà exister dans le répertoire de sauvegarde de la migration avant que cette commande ne soit exécutée. 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 trouvé, le système consigne une erreur.
- -profileName


Remarque : Ce paramètre n'est pas pris en charge sur la plateforme i5/OS. S'il est utilisé, une exception de paramètre incorrect est générée.
Paramètre facultatif pour la migration de profils spécifiques. La valeur
nom_profil spécifie le nom du profil, déjà créé dans la version la plus récente
de WebSphere ESB,
vers lequel le script effectue la migration de votre configuration. Ce profil doit déjà avoir été créé
avant l'appel de la commande WBIPostUpgrade. Si le paramètre -profileName
n'est pas spécifié, le profil par défaut est utilisé. Si aucun profil par défaut n'est trouvé, le système consigne une erreur.
Remarque : Pour garantir que la migration porte sur le profil correct, spécifiez le nom du profil à l'aide de ce paramètre et ne comptez pas sur la valeur par défaut.
- -scriptCompatibility
Remarque : Ce paramètre est ignoré pour les migrations de WebSphere ESB version 6.1.x vers version 6.2.
Paramètre facultatif servant à indiquer si une migration doit créer les définitions de configuration
version 6.0.2.x suivantes : - Transport
- ProcessDef
- SSL for 6.0.2
au lieu des définitions de configuration
version 6.2 suivantes :
- Channels
- ProcessDefs
- SSL pour version 6.2
La valeur par défaut est true.
Spécifiez la valeur true pour
ce paramètre pour réduire l'impact sur les scripts d'administration existants. Si vous disposez de scripts ou programmes wsadmin existants
qui utilisent des API de configuration tierce partie pour créer ou modifier les définitions de configuration version 6.0.2.x, par exemple, vous pouvez spécifier la valeur 'true' pour cette option durant la migration.
Remarque : Cet état est transitoire ; il ne dure que jusqu'à ce que tous les noeuds présents dans l'environnement soient au niveau
version 6.2.
Lorsqu'ils sont au dernier niveau, vous devez procéder accomplir les procédures suivantes :
- Modifiez les scripts d'administration afin d'utiliser tous les paramètres de version 6.2.
- Utilisez la commande convertScriptCompatability
pour convertir vos configurations de manière à ce qu'elles correspondent à tous les paramètres de version 6.2.
Pour plus d'informations,
reportez-vous à la rubrique Commande convertScriptCompatibility .
- -portBlock
- Il s'agit d'un paramètre facultatif. La valeur numéro_port_début
définit le premier bloc de numéros de port consécutifs attribués lors de l'exécution du script de commande.
- -replacePorts
- Ce paramètre facultatif permet de spécifier le mappage des valeurs de port
pour les hôtes virtuels et les ports de transfert de conteneur Web.
- -keepAppDirectory
Remarque : Ce paramètre est ignoré pour la migration de WebSphere ESB version
6.1 vers la version 6.2.
Paramètre facultatif servant à indiquer si tous les applications
doivent ou non être installées dans les mêmes répertoires que leurs répertoires actuels. La valeur par défaut est false. Si ce paramètre vaut 'true', chaque application
conserve son emplacement individuel.
Restrictions : Si
ce paramètre vaut 'true', l'emplacement est partagé entre l'installation
WebSphere ESB existante et la nouvelle. Si vous conservez les applications migrées dans les mêmes emplacements que ceux de la
précédente version, les restrictions suivantes s'appliquent :
- Les restrictions relatives à la prise en charge des noeuds mixtes version 6.2
doivent être respectées. Cela signifie que la prise en charge
suivante n'est pas applicable lors de l'appel de la commande wsadmin :
- Précompilation JSP
- Utilisation de configurations binaires
- Déploiement d'EJB
- Vous risquez de perdre par inadvertance les applications migrées si vous supprimez
par la suite les applications de ces emplacements lors de l'administration (par exemple, lors de la désinstallation) de votre installation précédente.
- -keepDmgrEnabled
Remarque : Ce paramètre est ignoré pour la migration de WebSphere ESB version
6.1 vers la version 6.2.
Paramètre facultatif servant à indiquer si le responsable de déploiement WebSphere ESB existant doit être supprimé. La valeur par défaut est false. Si
ce paramètre vaut 'true', vous pouvez utiliser le gestionnaire de déploiement existant une fois la migration terminée. Ceci n'est valable que lors de la migration d'un gestionnaire de déploiement et ce paramètre est ignoré dans toutes les autres migrations.
Attention : Ce paramètre doit être utilisé avec précaution.
- Les configurations existantes du gestionnaire de déploiement WebSphere ESB sont normalement arrêtées et désactivées dans le but d'empêcher que plusieurs gestionnaires de déploiement puissent gérer les mêmes noeuds. Vous devez arrêter le gestionnaire de déploiement existant avant de commencer à utiliser le gestionnaire de déploiement de la nouvelle version. Si cette opération n'est pas effectuée, les conditions d'erreurs les plus probables par la suite sont des conflits de port au démarrage de la seconde instance du gestionnaire de déploiement.
- L'application de la valeur 'true' à ce paramètre signifie que les modifications apportées à l'ancienne configuration durant la migration peuvent ne pas être migrées.
- -appInstallDirectory
Remarque : Ce paramètre est ignoré pour la migration de WebSphere ESB version
6.1 vers la version 6.2.
Paramètre facultatif permettant de transmettre le nom de répertoire utilisé lors de l'installation de
toutes les applications durant la migration. En l'absence de spécification de ce paramètre, la valeur de nom_profil\installedApps est
utilisée.Si le nom de répertoire contient un ou plusieurs espaces vides, il doit être spécifié entre guillemets.
Conseil : Vous pouvez inclure la variable ${USER_INSTALL_ROOT} dans votre argument. Cette variable se développe
en <WPS HOME>\profiles\<nom_profil>. Par exemple, si
WebSphere ESB
version 6.2 est installé dans C:\wps\ et que le
profil cible est ProcSrv01, ${USER_INSTALL_ROOT} représente
C:\wps62\profiles\ProcSrv01.
- -traceString
Remarque : Ce paramètre est ignoré pour la migration de
WebSphere ESB
version 6.0.2.x vers
la version 6.2.
Il s'agit d'un paramètre facultatif. La valeur spéc_trace définit
les informations de trace à collecter.Pour regrouper toutes les informations de trace,
spécifiez "*=all=enabled" (entre guillemets).
Important : Si ce paramètre est spécifié, vous devez également spécifier le paramètre -traceFile. Si vous spécifiez le paramètre -traceString sans indiquer le paramètre -traceFile, la commande crée un fichier de trace
par défaut et le place dans le répertoire répertoire_sauvegarde/logs.
- -traceFile
Remarque : Ce paramètre est ignoré pour la migration de
WebSphere ESB
version 6.0.2.x vers
la version 6.2.
Il s'agit d'un paramètre facultatif. La valeur nom_fichier définit
le nom du fichier de sortie pour les informations de trace. Important : Si vous spécifiez ce paramètre,
vous devez également spécifier le paramètre -traceString. Si vous spécifiez le paramètre -traceFile sans indiquer le
paramètre -traceString, la commande utilise la profondeur de trace par défaut et enregistre le fichier de trace à
l'emplacement que vous indiquez.
- -createTargetProfile
Ce paramètre optionnel a pour effet de créer un nouveau profil avec les paramètres de configuration corrects
pour la migration.
Journalisation
La commande WBIPostUpgrade affiche le
statut à l'écran lors de l'exécution. Cette commande sauvegarde également un ensemble plus complet d'informations de
journalisation dans le fichier WBIPostUpgrade.horodate.log situé dans le
répertoire répertoire_sauvegarde/logs. Vous pouvez afficher le fichier
WBIPostUpgrade.nom_profilhorodate.log à l'aide d'un éditeur
de texte.