Installation de WebSphere Partner Gateway

Lorsque tous les prérequis mentionnés dans les sections précédentes sont satisfaits, vous êtes prêt à exécuter les assistants d'installation Database Loader et WebSphere Partner Gateway. Ces assistants peuvent être exécutés directement ou via le LaunchPad. Pour plus d'informations, voir Tableau de bord.

Remarque :
Le fichier tar de l'image électronique du produit AIX ne peut être désarchivé correctement à l'aide du programme tar disponible par défaut sur AIX, car certains chemins de l'image dépassent les 100 caractères. IBM diffuse un programme tar qui parviendra à désarchiver le fichier tar de l'image d'AIX. Ce programme est disponible dans AIX Toolbox for Linux Applications à l'adresse suivante :
http://www-1.ibm.com/servers/aix/products/aixos/linux/download.html

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

WebSphere Partner Gateway contient un tableau de bord qui permet d'accéder à la Présentation du produit, au fichier Readme, à la documentation du produit, à Database Loader et au programme d'installation de WebSphere Partner Gateway. Vous pouvez également lancer Database Loader et le programme 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 système.

Emplacement du fichier exécutable du tableau de bord :

{CD_ROM/MEDIA DIR}/LaunchPad.sh

Création de la base de données

WebSphere Partner Gateway dispose d'un assistant d'installation pour 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 vous permet 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.

DBLoader peut être exécuté sur une machine qui n'a pas la base de données réelle. Oracle/DB2 doit être installé sur cette machine, mais la base de données réelle peut figurer sur un autre poste. Pour cela, le DBA doit procéder à quelques modifications, non décrites dans le présent manuel. Créez d'abord la base de données sur une machine éloignée. Configurez ensuite une base de données éloignée avec oracle/db2 sur la machine sur laquelle dbloader sera installé, en indiquant la machine sur laquelle il est exécuté, le port tilisé, etc. Une fois cette configuration terminée, DBLoader peut être exécuté comme si la base de données était en local. Oracle/DB2 se chargera automatiquement du reste. Toutes les commandes sql exécutées en rapport à cette base de données seront dirigées vers la bonne machine pour être traitées. Les commandes SQL peuvent être exécutées automatiquement.

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.

Remarque :
Consultez la documentation DB2 pour connaître les besoins spécifiques du système d'exploitation, tels que paramètres de configuration ou versions de produit exigées.

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

  1. Connectez-vous en tant qu'utilisateur root.

    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.

  2. A partir du répertoire Database Loader, lancez l'exécutable de configuration indiqué au tableau 9 et concernant votre plateforme :

    cd DBLoader

    Tableau 9. 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 d'accueil. Cliquez sur Suivant.

  3. Dans la fenêtre 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.
  4. Dans la fenêtre 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. IBM recommande de créer un nouveau répertoire ou d'en sélectionner un qui soit vide. Les noms de répertoires ne doivent contenir aucun espace ni caractère spécial.

    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 du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'insérez pas ".", la fenêtre Sélection d'un répertoire n'affiche pas la fenêtre à partir de laquelle elle a été lancée.
  5. Dans la fenêtre de sélection du type de base de données, sélectionnez le serveur de base de données que vous souhaitez utiliser pour WebSphere Partner Gateway. Vous pouvez sélectionner DB2 8.2 ou Oracle 9i 9.2.0.4 ou supérieur. Cliquez sur Suivant.
  6. Dans la fenêtre des informations relatives à la base de données, entrez les informations suivantes, puis cliquez sur Suivant lorsque vous avez terminé.

    DB2 :

    Si vous avez sélectionné DB2, la fenêtre Informations relatives à la base de données apparaît. Entrez les informations sur les bases de données DB2 suivantes :

    Oracle:

    1. Si vous avez sélectionné Oracle, la fenêtre Informations relatives à la base de données apparaît. Entrez les informations sur les bases de données Oracle suivantes :
      • ID de connexion de l'administrateur
      • Mot de passe de l'administrateur
      • Numéro de session Oracle
      • ID de connexion du propriétaire du schéma
      • Mot de passe du propriétaire du schéma
    2. La fenêtre de l'emplacement d'origine d'Oracle s'affiche. Entrez-le ou cliquez sur Parcourir. Voir la figure 2.

      Figure 2. Fenêtre de l'emplacement du répertoire d'origine d'Oracle
  7. Dans la fenêtre de l'emplacement de la base de données, figure 3 pour DB2 et figure 4 pour Oracle, indiquez le chemin complet de l'emplacement de la base de données et de chacun de ses espaces table sur le serveur de bases de données. Le chemin pour DB2 sera du type suivant : DB2Home/IBM/bcgdbloader/tables.
    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'insérez pas ".", la fenêtre Sélection d'un répertoire n'affiche pas la fenêtre à partir de laquelle elle a été lancée.
    Si l'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 WebSphere Partner Gateway.

    DB2

    Figure 3. Fenêtre de l'emplacement de la base de données DB2

    Oracle

    Figure 4. Fenêtre de l'emplacement de la base de données Oracle
  8. Dans la fenêtre de configuration des composants, figure 5, entrez les informations de connexion des composants WebSphere Partner Gateway ainsi que l'emplacement des fichiers partagés communs. Cliquez sur Suivant lorsque vous avez terminé.

    Dans les zones Nom d'utilisateur et Mot de passe de la console de communauté, du gestionnaire de documents et du réceptionnaire, indiquez le nom et le mot de passe de l'utilisateur pour chacun des composants. Si vous utilisez DB2, ces utilisateurs ont été créés au moment de la configuration du serveur.

    Dans la zone Nom du groupe, entrez le nom du groupe contenant les utilisateurs WebSphere Partner Gateway.

    Figure 5. Fenêtre de configuration des composants
  9. A partir du point de montage de la fenêtre des informations partagées, indiquez l'emplacement des fichiers partagés communs utilisés par les principaux composants de WebSphere Partner Gateway.
    Remarques :
    1. Si vous installez WebSphere Partner Gateway sur plusieurs machines, le dossier commun partagé doit utiliser le même point de montage et la même structure de répertoires sur toutes les machines.
    2. Lorsque vous recherchez un répertoire, entrez "." dans la zone du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'insérez pas "." la fenêtre Sélection d'un répertoire n'affiche pas la fenêtre à partir de laquelle elle a été lancée.
  10. L'assistant affiche une fenêtre sur laquelle vous pouvez indiquer si vous souhaitez que Database Loader crée simplement les fichiers SQL ou qu'il les crée puis les exécute. Voir la figure 6.

    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. Par conséquent, il vous faut déconnecter toutes les applications qui utilisent l'instance DB2 lorsque vous effectuez la configuration de la base de données de WebSphere Partner Gateway.

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

    Figure 6. Fenêtre Exécuter les fichiers SQL
  11. Confirmez l'emplacement d'installation de Database Loader. Cliquez sur Suivant.
  12. Cliquez sur le bouton Terminer lorsqu'il est activé.
  13. Si vous exécutez les fichiers SQL manuellement, reportez-vous au fichier Instructions.txt qui se trouve dans le sous-répertoire bcgdbloader/scripts (installé par l'assistant d'installation Database Loader) pour plus d'informations.

    Une fois la base de données de WebSphere Partner Gateway configurée, vous pouvez procéder à l'installation des composants de WebSphere Partner Gateway.

    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

WebSphere Partner Gateway comporte trois composants principaux : 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 la planification du placement des divers composants sur différents serveurs, voir Planification de l'environnement et Topologies.

Remarque :
Si vous installez WebSphere Partner Gateway sur plusieurs machines, le dossier common partagé doit utiliser le même point de montage et la même structure de répertoires 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 WebSphere Partner Gateway dans Plateforme, configuration matérielle et logicielle requise pour obtenir la configuration requise en terme de logiciel, et Installation - Généralités pour obtenir des informations sur la configuration de ces logiciels. La base de données de WebSphere Partner Gateway 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.

Pour installer WebSphere Partner Gateway :

  1. Connectez-vous en tant qu'administrateur 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é au tableau 10.
    Tableau 10. 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 la fenêtre d'accueil. Cliquez sur Suivant.

  3. Dans la fenêtre 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. Dans le fenêtre Nom du répertoire, entrez le chemin d'accès et le nom du répertoire que l'assistant doit utiliser lorsqu'il installe WebSphere Partner Gateway. IBM recommande de créer un nouveau répertoire ou d'en sélectionner un qui soit vide. Les noms de répertoire ne doivent contenir aucun espace ni caractère spécial. Cliquez sur Suivant.
    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'insérez pas ".", la fenêtre Sélection d'un répertoire n'affiche pas la fenêtre à partir de laquelle elle a été lancée.
  5. Dans le fenêtre de sélection des composants, figure 7, sélectionnez les composants que vous souhaitez installer sur le serveur. Vous pouvez sélectionner plusieurs composants. Cliquez sur Suivant.
    Figure 7. Fenêtre de sélection des composants

    La suite de la procédure suppose que vous installez tous les composants. Si vous ne les installez pas tous, certaines des fenêtres décrites dans les étapes suivantes n'apparaîtront pas.

  6. Précisez le nom d'hôte complet de la machine qui sert à l'installation. Cliquez sur Suivant.
  7. Sélectionnez l'un des WebSphere Application Servers, qui sera utilisé pour héberger WebSphere Partner Gateway. Voir la figure 8. Cliquez sur Suivant :
  8. Dans la fenêtre Sélection du serveur de base de données, figure 9, sélectionnez le serveur de base de données que vous prévoyez d'utiliser. Vous pouvez sélectionner DB2 8.2 ou supérieur ou Oracle 9i 9.2.0.4 ou supérieur. Cliquez sur Suivant.
    Figure 9. Fenêtre de sélection de la base de données
  9. La fenêtre 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, la fenêtre Informations relatives à la base de données apparaît. figure 10.

    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 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 utilisateur graphique) afin de déterminer les propriétés, ou entrez la commande de configuration DB2 suivante dans une invite de commande : db2 get dbm cfg. Ces informations de configuration DB2 sont également sauvegardées par Database Loader dans le répertoire système temp/bcgdbloader/logs. Le numéro de port par défaut est 50000.

    Dans les zones Nom du propriétaire, Mot de passe du propriétaire, Nom de la base de données, et Nom du schéma, indiquez le nom et le mot de passe du propriétaire, le nom de la base de données et le nom de l'instance. Ces noms sont ceux utilisés pour définir la base de données lors de l'installation de Database Loader. Voir Création de la base de données.

    Cliquez sur Suivant.

    Figure 10. Fenêtre Informations sur DB2

    Oracle :

    Si vous avez sélectionné Oracle, la fenêtre des informations sur la base de données s'affiche, voir la figure 11.

    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.

    Il peut également être téléchargé à partir de l'adresse http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html. Dans la section JDBC Driver Downloads, cliquez sur Oracle xx Release x drivers. Veillez à sélectionner la version du pilote qui correspond à la version xx d'Oracle que vous utilisez.

    Remarque :
    Lorsque vous recherchez un répertoire, entrez "." dans la zone du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'insérez pas ".", la fenêtre Sélection d'un répertoire n'affiche pas la fenêtre à partir de laquelle elle a été lancée.

    Cliquez sur Suivant.

    Figure 11. Fenêtre d'informations sur la base de données Oracle

    La fenêtre de confirmation de la connexion à la base de données s'affiche. Voir figure 12. 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 la fenêtre d'informations pour obtenir de l'aide, ou reportez-vous à la documentation de votre base de données pour corriger l'erreur.

    Figure 12. Fenêtre de confirmation de la connexion à la base de données
  10. Dans la fenêtre d'informations utilisateur, entrez le nom d'utilisateur, le mot de passe et le nom du groupe de l'administrateur responsable de l'installation. Cliquez sur Suivant.
    Remarque :
    Ces informations doivent correspondre aux informations utilisées lors de l'installation de Database Loader.
  11. Dans la fenêtre 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 du nom du fichier après avoir sélectionné le chemin d'installation souhaité. Si vous n'insérez pas ".", la fenêtre Sélection d'un répertoire n'affiche pas la fenêtre à partir de laquelle elle a été lancée.
  12. Dans le fenêtre WebSphere MQ Server, figure 13, 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é.

    Dans la zone 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 gestionnaire de file d'attente, remplacez le nom par défaut par le nom utilisé lors de la configuration de WebSphere MQ (voir l'étape 2 dans Configuration de WebSphere MQ).

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

    Cliquez sur Suivant.

    Figure 13. Fenêtre WebSphere MQ Server
  13. Si vous avez choisi d'installer le composant Console de communauté, configurez-le à l'aide de la fenêtre de configuration de la console de communauté. Voir la figure 14.

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

    Dans la zone 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 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 Port HTTPS, indiquez le nom du 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 port par défaut est 58443.

    Cliquez sur Suivant.

    Remarque :
    Si la connexion à la base de données échoue, la fenêtre d'informations relatives à la base de données apparaît. Vérifiez les informations de cette fenêtre ou reportez-vous à la documentation de votre base de données pour corriger l'erreur.
    Figure 14. Fenêtre de configuration de la console de communauté
  14. Si vous avez sélectionné le Réceptionnaire ou le Gestionnaire de documents, configurez-les dans leur fenêtre de configuration. Ces fenêtres contiennent les mêmes zones que la fenêtre 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 les figures figure 15 et figure 16 à la page figure 15.
    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 15. Fenêtre de configuration du réceptionnaire
    Figure 16. Fenêtre de configuration du gestionnaire de documents
  15. Dans la fenêtre de configuration RosettaNet, figure 17, 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.

    Dans la zone 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 fax, entrez les numéros de téléphone et de fax du contact RosettaNet.

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

    Cliquez sur Suivant.

    Figure 17. Fenêtre de configuration RosettaNet
  16. Dans la fenêtre de notification d'alerte, figure 18, configurez WebSphere Partner Gateway de façon à ce qu'il envoie des alertes par e-mail. Ces valeurs sont obligatoires. Si vous ne connaissez pas les valeurs exactes, utilisez les valeurs par défaut.

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

    Dans la zone Adresse électronique de l'émetteur, entrez l'adresse e-mail utilisée par WebSphere Partner Gateway pour envoyer des courriers électroniques.

    Dans la zone 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.

    Figure 18. Fenêtre de notification d'alerte
  17. Dans la fenêtre 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 la fenêtre Récapitulatif sont correctes, cliquez sur Suivant.
  18. Le programme d'installation de WebSphere Partner Gateway installe et configure les composants sélectionnés. Une fois cette tâche terminée, le programme d'installation active le bouton Terminé. Cliquez sur Terminer.

Répétez cette procédure pour chacun des serveurs sur lesquels vous souhaitez installer des composants WebSphere Partner Gateway. 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 WebSphere Partner Gateway installés, voir Démarrage de WebSphere Partner Gateway.

Copyright IBM Corp. 2003, 2005