README d'IBM WebSphere Business Integration Message Brokers Toolkit Version 5.1

Historique des modifications :
GA : 23 juillet 2004
Updated: 20 August 2004

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

Bienvenue dans IBM WebSphere Business Integration Message Brokers Toolkit, version 5.1. Ce fichier README contient des informations qui n'étaient pas disponibles à temps pour être incluses dans notre centre d'aide en ligne. Il 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.

Avertissement !
Installez Message Brokers Toolkit, version 5.1 uniquement si vous avez déjà installé la version 5.1 de WebSphere Application Development Integration Edition (WSADIE). N'installez pas la version 5.1 si vous disposez d'une version antérieure de WSADIE ; dans ce cas, vous devez utiliser la version 5.0 de Message Brokers Toolkit, qui est livrée avec les versions 5.0 de WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker. La version 5.1 de Message Brokers Toolkit dispose des mêmes fonctions que la version 5.0.3 (Fix Pack 3).

Pour plus d'informations concernant les autres composants de WebSphere Business Integration Message Broker et de WebSphere Business Integration Event Broker version 5.0, reportez-vous à la version 5.0 du fichier README.

Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation of the Message Brokers Toolkit Version 5.1. However, if at least one of your Message Broker Toolkit installations integrates with WSADIE Version 5.1, all your Message Broker Toolkit installations must be at Version 5.1 to ensure data sharing and integrity.

If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.0.

Informations essentielles destinées à tous les utilisateurs
Il est fortement recommandé de consulter la version la plus récente de ce fichier README. Cette version (en anglais uniquement) est disponible à l'adresse suivante :
http://www.ibm.com/software/integration/mqfamily/support/readme/

Pour effectuer l'installation, consultez le fichier install.html.

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/

Informations essentielles relatives à la migration

If you are migrating, refer to the install.html file for details of the actions that you must take before you install.

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first; the two versions cannot coexist.

The information center provides further information about migration; to view this before you install, download a stand-alone version of the information center (see the "Documentation" section for instructions).

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

• Lorsque vous créez ou que vous modifiez des flux de messages, des ensembles de messages et des mappages de messages à l'aide de la version 5.1 de Toolkit, vous ne pouvez plus accéder à ces ressources avec la version 5.0. Assurez-vous que tous les utilisateurs qui travaillent en équipe sur des projets communs, sont informés de ces restrictions et effectuent des sauvegardes, le cas échéant.
• Vous devez vous procurer, auprès de votre fournisseur, une version migrée de tous les modules d'extension de noeuds définis par l'utilisateur avant de pouvoir déployer correctement les flux de messages qui les contiennent.

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

• Vous pouvez déployer tous les projets développés avec la version 5.0, sans qu'aucune modification ne soit requise.
• Vous pouvez importer des fichiers d'archives de courtier, créés dans cette version, dans un espace de travail de la version 5.0 et les déployer correctement.

Documentation
Le centre d'aide en ligne pour WebSphere Business Integration Message Broker et WebSphere Business Integration Event Broker, version 5.0 a été mis à jour afin d'intégrer les modifications requises par la version 5.1 de Message Brokers Toolkit, cette aide peut être téléchargée. Le fichier zip correspondant est disponible à l'adresse : ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/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 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.
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).

Pour ce faire, procédez comme suit :

1. Dans Toolkit, sélectionnez Help > Software Updates > New Updates. 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 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 :

• WebSphere Studio Application Developer Integration Edition
• Coexistence
• Installation
• Après l'installation

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 (WSADIE) avec ce produit, vous devez mettre à jour WSADIE au niveau pris en charge approprié. La version 5.1 GA du workbench WSADIE peut être mise à jour avec "Interim Fix 002 - General Fixes 2.0.0".

Vous devez également appliquer le correctif "WebSphere Business Integration Message Broker v5.1.0 Interim Fix 001 - Prerequisite Fixes 1.0.0.1" après avoir installé WebSphere Business Integration Message Broker ou WebSphere Business Integration Event Broker.

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

Coexistence

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first. The two versions cannot coexist, however you can share resources between versions on different systems:

• Vous pouvez déployer tous les projets développés avec la version 5.0, sans qu'aucune modification ne soit requise.
• Vous pouvez importer des fichiers d'archives de courtier, créés dans cette version, dans un espace de travail de la version 5.0 et les déployer correctement.

Pour plus d'informations concernant la migration de vos ressources et des données utilisateur à la version 5.1, reportez-vous à la section Migration du centre d'aide en ligne.

Installation

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

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 Fichier de définitions de messages ne figure pas dans liste obtenue via Fichier > 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 Aide > 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 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 :
   • Votre navigateur d'aide ouvre une page blanche.
   • Votre navigateur d'aide affiche une erreur HTTP au lieu d'une page d'aide.
   • Le centre d'aide met du temps à se charger.
   
   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. Defect T32243
   The mxsd file extension is not associated correctly with the Message Definition Editor. To ensure that mxsd files are opened in the Message Definition Editor as the default action, select Window > Preferences > Workbench > File Associations. Scroll down the list of file types and select *.mxsd. Then select Message Definition Editor in the list of Associated editors. Click Default then OK.
4. Defect 36422
   In the topic "Distributing a user-defined node" in the online information center, the instructions about extracting the zip file are incorrect. Step 2 of the instructions tells you to unzip the file to the install_dir\eclipse\plugins directory. Instead, the correct location to unzip the file to is the WBIMB_install_dir\evtoolkit\eclipse\plugins directory.
   In the topic "Installing a user-defined extension on a broker domain" in the online information center, the install location for Windows is ambiguous. For C user-defined nodes, the topic tells you to use the location install_dir\bin. This should be WBIMB_install_dir\bin. For Java user-defined nodes, the topic tells you to use the location install_dir\jplugin. This should be WBIMB_install_dir\jplugin.
5. Defect 36589
   If you use any of the predefined ESQL constants, such as MQMO_NONE, in ESQL code, the code is flagged as Message Brokers Toolkit Version 5.0 compatible. This means that you cannot deploy message flows referencing this ESQL code to a Version 2.1 broker, regardless of the compatibility level set in the preferences. This limitation will be lifted in the next fix pack for Message Brokers Toolkit Version 5.1.
6. Defect 36605
   The description of the property Namespace in topics "Wildcard attribute logical properties" (ad11870_) and "Wildcard element logical properties" (ad11890_) is incorrect. In the current implementation, there is no enumerated list of options and the field is initially blank. You can specify a namespace in this field; this causes a Task List warning to be displayed which explains that the broker will not use this information and will allow an element from any namespace to be used as the wildcard.
7. Defect 36638
   The Message Set Editor Preferences topic (ad15810_) describes only the options available in the Version 5.0 toolkit. The Version 5.0 options are not available for Version 5.1. In the Version 5.1 toolkit, the options are:
   • Message set editor settings, Outline view settings. These options are displayed but are not operational:
     • Group by namespace and then by collections
     • Group by collections and then by namespace
   • Message definition editor settings:
     • Show base complex types
       If you have defined one or more complex types based on other complex types, select this option if you want the content of those base complex types to be displayed in the message definition editor overview and outline views (this is selected by default).
       If you do not want them displayed, clear the check box.
8. TDS properties
   The grouping and order of TDS properties of global attribute, global element, local attribute, and local element shown in the workbench differ from the grouping and order shown in the topics that describe them. Their meaning and use is unchanged.
9. Defect 36655
   If you uninstall the toolkit by invoking uninstaller.exe with the -silent option, the uninstall program returns control immediately and runs as a background task. If you do not want the uninstall program to return until it has completed, you must invoke the uninstaller within java using this command:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   where <install_dir> is the directory in which you installed the product.
   If you do not have a jvm configured (Version 1.3.1 or above), you can use the jvm within the installed product in directory <install_dir>\_sjvm\bin\. If you do this, you might have to delete this directory manually when uninstallation is complete.