Installation de Business Integration Connect

Lorsque tous les prérequis mentionnés dans les sections précédentes sont présents, vous êtes prêt à exécuter les assistants d'installation Database Loader et WebSphere Business Integration Connect.

Variable d'environnement DISPLAY

Les assistants d'installation de Database Loader et du concentrateur affichent l'interface graphique à l'aide du système X-Windows sous UNIX. L'utilisation du système X-Windows requiert l'exportation de la variable d'environnement DISPLAY vers l'environnement système. Les lignes suivantes permettent de définir la variable d'environnement DISPLAY sur l'adresse_IP à partir d'un shell Bourne :

DISPLAY=Adresse_IP:0.0
 

export DISPLAY
 

Utilisez la syntaxe appropriée à votre shell pour définir la variable d'environnement DISPLAY.

Remarque :
Vérifiez que la variable d'environnement système DISPLAY et le système X-Windows sont correctement configurés en exécutant un programme client X tel que xclock, depuis la ligne de commande. Si le client xclock s'affiche sur la fenêtre du serveur X (local ou distant), les assistants doivent également s'afficher correctement.

Tableau de bord

Business Integration Connect contient un tableau de bord, voir la Figure 2, qui permet d'accéder à la présentation du produit, au fichier ReadMe, à la documentation produit, à Database Loader et au programme d'installation de Business Integration Connect. Vous pouvez également lancer Database Loader et les programmes d'installation à l'aide des programmes setup*.* fournis. Voir Création de la base de données et Installation des composants à l'aide de l'assistant d'installation.

Remarque :
Pour utiliser certaines options du tableau de bord, un navigateur doit être installé et disponible au niveau du chemin du système.

Emplacement du fichier exécutable du tableau de bord :

{CD_ROM/MEDIA DIR}/LaunchPad.*
 



Figure 2. Fenêtre du tableau de bord

Création de la base de données

Business Integration Connect comprend un assistant d'installation permettant de configurer les tables de bases de données. Cet assistant, Database Loader, rassemble des informations qui lui permettent de créer et de remplir les tables. Il peut également sauvegarder les fichiers SQL utilisés pour créer les tables. Vous pouvez alors utiliser les fichiers SQL pour créer et alimenter les tableaux. L'exécution manuelle des fichiers SQL permet à l'administrateur de base de données de revoir les tables de la base de données avant de les alimenter.

Avant de commencer, assurez-vous que votre serveur de base de données est installé et configuré correctement et qu'il fonctionne.

Remarque :
Si SQL est exécuté automatiquement, Database Loader doit être exécuté sur le serveur où se trouve la base de données. Cela permet de garantir une adresse hôte correcte pour la base de données.

La procédure suivante explique comment configurer la base de données à l'aide de l'interface graphique de Database Loader. Vous pouvez également installer Database Loader sans l'aide de l'interface graphique. Pour plus d'informations, voir "Installation des composants à partir de la ligne de commande".

Afin de configurer les tables de base de données :

  1. Connectez-vous en tant qu'administrateur root.
  2. Database Loader requiert des privilèges d'administrateur pour exécuter automatiquement la propriété SQL de création/modification des répertoires d'espaces tables.
  3. A partir du répertoire Database Loader, lancez l'exécutable de configuration indiqué dans le Tableau 5 spécifique à votre plateforme :


    cd DBLoader


    Tableau 5. Exécutables spécifiques à une plateforme pour le programme d'installation
    Plateforme Exécutable

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSunOS

    L'assistant Database Loader démarre et affiche l'écran de bienvenue. Cliquez sur Suivant.

  4. Sur l'écran du contrat de licence du logiciel, lisez les termes du contrat. Si vous acceptez les termes du contrat de licence, sélectionnez le bouton d'acceptation des termes du contrat de licence. Cliquez sur Suivant.
  5. Sur l'écran Nom du répertoire, entrez le chemin d'accès et le nom du répertoire que Database Loader doit utiliser lors de la configuration de la base de données. Les noms de répertoire ne doivent contenir aucun espace imbriqué ni aucun caractère spécial. Voir la Figure 3.

    Sélectionnez un emplacement avec suffisamment d'espace pour stocker votre base de données et toutes les données d'applications. Cliquez sur Suivant

    Remarque :
    . Lorsque vous recherchez un répertoire, entrez "." dans la zone de saisie du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'entrez pas ".", l'écran de Sélection d'un répertoire n'affiche pas l'écran à partir duquel il a été lancé.

    Figure 3. Ecran Nom du répertoire


  6. Sur l'écran Sélection du type de base de données, sélectionnez le serveur de base de données que vous souhaitez utiliser pour Business Integration Connect. Cliquez sur Suivant. Voir la Figure 4.

    Figure 4. Ecran Sélection du type de base de données


  7. Sur l'écran Informations relatives à la base de données, Figure 5, entrez les informations suivantes, puis cliquez sur Suivant lorsque vous avez terminé.

    DB2 :

    Figure 5. Ecran Informations relatives à la base de données DB2


    Oracle:

    Figure 6. Ecran Informations relatives à la base de données Oracle


  8. Sur l'écran Emplacement de la base de données, Figure 7, entrez le chemin complet de l'emplacement de la base de données ainsi que chacun de ses espaces table sur le serveur de base de données. Ce chemin sera du type suivant : DB2Home/IBM/WBIConnect/DBLoader/tables.
    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone de saisie du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'entrez pas ".", l'écran de Sélection d'un répertoire n'affiche pas l'écran à partir duquel il a été lancé.
    Si une de ces valeurs est modifiée, elle doit exister avant d'exécuter les fichiers SQL. Si elle n'existe pas, il faut la créer manuellement.

    Lorsque vous avez saisi les informations nécessaires, cliquez sur Suivant.

    Remarque :
    Sélectionnez un emplacement du système de fichiers contenant suffisamment d'espace pour contenir la base de données et toutes les données d'application. La taille de la base de données augmentera lors de l'exécution de Business Integration Connect.

    DB2 :

    Figure 7. Ecran Emplacement de la base de données DB2

    Oracle:

    Figure 8. Ecran Emplacement de la base de données Oracle


  9. Sur l'écran Configuration des composants, Figure 9, entrez les informations de connexion des composants Business Integration Connect ainsi que l'emplacement des fichiers partagés communs. Cliquez sur Suivant lorsque vous avez terminé.

    Figure 9. Ecran Configuration des composants


    Dans les zones de saisie Nom d'utilisateur et Mot de passe associées à la Console de communauté, au Gestionnaire de documents et au Réceptionnaire, entrez le nom et le mot de passe de l'utilisateur, pour chaque composant. Ces utilisateurs ont été créés au moment de la configuration du serveur.

    Dans la zone de saisie Nom du groupe, entrez le nom du groupe contenant les utilisateurs Business Integration Connect.

    Le système affiche l'écran Point de montage des informations partagées.

  10. Entrez l'emplacement des fichiers partagés communs utilisés par les principaux composants de Business Integration Connect.
    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone de saisie du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'entrez pas ".", l'écran de Sélection d'un répertoire n'affiche pas l'écran à partir duquel il a été lancé.
  11. Le système affiche l'écran Récapitulatif. Vérifiez sur l'écran Récapitulatif l'emplacement d'installation de Database Loader. Si cet emplacement est incorrect, cliquez sur Précédent pour revenir à l'écran précédent. Lorsque les informations du Récapitulatif sont correctes, cliquez sur Suivant.
  12. L'écran suivant de l'assistant vous permet d'indiquer si Database Loader doit simplement créer les fichiers SQL ou bien les créer puis les exécuter Voir la Figure 10.

    Figure 10. Ecran Exécuter les fichiers SQL


    Lorsque Database Loader exécute les fichiers SQL, il procède comme suit :

    Le redémarrage de l'instance DB2 fait partie de la routine de Database Loader. Il vous faut, par conséquent, déconnecter toutes les applications qui utilisent l'instance DB2 lorsque vous effectuez la configuration de la base de données de Business Integration Connect.

    Si vous souhaitez que Database Loader exécute les fichiers, cochez la case Exécuter les fichiers SQL.

    Cliquez sur Suivant lorsque vous avez terminé.

  13. Cliquez sur Fin dès que ce bouton est actif.
  14. Si vous exécutez les fichiers SQL manuellement, reportez-vous au fichier Instructions.txt qui se trouve dans le répertoire SQL (installé par l'assistant d'installation Database Loader) pour plus d'informations.

    Une fois la base de données de Business Integration Connect configurée, vous pouvez procéder à l'installation des composants de Business Integration Connect.

    La section suivante explique comment installer les composants à l'aide de l'interface graphique de l'assistant d'installation InstallShield. Vous pouvez également installer les composants sans l'aide de l'interface graphique. Pour plus d'informations, voir "Installation des composants à partir de la ligne de commande".

Installation des composants à l'aide de l'assistant d'installation

Business Integration Connect comporte trois principaux composants : la Console de communauté, le Réceptionnaire et le Gestionnaire de documents. Ces trois composants partagent un contenu commun. Vous pouvez installer les composants et leur contenu commun sur un même serveur ou installer chaque composant sur un serveur distinct, ou bien utiliser une combinaison des deux. Vous devez installer une instance de chaque composant sur au moins un serveur. Pour plus d'informations sur le placement des divers composants sur différents serveurs, voir Planification de l'environnement et "Topologies".

Remarque :
Si vous installez Business Integration Connect sur plusieurs machines, le même point de montage et la même structure de répertoires doivent être utilisés pour le dossier partagé commun sur toutes les machines.

Avant de commencer, assurez-vous que les logiciels requis sont installés et correctement configurés. Consultez le tableau des prérequis pour tous les serveurs Business Integration Connect dans Configuration requise en matière de plateforme, matériel et logiciel pour obtenir la configuration de logiciels requise et Installation - Généralités pour obtenir des informations sur la configuration de ces logiciels. La base de données de Business Integration Connect doit être configurée. Pour plus d'informations à ce sujet, voir Création de la base de données. Enfin, vérifiez le fonctionnement du serveur de base de données et de WebSphere MQ, ainsi que du gestionnaire de file d'attente et du programme d'écoute.

Les composants communs doivent être installés une seule fois lors de l'utilisation de tout élément autre que la topologie consolidée.

Remarque :
Si vous travaillez sur une plateforme Linux, suivez la procédure ci-dessous afin d'éviter des fuites de mémoire :
a. Modifiez la valeur maximale de sémaphores (paramètre de noyau) de 32000 à 256000 sur le serveur de base de données.
b. Mettez le noyau Linux à niveau, au moins en version 2.4.9-e.27.

Pour installer Business Integration Connect :

  1. Connectez-vous en tant que root.

    Le programme d'installation du concentrateur exige le privilège root/Administrator pour l'intégration avec le registre de logiciels natifs.

  2. Dans le répertoire du concentrateur, lancez l'exécutable d'installation spécifique à votre plateforme, répertorié dans le Tableau 6.


    cd hub


    Tableau 6. Exécutables spécifiques à une plateforme pour le programme d'installation
    Plateforme Exécutable

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSolaris

    L'assistant démarre et affiche l'écran de bienvenue. Cliquez sur Suivant.

  3. Sur l'écran du contrat de licence du logiciel, lisez les termes du contrat. Si vous acceptez ces termes, sélectionnez le bouton d'acceptation des termes du contrat de licence. Cliquez sur Suivant.
  4. Sur l'écran Nom du répertoire, Figure 11, entrez le chemin d'accès et le nom du répertoire que l'assistant doit utiliser pour installer Business Integration Connect. Les noms de répertoire ne doivent contenir aucun espace imbriqué ni aucun caractère spécial. Cliquez sur Suivant.
    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone de saisie du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'entrez pas ".", l'écran de Sélection d'un répertoire n'affiche pas l'écran à partir duquel il a été lancé.

    Figure 11. Ecran Nom du répertoire


  5. Sur l'écran de sélection des composants, Figure 12, sélectionnez les composants que vous souhaitez installer sur le serveur. Vous pouvez sélectionner plusieurs composants. Cliquez sur Suivant.

    Figure 12. Ecran de sélection des composants


    La suite de la procédure part du principe que vous installez tous les composants sur le serveur. Si vous ne les installez pas tous, certains écrans décrits dans les étapes suivantes n'apparaîtront pas.

  6. Sur l'écran Sélection du serveur de base de données, Figure 13, sélectionnez le serveur de base de données que vous souhaitez utiliser. Vous pouvez sélectionner la version 8.1.2 (ou suivante) de DB2 ou la version 9i.9.2.0 (ou suivante) d'Oracle. Cliquez sur Suivant.

    Figure 13. Ecran de sélection du serveur de base de données


  7. L'écran Informations relatives à la base de données apparaît. Si vous avez sélectionné DB2 comme serveur de base de données, suivez les instructions spécifiques à DB2 dans cette procédure. Si vous avez sélectionné Oracle comme serveur de base de données, suivez les instructions spécifiques à Oracle dans cette procédure.

    DB2 :

    Si vous avez sélectionné DB2, l'écran Informations relatives à la base de données DB2 apparaît. Voir la Figure 14.

    Entrez le nom d'hôte de l'ordinateur exécutant DB2, s'il n'est pas installé sur le système courant, en remplaçant localhost par le nom du système contenant DB2.

    Dans la zone de saisie Port, entrez le port utilisé par l'instance DB2. Pour déterminer quel port est utilisé par l'instance DB2, utilisez le Centre de contrôle DB2 (interface graphique) afin de définir les propriétés ou entrez la commande de configuration DB2 suivante dans une invite de commande : db2 get dbm cfg. Cette information (configuration DB2) est également sauvegardée par Database Loader dans le répertoire system temp/WBIConnect/logs. Le numéro de port par défaut est 50000.

    Dans les zones de saisie Nom d'utilisateur, Mot de passe, Nom de la base de données et Nom d'instance, entrez respectivement le nom du propriétaire, son mot de passe, le nom de la base de données ainsi que le nom d'instance. Ces noms sont ceux utilisés pour définir la base de données lors de l'installation de Database Loader. Voir la "Création de la base de données".

    Cliquez sur Suivant.

    Figure 14. Ecran Informations relatives à la base de données DB2


    Oracle :

    Si vous avez sélectionné Oracle, l'écran Informations relatives à la base de données Oracle apparaît. Voir la Figure 15.

    Entrez les informations demandées sur la base de données Oracle. Le port par défaut est 1521.

    Le nom et le chemin d'accès complets du pilote JDBC doivent pointer vers la version correcte du pilote du poste utilisé. Le pilote est accessible à partir du répertoire d'installation d'Oracle 9i. Il peut être téléchargé à partir de http://otn.oracle.com/software/tech/java/sqlj_jdbc/index.html. Dans la section JDBC Driver Downloads, cliquez sur Oracle 9i Release 2 drivers. Veillez à sélectionner la version du pilote qui correspond à la version des services d'Oracle 9i (9.2.0) que vous utilisez.

    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone de saisie du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'entrez pas ".", l'écran de Sélection d'un répertoire n'affiche pas l'écran à partir duquel il a été lancé.

    Figure 15. Ecran Informations relatives à la base de données Oracle


    L'écran de confirmation de connexion à la base de données apparaît. Voir la Figure 16. Si la connexion est établie, notez et vérifiez les valeurs relatives aux tables, aux vues, aux fonctions et aux procédures. Si la connexion échoue, consultez l'écran d'informations pour obtenir de l'aide ou reportez-vous à la documentation de votre base de données pour corriger l'erreur. Voir la Figure 17.

    Figure 16. Ecran de confirmation de connexion à la base de données



    Figure 17. Ecran d'échec de connexion à la base de données

  8. Sur l'écran d'informations utilisateur, entrez le nom d'utilisateur, le mot de passe et le nom du groupe de l'administrateur responsable de l'installation.
    Remarque :
    Ces informations doivent correspondre aux informations utilisées lors de l'installation de Database Loader.
  9. Sur l'écran Répertoire des informations communes, entrez l'emplacement des informations communes utilisées par les composants. Cliquez sur Suivant.
    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone de saisie du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'entrez pas ".", l'écran de Sélection d'un répertoire n'affiche pas l'écran à partir duquel il a été lancé.
  10. Sur l'écran WebSphere MQ Server, Figure 18, entrez le nom d'hôte de l'ordinateur exécutant WebSphere MQ, s'il n'est pas installé sur ce poste. Assurez-vous de modifier le nom du gestionnaire de file d'attente si le nom par défaut n'a pas été utilisé. Voir la Figure 18.

    Figure 18. Ecran WebSphere MQ Server


    Dans la zone de saisie Nom d'hôte, si WebSphere MQ n'est pas sur le poste utilisé, remplacez localhost par le nom du système contenant WebSphere MQ.

    Dans la zone de saisie Gestionnaire de file d'attente, remplacez le nom par défaut par le nom utilisé lors de la configuration de WebSphere MQ (voir 2 dans "Configuration de WebSphere MQ").

    Dans la zone de saisie Port du programme d'écoute, entrez le port utilisé par le programme d'écoute (voir "Configuration de WebSphere MQ"). Le numéro de port par défaut est 9999.

    Cliquez sur Suivant.

  11. Si vous avez choisi d'installer la Console de communauté, configurez-la via l'écran de configuration de la console de communauté. Voir la Figure 19.

    Figure 19. Ecran de configuration de la console de communauté


    Dans la zone de saisie Nom d'utilisateur, entrez l'ID utilisateur utilisé par la Console de communauté pour se connecter à la base de données.

    Dans la zone de saisie Mot de passe, entrez le mot de passe associé au nom de l'utilisateur. Veillez à entrer le mot de passe correct, car la Console de communauté ne fonctionnera pas si le mot de passe est incorrect.

    Dans la zone de saisie Port HTTP, entrez le numéro de port sur lequel le composant écoute les messages. La Console de communauté, le Réceptionnaire et le Gestionnaire de documents doivent être associés à des numéros de ports uniques et doivent être disponibles sur ce poste de travail. Le port par défaut est 58080.

    Dans la zone de saisie Port HTTPS, entrez le numéro de port sécurisé sur lequel le composant écoute les messages. La Console de communauté, le Réceptionnaire et le Gestionnaire de documents doivent être associés à des numéros de ports uniques et doivent être disponibles sur ce poste de travail. Le numéro de port par défaut est 58443.

    Cliquez sur Suivant.

    Remarque :
    Si la connexion à la base de données échoue, l'écran d'informations relatives à la base de données apparaît. Vérifiez les informations de cet écran ou reportez-vous à la documentation de votre base de données pour corriger l'erreur.
  12. Si vous avez sélectionné le Réceptionnaire ou le Gestionnaire de documents, configurez-les sur leur écran de configuration. Ces écrans contiennent les mêmes zones de saisie que l'écran de configuration de la console de communauté. Les ports HTTP et HTTPS des trois composants (Console de communauté, Réceptionnaire et Gestionnaire de documents) doivent être différents. Voir la Figure 20 et Figure 21.
    Remarque :
    Si vous installez le Réceptionnaire et le Gestionnaire de documents sur différentes machines, le nom d'hôte de la machine du Réceptionnaire doit pouvoir être converti par la machine du Gestionnaire de documents.

    Figure 20. Ecran de configuration du réceptionnaire


    Figure 21. Ecran de configuration du Gestionnaire de documents


  13. Sur l'écran de configuration RosettaNet, Figure 22, indiquez la personne à contacter pour les messages RosettaNet. Si vous ne connaissez pas les valeurs exactes, utilisez les valeurs par défaut. Ces informations sont nécessaires si vous utilisez RosettaNet et recommandées pour toutes les installations.

    Figure 22. Ecran de configuration de RosettaNet


    Dans la zone de saisie Nom, entrez le nom de la personne à contacter en cas de problèmes relatifs à RosettaNet.

    Dans les zones Numéro de téléphone et Numéro de télécopie, entrez les numéros de téléphone et de télécopie du contact RosettaNet.

    Dans la zone Adresse électronique, entrez l'adresse e-mail du contact RosettaNet.

    Cliquez sur Suivant.

  14. Sur l'écran Notification d'alerte, Figure 23, configurez Business Integration Connect de façon à ce qu'il envoie des alertes par e-mail. Ces valeurs par défaut sont obligatoires. Utilisez-les si vous ne connaissez pas les valeurs correctes.

    Figure 23. Ecran Notification d'alerte


    Dans la zone de saisie Realis SMTP, entrez le nom d'hôte du serveur SMTP s'il ne tourne pas sur cet ordinateur.

    Dans la zone de saisie Adresse électronique de l'émetteur, entrez l'adresse e-mail utilisée par Business Integration Connect pour envoyer les courriers électroniques.

    Dans la zone de saisie Adresse électronique du destinataire, entrez l'adresse e-mail de destination utilisée par les utilisateurs qui répondent aux notifications d'alerte lorsqu'ils envoient un message de réponse.

    Cliquez sur Suivant.

  15. Sur l'écran Récapitulatif, vérifiez les informations relatives aux composants à installer. Si des données sont incorrectes, cliquez sur Précédent pour revenir aux écrans précédents. Lorsque toutes les informations de l'écran Récapitulatif sont correctes, cliquez sur Suivant.
  16. Le programme d'installation de Business Integration Connect installe et configure les composants sélectionnés. Une fois cette tâche terminée, le programme d'installation active le bouton Terminer. Cliquez sur Terminer.

Répétez cette procédure pour chacun des serveurs sur lesquels vous souhaitez installer des composants Business Integration Connect. Ce dernier doit être installé une seule fois car il est disponible sur tous les postes via le système de fichiers partagés.

Une fois tous les composants Business Integration Connect installés, voir "Démarrage de Business Integration Connect".

Copyright IBM Corp. 1997, 2004