Historique des modifications :
GA : 23 juillet 2004
(C) Copyright IBM Corporation 2004. All rights reserved.
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(R) Windows(R) 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 de la version 5.0 et aux instructions d'installation.
AVERTISSEMENT !
N'installez Message Brokers Toolkit Version 5.1 que si vous avez installé
WebSphere Studio Application Developer Integration Edition (WSADIE) Version
5.1. N'installez pas la version 5.1 si vous disposez d'une version précédente de
WSADIE ; dans ce cas, vous devez utiliser Message Brokers Toolkit Version 5.0, fourni
avec WebSphere Business Integration Message Broker et WebSphere Business
Integration Event Broker Version 5.0.
Migrating
If you are migrating, read Before you start.
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.
Vous devez consulter en ligne la version la
plus récente des instructions d'installation. 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 disponibles en
temps voulu à l'adresse suivante :
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
Il est possible de télécharger le centre d'aide et d'information
de WebSphere Business Integration Message Broker et de WebSphere
Business Integration Event Broker. Le zip correspondant est
disponible à l'adresse :
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip
Veuillez lire le fichier installing_and_managing.htm, inclus dans wbimb_help.zip.
Sommaire
Pour savoir quelles versions des systèmes d'exploitation
sont prises en charge par Message Brokers Toolkit Version 5.1,
consultez les rubriques WebSphere MQ Family Supported Software à l'adresse suivante :
http://www-3.ibm.com/software/integration/wbimessagebroker/requirements/ (pour WebSphere Business Integration Message Broker) ou
http://www-3.ibm.com/software/integration/wbieventbroker/requirements/
(pour WebSphere Business Integration Event Broker)
Message Brokers Toolkit Verison 5.1 est pris en charge sous les environnements suivants :
Il n'est pas pris en charge sous Windows 2003.
You might have to complete some actions before you install Message Brokers Toolkit Version 5.1:
The Version 5.0 installation instructions are also on the main product CD in \installdocs\<locale>\install.html.
After you have installed, refer to the online information center for further information about migration.
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.
Les instructions qui suivent décrivent les différentes étapes d'installation de Message Brokers Toolkit Version 5.1.
Si vous lancez l'installation à partir de la ligne de commande, vous pouvez spécifier des options vous indiquant comment effectuer l'installation. Ces options sont décrites dans Installation des options de 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 est lancé.
Vous pouvez mapper l'unité réseau du CD si elle est située sur un système éloigné. Vous ne pouvez 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 Java 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é.
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.
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. Voir les
instructions de désinstallation pour savoir
comment supprimer Message Brokers Toolkit.
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. Enfin, si
vous cliquez deux fois de suite sur Suivant>,
vous risquez d'omettre un panneau. Pour vérifier que le programme
d'installation progresse correctement, contrôlez l'utilisation de votre
unité centrale : celle-ci augmente considérablement pendant une
installation.
L'installation via la console fait appel à une interface à base de texte dans la fenêtre de console. Vous pouvez la lancer à partir de la ligne de commande en saisissant :
chemin setup.exe -console -is:javaconsole
où chemin correspond à l'emplacement en cours 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 afin de continuer.
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, en fonction des options disponibles dans les modes interactifs ci-dessus, 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 en cours 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 :
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 en dehors du répertoire d'installation du produit.
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.
WARNING
You must make the following correction in the template response file to
indicate whether the toolkit is to link to WSADIE.
En mode d'installation automatique, vous devez utiliser un fichier de réponses si vous souhaitez intégrer ce Toolkit avec WSADIE. Consultez WebSphere Studio Application Developer Integration Edition pour plus d'informations.
Les arguments d'installation permettent une installation dans quatre modes différents : interface graphique, console, accessibilité et installation automatique. Les arguments d'installation permettent d'enregistrer et d'utiliser un fichier de réponses.
Le mode Interface graphique, également désigné par le terme "mode AWT" (Abstract Window Toolkit), est le mode par défaut de l'installation sans argument d'installation. Entrez ce qui suit sur la 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.
Le mode console est généralement utilisé lorsqu'aucune interface graphique n'est disponible, mais il peut également être utilisé lorsqu'il y en a une de disponible. Entrez ce qui suit sur la ligne de commande :
setup.exe -console -is:javaconsole
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 ce qui suit sur la ligne de commande :
setup.exe -accessibility
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 automatiques sur un grand nombre de système identiques. Entrez ce qui suit sur la ligne de commande :
setup.exe -silent
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 ce qui suit 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 ce qui suit 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.
You must correct an error in the response file before you use it. For details, see the Warning under Silent mode in the Install instructions.
Pour fournir des options enregistrées, utilisées au cours d'une installation, à une installation automatique, procédez comme suit :
setup.exe -options fichier_réponses -silent
où fichier_réponses correspond au chemin complet et au nom du 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 afin de l'utiliser ultérieurement. Ce fichier peut être généré sans exécuter l'installation complète. Pour ce faire, entrez ce qui suit 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.
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.
Solution : Recherchez les erreurs dans le journal d'installation (mqsi5.log) après chaque installation automatique pour vérifier qu'elle a abouti sans erreurs.
Le fichier du journal d'installation s'intitule mqsi5.log. Son emplacement par défaut est généralement C:\Documents and Settings\nom_connexion_utilisateur.
WARNING!
You can integrate Message Brokers Toolkit Version 5.1 only with the supported GA
of WSADIE Version 5.1.
If you do not have the supported GA version of WSADIE installed, or you are unsure which version you have, contact your IBM Service representative for further information.
When you are ready to apply WSADIE fixes, you must complete these tasks in the order shown below.
Afin d'étendre un workbench WebSphere Studio Application Developer Integration Edition (WSADIE) avec ce produit, vous devez passer WSADIE au niveau de support approprié. La version du workbench WSADIE pouvant être étendue est WSADIE version 5.1 GA 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".
Vous devez appliquer ces correctifs après avoir installé WebSphere Business Integration Message Broker ou WebSphere Business Integration Event Broker et vous devez sélectionner l'option d'installation afin d'activer le lien vers WSADIE (voir Instructions d'installation).
Pour plus d'informations, consultez le site de téléchargement de support WSADIE, accessible à l'adresse : http://www.ibm.com/software/awdtools/studiointegration/support/
Ces informations partent du principe que vous avez déjà installé WSADIE lorsque vous installezMessage Brokers Toolkit Version 5.1. Si vous installez WSADIE après Message Brokers Toolkit, veuillez suivre les instructions du centre d'aide et d'information en ligne.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.
Ces instructions décrivent la procédure de désinstallation de Message Brokers Toolkit Version 5.1. Comme l'assistant d'installation, l'assistant de désinstallation peut être exécuté en 3 modes différents :
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.
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.
Le mode console fait appel à une interface à base de texte dans la fenêtre de console. Vous pouvez lancer le mode console à partir de la ligne de commande en saisissant :
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_install\_uninst\studio\uninstaller.exe -console -is:javaconsole
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.
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
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 Fix Pack 1 avant de pouvoir installer 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 correctifs disponibles figurent à l'adresse suivante : http://www.ibm.com/software/integration/mqfamily/support/summary
Les correctifs pour WebSphere Business Integration Message Brokers Toolkit sont installées grâce à 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éinstaller 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 installer de Fix Pack Version 5.0 sur un
composant en version 5.1). Il installera correctement les correctifs pour tous
les autres composants.
(Si vous êtes en mode console ou installation automatique, veillez à sélectionner
les options adéquates.)
Vous pouvez télécharger le dernier correctif à l'adresse suivante :http://www.ibm.com/software/integration/mqfamily/support/summary/wbib.html
Faites défiler la page Web WebSphere Business Integration Brokers Support jusqu'à Message Brokers Toolkit Version 5.1.
Vous devez lire le mémo. Pour y accéder, cliquez sur le lien Détails dans la colonne View Memo.
Pour lancer le processus de téléchargement, allez dans la colonne Download PTF/Fix Pack et cliquez sur le lien (son nom est de la forme Fix Pack XX Unnnnnn, où XX correspond au numéro du correctif, et Unnnnnn au nom du fichier du correctif).
Suivez les instructions du site Web IBM Downloads, qui vous guidera dans un processus en trois étapes (configuration, enregistrement, téléchargement). Sélectionnez un emplacement approprié pour y enregistrer la CSD téléchargée.
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 :
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 ce qui suit 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. Voir Installation des options de ligne de commande.
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.
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.