WebSphere Enterprise Service Bus, Version 6.2.0 Systèmes d'exploitation: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Utilitaire de ligne de commande WBIPostUpgrade

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é.

For i5/OS operating system 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 :

For i5/OS operating system
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.

For Linux operating systemFor UNIX operating system
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]

For Windows operating system
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
For UNIX operating systemFor Linux operating systemFor Windows operating system
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 :
  1. Modifiez les scripts d'administration afin d'utiliser tous les paramètres de version 6.2.
  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.
  • False
    Ne pas remplacer les définitions de port de la version 6.0.x ou 6.1.x durant la migration.
    • La configuration de la version précédente est laissée intacte et aucun canal n'est supprimé.
    • Les quatre canaux nommés suivants sont définis sur des valeurs équivalentes à celles qui étaient définies dans la version précédente :
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • Le processus de migration crée des transferts ou des canaux d'après la valeur du paramètre -scriptCompatibility, pour tous les ports de la version précédente.
    • Le processus de migration définit tous les ports autres que de conteneur Web sur les valeurs configurées pour la version précédente.
    • Des conflits de port peuvent se produire si le processus de migration crée un transfert ou un canal dont le nom est existe déjà dans le conteneur Web.

    C'est la valeur par défaut.

  • True

    Remplace tous les paramètres de port pour les alias d'hôte virtuel durant la migration par les définitions de port de la version 6.2.

    Par défaut, le processus de migration ajoute les données de configuration issues des environnements précédents aux données contenues dans le nouvel environnement WebSphere ESB. Dans certains cas, toutefois, il n'est pas souhaitable que ce comportement soit appliqué aux valeurs de port. Il se peut par exemple que les définitions de port existantes issues de la version précédente aient été soigneusement configurées pour éviter les conflits de port avec d'autres produits, ce qui implique le souhait probable de faire migrer ces paramètres dans la configuration de la nouvelle version. Spécifiez la valeur 'true' pour ce paramètre afin que tous les ports des hôtes virtuels correspondants soient supprimés de configuration de la nouvelle version avant que les nouvelles valeurs ne soient ajoutées.
    • Tous les canaux de transfert associés au conteneur Web sont supprimés, à l'exception des quatre canaux suivants, définis sur des valeurs équivalentes à celles de la version précédente :
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • Le processus de migration crée des transferts ou des canaux d'après la valeur du paramètre -scriptCompatibility, pour tous les ports de la version précédente.
    • Le processus de migration définit tous les ports autres que de conteneur Web sur les valeurs configurées pour la version précédente.
-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.


reference Rubrique de référence

Conditions d'utilisation | Commentaires en retour


Icône d'horodatage Dernière mise à jour: 07 juillet 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_wbipostupgrade.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
Ce centre d'information est mis en service par la technologie Eclipse (http://www.eclipse.org).