La commande WBIPreUpgrade de WebSphere ESB permet d'enregistrer la configuration d'une version de WebSphere ESB installée précédemment dans un répertoire de sauvegarde propre aux migrations.
Procédure
La commande WBIPreUpgrade permet d'enregistrer les fichiers que vous sélectionnez dans les répertoires racine_installation et racine_profil dans un répertoire de sauvegarde que vous spécifiez. La valeur par défaut de racine_profil est profiles/nom_profil. Les fichiers copiés se trouveront dans différents sous-répertoires, tous copiés par WBIPreUpgrade dans le répertoire de sauvegarde spécifié. De plus, un sous-répertoire logs est créé ; il contient les nouveaux fichiers journaux correspondant à l'instance en cours de la commande WBIPreUpgrade.
En fonction de la version à partir de laquelle vous migrez, la commande
WBIPreUpgrade sauvegarde les profils existants dans
WebSphere Enterprise Service Bus, soit tous en même temps, soit un à la fois.
- Si vous migrez depuis version 6.0.2.x,
la commande WBIPreUpgrade sauvegarde les profils existant dans WebSphere Enterprise Service Bus tous à la fois.
- Si vous migrez à partir de version 6.1.x,
la commande WBIPreUpgrade sauvegarde les profils existants un à la fois et seulement les profils identifiés à l'aide du paramètre -profileName.
Restrictions
- Si vous migrez à partir de version 6.1.x,
la commande WBIPreUpgrade hérite des limitations suivantes à partir des utilitaires WebSphere Application Server Network Deployment,
version 6.1 backupConfig :
- Par défaut, tous les serveurs du
noeud sont arrêtés avant exécution de la sauvegarde de sorte que les informations
partiellement synchronisées ne soient pas sauvegardées.
- Vous devez disposer des droits de l'utilisateur root pour effectuer la migration.
- Dans un environnement UNIX® ouLinux®, la commande backupConfig ne sauvegarde ni les autorisations ni les droits de propriété des fichiers.
- Lors de la restauration d'un fichier, la commande restoreConfig utilise l'umask en cours et l'ID utilisateur effectif (EUID) pour définir les autorisations et la propriété.
- Vous devez arrêter le gestionnaire de déploiement source avant de démarrer la migration. Si vous n'arrêtez pas le gestionnaire de déploiement source, la commandeWBIPreUpgrade l'arrête automatiquement.
Si vous migrez sur une plateforme i5/OS, le nom du profil cible doit correspondre au nom du profil source en cours de migration.
Si vous migrez sur une plateforme i5/OS, la commande backUpConfig ne sauvegarde aucun droit privé sur les fichiers et répertoires que vous avez configuré le profil source. Ensuite, notez les droits privés qui peuvent exister sur les fichiers et répertoires figurant sous l'arborescence de configuration du profil source, puis restaurez-les manuellement vers le profil cible une fois la commande WBIPostUpgrade exécutée et la migration du profil terminée.
Emplacement
Le fichier de commandes se trouve dans le répertoire rép_installation/bin et doit être exécuté à partir de ce répertoire.
Autorité
Pour exécuter ce script de commandes, votre profil utilisateur doit avoir l'autorisation *ALLOBJ.
Paramètres
Les paramètres utilisés sont les suivants :
- backupDirectory
- Il s'agit d'un paramètre obligatoire ; il doit être le premier paramètre spécifié. La valeurbackupDirectory indique le nom du répertoire dans lequel le script de commande stocke la configuration sauvegardée et les journaux créés au cours de l'exécution des commandes WBIPreUpgrade et WBIPostUpgrade.
C'est également à partir de ce répertoire que la commande
WBIPostUpgrade lit la configuration.
Si ce répertoire n'existe pas, le script de commandes WBIPreUpgrade le crée.
- currentWebSphereDirectory
- Il s'agit d'un paramètre obligatoire ; il doit être le deuxième paramètre spécifié. Il peut s'agir de toute édition deWebSphere ESB pour laquelle la migration est prise en charge.

La valeur
currentWebSphereDirectory indique le nom du répertoire racine du profil pour le profil
WebSphere ESB existant que vous voulez migrer. Sur
i5/OS, le format du chemin de répertoire se présente comme suit :
racine_données_utilisateur/profiles/nom_profil,
où
nom_profil est le nom du profil et
racine_données_utilisateur est le répertoire de données d'utilisateur par défaut pour
WebSphere ESB (
/QIBM/UserData/WebSphere/ESB). Les sous-répertoires profiles et profileRegistry sont créés sous le répertoire lorsque vous installez le produit.
Remarque : La plateforme i5/OS est prise en charge uniquement si vous migrez à partir de version 6.1.x vers version 6.2.


La valeur decurrentWebSphereDirectory représente le nom du répertoire racine d'installation de WebSphere ESB.
Les répertoires suivants sont les valeurs par défaut de
WebSphere ESB version 6.1.x.
Il est possible d'un chemin différent, autre que celui par défaut ait été utilisé pour votre installation.
- Si, pour l'installation précédente, WebSphere Application Server et WebSphere ESB ont été installés ensemble au cours du même processus d'installation : /QIBM/UserData/WebSphere/ProcServer/profiles/nom_profil.
- Si, pour l'installation précédente, WebSphere Application Server a déjà été installé et que WebSphere ESB a été installé par-dessus : /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/nom_profil.
- -password
- Il s'agit d'un paramètre facultatif requis si la sécurité d'administration est configurée dans la version précédente de WebSphere ESB. La valeur mot_de_passe indique le mot de passe et le nom de l'utilisateur administratif de l'installation actuelle de WebSphere ESB (avant migration).
- -profileName


Remarque : Ce paramètre n'est pas pris en charge sur la plateforme i5/OS.
S'il est utilisé, une exception paramètre non valide est déclenchée.
Il s'agit d'un paramètre facultatif pour la migration à partir de profils spécifiques. La valeur nom_profil indique le nom du profil créé dans la version précédente de WebSphere ESB, à partir de laquelle le script migre votre configuration. 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 vérifier que le profil correct est migré, indiquez le nom du profil à l'aide de ce paramètre et ne comptez pas sur la valeur par défaut.
- -traceFile
Remarque : Ce paramètre est ignoré pourWebSphere ESB version 6.1.x pour la migration de version 6.2.
Il s'agit d'un paramètre facultatif. La valeur affectée à nom_fichier spécifie le nom du fichier de sortie contenant 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 mais ne spécifiez pas le paramètre -traceString, la commande utilise la profondeur de trace par défaut et stocke le fichier de trace à l'emplacement que vous avez spécifié.
- -traceString
Remarque : Ce paramètre est ignoré pourWebSphere ESB version 6.1.x pour la migration de version 6.2.
Il s'agit d'un paramètre facultatif. La valeur affectée à spéc_trace représente l'information de trace à collecter. Pour rassembler 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 mais ne spécifiez pas le paramètre -traceFile, la commande crée un fichier trace par défaut et la place dans le répertoire backupDirectory/logs.
- -username
- Il s'agit d'un paramètre facultatif requis si la sécurité d'administration est configurée dans la version précédente de WebSphere ESB. La valeur ID _utilisateur indique le nom de l'utilisateur administratif de l'installation actuelle de WebSphere ESB (avant migration).
Journalisation
La commande WBIPreUpgrade affiche le statut à l'écran pendant son exécution. Elle enregistre également un ensemble d'informations plus complet dans le fichier WBIPreUpgrade.horodatage.log du répertoire backupDirectory/logs, où backupDirectory correspond à la valeur spécifiée pour le paramètre backupDirectory. Vous pouvez visualiser le fichier WBIPreUpgrade.profileName.horodatage.log avec un éditeur de texte.