Configuration et exécution de l'exemple BeenThere


Mise en route
Ajout de noeuds de serveur d'applications
Création du cluster de conteneur Web
Création du cluster de conteneur d'EJB
Mise à jour de l'hôte virtuel
Activation du service de configuration de WebSphere
Installation du fichier BeenThere.ear
Configuration de la sécurité (facultatif)
Démarrage des serveurs
Exécution de l'exemple
Vérification de la configuration de l'exemple


Mise en route

Cette section décrit les étapes de configuration de l'environnement, comme indiqué Figure 1, ainsi que l'installation et l'exécution de l'exemple BeenThere. Il est admis que les logiciels suivants sont déjà installés :


Nom de la machine Logiciel installé
web IBM HTTP Server
Plug-in IBM HTTP Server
app1 IBM WebSphere Application Server
app2 IBM WebSphere Application Server
dm Gestionnaire de déploiement d'IBM WebSphere Application Server


Remarque : Les instructions suivantes partent du principe que le serveur Web et le service d'administration correspondant sont actifs et qu'une définition de serveur Web a été créée dans le gestionnaire de déploiement afin que le fichier plugin-cfg.xml soit propagé automatiquement.



Ajout de noeuds de serveur d'applications

Suivez la procédure ci-dessous pour ajouter les noeuds de serveur d'applications dans la cellule.


  1. Démarrez le gestionnaire de déploiement.
  2. Sur la ligne de commande d'une des machines sur lesquelles un serveur d'applications est installé, entrez la commande suivante (racine_installation/bin doit être indiqué dans la variable d'environnement PATH, racine_installation correspondant à la racine de l'installation du serveur WebSphere Application Server de base) :

    Sur les plateformes Windows :
    addNode <hôte gestionnaire_déploiement>

    Sous UNIX et Linux :
    addNode.sh <hôte gestionnaire_déploiement>

    Sur les plateformes iSeries :
    racine_installation/bin/addNode <hôte gestionnaire_déploiement>
    <port gestionnaire_déploiement> -profileName
    <nomProfil> -startingport <blocport>

    où :
    <hôte gestionnaire_déploiement> est le nom de l'hôte sur lequel le gestionnaire de déploiement est exécuté.
    <port gestionnaire_déploiement> correspond au port du connecteur SOAP du gestionnaire de déploiement.
    <nomProfil> correspond au nom de profil du serveur d'applications à ajouter au gestionnaire de déploiement.
    <blocport> correspond à un bloc de ports inutilisés. Utilisé pour éviter les conflits entre ports dans un environnement à plusieurs instances.

  3. Répétez cette procédure sur la machine où la seconde instance de WebSphere Application Server est installée.

Les serveurs d'applications sont maintenant incorporés dans la cellule.



Création du cluster de conteneur Web

Le cluster MyWebCluster fournit des fonctionnalités d'équilibrage de charge et de reprise pour les servlets.

Suivez la procédure ci-dessous pour créer le cluster MyWebCluster.


  1. Ouvrez la console d'administration à l'adresse http://<nom_hôte>:9060/ibm/console à partir d'un navigateur Web, où <nom_hôte> est le nom d'hôte ou l'adresse IP où le gestionnaire de déploiement est exécuté.
  2. Dans la console d'administration, cliquez sur Serveurs > Clusters.
  3. Cliquez sur Nouveau.
  4. Entrez MyWebCluster dans la zone Nom du cluster.
  5. Cliquez sur Suivant.
  6. Entrez les valeurs suivantes :
  7. Cliquez sur Suivant.
  8. Entrez les valeurs suivantes :
  9. Cliquez sur Valider.
  10. Cliquez sur Suivant.
  11. Cliquez sur Fin.
  12. Cliquez sur Sauvegarder, en haut du panneau principal de la console d'administration.
  13. Sélectionnez la case à cocher Synchroniser les modifications avec les noeuds.
  14. Cliquez sur Sauvegarder.

Le cluster MyWebCluster est créé.



Création du cluster de conteneur d'EJB

Le cluster MyEJBCluster fournit des fonctionnalités d'équilibrage de charge et de reprise pour les beans enterprise.

Suivez la procédure ci-dessous pour créer le cluster MyEJBCluster.


  1. Cliquez sur Serveurs > Clusters.
  2. Cliquez sur Nouveau.
  3. Entrez MyEJBCluster dans la zone Nom du cluster.
  4. Désélectionnez la case à cocher Environnement local favori activé.

    Note :Sur une plateforme distribuée, la sélection de l'option Environnement local préféré indique que la requête est acheminée vers un bean enterprise exécuté sur le noeud local, si ce dernier est disponible. L'option Environnement local préféré est désactivée dans la configuration de l'exemple pour illustrer la gestion de la charge de travail des requêtes EJB.

  5. Cliquez sur Suivant.
  6. Entrez les valeurs suivantes :
  7. Cliquez sur Suivant.
  8. Entrez les valeurs suivantes :
  9. Cliquez sur Valider.
  10. Cliquez sur Suivant.
  11. Cliquez sur Fin.
  12. Cliquez sur Sauvegarder, en haut du panneau principal de la console d'administration.
  13. Cliquez sur Sauvegarder.

Le cluster MyEJBCluster est créé.



Mise à jour de l'hôte virtuel

Au cours de la création du cluster MyWebCluster, l'option Générer des ports HTTP uniques est sélectionnée pour chaque nouveau membre du cluster. La sélection de cette option évite les conflits entre les ports HTTP en créant une valeur de port unique pour chaque serveur d'applications créé.

Suivez la procédure ci-après pour vous assurer que chaque valeur de port HTTP créée dynamiquement ait une entrée d'alias hôte associée configurée pour l'hôte virtuel hôte_par_défaut :


  1. Dans la console d'administration, cliquez sur Serveurs > Serveurs d'applications > WebServer1 > Paramètres du conteneur Web > Chaînes de transport de conteneur Web > WCInboundDefault.
  2. Notez l'hôte et les valeurs de port pour l'entrée dans laquelle SSL est désactivée.
  3. Cliquez sur Environnement > Hôtes virtuels > hôte_par_défaut > Alias d'hôte.
  4. Vérifiez que la liste Alias d'hôte contient le nom d'hôte et les valeurs de port définis à l'étape 2. Pour les valeurs non répertoriées, suivez la procédure ci-dessous.
    1. Cliquez sur Nouveau.
    2. Entrez le nom d'hôte et le port en utilisant les valeurs que vous avez notées précédemment.
    3. Cliquez sur Valider.
    4. Cliquez sur Sauvegarder, en haut du panneau principal de la console d'administration.
    5. Cliquez sur Sauvegarder.
  5. Répétez cette procédure pour WebServer2.

L'hôte virtuel est mis à jour.



Activation du service de configuration de WebSphere

Le service de configuration de WebSphere n'est pas activé pour les serveurs d'applications par défaut. Pour le présent exemple, ce service doit lire par programme les fichiers de configuration de WebSphere Application Server afin d'obtenir des informations relatives à l'environnement.

Suivez la procédure ci-dessous pour activer le service de configuration de WebSphere :


  1. Cliquez sur Serveurs > Serveurs d'applications > WebServer1 > Infrastructure du serveur > Administration > Services d'administration > Propriétés personnalisées.
  2. Cliquez sur Nouveau.
  3. Entrez les valeurs suivantes :
  4. Cliquez sur Valider.
  5. Cliquez sur Sauvegarder, en haut du panneau principal de la console d'administration.
  6. Cliquez sur Sauvegarder.
  7. Répétez cette procédure pour WebServer2.

Le service de configuration de WebSphere est activé.



Installation du fichier BeenThere.ear

Suivez la procédure ci-dessous pour installer le fichier BeenThere.ear.


  1. Dans la console d'administration, cliquez sur Applications > Installation d'une nouvelle application.
  2. Sélectionnez Système de fichiers éloigné, puis cliquez sur Parcourir.
  3. Sélectionnez le noeud du gestionnaire de déploiement.
  4. Sélectionnez le fichier <racine_installation>/samples/lib/BeenThere/BeenThere.ear, où <racine_installation> représente le répertoire d'installation du gestionnaire de déploiement.
  5. Cliquez sur OK.
  6. Cliquez sur Suivant.
  7. Vérifiez que l'hôte virtuel a pour valeur Nom d'hôte virtuel par défaut pour les modules Web et hôte_par_défaut.
  8. Cliquez sur Suivant.
  9. Cliquez sur Continuer.
  10. Sélectionnez l'étape Mapper les modules vers les serveurs.
  11. Sélectionnez le cluster MyWebCluster et le serveur Web dans la liste Clusters et serveurs.
  12. Sélectionnez le module BeenThere WAR.
  13. Cliquez sur Valider.
  14. Sélectionnez le cluster MyEJBCluster et le serveur Web dans la liste Clusters et serveurs.
  15. Sélectionnez le module BeenThere EJB.
  16. Cliquez sur Valider.
  17. Cliquez sur Etape 8 (Récapitulatif).
  18. Cliquez sur Fin.
  19. Cliquez sur Sauvegarde dans la configuration maîtresse.
  20. Cliquez sur Sauvegarder.


Configuration de la sécurité (facultatif)

Si vous ne souhaitez pas utiliser l'exemple BeenThere avec la sécurité, vous pouvez ignorer cette section. Pour utiliser l'exemple BeenThere avec la sécurité, cliquez sur ici afin d'obtenir des instructions sur la configuration de la sécurité.



Démarrage des serveurs

Suivez la procédure ci-dessous pour démarrer les serveurs :


  1. Cliquez sur Serveurs > Clusters.
  2. Sélectionnez les clusters MyWebCluster et MyEJBCluster.
  3. Cliquez sur Démarrer.

Les serveurs ont démarré.



Exécution de l'exemple

Pour exécuter l'exemple, connectez-vous à la page BeenThere à l'adresse http://<nom_hôte>/wlm/BeenThere dans un navigateur Web, où <nom_hôte> est le nom d'hôte ou l'adresse IP où IBM HTTP Server est exécuté.





Vérification de la configuration de l'exemple

Nota : A partir de la version 6 de WebSphere, une nouvelle fonction a fait son apparition qui est conçue pour maximiser le rendement de l'environnement dans son ensemble. En d'autres termes, lorsqu'on teste l'exemple BeenThere dans ces versions, le composant de pondération de la charge de travail ne route pas nécessairement les demandes vers les valeurs exactes de pondération. Ces valeurs risquent de changer lors de l'exécution, ce qui risque de rendre erronées les méthodes de vérification exposées ci-dessous. Dans ces scénarios, la meilleure méthode pour vérifier la gestion de la charge de travail est de s'assurer que les demandes sont acheminées vers la totalité des membres du cluster, sans se préoccuper de savoir si ce routage s'effectue ou non dans le strict respect des valeurs de pondération. Il existe également des méthodes permettant de désactiver ces mécanismes de feedback ; contactez le support IBM pour en savoir plus à ce sujet si nécessaire.


Procédez comme indiqué ci-dessous pour vérifier que la gestion de la charge de travail de conteneur Web fonctionne comme prévu dans sa configuration :


  1. Connectez-vous à la page BeenThere à l'adresse http://<nom_hôte>/wlm/BeenThere dans un navigateur Web, où <nom_hôte> est le nom d'hôte ou l'adresse IP où IBM HTTP Server est exécuté.

  2. Notez les valeurs dans le récapitulatif d'exécution du servlet. Voici un exemple de ce récapitulatif :

  3. Rechargez la page BeenThere dans le navigateur.

    Les valeurs indiquées dans le récapitulatif d'exécution du servlet changent, comme indiqué dans l'exemple suivant :


    Le noeud du servlet est app2 au lieu de app1. Les résultats indiquent qu'IBM HTTP Server a transmis la demande HTTP à l'autre membre du cluster MyWebCluster, c'est-à-dire WebServer2 sur app2. Les exécutions répétées du servlet révèlent un comportement de gestion de la charge de travail des demandes HTTP fondé sur les valeurs de pondération des membres du cluster MyWebCluster.

La configuration de la fonctionnalité de gestion de la charge de travail de conteneur Web a été vérifiée.


Suivez la procédure ci-dessous pour vérifier que la gestion de la charge de travail de conteneur d'EJB fonctionne comme indiqué dans sa configuration :


  1. Sélectionnez l'option Display servlet and bean run summaries pour exécuter le servlet BeenThere.
  2. Entrez 7 dans la zone Bean invocations.
  3. Cliquez sur Exécuter.

    Sur une plateforme distribuée, les valeurs indiquées dans le récapitulatif d'exécution du bean doivent être similaires à celles présentées dans l'exemple suivant :


    Dans cet exemple, vous pouvez observer le comportement d'exécution de la gestion de la charge de travail du bean enterprise fondé sur les valeurs de pondération configurées pour les membres du cluster MyEJBCluster. Trois appels du bean enterprise exécutés sur app2 pour chaque exécution sur app1.

    Sur la plateforme z/OS, les valeurs de pondération sont utilisées pour équilibrer les demandes HTTP, mais ne sont pas utilisées pour équilibre les requêtes IIOP (Internet Inter-ORB Protocol).

La configuration de la fonctionnalité de gestion de la charge de travail de conteneur d'EJB a été vérifiée.


Suivez la procédure ci-dessous pour vérifier que les valeurs de pondération des membres du cluster de bean sont définies correctement, comme indiqué dans la configuration.


  1. Sélectionnez l'option Display bean cluster member weights pour exécuter le servlet BeenThere.
  2. Cliquez sur Exécuter.

    Comparez les résultats à l'exemple suivant :


    Les résultats indiquent les valeurs de pondération pour tous les membres du cluster MyEJBCluster. EJBServer1 a une pondération de 1 et EJBServer2 a une pondération de 3.

Les valeurs de pondération des membres du cluster de bean ont été vérifiées.


Félicitations, vous avez pu découvrir le fonctionnement de la gestion de la charge de travail et vérifier que l'exemple BeenThere a fonctionné comme indiqué dans sa configuration !