Installation et configuration

Dans les sections qui suivent, WBI_folder désigne le dossier contenant votre installation WebSphere ICS. Les variables d'environnement et les séparateurs de fichier figurent tous au format Windows 2000 ou 2003. Apportez les modifications requises si vous travaillez sous AIX ou Solaris. (par exemple, WBI_folder\connectors serait WBI_folder/connectors).

Démarrage du serveur et de l'outil

  1. Démarrez WebSphere InterChange Server (ICS) à partir du raccourci.
  2. Démarrez WebSphere Business Integration System Manager et ouvrez Component Navigator Perspective.
  3. Enregistrez et connectez votre serveur en tant qu'instance serveur dans la vue Interchange Server.

Chargement du contenu exemple

A partir de Component Navigator Perspective :

  1. Créez une nouvelle bibliothèque Integration Component Library.
  2. Importez le fichier référentiel HTTPSample.jar situé dans : WBI_folder\connectors\HTTP\samples\WebSphereICS\

Compilation des modèles de collaboration

A l'aide de WebSphere Business Integration System Manager :

Configuration du connecteur

  1. Si ce n'est déjà fait, configurez le connecteur tel que le décrit ce guide et selon votre système.
  2. A l'aide de WebSphere Business Integration System Manager, ouvrez HTTPConnector dans Connector Configurator.
  3. Vous devez également configurer HTTPConnector pour le protocole à utiliser dans cet exemple :

Configuration du scénario de protocole HTTP

Cette section décrit la configuration du connecteur pour le scénario HTTP exemple. Comme indiqué dans ce document, le connecteur comprend un programme d'écoute HTTP et un gestionnaire de protocole HTTP-HTTPS.

Dans les étapes et descriptions qui suivent, les propriétés hiérarchiques de configuration du connecteur sont représentées par le symbole ->. Par exemple, A-> B signifie que A est une propriété hiérarchique, et B est propriété enfant de A.

Pour configurer le programme d'écoute HTTP pour cet exemple :

  1. Dans Connector Configurator, cliquez sur Connector-Specific Properties pour le connecteur HTTPConnector.
  2. Développez la propriété ProtocolListenerFramework pour afficher la propriété enfant ProtocolListeners.
  3. Développez la propriété enfant ProtocolListeners pour afficher la propriété enfant HTTPListener1.
  4. Vérifiez les propriétés HTTPListener1->Host et HTTPListener1->Port. Assurez-vous qu'aucun autre processus ne s'exécute sur l'hôte et n'écoute les communications sur ce port TCP/IP. Le cas échéant, vous pouvez définir la valeur de HTTPListener1->Host sur le nom de l'ordinateur qui exécutera le connecteur.

Il n'est pas nécessaire de configurer le gestionnaire de protocole HTTP-HTTPS pour l'exemple ; cependant, pour configurer la fonctionnalité SSL (des exemples sont fournis avec les composants dépendant de SSL), consultez Configuration du scénario de protocole HTTPS.

Configuration du scénario de protocole HTTPS

Cette section décrit la configuration du connecteur pour le scénario HTTPS exemple. Le connecteur inclut le programme d'écoute de protocole HTTPS et le gestionnaire de protocole HTTP-HTTPS.

Dans les étapes et descriptions qui suivent, les propriétés hiérarchiques de configuration du connecteur sont représentées par le symbole ->. Par exemple, A-> B signifie que A est une propriété hiérarchique, et B est propriété enfant de A.

Remarque :
Outre les éléments de pré-installation décrits dans Avant de commencer, vous devez également avoir créé et testé votre magasin de clés et votre truststore à l'aide du logiciel de gestion des clés et des certificats.
Configuration des propriétés spécifiques au connecteur SSL

Pour HTTPS, le connecteur nécessite que vous configuriez la propriété hiérarchique spécifique au connecteur SSL.

  1. Dans Connector Configurator, cliquez sur l'onglet Connector-Specific Properties pour le connecteur HTTPConnector.
  2. Développez la propriété hiérarchique SSL pour afficher toutes ses propriétés enfants. De plus, vérifiez ou modifiez les propriétés enfants de la propriété hiérarchique spécifique au connecteur SSL.

Remarque :
N'oubliez pas de sauvegarder les modifications dans Connector Configurator.
Configuration du programme d'écoute de protocole HTTPS

  1. Dans Connector Configurator, cliquez sur Connector-Specific Properties pour le connecteur HTTPConnector.
  2. Développez la propriété ProtocolListenerFramework pour afficher la propriété enfant ProtocolListeners.
  3. Développez la propriété enfant ProtocolListeners pour afficher la propriété enfant HTTPSListener1. Vérifiez la valeur des propriétés HTTPSListener1->Host et HTTPSListener1->Port. Assurez-vous qu'aucun autre processus ne s'exécute sur l'hôte et n'écoute les communications sur ce port TCP/IP. Le cas échéant, vous pouvez définir la valeur de HTTPSListener1->Host sur le nom de l'ordinateur qui exécute le connecteur.

Vous ne devez pas configurer le gestionnaire de protocole HTTP-HTTPS pour l'exemple.

Configuration de KeyStore et de TrustStore

Vous pouvez rapidement configurer KeyStore et TrustStore afin de les utiliser avec le scénario exemple. Pour les systèmes de production, utilisez un logiciel tiers de configuration et de gestion des magasins de clés et de génération de certificats et de clés. Adapter for HTTP ne comporte pas d'outil de configuration et de gestion de ces ressources.

Dans cette section, on suppose que la machine virtuelle Java (JVM) est installée sur votre système et que vous êtes familiarisé avec l'outil keytool fourni avec cette JVM. Pour plus d'informations sur l'outil keytool et sur les incidents liés, consultez la documentation de votre JVM.

Pour configurer KeyStore :

  1. Créez KeyStore à l'aide de keytool. Vous devez créer une paire de clés dans KeyStore. Pour cela, entrez ce qui suit sur la ligne de commande :
    keytool -genkey -alias httpadapter -keystore c:\security\keystore
  2. keytool vous demande alors un mot de passe. Indiquez le mot de passe que vous avez saisi pour la valeur de la propriété du connecteur SSL->KeyStorePassword.

    Notez que si vous avez saisi -keystore c:\security\keystore sur la ligne de commande dans l'exemple précédent, vous devez saisir c:\security\keystore comme valeur de la propriété SSL->KeyStore. De même, si vous avez entré -alias httpadapter sur la ligne de commande, vous devez entrer httpadapter comme valeur de la propriété SSL->KeyStoreAlias. keytool vous demande alors d'entrer des informations détaillées sur le certificat. Voici que vous pourriez entrer à chaque invite (pour toute information, consultez la documentation de keytool).
    What is your first and last name?
          [Unknown]:  HostName
     What is the name of your organizational unit?
          [Unknown]:  myunit
     What is the name of your organization?
          [Unknown]:  myorganization
     What is the name of your City or Locality?
          [Unknown]:  mycity
     What is the name of your State or Province?
          [Unknown]:  mystate
     What is the two-letter country code for this unit?
          [Unknown]:  mycountryIs <CN=HostName, OU=myunit, O=myorganization, 
          L=mycity, ST=mystate, C=mycountry> correct?
          [no]:  yes
  3. Notez que pour What is your first and last name?, vous devez entrer le nom de l'ordinateur sur lequel vous exécutez le connecteur. keytool affiche alors une invite :
    Entrez le mot de passe de la clé de <httpadapter> (appuyez sur RETOUR si le mot 
     de passe est identique à celui du magasin de clés) :
  4. Appuyez sur Retour pour utiliser le même mot de passe. Si vous souhaitez utiliser un certificat auto-signé, vous pouvez exporter le certificat créé précédemment. Pour cela, entrez ce qui suit sur la ligne de commande :
    C:\security>keytool -export -alias httpadapter -keystore c:\security\keystore 
     -file c:\security\httpadapter.cer
  5. keytool vous demande alors le mot de passe du magasin de clés. Entrez le mot de passe saisi précédemment.

Pour configurer TrustStore :

  1. Pour importer les certificats approuvés dans TrustStore, entrez la commande suivante :
    keytool -import -alias trusted1 -keystore c:\security\truststore 
     -file c:\security\httpadapter.cer
  2. keytool vous demande alors le mot de passe du magasin de clés. Si vous avez saisi -keystore c:\security\truststore, vérifiez que la propriété SSL->TrustStore est réglée sur c:\security\truststore. Réglez également la propriété SSL->TrustStorePassword sur le mot de passe que vous avez saisi précédemment.

Création d'un projet utilisateur

Ajout et déploiement du projet

  1. Dans la vue Instance de serveur, ajoutez à WebSphere ICS le Projet utilisateur créé dans Création d'un projet utilisateur.
  2. Déployez tous les composants de ce projet utilisateur vers le serveur ICS.

Redémarrage d'ICS

  1. Redémarrez ICS pour que toutes les modifications prennent effet.
  2. A l'aide de l'outil Moniteur système, assurez-vous que tous les objets de collaboration, contrôleurs de connecteur et mappes sont opérationnels.

Copyright IBM Corp. 2003, 2005