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 :
- Connectez-vous en tant que DB2ADMIN si vous utilisez DB2 comme votre base de données.
- 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.
- 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.
-
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.
- 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.
- 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 :
- Nom de la base de données
- Nom de l'instance
- Nom du groupe
- Nom du propriétaire
- Mot de passe du propriétaire
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
- 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
- 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
- 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
- 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
- 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 :
- 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.
- 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.
- 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 :
- Il crée les espaces table
- Il crée le schéma
- Il crée les tables, les vues, les séquences, les procédures et
les fonctions puis les remplit de métadonnées
- Il affecte des droits sur les tables
- Il crée les procédures mémorisées.
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
- Confirmez l'emplacement d'installation de Database Loader. Cliquez sur Suivant.
- Cliquez sur le bouton Terminer lorsqu'il est activé.
- 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 :
- 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.
- 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.
- 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.
- 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.
- 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.
- Précisez le nom d'hôte complet de la machine qui sert à l'installation. Cliquez sur Suivant.
- Sélectionnez l'un des WebSphere Application Servers, qui sera utilisé pour
héberger WebSphere Partner Gateway, et cliquez sur Suivant. Voir figure 7.
- 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
- 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
- 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.
- 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
- 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
- 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é
- 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
- 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
- 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
- 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.
- 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.
- Vérifiez que les valeurs suivantes sont définies :
DB2 :
- Ouvrez le fichier console\lib\config\bcg_console.properties. Vérifiez que la valeur suivante est définie :
bcg.co.db.schema=DB2ADMIN.
- Ouvrez le fichier receiver\lib\config\bcg_receiver.properties. Vérifiez que la valeur suivante est définie :
bcg.co.db.schema=DB2ADMIN.
- Ouvrez le fichier router\lib\config\bcg.properties. Vérifiez que la valeur suivante est définie :
bcg.co.db.schema=DB2ADMIN.
Oracle :
- Ouvrez le fichier console\lib\config\bcg_console.properties. Vérifiez que la valeur suivante est définie :
bcg.co.db.schema=BCGAPPS.
- Ouvrez le fichier receiver\lib\config\bcg_receiver.properties. Vérifiez que la valeur suivante est définie :
bcg.co.db.schema=BCGAPPS.
- Ouvrez le fichier router\lib\config\bcg.properties. Vérifiez que la valeur suivante est définie :
bcg.co.db.schema=BCGAPPS.
- 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.
