Instructions d'installation d'IBM WebSphere Business Integration Message Brokers Toolkit pour WebSphere Studio Version 5.1  

Historique des modifications :
GA : 23 juillet 2004
Fix Pack 5 : 09 février 2005
Mise à jour Web : février 2006

(C) Copyright IBM Corporation 2004, 2006. All rights reserved. (C) Copyright IBM France 2004, 2006. Tous droits réservés.

Ce fichier contient les informations nécessaires à l'installation d'IBM WebSphere Business Integration Message Brokers Toolkit pour WebSphere Studio Version 5.1 sous Microsoft Windows 2000 et Windows XP. Il fournit également les procédures permettant de configurer ces produits à l'issue de l'installation.

Il ne s'applique qu'à l'installation de Message Brokers Toolkit Version 5.1 et à son utilisation avec WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker Version 5.0. Pour plus d'informations sur tous les autres composants, reportez-vous au fichier readme.html, ainsi qu'aux instructions d'installation de la version 5.0.

Le fichier readme.html Version 5.0 est accessible à l'adresse suivante : http://www.ibm.com/software/integration/wbimessagebroker/support/ ou
http://www.ibm.com/software/integration/wbieventbroker/support/

Les instructions d'installation de la version 5.0 sont accessibles à l'adresse suivante : ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/

AVERTISSEMENT !
N'installez Message Brokers Toolkit Version 5.1 que si vous avez installé WebSphere Studio Application Developer Integration Edition Version 5.1. N'installez pas la version 5.1 si vous disposez d'une version antérieure de WebSphere Studio Application Developer Integration Edition ; dans ce cas, vous devez utiliser Message Brokers Toolkit Version 5.0, qui est fourni avec WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker Version 5.0.

Migration
Si vous prévoyez d'effectuez une migration, consultez la section Avant de commencer.

Installation de Message Brokers Toolkit Version 5.1 dans un environnement d'équipe
WebSphere Studio Application Developer Integration Edition Version 5.1 n'est pas un composant prérequis pour chaque installation de Message Brokers Toolkit Version 5.1. Toutefois, si au moins une de vos installations Message Broker Toolkit s'intègre à WebSphere Studio Application Developer Integration Edition Version 5.1, toutes vos installations Message Broker Toolkit doivent être en Version 5.1 pour assurer le partage et l'intégrité des données.

Si vous n'utilisez WebSphere Studio Application Developer Integration Edition Version 5.1 sur aucun système, ou que vous utilisez WebSphere Studio Application Developer Integration Edition Version 5.0, vous devez installer Message Brokers Toolkit Version 5.0.

Documentation

Consultez en ligne la version la plus récente des instructions d'installation pour vous assurer que vous disposez bien de la version courante. Vous trouverez la dernière version (en anglais uniquement) à l'adresse suivante 
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Les versions traduites de ces instructions seront également accessibles en temps voulu via la même page Web.

Une mise à jour de la documentation est disponible à compter de février 2006, comme faisant suite à la livraison du Fix Pack 7. Téléchargez la fonction Eclipse appropriée afin d'obtenir le niveau le plus récent de la documentation. La version anglaise (Etats-Unis) est accessible immédiatement. D'autres mises à jour des fonctions Eclipse seront disponibles pour les versions traduites en temps voulu. Les instructions de téléchargement de ces mises à jour sont fournies dans le fichier Readme.

Il est possible de télécharger le centre de documentation autonome de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker. Celui-ci contient les informations relatives aux versions 5.0 et 5.1 du Toolkit. Le fichier compressé correspondant est disponible à l'adresse :
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/wbimb_help.zip

Lisez le fichier installing_and_managing.htm, inclus dans le fichier wbimb_help.zip.

La version anglaise (Etats-Unis) est accessible immédiatement. Les versions traduites seront disponibles en temps voulu via la même page Web.

Le centre de documentation est également accessible en ligne, en version anglaise (Etats-Unis) uniquement, à l'adresse suivante :
http://publib.boulder.ibm.com/infocenter/wbihelp/v6rxmx/index.jsp

Sommaire

Environnements d'exploitation pris en charge

Pour connaître les dernières informations sur les versions spécifiques des systèmes d'exploitation pris en charge par WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker, sélectionnez l'option "Brokers V5" dans les pages System Requirements, à l'adresse suivante :

http://www.ibm.com/software/integration/wbimessagebroker/requirements/ (pour WebSphere Business Integration Message Broker)

http://www.ibm.com/software/integration/wbieventbroker/requirements/ (pour WebSphere Business Integration Event Broker)

Message Brokers Toolkit Version 5.1 est pris en charge sous les environnements suivants :

Le Toolkit n'est pas pris en charge sous Windows 2003.

Début^

Avant de commencer

Vous serez peut-être amené à accomplir certaines tâches avant d'installer Message Brokers Toolkit Version 5.1 :

  1. Si vous installez Message Brokers Toolkit Version 5.1 dans le cadre d'une migration de la Version 2.1 vers la Version 5.0, ce fichier ne contient pas les informations dont vous avez besoin. Vous devez vous reporter aux fichiers readme.htm et install.htm de Message Brokers Version 5.0 et accéder au centre de documentation autonome de la version 5.0 (février 2006). Ces fichiers fournissent des détails sur les tâches de migration à accomplir avant d'installer la Version 5.0.
  2. Si vous disposez déjà d'une installation de Message Brokers Version 5.0 et que vous faites migrer le Toolkit de la Version 5.0 vers la Version 5.1, procédez comme suit :
    1. Sauvegardez les fonctions ou plug-ins tiers que vous avez installés dans Message Brokers Toolkit Version 5.0. Ceux-ci seront supprimés au cours de l'installation de Message Brokers Toolkit Version 5.1.
    2. Sauvegardez votre espace de travail Message Brokers Toolkit Version 5.0 à un autre emplacement :
      • Si vous avez appelé Message Brokers Toolkit Version 5.0 sur la ligne de commande avec l'option -data, l'espace de travail est stocké dans le répertoire que vous avez indiqué avec cette option.
      • Si vous n'avez pas appelé Message Brokers Toolkit Version 5.0 sur la ligne de commande avec l'option -data, l'espace de travail est stocké à l'emplacement par défaut eclipse/workspace/ dans votre répertoire d'installation.
    3. Désinstallez Message Brokers Toolkit Version 5.0. Le processus d'installation n'aboutira pas si Message Brokers Toolkit Version 5.0 est toujours présent sur le système.
    4. Une fois Message Brokers Toolkit Version 5.1 installé selon les instructions d'installation, rétablissez votre espace de travail de la Version 5.0 en effectuant l'une des deux opérations suivantes :
      • Copiez l'ancien espace de travail de l'autre emplacement vers le dossier eclipse/ de votre installation Message Brokers Toolkit Version 5.1.
      • Exécutez Message Brokers Toolkit Version 5.1 à partir de la ligne de commande à l'aide de l'option -data, qui doit indiquer l'autre emplacement. Exemple :
        mqsistudio.exe -data C:\chemin_de_votre_espace_de_travail
    5. Suivez les instructions fournies dans le centre de documentation en ligne pour accomplir la migration des fonctions ou des plug-ins tiers éventuels.
  3. Une fois l'installation terminée, reportez-vous au centre de documentation en ligne pour plus d'informations sur la migration.

Si vous installez Message Brokers Toolkit Version 5.1 sur un système qui ne comporte aucun autre composant Message Brokers, vous n'avez aucune opération à effectuer avant l'installation.

Début^

Instructions d'installation

Lorsque vous montez le CD, l'assistant d'installation est automatiquement lancé. Vous pouvez également exécuter le programme d'installation en double-cliquant sur setup.exe dans l'Explorateur Windows ou l'appelant sur la ligne de commande.

Les instructions d'installation qui suivent décrivent les différentes étapes d'installation de Message Brokers Toolkit Version 5.1.

Si vous lancez le programme d'installation à partir de la ligne de commande, vous pouvez définir des options pour indiquer comment l'installation s'opérer. Ces options sont décrites dans la section Options d'installation par ligne de commande.

Le format de la commande est affiché ci-dessous :
setup.exe [-options-...]

Si vous ne spécifiez aucune option, l'assistant d'installation se lance en mode par défaut (interface utilisateur).

Unités réseau mappées

Vous pouvez mapper l'unité réseau du CD si elle est située sur un système éloigné. Vous ne pouvez pas utiliser des chemins UNC (\\serveur\unité) pour accéder au programme d'installation. Il est nécessaire de mapper l'unité pour que le processus JavaTM n'expire pas. S'il vous est impossible ou si vous ne souhaitez pas mapper l'unité, copiez le contenu du CD dans une unité locale et procédez à l'installation à partir de cette unité.

Assistant d'installation

Ces instructions décrivent la procédure d'installation de Message Brokers Toolkit Version 5.1. Vous pouvez exécuter l'assistant d'installation dans trois modes différents :

Avant de démarrer, assurez-vous de disposer des droits Administrateur.

Interface graphique (AWT)

L'interface graphique est le mode par défaut de l'assistant d'installation. Elle ne fait appel à aucune option de ligne de commande.

Si vous cliquez sur Annuler avant l'apparition de l'écran de progression de l'installation, vous quittez le programme d'installation et revenez à l'état initial du système. Toutefois, si vous annulez l'assistant d'installation après l'apparition du panneau de progression, le système ne revient pas à son état antérieur. Pour savoir comment supprimer Message Brokers Toolkit, consultez la section Instructions de désinstallation.
Lorsque vous utilisez l'assistant d'installation, gardez à l'esprit que le passage d'un panneau au suivant après avoir cliqué sur le bouton Suivant > peut prendre plusieurs secondes. De même, si vous cliquez deux fois de suite sur Suivant >, vous risquez d'omettre un panneau. Pour vérifier que l'installation progresse correctement, contrôlez le niveau d'activité de votre unité centrale : celui-ci augmente considérablement pendant une installation.

  1. Lancez le programme d'installation.
  2. Initialisation de l'assistant InstallShield. Cette étape peut prendre quelques minutes.
  3. Sélectionnez votre langue. 
  4. Bienvenue. Le premier panneau présente le produit. Cliquez sur Suivant > pour continuer. 
  5. Avertissement. Assurez-vous de vouloir poursuivre l'installation de cette version du Toolkit : ce panneau fournit des informations permettant de prendre cette décision. Cliquez sur Suivant > pour continuer. Pour annuler l'installation, cliquez sur Annuler.
  6. Avertissement. Vérifiez que vous avez préservé les données et terminé les étapes de migration. Sélectionnez Oui puis cliquez sur Suivant > pour continuer. Si vous n'êtes pas prêt, laissez Non sélectionné puis cliquez sur Annuler afin d'annuler l'installation.
  7. Avenant au contrat de licence du logiciel. Lisez l'avenant au contrat de licence et cliquez sur Suivant > pour continuer.
  8. Emplacement d'installation. Ce panneau ne s'affiche que si vous n'avez aucun composant WebSphere Business Integration Message Broker ou WebSphere Business Integration Event Broker déjà installé. Le répertoire par défaut est C:\Program Files\IBM\WebSphere Business Integration Message Brokers. Vous pouvez néanmoins choisir un emplacement différent en cliquant sur le bouton Parcourir. Cliquez sur Suivant > pour continuer. 
  9. Type d'installation. Ce panneau ne s'affiche que si vous avez installé WebSphere Studio Application Developer Integration Edition sur ce système. Sélectionnez Par défaut si vous ne souhaitez pas intégrer le Toolkit à WebSphere Studio Application Developer Integration Edition. Sélectionnez Personnalisé si vous souhaitez intégrer le Toolkit à WebSphere Studio Application Developer Integration Edition. Cliquez sur Suivant > pour continuer.
    Pour plus d'informations sur l'intégration WebSphere Studio Application Developer Integration Edition, consultez la section WebSphere Studio Application Developer Integration Edition.
  10. WebSphere Studio Application Developer Integration Edition Integration. Ce panneau ne s'affiche que si vous avez sélectionné une installation personnalisée. Sélectionnez la case afin de confirmer que l'intégration est nécessaire. Cliquez sur Suivant > pour continuer.
  11. Récapitulatif de l'installation. Les options sélectionnées au cours des panneaux précédents, ainsi que l'espace disque total requis en Mo et l'emplacement choisi pour l'installation du Toolkit sont affichés. A ce stade, vous pouvez encore revenir en arrière pour effectuer des modifications.
    Cliquez sur Suivant > afin d'installer le Toolkit.
  12. Progression de l'installation. Le pourcentage de progression affiché évolue à mesure des modifications sur le système hôte. 
  13. Installation terminée. L'installation a abouti. Cliquez sur Terminer.

Interface de la console

L'installation via la console fait appel à une interface à base de texte dans la fenêtre de la console. Vous pouvez la lancer à partir de la ligne de commande en saisissant :

chemin setup.exe -console -is:javaconsole

où chemin correspond à l'emplacement courant du programme d'installation. Exemple :

E:\setup.exe -console -is:javaconsole

lance le programme d'installation pour Windows, qui se trouve dans le répertoire racine de l'unité E, dans la fenêtre de console en cours.

Utilisez les invites suivantes pour naviguer dans l'installation :
1 pour accéder à l'écran suivant
2 pour retourner à l'écran précédent
3 pour annuler et terminer le programme d'installation
4 pour réafficher l'écran en cours
L'option par défaut est toujours affichée entre crochets, par exemple [1]. Si le choix est correct, appuyez sur Entrée pour continuer.

  1. Sélectionnez la langue dans laquelle vous souhaitez exécuter l'assistant. Une liste de 10 langues numérotées s'affiche. Entrez le numéro de la langue que vous avez choisie. La liste s'affiche de nouveau et la langue que vous avez choisie est signalée par une croix (X) située entre les crochets à gauche du numéro sélectionné. Lorsque vous avez terminé, cliquez sur0.
  2. Bienvenue. Affiche des informations sur le produit, à savoir le nom, le numéro d'identification et le site Web. Entrez 1 pour accéder à l'écran suivant.
  3. Avertissement. Assurez-vous de vouloir poursuivre l'installation de cette version du Toolkit : ce panneau fournit des informations permettant de prendre cette décision. Entrez 1 pour accéder à l'écran suivant.
  4. Avertissement. Confirmez que vous avez préservé les données et terminé les étapes de la migration. Entrez 1 pour accéder à l'écran suivant.
  5. Avenant au contrat de licence du logiciel. Appuyez sur Entrée pour afficher et lire l'avenant au contrat de licence. Entrez 1 pour accéder à l'écran suivant.
  6. Répertoire de destination. Ce panneau ne s'affiche que si vous n'avez aucun composant WebSphere Business Integration Message Broker ou WebSphere Business Integration Event Broker déjà installé. Le répertoire par défaut est C:\Program Files\IBM\WebSphere Business Integration Message Brokers. Vous pouvez l'accepter en appuyant surEntrée ou vous pouvez définir un emplacement différent dans l'invite de commande. Entrez 4 pour afficher de nouveau l'écran avec la destination définie. Entrez 1 pour accéder à l'écran suivant.
  7. Type d'installation. Ce panneau ne s'affiche que si vous avez installé WebSphere Studio Application Developer Integration Edition. Sélectionnez Par défaut si vous ne souhaitez pas intégrer le Toolkit à WebSphere Studio Application Developer Integration Edition. Sélectionnez Personnalisé si vous souhaitez intégrer le Toolkit à WebSphere Studio Application Developer Integration Edition. Entrez 1 pour continuer.
    Pour plus d'informations sur l'intégration WebSphere Studio Application Developer Integration Edition, consultez la section WebSphere Studio Application Developer Integration Edition.
  8. WebSphere Studio Application Developer Integration Edition Integration. Ce panneau ne s'affiche que si vous avez sélectionné une installation personnalisée. Sélectionnez Oui afin de confirmer que l'intégration est nécessaire.
  9. Récapitulatif de l'installation. Ce panneau indique l'emplacement d'installation que vous avez choisi, la liste des modules à installer et l'espace disque total nécessaire exprimé en mégaoctets (Mo). A ce stade, vous pouvez encore revenir en arrière pour effectuer des modifications en entrant 2. Pour installer le produit, entrez1.
  10. Progression de l'installation. L'avancement des modifications apportées au système hôte est indiqué sous la forme d'un pourcentage. Une fois l'installation terminée (progression égale à 100 %), le programme de désinstallation est créé.
  11. Installation terminée. L'installation a abouti. Entrez 3 pour quitter l'assistant.

Mode d'installation automatique

Le mode d'installation automatique peut être géré par un fichier de réponses ou en utilisant les paramètres par défaut du programme d'installation.

Les paramètres par défaut de l'assistant d'installation, qui varient en fonction des options disponibles dans les modes interactifs précédents, permettent d'effectuer les actions suivantes :

Pour utiliser les paramètres par défaut, entrez la commande suivante sur la ligne de commande :

chemin setup.exe -silent

où chemin correspond à l'emplacement courant du programme d'installation. Exemple :

E:\setup.exe -silent

lance le programme d'installation pour Windows, qui se trouve dans le répertoire racine de l'unité E.

Un fichier de réponses vous permet de disposer d'un certain niveau de contrôle sur l'installation automatique. Vous pouvez générer un fichier de réponses de deux manières :

  1. Exécuter l'assistant d'installation. Le fichier de réponses généré correspond à un enregistrement des entrées effectuées lors de l'installation. La ligne de commande de cette méthode est :

    chemin setup.exe -options-record fichier_réponses

    où fichier_réponses correspond au chemin complet et au nom du fichier de réponses. Il est recommandé de créer le fichier de réponses dans un répertoire distinct, indépendant du répertoire d'installation du produit.

  2. Entrer une commande afin de générer un modèle de fichier de réponses que vous pouvez modifier, avec des options spécifiques, sans exécuter l'assistant d'installation. La ligne de commande de cette méthode est :

    chemin setup.exe -template fichier_réponses

    où fichier_réponses correspond au chemin complet et au nom du fichier de réponses. Le modèle de fichier contient toutes les instructions sur l'entrée des options spécifiques.

AVERTISSEMENT
Vous devez apporter les modifications suivantes aux fichiers de réponses (générés ou modèle) pour que le Toolkit se lie au workbench WebSphere Studio Application Developer Integration Edition.

  1. Recherchez et supprimez la ligne suivante :
    -W linkChoice.YES_NO="<value>"
  2. Si vous souhaitez que le Toolkit soit lié à WebSphere Studio Application Developer Integration Edition, insérez le contenu suivant :
  3. Si vous ne voulez pas que le Toolkit soit lié à WebSphere Studio Application Developer Integration Edition, vous n'avez pas besoin d'apporter d'autres modifications.

En mode d'installation automatique, vous devez utiliser un fichier de réponses si vous souhaitez intégrer ce Toolkit à WebSphere Studio Application Developer Integration Edition. Consultez la section WebSphere Studio Application Developer Integration Edition pour plus d'informations.

Options d'installation par ligne de commande

Les arguments d'installation offrent quatre modes d'exécution différents du programme d'installation : interface graphique, console, accessibilité et installation automatique. Les arguments d'installation permettent également d'enregistrer et d'utiliser un fichier de réponses.

Mode Interface graphique (AWT)

Le mode Interface graphique, également désigné par le terme "mode AWT" (Abstract Window Toolkit), est le mode d'installation par défaut. Celui-ci ne fait appel à aucun argument d'installation. Entrez la commande suivante sur une ligne de commande :

setup.exe [-awt]

où awt est facultatif ; il n'est obligatoire que si le mode Interface graphique n'est pas le mode d'installation par défaut.

Mode console

Le mode console est généralement utilisé lorsqu'aucune interface graphique n'est disponible, mais vous pouvez l'utiliser en permanence si vous le souhaitez. Entrez la commande suivante sur une ligne de commande :

setup.exe -console -is:javaconsole

Mode accessibilité

Le mode accessibilité fournit des informations orales supplémentaires pour les personnes malvoyantes et peut être utilisé comme ligne de commande alternative pour l'exécution en mode console. Entrez la commande suivante sur une ligne de commande :

setup.exe -accessibility

Mode d'installation automatique

En mode d'installation automatique, aucune intervention de l'utilisateur n'est nécessaire, sauf en cas d'utilisation d'un fichier de réponses. Ce mode est recommandé pour les installations automatisées sur un grand nombre de système identiques. Entrez la commande suivante sur une ligne de commande :

setup.exe -silent

Enregistrement d'un fichier de réponses

Les fichiers de réponses sont utilisés pour fournir des options, utilisées au cours d'une installation en mode Interface graphique ou console interactive, dans le cadre d'une installation automatique. Pour enregistrer une réponse dans une installation en mode console, entrez la commande suivante sur une ligne de commande :

setup.exe -options-record fichier_réponses -console -is:javaconsole

où fichier_réponses correspond au chemin complet et au nom du fichier de réponses.

Pour enregistrer une réponse dans une installation Interface graphique, entrez la commande suivante sur une ligne de commande :

setup.exe -options-record fichier_réponses

où fichier_réponses correspond au chemin complet et au nom du fichier de réponses.

Un exemple de fichier de réponses est fourni dans le répertoire sample-scripts du répertoire images du CD-ROM racine.

Utilisation d'un fichier de réponses

Vous devez corriger toute erreur contenue dans le fichier de réponses avant de l'utiliser. Pour plus d'informations, consultez l'avertissement relatif au mode automatique dans les instructions d'installation.

Pour fournir des options enregistrées, utilisées au cours d'une installation, à une installation automatique, entrez la commande suivante sur une ligne de commande :

setup.exe -options fichier_réponses -silent

où fichier_réponses correspond au chemin complet et au nom du fichier de réponses.

Génération d'un modèle de fichier de réponses

Le modèle de fichier de réponses ne contient pas d'options d'installation prédéfinies ; il est généré pour vous permettre de l'éditer en vue d'une utilisation ultérieure. Ce fichier peut être généré sans exécuter l'installation complète. Pour ce faire, entrez la commande suivante sur une ligne de commande :

setup.exe -options-template fichier_réponses

où fichier_réponses correspond au chemin complet et au nom du fichier de réponses.

Instructions d'installation

Identification et résolution des incidents d'installation

  1. Scénario : Le message qui suit s'affiche au démarrage de Message Brokers Toolkit, ou pendant son utilisation. La licence est introuvable ou a expiré. Les fonctions ne possédant pas de licence valide seront désactivées."

    Solution : Pour certains éléments de Message Brokers Toolkit, une licence doit être enregistrée. Généralement, cet enregistrement est automatique mais, dans la situation présente, vous devez exécuter enroll.exe manuellement à l'aide de l'une des commandes suivantes. Vérifiez également que votre date système est correcte.

  2. Scénario : Le programme d'installation automatique renvoie le code retour 0, même en cas d'échec de l'installation.

    Solution : Recherchez des erreurs dans le journal d'installation (mmqsi5.log) après chaque installation automatique pour vérifier qu'elle a abouti sans erreurs.

    mqsi5.log est le fichier d'historique de l'installation. Son emplacement par défaut est généralement C:\Documents and Settings\nom_connexion_utilisateur.

Installation du Toolkit uniquement sous Windows

Si vous avez uniquement installé le Toolkit sur un système Windows, des problèmes d'accès peuvent se produire lors de la connexion du Toolkit à Configuration Manager. Ceci est dû au fait que plusieurs fichiers nécessaires à l'identification des informations relatives au domaine utilisateur (outre celles relatives à l'ID utilisateur) ne sont pas installés dans ce scénario. Les informations relatives au domaine ne sont pas envoyées à Configuration Manager, ce qui peut entraîner une défaillance lors du contrôle de sécurité.

Pour résoudre ce problème, configurez votre système en sélectionnant l'une des options suivantes :

  1. Installez l'un des composants Runtime (Configuration Manager, User Name Server ou le courtier), ainsi que le Toolkit. La configuration du composant n'est pas nécessaire.
  2. Copiez les fichiers suivants à partir d'un système Windows sur lequel vous avez installé l'un des composants Runtime (Configuration Manager, User Name Server ou le courtier) vers le système sur lequel vous avez installé uniquement le Toolkit :

    Assurez-vous que les fichiers figurent dans la variable PATH définie.

Début^

WebSphere Studio Application Developer Integration Edition

AVERTISSEMENT !

Si vous souhaitez étendre un workbench WebSphere Studio Application Developer Integration Edition avec ce produit, vous devez installer WebSphere Studio Application Developer Edition Version 5.1 GA ; les versions antérieures ne sont pas prises en charge.

Si vous n'avez pas installé la version GA prise en charge de WebSphere Studio Application Developer Integration Edition, ou que vous ne savez pas exactement quelle est la version dont vous disposez, prenez contact avec votre représentant du service d'assistance IBM pour de plus amples informations.

Vous devez également mettre à niveau WebSphere Studio Application Developer Integration Edition avec le niveau pris en charge approprié ; vous devez appliquer "Interim Fix 002 - General Fixes 2.0.0" et "WebSphere Business Integration Message Broker v5.1.5 Interim Fix 001 - Prerequisite Fixes 1.0.0.1".

Dès lors que vous êtes prêt à appliquer les correctifs WebSphere Studio Application Developer Integration Edition, vous devez accomplir ces tâches dans l'ordre indiqué ci-dessous.

Vous devez appliquer ces correctifs après avoir installé WebSphere Business Integration Message Broker ou WebSphere Business Integration Event Broker ; vous devez par ailleurs sélectionner l'option d'installation afin d'activer le lien vers WebSphere Studio Application Developper Integration Edition (voir Instructions d'installation).

  1. Dans WebSphere Studio Application Developer Integration Edition, accédez à Aide > Mises à jour logicielles > Nouvelles mises à jour.
  2. Sélectionnez "IBM WebSphere Studio Application Developer Integration Edition Interim Fix 002 - General Fixes" 2.0.0. Cliquez sur Installer.
    NE redémarrez PAS le workbench une fois l'installation terminée.
  3. Sélectionnez Aide > Mises à jour logicielles > Gestionnaire des mises à jour pour accéder au gestionnaire des mises à jour.
  4. Dans la vue inférieure gauche Mise à jour de fonctions, développez "Sites à visiter", "IBM WebSphere Studio Application Developer Integration Edition Discovery".
  5. Sélectionnez "WebSphere Business Integration Message Broker Interim Fix 001 - Prerequisite Fixes 1.0.0.1" puis cliquez sur Installer.
  6. Redémarrez le workbench.
  7. Accédez aux informations de configuration afin de vérifier si l'installation a abouti. Sélectionnez Aide > A propos > Détails sur la configuration. En bas du fichier, il ne doit figurer aucun nouvel avertissement (avec l'horodatage courant) relatif aux modules d'extension ne pouvant être chargés. Des avertissements générés lors du démarrage avant l'application du correctif temporaire risquent de s'afficher mais ne doivent pas être pris en compte.
  8. Les perspectives Broker Administration et Broker Application Development sont désormais disponibles sur le workbench WebSphere Studio Application Developer Integration Edition.

Pour plus d'informations, consultez le site de téléchargement du support WebSphere Studio Application Developer Integration Edition, accessible à l'adresse : http://www.ibm.com/software/awdtools/studiointegration/support/

Ces informations partent du principe que vous avez déjà installé WebSphere Studio Application Developer Integration Edition lorsque vous installez Message Brokers Toolkit Version 5.1. Si vous installez WebSphere Studio Application Developer Integration Edition après Message Brokers Toolkit, veuillez suivre les instructions fournies dans le centre de documentation en ligne.

Instructions de désinstallation

Vous devez utiliser l'assistant de désinstallation disponible sous emplacement_installation\_uninst\studio\uninstaller.exe afin de supprimer Message Brokers Toolkit Version 5.1.

AVERTISSEMENT : Vous devez arrêter tous les processus d'exécution avant d'exécuter l'assistant de désinstallation.

Assistant de désinstallation

Ces instructions décrivent la procédure de désinstallation de Message Brokers Toolkit Version 5.1. A l'instar de l'assistant d'installation, vous pouvez appeler l'assistant de désinstallation dans trois modes différents :

Interface graphique (AWT)

L'interface graphique est le mode par défaut de l'assistant de désinstallation. Elle ne fait appel à aucune option de ligne de commande.

Si vous cliquez sur Annuler avant que l'écran d'avancement de la désinstallation ne s'affiche, vous quittez l'assistant de désinstallation et l'état d'origine du système est restauré.

Il est aussi possible de lancer le programme de désinstallation sous Windows à partir de Ajout/Suppression de programmes. Par exemple, Démarrer >Paramètres >Panneau de configuration> Ajout/Suppression de programmes.

  1. Sélectionnez IBM Message Brokers Toolkit pour WebSphere Studio Version 5.1.
    Cliquez sur Modifier/Supprimer.
    Sélectionnez la langue dans laquelle vous souhaitez exécuter l'assistant de désinstallation. Cliquez sur OK.

  2. Bienvenue. Affiche des informations sur le produit, à savoir le nom, le numéro d'identification et le site Web. Cliquez sur Suivant > pour continuer. 
  3. Avertissement. Vérifiez qu'aucun autre produit ne nécessite WebSphere Workbench. Sélectionnez Oui puis cliquez sur Suivant > pour continuer.
  4. Récapitulatif. Affiche les détails de ce qui sera désinstallé, c'est-à-dire le répertoire du produit et les fonctions à retirer. Cliquez sur Suivant > pour continuer.
  5. Avancement de la désinstallation. Ce panneau indique que la désinstallation est en cours.
  6. Désinstallation terminée. L'assistant a terminé la désinstallation correctement. Un message peut vous demander de redémarrer la machine à ce stade. Cliquez sur Terminer pour fermer l'assistant.

Interface de la console

Le mode console fait appel à une interface à base de texte dans la fenêtre de console. Pour lancer le mode console depuis la ligne de commande, entrez la commande suivante :

chemin programme de désinstallation -console -is:javaconsole

où chemin correspond à l'emplacement en cours du programme de désinstallation et programme de désinstallation est le nom du programme de désinstallation. Exemple :

emplacement_installation\_uninst\studio\uninstaller.exe -console -is:javaconsole
  1. Sélectionnez la langue dans laquelle vous souhaitez exécuter l'assistant. Une liste de 10 langues numérotées s'affiche. Entrez le numéro de la langue que vous avez choisie. La liste s'affiche de nouveau et la langue que vous avez choisie est signalée par une croix (X) située entre les crochets à gauche du numéro sélectionné. Entrez 0 une fois la sélection terminée.
  2. Bienvenue. Affiche des informations sur le produit, à savoir le nom, le numéro d'identification et le site Web. Entrez 1 pour accéder au panneau suivant.
  3. Récapitulatif de la désinstallation. Ce panneau affiche le nom du produit, son emplacement et une liste des fonctions à désinstaller. A ce stade, vous pouvez encore revenir en arrière pour effectuer des modifications en entrant 2. Pour désinstaller le produit, entrez1.
  4. Désinstallation du produit. Le message"Désinstallation du produit..." s'affiche. Cet écran ne contient pas d'indicateur d'avancement.
  5. Désinstallation terminée. La désinstallation a abouti. Entrez 3 pour quitter l'assistant.

Mode automatique

Ce mode utilise les paramètres par défaut de l'assistant de désinstallation. En fonction des options disponibles dans les modes interactifs ci-dessus, les paramètres désinstallent toutes les fonctions sélectionnables.

Entrez la commande suivante sur la ligne de commande :

chemin programme de désinstallation -silent

où chemin correspond à l'emplacement en cours du programme de désinstallation et programme de désinstallation est le nom du programme de désinstallation. Exemple :

emplacement_install\_uninst\studio\uninstaller.exe -silent

Début^

Installation d'un niveau de maintenance

Les mises à jour de maintenance sont disponibles via un téléchargement à partir d'un site Web, sous la forme de PTF (Program Temporary Fix), également désigné par le terme "fix pack" ou correctif. Les correctifs sont cumulatifs ; ainsi, il n'est pas nécessaire d'installer le Fix Pack 1 avant de pouvoir installer le Fix Pack 2. Cependant, le code GA doit avoir été installé en premier afin d'activer les conditions prérequises pour la licence.

Les informations les plus récentes sur les modules Fix Pack disponibles sont accessibles à l'adresse suivante : http://www.ibm.com/software/integration/wbimessagebroker/support/ or
http://www.ibm.com/software/integration/wbieventbroker/support/

Les correctifs pour WebSphere Business Integration Message Brokers Toolkit sont installés en utilisant la même technologie que l'édition GA. Cela signifie qu'un suivi permanent des fichiers du produit est effectué et qu'ils sont mis à jour de façon appropriée.

Vous ne pouvez pas retirer un correctif sans désinstaller la totalité du produit. Il est fortement recommandé d'avoir à portée de main une image GA de sauvegarde ainsi que les correctifs précédents au cas où vous rencontrez des problèmes après l'installation d'un niveau de maintenance. Si vous voulez restaurer un système à un niveau de maintenance précédent, vous devez désinstaller la totalité du produit, réinstaller le niveau GA du produit, puis installer le niveau voulu du correctif.

Si des correctifs provisoires sont appliqués à votre installation, prenez contact avec votre technicien de maintenance IBM pour obtenir des instructions et d'éventuels correctifs provisoires mis à jour pour le niveau de correctif que vous installez.

Remarque : Si vous installez un correctif pour les composants d'exécution de la version 5.0 après avoir installé Message Brokers Toolkit Version 5.1, choisissez une installation personnalisée et décochez la case correspondant au composant Message Brokers Toolkit. Les correctifs des outils fournis dans le Fix Pack Version 5.0 ne sont pas compatibles avec le Toolkit Version 5.1 ; si vous ne décochez pas la case, le programme d'installation renvoie une erreur (car il ne peut pas installer de correctifs de Version 5.0 sur un composant en Version 5.1). Il installera correctement les correctifs pour tous les autres composants.
(Si vous procédez à une installation en mode automatique ou console, veillez à sélectionner les options adéquates).

Téléchargement d'un Fix Pack

Vous pouvez télécharger les derniers Fix Packs à l'adresse suivante :
http://www.ibm.com/software/integration/wbimessagebroker/support/ ou
http://www.ibm.com/software/integration/wbieventbroker/support/

Cliquez sur l'option "Recommended updates" et suivez le lien permettant d'accéder à WebSphere Business Integration Brokers v5. Repérez le produit souhaité et cliquez sur le lien correspondant au dernier niveau de Fix Pack. Une description du Fix Pack s'affiche.

Cette page vous permet d'accéder au fichier readme.html, à la liste des incidents résolus dans ce correctif (contenue dans le fichier memo.ptf), ainsi qu'aux modules de téléchargement.

Cliquez sur le lien permettant de télécharger le module et suivez les instructions indiquées sur le site Web de téléchargement d'IBM. Sélectionnez un emplacement approprié pour y enregistrer la CSD téléchargée.

Installation d'un correctif

Assurez-vous que l'ID avec lequel vous êtes connecté appartient au groupe Administrateurs de Windows dans le domaine de sécurité local. Il est recommandé d'utiliser l'ID avec lequel vous avez installé WebSphere Business Integration Message Brokers Toolkit.

Vérifiez que tous les processus WebSphere Business Integration Event Broker ou WebSphere Business Integration Message Broker sont arrêtés. Vous devez effectuer les tâches suivantes :

  1. Arrêtez l'exécution du gestionnaire de configuration, du serveur de noms d'utilisateur et de tous les courtiers du système à l'aide de la commande mqsistop ou en arrêtant les services Windows dédiés à ces composants à partir du programme Services du Panneau de configuration.
  2. Arrêtez l'exécution de toutes les instances du workbench.
  3. Vérifiez qu'aucun fichier de WebSphere Business Integration Event Broker ou WebSphere Business Integration Message Broker n'est ouvert.
  4. Fermez tous les programmes Windows avant de procéder à la maintenance de Message Brokers Toolkit.
  5. Accédez au répertoire dans lequel vous avez téléchargé le fichier du correctif (Unnnnnn.exe). Dans Windows Explorer, cliquez à l'aide du bouton droit de la souris et sélectionnez Ouvrir. Vous pouvez également entrer la commande suivante sur une invite de commande :
    fichier_lancement_correctif [-s] -a arguments_installation

    où fichier_lancement_correctif est le chemin d'accès complet au fichier exécutable du correctif, par exemple U200208.exe.
    -s est facultatif et signifie que le fichier de lancement du correctif effectue l'extraction automatiquement. Si vous l'omettez, un écran indiquant la progression de l'extraction s'affiche.
    -a signifie lire les arguments d'installation suivants
    arguments_installation sont les arguments qui déterminent le mode d'exécution du programme d'installation. Consultez la section Options d'installation par ligne de commande.

    Une fois l'extraction accomplie, le programme d'installation s'exécute automatiquement en fonction des arguments choisis. Suivez les instructions fournies sur les panneaux d'installation. Pour obtenir une description détaillée des panneaux d'installation, consultez la section Instructions d'installation.

    A l'issue de l'installation, consultez le mémo multiplateformes figurant dans le répertoire readme, puis accomplissez les tâches post-installation manuelles nécessaires.

Début^

Notifications

Ces informations ont été développées pour des produits et services disponibles aux Etats-Unis.

Le présent document peut contenir des informations ou des références concernant certains produits, logiciels ou services IBM non annoncés dans ce pays. Pour plus de détails, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial IBM. Toute référence à un produit, logiciel ou service IBM n'implique pas que seul ce produit, logiciel ou service puisse être utilisé. Tout autre élément fonctionnellement équivalent peut être utilisé, s'il n'enfreint aucun droit d'IBM. Il est de la responsabilité de l'utilisateur d'évaluer et de vérifier lui-même les installations et applications réalisées avec des produits, logiciels ou services non expressément référencés par IBM.

IBM peut détenir des brevets ou des demandes de brevet couvrant les produits mentionnés dans ces informations. La remise de ces informations ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirez recevoir des informations concernant l'acquisition de licences, veuillez en faire la demande par écrit à l'adresse suivante :

Les informations sur les licences concernant les produits utilisant un jeu de caractères double octet peuvent être obtenues par écrit à l'adresse suivante :

Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun pays dans lequel il serait contraire aux lois locales :

LE PRESENT DOCUMENT EST LIVRE EN L'ETAT. IBM DECLINE TOUTE RESPONSABILITE, EXPLICITE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE VALEUR MARCHANDE OU D'ADAPTATION A VOS BESOINS. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne vous sera pas applicable.

Le présent document peut contenir des inexactitudes ou des coquilles. Il est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. IBM peut modifier sans préavis les produits et logiciels présents dans ces informations.

Les références à des sites Web non IBM sont fournies à titre d'information uniquement et n'impliquent en aucun cas une adhésion aux données qu'ils contiennent. Les éléments figurant sur ces sites Web ne font pas partie des éléments du présent produit IBM et l'utilisation de ces sites relève de votre seule responsabilité.

IBM pourra utiliser ou diffuser, de toute manière qu'elle jugera appropriée et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies.

Les licenciés souhaitant obtenir des informations permettant : (i) l'échange des données entre des logiciels créés de façon indépendante et d'autres logiciels (dont celui-ci), et (ii) l'utilisation mutuelle des données ainsi échangées, doivent adresser leur demande à :

Ces informations peuvent être soumises à des conditions particulières, prévoyant notamment le paiement d'une redevance.

Le logiciel sous licence décrit dans ces informations et tous les éléments sous licence disponibles s'y rapportant sont fournis par IBM conformément aux dispositions de l'ICA, des Conditions internationales d'utilisation des logiciels IBM ou de tout autre accord équivalent.

Les informations concernant des produits non IBM ont été obtenues auprès des fournisseurs de ces produits, par l'intermédiaire d'annonces publiques ou via d'autres sources disponibles. IBM n'a pas testé ces produits et ne peut confirmer l'exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoir aucune réclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit être adressée aux fournisseurs de ces produits.

Le présent document peut contenir des exemples de données et de rapports utilisés couramment dans l'environnement professionnel. Ces exemples mentionnent des noms fictifs de personnes, de sociétés, de marques ou de produits à des fins illustratives ou explicatives uniquement. Toute ressemblance avec des noms de personnes, de sociétés ou des données réelles serait purement fortuite.

COPYRIGHT LICENCE :

Le présent logiciel contient des exemples de programmes d'application en langage source destinés à illustrer les techniques de programmation sur différentes plateformes d'exploitation. Vous avez le droit de copier, de modifier et de distribuer ces exemples de programmes sous quelque forme que ce soit et sans paiement d'aucune redevance à IBM, à des fins de développement, d'utilisation, de vente ou de distribution de programmes d'application conformes aux interfaces de programmation des plateformes pour lesquels ils ont été écrits ou aux interfaces de programmation IBM. Ces exemples de programmes n'ont pas été rigoureusement testés dans toutes les conditions. Par conséquent, IBM ne peut garantir expressément ou implicitement la fiabilité, la maintenabilité ou le fonctionnement de ces programmes. Vous avez le droit de copier, de modifier et de distribuer ces exemples de programmes sous quelque forme que ce soit et sans paiement d'aucune redevance à IBM, à des fins de développement, d'utilisation, de vente ou de distribution de programmes d'application conformes aux interfaces de programmation IBM.

Marques

Les termes qui suivent sont des marques d'International Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays :

IBM, WebSphere

Java et toutes les marques incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.

Microsoft et Windows sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays.

D'autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document.