IBM WebSphere Business Integration Message Brokers Toolkit version 5.1


Historique des modifications :
GA : 23 juillet 2004
Mise à jour : 20 août 2004
Mise à jour : 20 octobre 2004
Mise à jour : 17 décembre 2004
Fixpack 5 : 9 février 2005
Fix Pack 7 : 6 février 2006
Mise à jour : 24 février 2006

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


Bienvenue dans IBM WebSphere Business Integration Message Brokers Toolkit version 5.1.

Le présent fichier Readme concerne uniquement l'installation de Message Brokers Toolkit, version 5.1 sur Microsoft Windows, ainsi que son utilisation avec WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker version 5.0. Il décrit des problèmes connus et contient des mises à jour de la documentation qui n'étaient pas disponibles au moment de la publication dans le centre de documentation. Vous devez également prendre connaissance du fichier Readme d'IBM WebSphere Business Integration Message Brokers version 5.0 pour plus d'informations sur le produit.

Avertissement !
Installez Message Brokers Toolkit, version 5.1 uniquement si vous avez installé la version 5.1 de WebSphere Application Development Integration Edition. N'installez pas la version 5.1 si vous disposez d'une version antérieure de WebSphere. Dans ce cas, vous devez utiliser la version 5.0 de Message Brokers Toolkit qui est livrée avec la version 5.0 de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker. La version 5.1 de Message Brokers Toolkit présente les mêmes fonctions que la version 5.0.

Installation de Message Brokers Toolkit version 5.1 dans un environnement coopératif
WebSphere Studio Application Developer Integration Edition version 5.1 n'est pas prérequis pour toutes les installations de Message Brokers Toolkit version 5.1. Cependant, si au moins l'une de vos installations de Message Broker Toolkit s'intègre à WebSphere Studio Application Developer Integration Edition version 5.1, toutes vos installations de Message Broker Toolkit doivent être en version 5.1 afin d'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 si vous utilisez WebSphere Studio Application Developer Integration Edition version 5.0, vous devez installer Message Brokers Toolkit version 5.0.

Compatibilité CVS
Le Toolkit de Message Brokers version 5.1 repose sur la technologie Eclipse 2.1.2 et exploite le module plug-in de client CVS version 2.1.1. Pour cette version, le serveur CVS doit être configuré avec la version 1.11.6 ou une version antérieure (Linux et UNIX uniquement, CVSNT non pris en charge).

Informations essentielles destinées à tous les utilisateurs

Il vous est fortement conseillé de prendre connaissance de la version la plus récente de ce fichier Readme. Celle-ci est disponible (en anglais uniquement) à l'adresse suivante :
http://www.ibm.com/support/docview.wss?rs=849&uid=swg27006913/

Pour effectuer l'installation, reportez-vous au fichier install.html. Celui-ci comporte des informations sur les tâches à effectuer avant de procéder à l'installation du produit.

Les versions traduites des fichiers Readme et install.html sont disponibles à l'adresse suivante : ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

Les versions traduites du centre de documentation ne sont pas incluses dans ce module. Tous les fragments de langue nationale contenus dans le centre de documentation sont vides et les informations s'affichent en anglais. Pour afficher les informations du centre de documentation dans une autre langue que l'anglais, vous devez télécharger la fonction Eclipse appropriée, après avoir installé le Fixpack. Les traductions sont disponibles dès la mise à disposition du Fixpack. Pour plus d'instructions sur le téléchargement des mises à jour, reportez-vous à la section Mise à jour des options.

Informations essentielles relatives à la migration

Si vous effectuez une migration, reportez-vous au fichier install.html pour plus de détails sur les opérations à effectuer avant de procéder à l'installation.

Si vous souhaitez installer la version 5.1 de Message Brokers Toolkit sur un système sur lequel la version 5.0 est déjà installée, vous devez d'abord désinstaller cette version du Toolkit car les deux versions ne peuvent pas coexister.

Le centre de documentation fournit des informations supplémentaires sur la migration. Pour les visualiser avant de procéder à l'installation, téléchargez une version autonome du centre de documentation (pour plus d'instructions, reportez-vous à la section Documentation).

Pour la migration et le déploiement, vous devez tenir compte des points suivants :

Vous pouvez partager des ressources entre les versions, sur des systèmes différents :

Documentation

Le centre de documentation en ligne de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker est accessible à l'adresse suivante : http://www.ibm.com/software/integration/wbimessagebroker/library/.

Vous pouvez également le télécharger sous forme de fichier compressé à l'adresse suivante : 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.

Support

Ce fichier Readme contient des références à des numéros d'incident. Ces numéros font référence à des incidents IBM internes. Ils peuvent s'avérer utiles si vous devez exposer un incident à un technicien de maintenance IBM.
Pour connaître les informations récentes concernant les incidents connus et les correctifs disponibles, consultez l'adresse :
http://www.ibm.com/software/integration/wbimessagebroker/support/
pour WebSphere Business Integration Message Broker, et
http://www.ibm.com/software/integration/wbieventbroker/support/
pour WebSphere Business Integration Event Broker.

Mises à jour des options

Vérifiez régulièrement s'il existe des mises à jour des options (y compris de la documentation en anglais ou dans les autres langues prises en charge) :
  1. Dans Toolkit, sélectionnez Help (Aide) > Software Updates (Mises à jour de logiciels) > New Updates (Nouvelles mises à jour). Eclipse recherche ensuite les mises à jour disponibles.
  2. Eclipse affiche les mises à jour disponibles. Sélectionnez les mises à jour que vous souhaitez installer.
  3. Une fois ces mises à jour sélectionnées, un message d'avertissement indiquant qu'aucune signature numérique n'est associée aux fonctions apparaît. Ignorez-le.
  4. Une fois les fonctions installées, Eclipse vous invite à relancer le workbench.
  5. Après le redémarrage du workbench, les nouvelles fonctions sont installées et prêtes à être utilisées.

Sommaire

Restrictions et limitations :

Notifications et Marques

Pages Web utiles


Restrictions et limitations

Cette section présente, pour chaque composant, les restrictions et limitations de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker.


WebSphere Studio Application Developer Integration Edition

Pour augmenter les capacités d'un workbench WebSphere Studio Application Developer Integration Edition avec ce produit, vous devez mettre à jour WebSphere Studio Application Developer Integration Edition au niveau pris en charge approprié. La version du workbench WebSphere Studio Application Developer Integration Edition workbench pouvant être mise à jour est la version 5.1 GA de WebSphere Studio Application Developer Integration Edition avec "Interim Fix 002 - General Fixes 2.0.0". Les versions antérieures à la version 5.1 de WebSphere Studio Application Developer Integration Edition 5.1 ne sont pas prises en charge.

Vous devez également appliquer le correctif "WebSphere Business Integration Message Broker v5.1.X Interim Fix 001" après avoir installé WebSphere Business Integration Message Broker ou WebSphere Business Integration Event Broker, où X est le numéro du Fix Pack appliqué.

Pour obtenir des instructions détaillées, reportez-vous au fichier install.html.


Coexistence

Si vous souhaitez installer la version 5.1 de Message Brokers Toolkit sur un système sur lequel la version 5.0 est déjà installée, vous devez d'abord désinstaller la version 5.0 du Toolkit. Les deux versions ne peuvent pas coexister. Cependant, vous pouvez partager des ressources entre ces versions sur des systèmes différents : Pour plus d'informations concernant la migration de vos ressources et des données utilisateur en version 5.1, reportez-vous à la section Migration du centre de documentation.

Installation

  1. Incident 34320
    Au cours de l'installation, si vous choisissez de NE PAS accepter le contrat de licence, un message en incrustation comportant les boutons OUI et NON apparaît. Quelle que soit votre sélection, la page du contrat de licence s'affiche de nouveau. Si vous cliquez sur OUI, l'installation est annulée et le Tableau de bord, fermé.

    De même, si, au cours de l'installation, vous cliquez sur PRECEDENT sur la page du contrat de licence, plusieurs messages d'erreur JVM (Java Virtual Machine) s'affichent et le Tableau de bord reste bloqué.

    Solution : Acceptez le contrat de licence si vous voulez installer correctement ce produit.

  2. Incident 37122
    Lorsque des fichiers de réponses sont utilisés lors d'une installation automatique, ils peuvent comporter un indicateur erroné. Pour résoudre ce problème, procédez comme suit :

    L'exemple ci-dessous installe les outils à l'emplacement suivant : C:\Program Files\IBM\WBIMB.

    ---start of response file---------
    
    -P installLocation="C:\Program Files\IBM\WBIMB"
    -W setupTypes.selectedSetupTypeId=custom
    
    ###############################################################################
    #
    # User Input Field - suiteFeatures
    #
    #
    
    #Do not change this - it sets the installer to ignore the standard custom setup route
    -W featureSelectionIB.active=false
    
    #Set a value to true to install that component
    # If any of the Broker, UNS or Config Manager parameters are set to true, 
    # the core value must also be set to true.  
    # Otherwise set this should be set to false to avoid installing most of the product.
    
    -W enableCore.value=true
    -W setCustomSuiteBrokerFeatureTrue.propertyValue=false
    -W setCustomSuiteUNSFeatureTrue.propertyValue=false
    -W setCustomSuiteConfigMgrFeatureTrue.propertyValue=false
    
    #Set to true if the Message Broker extension features are required.
    #The broker and core features must also be set to true to install this
    
    -W setCustomMessageTrue.value=false
    
    #Set to true if the tooling is required
    -W setCustomToolingTrue.value=true
    
    ------ end of response file----------
    

Après l'installation

  1. Si vous avez installé la version 5.1 de Message Brokers Toolkit et remplacé la version 5.0 :
    1. Incident 34555
      Vous devez recompiler tous les projets définis dans votre espace de travail.
    2. Incident 34930
      Si INSTALL_PATH\eclipse\workspace\.metadata existe, il se peut que, lorsque vous ouvrez Message Brokers Toolkit, le gestionnaire de mises à jour soit lancé correctement, mais que les mises à jour de vos plug-ins échouent. Suite à cela, le Message Brokers Toolkit ne s'ouvre pas avec les niveaux de plug-in corrects et risque d'échouer.

      Par exemple, dans Broker Application Development Perspective, il se peut que l'option de menu Message Definition File (Fichier de définitions de messages) ne figure pas dans liste obtenue via File (Fichier) > New Menu (Nouveau menu). Cela indique que votre installation ne contient pas le niveau ou la version correct(e) de plug-ins pour Message Brokers Toolkit.

      Vous pouvez vérifier que les niveaux de plug-ins que vous utilisez sont corrects depuis la fenêtre Message Brokers Toolkit for WebSphere Studio, en cliquant sur Help (Aide) > About Message Brokers Toolkit for WebSphere Studio - Message Broker (A propos de Message Brokers Toolkit for WebSphere Studio - Message Broker). Sous l'en-tête "Message Brokers Toolkit for WebSphere Studio", un numéro de version s'affiche. Si, une fois la version 5.1 installée, vous utilisez les versions correctes de plug-ins, la version affichée est la version 5.1.0. Si la version affichée est antérieure à celle-ci, procédez comme suit :
      1. Supprimez le répertoire .metadata.
      2. Ouvrez à nouveau Message Brokers Toolkit.
      3. Réimportez vos projets existants dans l'espace de travail en procédant comme suit pour chaque projet :
        1. Cliquez sur File (Fichier) > Import (Importation).
        2. Lorsque l'assistant d'importation apparaît, choisissez Existing Project into Workspace (Projet existant dans l'espace de travail) et cliquez sur Next (Suivant).
        3. Cliquez sur Browse (Parcourir) et spécifiez l'emplacement du projet dans votre espace de travail.
        4. Cliquez sur Finish (Terminer).
  2. Incident 32898
    Si vos paramètres LAN ne sont pas correctement configurés pour l'accès à l'hôte local, peut-être en raison des paramètres de votre script de configuration automatique, l'un des événements suivants peut se produire :
    Solution : votre administrateur système peut configurer vos paramètres LAN afin de faciliter l'accès aux documents d'aide depuis le serveur d'aide local en procédant comme suit :
    1. Dans le Panneau de configuration, ouvrez Options Internet, sélectionnez l'onglet Connexions et choisissez Paramètres LAN....
    2. Si votre hôte est configuré pour utiliser DHCP pour l'affectation IP, vérifiez que la case Détecter automatiquement les paramètres de Internet Explorer n'est pas cochée.
    3. Si vous utilisez un serveur Proxy, vérifiez que la case Ne pas utiliser de serveur Proxy pour les adresses locales est cochée.
    4. Cliquez sur Avancés... et ajoutez '127.0.0.1;localhost' dans la section Exceptions si cette adresse n'est pas répertoriée.
    5. Si vous utilisez un script de configuration automatique pour les paramètres Proxy et que vous n'êtes pas sûr que le script est correct, décochez la case Utiliser le script de configuration automatique.

    Si les opérations ci-dessus ne résolvent pas votre problème, essayez de modifier les propriétés du port et de l'hôte dans org.eclipse.tomcat\preferences.ini. Choisir host=localhost ou host=127.0.0.1, cela devrait fonctionner. Si vous n'utilisez pas de pare-feu, vous pouvez également devoir définir port=80 (ou toute autre valeur adéquate pour le pare-feu).
  3. Incident T32243
    L'extension du fichier mxsd n'est pas correctement associée à l'éditeur de définitions de messages (Message Definition Editor). Pour s'assurer que les fichiers mxsd s'ouvrent par défaut dans Message Definition Editor, sélectionnez Window (Fenêtre) > Preferences (Préférences) > Workbench (Plan de travail) > File Associations (Associations de fichiers). Faites défiler la liste des types de fichiers vers le bas et sélectionnez *.mxsd. Ensuite, sélectionnez Message Definition Editor dans la liste des éditeurs associés. Cliquez sur Default (Par défaut), puis sur OK.
  4. Incident 36638
    La rubrique relative aux préférences de l'éditeur d'ensembles de messages (Message Set Editor Preferences)(ad15810_) décrit uniquement les options disponibles dans la version 5.0 du Toolkit. Les options de la version 5.0 ne sont pas disponibles pour la version 5.1. Dans la version 5.1 du Toolkit, les options sont les suivantes :
  5. Incident 36655
    Si vous avez désinstallé le Toolkit à l'aide du fichier uninstaller.exe avec l'option -silent, le programme de désinstallation renvoie immédiatement la commande et s'exécute en tâche d'arrière-plan. Pour que le programme de désinstallation ne réapparaisse pas tant qu'il n'a pas terminé, vous devez invoquer le programme de désinstallation dans Java à l'aide de la commande suivante :
    java -cp <rép_installation>\_uninst\studio\uninstall.jar run -silent
    où <rép_installation> correspond au répertoire dans lequel vous avez installé le produit.
    Si vous ne disposez pas de machine virtuelle Java configurée (version 1.3.1 ou ultérieure), vous pouvez utilisez la JVM du produit installé dans le répertoire <rép_installation>\_sjvm\bin\. Si vous procédez ainsi, il se peut que vous deviez supprimer le répertoire manuellement une fois la désinstallation terminée.
  6. Incident 37671
    Importation des fichiers de stockage COBOL : lorsque vous importez un fichier de stockage COBOL pour remplir un fichier de définition d'un ensemble de messages, vérifiez que le fichier de stockage contient au moins une structure de niveau 01. Si la structure de niveau 01 n'existe pas, aucun objet (éléments, groupes, types) n'est importé.
  7. Les définitions des vues de base de données (Database Views) ne sont pas prises en charge par l'éditeur ESQL. Les références aux vues de base de données dans le code ESQL (en lieu et place des schémas ou des tables) sont identifiées par des indicateurs d'avertissement (référence non résolue) dans l'éditeur ESQL. Ces avertissements n'empêchent pas le déploiement du code ESQL correspondant.
    Ces avertissements relatifs à des références non résolues sont également susceptibles d'apparaître lors de la migration d'un flux de messages de la version 2.1, car les références de bases de données sont validées par l'éditeur ESQL 5.0.
    Seules les références aux tables et schémas de base de données sont prises en charge.
  8. Restrictions concernant la compilation ESQL : Si vous créez un flux secondaire et choisissez de le distribuer sous forme de projet de module plug-in, il se peut que les appels de routines globales ESQL contenues dans le flux secondaire ne soient pas générés correctement lors de l'ajout à un fichier BAR d'un flux de messages contenant ce flux. Dans pareil cas, le déploiement du fichier BAR échoue.
    Palliatif : mettez en oeuvre l'une des solutions suivantes :

Notifications

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 le présent document. La remise de ce document 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 décrits dans ce document.

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 ce document 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.

LICENCE DE COPYRIGHT :

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


Pages Web utiles

Correctifs WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker
http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006041

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

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

Fichier Install.html de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Fichiers Readme de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker
http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006913

Aide en ligne de WebSphere Business Integration Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/library/

Aide en ligne de WebSphere Business Integration Event Broker
http://www.ibm.com/software/integration/wbieventbroker/library/