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.

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 du système.

Emplacement du fichier exécutable du tableau de bord :

{CD_ROM/MEDIA DIR}/LaunchPad.*

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 de façon à ce que vous puissiez ensuite les utiliser pour créer et compléter manuellement les tables. L'exécution manuelle des fichiers SQL vous permet de contrôler 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.

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'interface graphique.

Remarque :
Si vous envisagez d'utiliser DB2 comme serveur de base de données, vous devez exécuter le SQL (manuellement ou automatiquement) en tant qu'utilisateur Windows DB2ADMIN.

Pour configurer les tables de base de données, procédez comme suit :

  1. Connectez-vous en tant que DB2ADMIN si vous utilisez DB2 comme votre base de données.
  2. Exécutez le fichier CD-MediaDir\DBLoader\setup.exe de Database Loader qui se trouve sur le CD du produit WebSphere Partner Gateway.

    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.

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

    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.

  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 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 :

    Remarque :
    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.

    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. Le fenêtre de l'emplacement d'origine d'Oracle s'affiche. Entrez-le ou cliquez sur Parcourir. Voir figure 19 .
    Remarque :
    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.

    Figure 19. Fenêtre de l'emplacement du répertoire d'origine d'Oracle
  7. Dans la fenêtre d'emplacement de la base de données, sélectionnez un emplacement du système de fichiers avec 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

    Entrez l'emplacement de la base de données ainsi que chacun de ses espaces table sur le serveur RDBMS. Les zones doivent contenir le chemin d'accès complet. Cliquez sur Suivant. Voir figure 2.

    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.

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

    Oracle

    Entrez l'emplacement de la base de données ainsi que chacun de ses espaces table sur le serveur RDBMS. Les zones doivent contenir le chemin d'accès complet. Cliquez sur Suivant. Voir figure 21.

    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.
    Figure 21. Fenêtre de l'emplacement de la base de données Oracle
  8. Dans la fenêtre de Configuration des composants, à la figure 22, entrez les informations de connexion des composants WebSphere Partner Gateway ainsi que l'emplacement des fichiers partagés communs.

    Dans les zones Nom d'utilisateur et Mot de passe pour la console de communauté, le gestionnaire de documents et le 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.

    Cliquez sur Suivant.

    Figure 22. Fenêtre de configuration des composants
  9. Le système affiche la fenêtre Point de montage des informations partagées. Entrez l'emplacement des fichiers partagés communs utilisés par les principaux composants de WebSphere Partner Gateway. Cliquez sur Suivant.
    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. La fenêtre suivante de l'assistant, figure 23, vous permet d'indiquer si Database Loader doit simplement créer les fichiers SQL ou bien les créer puis les exécuter.

    Si 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 23. 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 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.

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. 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 WebSphere Partner Gateway sur plusieurs machines, le dossier common partagé doit utiliser la même lettre d'unité 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 Vérification et configuration des prérequis d'installation 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.

La procédure suivante explique comment installer les composants à l'aide de l'interface graphique de l'assistant d'installation InstallShield.

Remarque :
Vous pouvez également installer les composants à partir de la ligne de commande. Pour plus d'informations, voir Installation des composants à partir de la ligne de commande.

Pour installer WebSphere Partner Gateway, procédez comme suit :

  1. Connectez-vous en tant qu'utilisateur disposant de droits d'administrateur.

    Les droits d'administrateur sont nécessaires pour permettre au programme d'installation du concentrateur de créer le service Windows correctement.

  2. Exécutez le fichier CD-MediaDir\hub\setup.exe qui se trouve sur le CD du produit WebSphere Partner Gateway.

    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 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 dans lequel WebSphere Partner Gateway est installé. IBM recommande de créer un nouveau répertoire ou d'en sélectionner un qui soit vide. 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 24, sélectionnez les composants que vous souhaitez installer sur le serveur. Vous pouvez sélectionner plusieurs composants. Cliquez sur Suivant.
    Figure 24. 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, et cliquez sur Suivant. Voir figure 7.
  8. Dans la fenêtre Sélection du serveur de base de données, figure 26, 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 26. 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é la base de données DB2, suivez les instructions spécifiques à DB2 dans cette procédure. Si vous avez sélectionné la base de données Oracle, 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. Voir figure 27.

    Dans la zone Nom d'hôte, si DB2 n'est pas sur le système utilisé, remplacez 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) pour connaître les propriétés ou entrez ce qui suit en ligne de commande : db2 get dbm cfg. Ces informations (configuration DB2) sont également sauvegardées par Database Loader dans le répertoire "system temp"/bcgdbloader/logs. Le port par défaut est 50000.

    Renseignez les zones Nom du propriétaire, Mot de passe du propriétaire, Nom de la base de données et Nom du schéma. Il s'agit des noms qui ont été 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 27. Fenêtre Informations sur DB2

    Oracle

    Si vous avez sélectionné Oracle, la fenêtre Informations relatives à la base de données apparaît, figure 28.

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

    Remarque :
    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 de l'arborescence des répertoires installée 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 Oraclexx Release x drivers. Veillez à sélectionner la version du pilote qui correspond à la version d'Oracle que vous exécutez.
    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.
    Figure 28. Fenêtre d'informations Oracle

    La fenêtre de confirmation de la connexion à la base de données s'affichera. Voir figure 29. 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 29. Fenêtre de confirmation de la connexion à la base de données
  10. Dans la fenêtre Répertoire des informations communes, entrez l'emplacement des composants communs partagés. Cette valeur doit correspondre à l'emplacement du répertoire utilisé lors de l'installation de Database Loader.
    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.
  11. Dans la fenêtre WebSphere MQ server, entrez les informations requises concernant votre serveur WebSphere MQ. Voir la figure 30.

    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 Configuration de WebSphere MQ.)

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

    Figure 30. Fenêtre WebSphere MQ server
  12. La fenêtre Installation du service Windows apparaît. Si vous souhaitez enregistrer les fonctionnalités de WebSphere Partner Gateway comme un service Windows, cochez la case Installer en tant que service Windows. Voir la figure 31.

    Cliquez sur Suivant.

    Figure 31. Fenêtre d'installation du service Windows
  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 32.

    Dans la zone Nom d'utilisateur, entrez l'ID utilisateur utilisé par la Console de communauté pour établir la connexion à 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, sinon la Console de communauté ne fonctionnera pas.

    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, 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 port par défaut est 58443.

    Dans la zone Nom d'hôte du système d'aide, entrez l'adresse du serveur sur lequel résidera le système d'aide.

    Dans la zone Numéro de port du système d'aide, entrez le numéro de port permettant d'accéder au système d'aide.

    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 32. Fenêtre 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 figure 33 et figure 34.
    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.

    Cliquez sur Suivant lorsque vous avez terminé.

    Figure 33. Fenêtre de configuration du réceptionnaire
    Figure 34. Fenêtre de configuration du gestionnaire de documents
  15. Dans la fenêtre de configuration RosettaNet, figure 35, indiquez la personne à contacter pour les messages RosettaNet. Ces zones doivent être renseignées. 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 télécopie, entrez les numéros de téléphone et de télécopie du contact RosettaNet.

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

    Cliquez sur Suivant.

    Figure 35. Fenêtre de configuration RosettaNet
  16. Dans la fenêtre de notification d'alerte, figure 36, 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 l'emplacement du serveur SMTP.

    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 36. 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 Terminer. Cliquez sur Terminer.
  19. Vérifiez que les valeurs suivantes sont définies :

    DB2 :

    1. Ouvrez le fichier console\lib\config\bcg_console.properties. Vérifiez que la valeur suivante est définie : bcg.co.db.schema=DB2ADMIN.
    2. Ouvrez le fichier receiver\lib\config\bcg_receiver.properties. Vérifiez que la valeur suivante est définie : bcg.co.db.schema=DB2ADMIN.
    3. Ouvrez le fichier router\lib\config\bcg.properties. Vérifiez que la valeur suivante est définie : bcg.co.db.schema=DB2ADMIN.

    Oracle :

    1. Ouvrez le fichier console\lib\config\bcg_console.properties. Vérifiez que la valeur suivante est définie : bcg.co.db.schema=BCGAPPS.
    2. Ouvrez le fichier receiver\lib\config\bcg_receiver.properties. Vérifiez que la valeur suivante est définie : bcg.co.db.schema=BCGAPPS.
    3. Ouvrez le fichier router\lib\config\bcg.properties. Vérifiez que la valeur suivante est définie : bcg.co.db.schema=BCGAPPS.
  20. 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, consultez Installation des composants à partir de la ligne de commande.

Copyright IBM Corp. 2003, 2005