Documentation relative aux notes sur l'édition pour IBM Integration Bus V9.0 des composants d'outils et d'exécution.
Notes sur l'édition pour : IBM Integration Bus
Edition du produit/composant : 9.0
Nom de la mise à jour : 9.0.0.0
Consultez toujours la dernière version de ce fichier de notes sur l'édition, disponible à l'adresse suivant (en anglais) :
http://www.ibm.com/support/docview.wss?uid=swg27006917
Les fichiers Notes sur l'édition traduits sont disponibles à l'adresse suivante :
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/
Pour plus d'informations sur les tâches à accomplir avant d'installer le produit, reportez-vous au centre de documentation d'IBM Integration Bus 9.0 à l'adresse suivante :
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp
Vérifiez la configuration système requise pour IBM Integration Bus afin de vous assurer que votre plateforme d'installation est prise en charge pour l'édition du produit que vous prévoyez d'installer. La page Web relative à la configuration système requise pour IBM Integration Bus est disponible à l'adresse suivante :
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Deux éditions d'IBM Integration Bus v9.0 sont disponibles sous Windows :
L'édition 64 bits d'IBM Integration Bus n'est pas prise en charge sur certaines versions 64 bits du système d'exploitation Windows. Pour plus d'informations, voir la page Web de configuration système requise pour IBM Integration Bus.
Si vous procédez à une migration de WebSphere Message Broker version 6.1, version 7.0 ou version 8.0, consultez le centre de documentation en ligne à l'adresse suivante : http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp, qui donne des informations détaillées relatives à la migration.
Le centre de documentation en ligne d'IBM Integration Bus est disponible à l'adresse suivante :
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp
Consultez le centre de documentation en ligne afin d'obtenir les informations les plus récentes. Le centre de documentation en ligne contient des informations plus récentes que le centre de documentation livré avec IBM Integration Toolkit.
Le centre de documentation autonome peut être téléchargé à l'adresse suivante :
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_linux.tgz (version Linux)
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_win.zip (version Windows)
Pour plus d'informations sur l'utilisation du centre de documentation autonome, lisez le fichier using_the_infocenter.html qui se trouve dans le dossier ibm_help (fichiers ib_help_linux.tgz et ib_help_win.zip).
Incidents : ce fichier Notes sur l'édition peut contenir des références à des numéros d'incident. Ces numéros se réfèrent à des incidents IBM internes. Ils peuvent s'avérer utiles si vous devez exposer un incident à un technicien de maintenance IBM.
Notes techniques : pour des informations à jour sur les problèmes connus et les correctifs disponibles, consultez le site Web de support d'IBM Integration Bus à l'adresse suivante :
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
Pour rechercher des informations, cliquez sur Troubleshoot. Les notes techniques IBM Integration Bus s'affichent et vous pouvez les trier et effectuer une recherche.
Pour plus d'informations sur le téléchargement des images d'installation d'IBM Integration Bus 9.0 à partir du site Web Passport Advantage, reportez-vous au document Download IBM Integration Bus V9.0 from the Passport Advantage website, disponible à l'adresse suivante :
http://www.ibm.com/support/docview.wss?uid=swg24034922
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 IBM Integration Bus, consultez la page relative
à la configuration requise, à l'adresse suivante :
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Vérifiez régulièrement
si des mises à jour d'IBM Integration Toolkit ont été effectuées (notamment dans la
documentation disponible en anglais et dans les autres langues prises en charge). Vous trouverez les correctifs recommandés pour IBM Integration Bus à l'adresse suivante :
http://www.ibm.com/support/docview.wss?uid=swg27006041
Des détails sur les nouveautés de la version 9.0 sont disponibles à l'adresse suivante :
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23800_.htm
Cette section présente, pour chaque composant, les problèmes connus et leurs solutions (le cas échéant) d'IBM Integration Bus.
Symptômes :
Si vous exécutez le programme de désinstallation d'IBM Integration Bus uninstaller.exe et que vous utilisez Windows 7 ou Windows Server 2008 R2, une fenêtre risque de s'ouvrir pour vous signaler que le fichier de désinstallation n'est pas signé.
Solution :
Cet avertissement peut être ignoré. Poursuivez le processus de désinstallation.
IBM Integration Bus est pris en charge sur Ubuntu, mais uniquement pour les systèmes de développement. Les systèmes de production ne doivent pas être utilisés pour exécuter IBM Integration Bus sur Ubuntu.
Pour plus d'informations, voir la page de configuration système requise pour IBM Integration Bus :
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Symptômes
Lors de la tentative de connexion d'un noeud contenant plusieurs terminaux de sortie vers d'autres noeuds, une connexion n'est pas créée.
Solution
Pour contourner ce problème, procédez de l'une des façons suivantes :
Symptômes
Lors de la mise à niveau de WebSphere Message Broker V8.0.0.1, les processus de courtier de signaux et de moteur de flux de données sur des plateformes Solaris ou HP peuvent consommer 204 Mo de mémoire supplémentaires. Cela est dû à une augmentation de la valeur par défaut du paramètre ReservedCodeCacheSize dans la machine virtuelle Java (JVM) utilisée par les processus de courtier. Cette zone de mémoire est liée à la compilation JIT des classes Java et elle a été augmentée par le fournisseur de la machine virtuelle Java en réponse à un besoin d'espace disponible supplémentaire dans le cache du code des produits tiers.
Solution
Si l'augmentation de l'utilisation de mémoire entraîne des problèmes pour votre système, vous pouvez revenir à l'ancienne valeur du paramètre ReservedCodeCacheSize en exportant la variable d'environnement suivante dans le profil de votre courtier avant de démarrer celui-ci :
Pour connecter IBM Integration Explorer à un gestionnaire de files d'attente et recevoir des publications, la valeur attribuée à la propriété SHARECNV du canal SVRCONN de ce gestionnaire de files d'attente doit être supérieure à 0. Cette valeur est obligatoire si vous souhaitez utiliser la vue Statistiques ou Graphique des statistique dans IBM Integration Explorer.
Symptôme :
Lorsque vous importez des ressources dans un nouvel espace de travail, des messages d'erreur peuvent s'afficher une fois la construction automatique terminée.
Solution :
Dans la vue Application Development, sélectionnez vos projets, puis cliquez avec le bouton droit de la souris sur Project > Clean pour reconstruire les projets. Une fois les projets nettoyés, les messages d'erreur relatifs à l'importation sont supprimés.
mqsicreatebar
peut impliquer de nettoyer le projetSymptôme :
Lorsque vous exécutez la commande mqsicreatebar
et spécifiez un nouvel espace de travail, des messages d'erreur peuvent s'afficher.
Solution :
Utilisez l'option -cleanBuild
lors de l'exécution de la commande mqsicreatebar
pour nettoyer les projets.
Symptôme :
Si vous possédez plusieurs applications ou bibliothèques dans votre espace de travail requérant un projet Java, PHP ou d'ensemble de messages portant le même nom, un message d'erreur similaire au suivant apparaît :
Le projet < Nom du projet > ne peut pas être membre de plusieurs applications ou bibliothèques....
Solution :
Pour utiliser un projet dans plusieurs applications ou bibliothèques, convertissez ce projet en bibliothèque, puis référencez-la à partir de l'application ou de la bibliothèque dans laquelle vous voulez l'utiliser.
Symptôme :
Peu de temps après son lancement sous Linux, IBM Integration Toolkit tombe en panne avec l'erreur suivante :
JVM terminated - Exit code=160
Solution :
Installez une version de XULRunner compatible avec Eclipse 3.6.
Les versions compatibles de XULRunner sont les versions 1.8-3.6 et les groupes de correctifs associés.
IBM a effectué des tests avec la version suivante de XULRunner, qui permet de résoudre le problème :
http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.2.19/runtimes/xulrunner-1.9.2.19.en-US.linux-i686.tar.bz2
Développez le fichier compressé téléchargé dans un répertoire local (par exemple /usr/lib/xulrunner_new)
Ajoutez la ligne suivante au fichier eclipse.ini sous le répertoire d'installation mb :
-Dorg.eclipse.swt.browser.XULRunnerPath=<emplacement du téléchargement décompressé> (par exemple -Dorg.eclipse.swt.browser.XULRunnerPath=/usr/lib/xulrunner_new)
Symptôme :
Lorsque vous utilisez l'outil de conversion WebSphere ESB pour convertir un flux de médiation créé à l'aide d'un modèle d'intégration de service ou d'un modèle de mappe d'opération, et que ce flux de médiation inclut des opérations unidirectionnelles, le nom du flux secondaire généré se termine par Request_Response et non par Request. L'outil de conversion ESB affiche un message de conversion indiquant que le flux de réponses a été converti, mais une opération unidirectionnelle n'a pas de flux de réponses.
Solution :
Ignorez le message de conversion.
Problème :
Si vous avez deux bibliothèques indépendantes avec le même préfixe d'espace de nom défini dans un module ESQL et que vous essayez de déployer les deux bibliothèques sur l'application par défaut, l'un des deux déploiements échoue.
Par exemple :
Library 1 : MyDBLibrary
ESQL file : MyFlow_GetCustomerInfo.esql
PATH MyDBService.CUSTOMERGroup;
DECLARE ns NAMESPACE 'http://MyDBService';
Library 2: MyTestDBLibrary
ESQL file: MyFlow_Compute.esql
PATH DatabaseService.CUSTOMER_Table_Operations;
DECLARE ns NAMESPACE 'http://DatabaseService';
Cette opération donne lieu à l'erreur suivante :
BIP4128E: Failed to deploy ESQL 'declare' called '#NS' contained in 'MyTestDBLibrary.mqsiLibrary\MyFlow_Compute.esql' because it is already deployed in file 'MyDBLibrary.mqsiLibrary\MyFlow_GetCustomerInfo.esql'? The ESQL component has already been deployed in a different ESQL file.
Solution :
ESQL requiert un préfixe d'espace de nom unique dans un module ESQL. Vérifiez que chaque module, routine ou instruction de déclaration ESQL n'est déclaré que dans un seul fichier ESQL. Changez le préfixe d'espace de nom de l'une des bibliothèques de sorte qu'il devienne unique dans le contexte de déploiement.
Lorsque vous utilisez IBM Integration Bus sur z/OS, vous ne pouvez pas télécharger les fichiers WSDL et les utiliser dans le modèle Web Based Static Endpoint via l'interface utilisateur Web.
Problème :
L'interface utilisateur Web ne parvient pas à afficher les modifications statistiques ou administratives.
L'erreur suivante se produit lorsque vous démarrez IBM Integration Bus :
BIP2112E: Message broker internal error: diagnostic information '2', '2033'.
Solution :
Appliquez la modification provisoire du logiciel pour WebSphere MQ APAR PM90120.
Symptômes :
Lors de la reconnaissance itérative de WebSphere Adapter for SAP Software Enterprise Metadata Discovery (EMD), le panneau Service Generation and Deployment Configuration de l'assistant de connexion s'affiche et peut être édité ; toutefois, les informations de connexion du système d'adaptateur que vous entrez ne seront pas sauvegardées dans le composant d'adaptateur.
Solution :
Utilisez l'éditeur WebSphere Adapters pour modifier les informations de connexion du système d'adaptateur et faire en sorte que les reconnaissances itératives EMD suivantes conservent ces informations :
Symptômes :
L'adaptateur entrant JDE ne se déploie pas si la case assured delivery est cochée dans l'assistant d'adaptateur. L'erreur suivante est émise :
La tentative de définir la propriété 'AssuredOnceDelivery' sur le composant d'adaptateur
'AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne' a échoué car cette propriété n'est
pas prise en charge.
Solution :
Cette fonctionnalité n'est actuellement pas prise en charge et ne devrait pas être utilisée dans le développement de flux de messages.
Symptômes : Lors de la génération d'une mappe de données graphiques incluant une routine de transformation de base de données, si cette dernière utilise un modèle de base de données (fichier .dbm) reconnu à partir d'un serveur de base de données autre que IBM DB2, l'éditeur de mappage de données graphiques empêche la sélection d'aboutir. L'éditeur affiche le message explicatif suivant : "Selected Routine is not supported in this release" .
Solution : seules les procédures mémorisées IBM DB2 peuvent être appelées simultanément à partir des mappes de données graphiques.
Symptômes :
Sur les systèmes UNIX qui utilisent l'interpréteur de commandes Z (zsh) comme environnement shell, un appel à 'source {install path}/mqsiprofile' provoque la fermeture du shell. En raison du comportement par défaut de zsh, la commande mqsiprofile vérifie un nombre d'argument incorrect pour déterminer s'il est sourcé ou exécuté directement. Le script mqsiprofile imprime alors un message d'avertissement et appel l'exit, mais zsh interprète cet appel comme une instruction pour quitter le shell en cours.
Solution :
Pour contourner ce problème, procédez comme suit :
Les clients utilisant des bases de données utilisateur sur z/OS nécessitent le correctif APAR DB2 PK99362.
Les transactions JDBC/XA coordonnées globalement ('XA') sont prises en charge sous DB2 et Oracle (sauf Oracle RAC) sur toutes les plateformes prises en charge par IBM Integration Bus, à l'exception de HP-UX sous Itanium et z/OS.
Il n'est pas possible d'avoir ODBC XA et JDBC/XA sur le même courtier.
Les transactions Informix coordonnées globalement ('XA') ne sont pas prises en charge.
Lors de la configuration d'un courtier en vue de l'utilisation de XA avec un gestionnaire de files d'attente WebSphere MQ 7.5 comme gestionnaire de transactions, le fichier de commutation approprié doit être inclus dans le
répertoire <MQ_DATA_PATH>/exits ou <MQ_DATA_PATH>/exits64, ou dans les deux. N'utilisez pas les sous-répertoires propres à l'installation exits et exits64 pour les fichiers de commutation.
Symptômes :
IBM Integration Bus v9.0 permet l'intégration avec BPM, via l'importation des définitions de service d'intégration BPM dans IBM Integration Bus, de manière à générer des services d'intégration IBM Integration Bus. Un fichier .twx, qui représente une exportation d'instantané d'un BPM Toolkit, permet de transférer la définition de service d'intégration BPM vers IBM Integration Bus. Le BPM Toolkit doit contenir un service d'intégration BPM avec des variables d'entrée et de sortie définies, et peut également contenir des références à d'autres BPM Toolkits qui contiennent des objets métier associés.
Les BPM Toolkits peuvent référencer des BPM Toolkits dépendants référençant eux-mêmes d'autres BPM Toolkits. Toutefois, lorsque vous créez un service d'intégration IBM Integration Bus v9.0 à partir d'un fichier .twx file, il ne peut y avoir qu'un niveau d'abstraction BPM Toolkit entre un service d'intégration BPM et les objets métier.
Solution :
Lorsque vous intégrez BPM avec IBM Integration Bus v9.0, assurez-vous que le BPM Toolkit qui contient le service d'intégration BPM ne contient pas de références aux BPM Toolkits faisant référence à d'autres BPM Toolkits.
http://www.ibm.com/legal/copytrade.shtml
Les informations contenues dans ce manuel font référence à des produits et services disponibles aux Etats-Unis.
IBM n'offre pas obligatoirement les produits, services ou fonctionnalités décrits ici dans tous les autres 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 :
Des 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 Web 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 saurait être tenue responsable de leurs performances, de leur compatibilité, ni de tout autre problème liés à des produits tiers. 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 :
DB2, developerWorks, IBM, Informix, Passport Advantage, WebSphere, z/OS.
Java ainsi que tous les logos et toutes les marques incluant JAVA sont des marques d'Oracle et/ou de ses sociétés affiliées 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.
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.
Les autres noms de sociétés, de produits et de services peuvent appartenir à des tiers.
Page de produit IBM Integration Bus
http://www.ibm.com/software/products/us/en/integration-bus/
Groupes de correctifs DB2
Si vous avez un contrat de support en vigueur,
vous pouvez commander les groupes de correctifs DB2 sur CD-ROM en appelant le support DB2. Vous pouvez également
télécharger ces groupes de correctifs DB2 depuis le Web. Toutefois, certains fichiers de ces groupes de correctifs
sont volumineux et, par conséquent, il est préférable de se procurer les versions disponibles sur CD afin d'éviter
des téléchargements trop longs.
Des détails expliquant comment contacter le support DB2 et télécharger des groupes de correctifs DB2 sont
disponibles à l'adresse suivante :
http://www.ibm.com/software/data/db2/udb/support.html
Groupes de correctifs WebSphere MQ
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
Groupes de correctifs IBM Integration Bus
http://www.ibm.com/support/docview.wss?uid=swg27006041
Exigences IBM Integration Bus
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Fichier de notes dur l'édition IBM Integration Bus
http://www.ibm.com/support/docview.wss?uid=swg27006917
Centre de documentation autonome IBM Integration Bus v9.0
Pour Linux :
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_linux.tgz
Pour Windows :
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_win.zip
Centre de documentation en ligne IBM Integration Bus v9.0
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/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
Zone IBM Integration Bus developerWorks
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html