IBM WebSphere® Message Broker Version 6.1

Historique des modifications :

(C) Copyright IBM Corporation 2007. All rights reserved.

Bienvenue dans IBM WebSphere Message Broker. Le présent document est le fichier Readme se rapportant à la version 6.1 des composants Tooling et Runtime

Ce fichier Readme décrit les problèmes connus et contient les mises à jour de la documentation qui n'étaient pas disponibles à temps pour être intégrées au centre de documentation en ligne.

Sommaire


Informations essentielles pour tous les utilisateurs

Consultez toujours la dernière version de ce fichier Readme, que vous trouverez (en version anglaise) sur le site suivant :
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917

Pour effectuer l'installation, consultez le document WebSphere Message Broker - Guide d'installation. Ce document inclut des informations relatives aux tâches que vous devez effectuer avant d'installer le produit. Accédez au Guide d'installation en ligne du centre de publications IBM à l'adresse suivante :

http://publib.boulder.ibm.com/epubs/pdf/c3468660.pdf

Informations essentielles relatives à la migration

Si vous procédez à une migration de la version 5.0 ou 6.0 de ce produit, consultez le centre de documentation en ligne, qui fournit des instructions de migration détaillées.

Un document décrivant les problèmes spécifiques à la migration signalés par le biais du support technique IBM est régulièrement mis à jour sur le site de support Broker. Consultez la section "Solve a problem" associée au document intitulé "Problems and solutions when migrating" (problèmes et solutions lors de la migration).

Documentation

Le centre de documentation autonome de WebSphere Message Broker est disponible sur le CD de démarrage rapide, ainsi qu'en ligne à l'adresse : http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp

Vous pouvez également le télécharger sur le site suivant :
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz (version Linux)
et
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip (version Windows).

Lisez le fichier quickstart_welcome.html, qui se trouve dans les fichiers wmb_help_linux.tgz et wmb_help_win.zip du dossier ibm_help.

L'ensemble des rubriques disponibles au format PDF, ainsi que la documentation spécifique à l'extension Rules and Formatter, sont disponibles à l'adresse suivante :
http://www-306.ibm.com/software/integration/wbimessagebroker/library/

Support

Incidents : Ce fichier Readme contient des références à des numéros d'incident. Ces numéros se réfèrent à des incidents IBM internes. Ces numéros peuvent s'avérer utiles pour décrire un incident à un technicien de maintenance IBM.

Notes techniques : Pour connaître les informations en cours concernant les incidents connus et les correctifs disponibles, consultez l'adresse suivante :
http://www.ibm.com/software/integration/wbimessagebroker/support/

Pour rechercher les informations, utilisez l'une des méthodes suivantes :

Toutes les notes techniques correspondantes s'affichent ; vous pouvez ensuite les classer ou poursuivre la recherche.

Pour en savoir plus sur le téléchargement des images d'installation de WebSphere Message Broker version 6.1 depuis le site Web Passport Advantage, consultez le document téléchargeable Passport Advantage downloads for WebSphere Message Broker V6.1, disponible à l'adresse suivante :
http://www.ibm.com/support/docview.wss?rs=849&uid=swg24017456

Versions : Pour obtenir les dernières informations concernant les versions des systèmes d'exploitation et des bases de données prises en charge par WebSphere Message Broker, consultez la page relative à la configuration requise, à l'adresse suivante :
http://www-306.ibm.com/software/integration/wbimessagebroker/requirements/index.html

Mises à jour des options

Vérifiez régulièrement s'il existe des mises à jour des options (y compris de la documentation, en Anglais et dans les autres langues prises en charge).
HAUT

Restrictions et limitations

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

HAUT

Installation

Lorsque vous créez votre chemin d'installation, veillez à ce que sa longueur n'excède pas la longueur maximale autorisée par votre système (par exemple, Windows permet 256 caractères maximum).


HAUT

Migration

La migration sous z/OS requiert la version IC54505.


HAUT

WebSphere Message Broker Toolkit

Lorsque vous tentez de lancer le Toolkit, un erreur "JVM terminated Exit Code = 1" s'affiche (arrêt de la machine virtuelle Java, code d'erreur 1) ou bien le processus javaw.exe utilise 100 % des ressources de l'unité centrale et s'arrête.

Cet incident peut provenir de l'élément -Xshareclasses:singleJVM,keep du fichier eclipse.ini. Cet élément crée un cache qui permet de partager toutes les classes chargées, sans imposer de restrictions aux JVM qui utilisent les données de ces classes. Si le cache est endommagé, aucune nouvelle JVM ne peut s'y connecter. Les JVM en cours continuent à fonctionner mais ne peuvent pas mettre à jour le cache.

Solution :

Pour résoudre cet incident, supprimez le cache endommagé. Le cache sera régénéré lors du prochain démarrage du produit. Pour supprimer le cache :

1. Ouvrez une invite de commande.

2. Accédez au répertoire Message Broker Toolkit/jdk/jre/bin

3. Entrez la commande suivante :

Sous Microsoft Windows : javaw.exe -Xshareclasses:destroy

Sous Linux : ./javaw -Xshareclasses:destroy

Vous pouvez ensuite lancer le produit.

Les modules qui ont été installés à l'aide du gestionnaire d'installation IBM doivent être mis à jour en utilisant ce gestionnaire d'installation IBM. Vous pouvez utiliser le gestionnaire de mises à jour Eclipse pour installer des plug-ins non IBM, mais vous ne devez pas l'utiliser pour mettre à jour des plug-ins et des fonctions Eclipse qui ont été installés à l'aide du gestionnaire d'installation IBM. Si vous souhaitez ajouter des plug-ins à l'aide du gestionnaire de mises à jour Eclipse, vérifiez qu'ils ont été installés dans le répertoire du groupe de package et non dans le répertoire de ressources partagées (qui est géré par le gestionnaire d'installation et réservé à celui-ci).

Si plusieurs produits ont été installés dans un groupe de package, le contenu de l'écran d'accueil qui s'affiche lors du démarrage d'un programme dépend du produit qui a été installé en premier dans le groupe de package. Par exemple, si vous avez installé Rational Application Developer (RAD), puis WebSphere Message Broker et enfin WebSphere Integration Developer (WID), l'écran d'accueil de RAD s'affiche au démarrage de chacun des trois programmes.

Sous Windows, les éléments des menus "Start Help" et "Stop Help" du menu Démarrer->Program Files sont manquants.

Sous Windows, les commandes suivantes sont introuvables depuis la console de commandes :


HAUT

Services Web

La sécurité X509 pour les services Web sous Windows .NET Server n'est pas prise en charge par WebSphere Message Broker version 6.1. Toutes les autres fonctions de services Web de WebSphere Message Broker avec Windows .NET sont entièrement prises en charge, en particulier les jetons USERNAME associés à la sécurité des services Web.


HAUT

Noeuds

Le noeud du collecteur peut provoquer des arrêts, résolus avec la version IC54505.

Les noeuds JMS sous z/OS ne prennent pas en charge les transactions coordonnées avant la version IC54505.

Ces noeuds ne sont pas pris en charge sous z/OS avant la version IC54505.


HAUT

Noeuds WebSphere Adapter

Pour effectuer une migration depuis MQ Link pour SAP R/3 vers Message Broker V6.1, vous avez besoin de la version IC54505.


HAUT

Bases de données

Voici une liste des incidents connus relatifs à JDBC/XA et résolus avec la version IC54505.

Le support des transactions coordonnées de façon globale ('XA') n'est pas pris en charge.


HAUT

Documentation

Le Chapitre 4 du Guide d'installation de WebSphere Message Broker décrit le contenu physique des modules. Certaines indications sont incorrectes :

La section "Installation en mode silencieux" (page 100) indique la liste des étapes à accomplir pour installer le composant Message Broker Toolkit en mode silencieux. Les exemples de commandes mentionnés à l'étape 2 sont incorrects et doivent être remplacés comme suit :

Linux (plateforme 86)
install -nosplash --launcher.suppressErrors -input mbtoolkit-silent.xml -silent
Windows
install.exe -nosplash --launcher.suppressErrors -input mbtoolkit-silent.xml -silent

mbtoolkit-silent.xml est le nom du fichier de réponses.

Si vous préférez, vous pouvez installer le composant Toolkit via le fichier batch/sh fourni sur le Disque 1. Le fichier installToolkit-silent.bat installe les outils de développement en spécifiant les chemins d'accès et paramètres par défaut via le fichier de réponses mbtoolkit-silent.xml. Le second fichier batch fourni sur le Disque 1 (installToolkit.bat) installe le composant Toolkit en mode graphique.


HAUT

Exemples

L'exemple n'est pas pris en charge avant la version IC54505.

L'exemple n'est pas pris en charge avant la version IC54505.


HAUT

Remarques et marques

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 (DBCS) peuvent être obtenues suite à une demande par écrit envoyée à 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 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.

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.

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

AIX, DB2, developerWorks, Everyplace, IBM, Passport Advantage, Rational, WebSphere, z/OS.

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.

UNIX est une marque enregistrée de The Open Group aux Etats-Unis et/ou dans certains autres pays.

Linux est une marque de Linus Torvalds 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.


HAUT

Sites Web utiles

Groupes de correctifs DB2
Les groupes de correctifs DB2 sont disponibles sur CD-ROM ou sur le Web. Notez toutefois que ces groupes de correctifs peuvent être volumineux et qu'il est donc conseillé de demander les versions sur CD-ROM afin d'éviter des temps de téléchargement très longs.
Si vous avez un contrat de support en cours, vous pouvez commander les groupes de correctifs DB2 sur CD-ROM en appelant le support DB2.
Les détails des contacts sont fournis à l'adresse :
http://www.ibm.com/software/data/db2/udb/support.html
Vous pouvez également les télécharger à partir de la même adresse.

Groupes de correctifs WebSphere MQ
http://www.ibm.com/software/integration/wmq/support/

Groupes de correctifs WebSphere Message Broker
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367

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

WebSphere Message Broker - Fichier Readme
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917

Centre de documentation autonome WebSphere Message Broker
Pour Linux :
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz
Pour Windows :
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip

Aide en ligne WebSphere Message Broker V6.1
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp

Centre IBM de technologie Java - Téléchargements
http://www.ibm.com/developerworks/java/jdk/

Spécification WSDL (Web Services Description Language)
http://www.w3.org/TR/wsdl

WebSphere Message Broker, zone developerWorks
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html