Configuration de WebSphere Application Server de sorte qu'il puisse être utilisé avec Rational Quality Manager

Suivez les instructions ci-après pour configurer IBM WebSphere Application Server afin de pouvoir l'utiliser avec IBM Rational Quality Manager.

Planification de la configuration

Remarque : IBM Rational Team Concert fournit des informations supplémentaires sur la configuration de WebSphere Application Server. Pour visualiser ces informations, voir Setting up a WebSphere Application Server.

Mise à jour de WebSphere Application Server

  1. Si WebSphere Application Server (WAS) n'est pas installé, installez-le maintenant. Reportez-vous au guide d'installation de WebSphere Application Server pour des instructions détaillées.
  2. Installez le groupe de correctifs WASSDK FP13 ou WASSDK FP15 de WebSphere Application Server. Pour que Jazz soit pris en charge dans WebSphere Application Server 6.1, vous devez appliquer à ce dernier Java SDK 1.5 SR6 Cumulative Fix for WebSphere Application Server (ou des groupes de correctifs ultérieurs). Pour installer le groupe de correctifs, vous devez au préalable installer le programme d'installation des mises à jour ("Update Installer"). Vous devez appliquer WASSDK FP13 (qui correspond à IBM JDK SR6) au moins. C'est à ce groupe de correctifs que renvoient les instructions d'installation de Jazz WebSphere.
    Remarque : Veillez à installer le groupe de correctifs SDK et non le groupe de correctifs standard.

Configuration de WebSphere Application Server

Pour configurer WebSphere Application Server :

  1. S'il n'est pas déjà actif, démarrez le service WebSphere Application Server.
  2. Recherchez la console d'administration de WebSphere Application Server.
  3. Authentifiez-vous auprès du serveur en tant que ressource administrateur.
    Remarque : L'ID utilisateur et le mot de passe de cette dernière ont été spécifiés au cours de l'installation de WebSphere.
  4. Une fois authentifié, cliquez sur Serveurs > Serveurs d'applications > server1.
  5. Recherchez la section Infrastructure du serveur de la page de configuration de server1, développez Gestion des processus et Java et cliquez sur Définition des processus.
  6. Dans la page Définition des processus, accédez à la section Propriétés supplémentaires et cliquez sur Machine virtuelle Java.
  7. Augmentez la valeur Taille maximale du segment Java à 1000 et cliquez sur Appliquer.
  8. Dans la section Arguments JVM génériques de la page Machine virtuelle Java, incluez les arguments JVM ci-dessous. Ajoutez les arguments JVM sur une seule ligne.

    Exemple Windows :

    -Dcom.ibm.team.server.configURL=file:///D:/RQM/server/teamserver.properties -Dlog4j.configuration=file:///D:/RQM/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///D:/RQM/server/provision_profiles -Dcom.ibm.rqm.create.samples=false -Xss768k

    Exemple Linux :

    -Dcom.ibm.team.server.configURL=file:///opt/IBM/RQM/server/teamserver.properties -Dlog4j.configuration=file:///opt/IBM/RQM/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///opt/IBM/RQM/server/provision_profiles -Dcom.ibm.rqm.create.samples=false -Xss768k

    D:/RQM correspond au répertoire d'installation sous Windows et opt/IBM/RQM au répertoire d'installation sous Linux.

    Ces valeurs doivent être encodées, ce qui signifie que chaque espace contenu dans le chemin des fichiers doit être remplacé par %20. Par exemple, C:\Program Files doit être remplacé par C:\Program%20Files. Si vous ne définissez pas les valeurs d'argument JVM de manière correcte, le serveur WebSphere Application Server ne démarrera pas. Si tel est le cas, vous ne pouvez pas utiliser l'interface utilisateur Web de WebSphere Application Server pour les corriger ; vous devez rechercher le fichier server.xml, l'éditer, puis démarrer WebSphere Application Server. Ce fichier se trouve généralement à l'emplacement suivant :
    c:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\qwin268Node01Cell\nodes\qwin268Node01\servers\server1\server.xml
    Remarque : L'aide de Rational Team Concert ne mentionne pas la totalité des arguments JVM nécessaires au déploiement correct de Rational Quality Manager.
  9. Sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
  10. Cliquez sur Nouveau et ajoutez les valeurs suivantes :
    • Nom : com.ibm.team.repository.provision.profile Valeur : file:///JazzInstallDir/server/provision_profiles
    • Nom : com.ibm.team.server.configURL Valeur : file:///JazzInstallDir/server/teamserver.properties
    • Nom : log4j.configuration Valeur : file:///JazzInstallDir/server/log4j.properties
    • Nom : java.awt.headless Valeur : true
    • Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true

      Par exemple, ajoutez les valeurs spécifiées comme suit : JazzInstallDir = C:/IBM/RQM

  11. Sauvegardez les modifications dans le fichier de configuration maîtresse.
  12. Arrêtez et redémarrez WebSphere Application Server.
    Remarque : Si le serveur ne démarre pas, vérifiez manuellement les arguments JVM génériques. Ceux-ci sont contenus dans le fichier server.xml qui se trouve à l'emplacement suivant dans une installation standard :
    C:\Program Files\ibm\WebSphere\AppServer\profiles\AppSrv01\config\cells\enable01
    Node01Cell\nodes\enable01Node01\servers\server1\server.xml

Configuration de Rational Quality Manager et de l'aide associée sous WebSphere Application Server

Pour configurer IBM Rational Quality Manager et l'aide associée dans un environnement WebSphere Application Server :

  1. Démarrez l'interface de la console d'administration WebSphere et authentifiez-vous auprès du serveur à l'aide de l'ID de l'administrateur WebSphere Application Server.
  2. Développez Applications et cliquez sur Installation d'une nouvelle application.
  3. Sous Chemin de la nouvelle application, recherchez l'emplacement du fichier jazz.war dans le système de fichiers local et sélectionnez-le.
  4. Entrez la racine de contexte sous la forme /jazz et cliquez ensuite sur Suivant.
    Remarque : Le fichier jazz.war se trouve dans <chemin_install_Rational Quality Manager>\server\tomcat\webapps\jazz.war.
  5. Cliquez de manière répétée sur Suivant jusqu'à ce que l'écran de récapitulatif s'affiche et cliquez ensuite sur Terminer pour installer la nouvelle application.
  6. Vérifiez que l'application jazz_war a été installée et cliquez sur Sauvegarder pour sauvegarder les modifications dans le fichier de configuration maîtresse.
  7. Vous êtes renvoyé à la page Installation d'une nouvelle application.
  8. Recherchez l'emplacement du fichier help.war dans le système de fichiers local et sélectionnez-le. Entrez la racine de contexte sous la forme /help et cliquez sur Suivant.
    Remarque : Le fichier help.war se trouve dans <chemin_installation_Rational Quality Manager>\server\tomcat\webapps\help.war.
  9. Cliquez de manière répétée sur Suivant jusqu'à ce que l'écran de récapitulatif s'affiche et cliquez ensuite sur Terminer pour installer la nouvelle application.
  10. Vérifiez que l'application help_war a été installée et cliquez sur Sauvegarder pour sauvegarder les modifications dans le fichier de configuration maîtresse.
  11. Développez la section Application d'entreprise dans l'option Applications.
  12. Sélectionnez jazz_war et cliquez sur Démarrer.
  13. Sélectionnez help_ war et cliquez sur Démarrer.

Configuration de LDAP sous WebSphere Application Server pour Rational Quality Manager

Pour configurer LDAP :

  1. A partir de la console d'administration Websphere, cliquez sur Sécurité > Administration, applications et infrastructure sécurisées.
  2. Mettez à jour les paramètres de sécurité comme suit :
    • Activer la sécurité d'administration : on
    • Activer la sécurité des applications : on
    • Référentiel de comptes utilisateur/Définitions de domaines disponibles : registre LDAP autonome
    • Dans la section Référentiel du compte utilisateur, cliquez sur Configurer et fournissez les propriétés générales.
      • Nom d'utilisateur administratif principal - votre ID utilisateur
      • Identité d'utilisateur de serveur - identité du serveur générée automatiquement
      • Type de serveur LDAP - personnalisé
      • Délai d'expiration de la recherche - 120 secondes
  3. Cliquez sur Appliquer et sauvegardez les modifications.
  4. Dans la section Configuration, cliquez sur Tester la connexion.
  5. Dans la section Propriétés supplémentaires, cliquez sur Advanced Lightweight Directory Access Protocol (LDAP).
  6. Renseignez les zones Propriétés générales comme indiqué ci-dessous :
    • Filtre d'utilisateur :
      (&(emailaddress=%v)(objectclass=ePerson)) 
    • Filtre de groupe :
      (&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames))) 
    • Mappe des ID utilisateur :
       *:emailaddress 
    • Mappe des ID de membre de groupe : (remplacez ibm par votre propre ID)
      ibm-allGroups:member;ibm-allGroups:uniqueMember 
    • Mode de mappage des certificats :
      EXACT_DN
  7. Lorsque vous avez terminé, cliquez sur Appliquer et sauvegardez les modifications.
  8. Cliquez sur Appliquer et Sauvegarder dans chaque écran de confirmation des paramètres.
    Remarque : A la dernière page, vérifiez que le paramètre Définition du domaine en cours est défini à la valeur Registre LDAP autonome.
  9. Arrêtez puis redémarrez WebSphere Application Server.
  10. Une fois que WebSphere Application Server a redémarré, validez les modifications en vous connectant à la console d'administration.
  11. Pour mapper les groupes d'utilisateurs vers les applications spécifiques, cliquez sur Applications > Applications d'entreprise.
  12. Dans la liste des applications d'entreprise, sélectionnez l'application jazz_war et cliquez sur Arrêter.
  13. Une fois l'application arrêtée, cliquez dessus pour l'ouvrir et la modifier.
  14. Dans la section Propriétés du détail, cliquez sur Mappage rôle de sécurité-utilisateur/groupe.
  15. Sélectionnez un groupe spécifique, tel que JazzAdmins et JazzUsers, et cliquez sur Rechercher des groupes.

    Ces groupes sont associés à chaque implémentation Jazz et doivent être mappés vers un groupe LDAP particulier contenant les utilisateurs autorisés. Pour que ce mappage puisse s'effectuer, les groupes doivent être définis sur le serveur LDAP.

  16. Entrez une chaîne de recherche afin d'obtenir vos noms de groupe depuis le serveur LDAP. Cliquez sur Rechercher pour lancer la requête.
  17. Dans la liste des groupes disponibles renvoyée, sélectionnez un groupe et transférez-le dans la colonne Sélectionné.
  18. Cliquez sur OK pour mapper les groupes LDAP vers les groupes Jazz.
  19. Mappez le groupe LDAP approprié pour tous les groupes Jazz :
    • JazzAdmins
    • JazzDWAdmins
    • JazzUsers
    • JazzGuests
    Remarque : N'activez pas l'option Tous les utilisateurs authentifiés ?.
  20. Sauvegardez les modifications et redémarrez l'application jazz_war.
  21. Déconnectez-vous de la console d'administration et fermez la fenêtre du navigateur.

Configuration du registre personnalisé WebSphere Application Server

Remarque : Les instructions présentées dans cette section peuvent vous être utiles lors de l'évaluation de Rational Quality Manager. En revanche, elles ne sont pas pertinentes dans un environnement de production réel si vous utilisez LDAP.

Pour configurer les données d'identification utilisateur à l'aide du registre personnalisé de WebSphere Application Server :

  1. Créez un répertoire WAS_Security et ajoutez les fichiers users.props et groups.props à la racine de l'unité sur laquelle est installé WebSphere Application Server.
  2. Cliquez sur Sécurité > Administration, applications et infrastructure sécurisées et sélectionnez Registre personnalisé autonome dans la section Référentiel de comptes utilisateur ; cliquez ensuite sur le bouton Assistant de configuration des paramètres de sécurité.
  3. A l'étape 1 de l'assistant de configuration des paramètres de sécurité, sélectionnez Activer la sécurité des applications.
  4. A l'étape 2, sélectionnez Registre personnalisé autonome.
  5. A l'étape 3 de configuration du référentiel des utilisateurs, ajoutez un nom d'utilisateur d'administration principal, ainsi qu'un nom et une valeur pour usersFile (users.props) et groupsFile (groups.props) :
    Etape 3 de l'assistant de configuration de la sécurité dont les zones de nom de l'utilisateur admin et d'emplacement des fichiers usersFile et groupsFile sont remplies
  6. A l'étape 4, consultez le récapitulatif et cliquez ensuite sur Terminer.
  7. Sauvegardez les modifications en cliquant sur Sauvegarde dans la configuration maîtresse. Dans Applications > Applications d'entreprise, sélectionnez jazz.war et cliquez ensuite sur Arrêter (sauf si une croix rouge indique que le processus est déjà arrêté).
  8. Cliquez sur le lien jazz.war et sélectionnez ensuite Mappage rôle de sécurité-utilisateur/groupe.
  9. Sélectionnez JazzAdmins et cliquez ensuite sur Rechercher des groupes :
    Mappage rôle de sécurité-utilisateur/groupe
  10. Cliquez sur Rechercher des groupes et sélectionnez ensuite admins dans la liste disponible.
  11. Ajoutez à la liste sélectionnée. Répétez les étapes 9 et 10 pour JazzDWAdmins en sélectionnant à nouveau admins.
  12. Pour JazzUsers et JazzGuests, suivez les étapes 9 et 10, mais sélectionnez users pour les rôles.
  13. Sauvegardez les modifications en cliquant sur Sauvegarde dans la configuration maîtresse.
  14. Pour terminer la configuration de WebSphere Application Server, redémarrez WebSphere Application Server.

Démarrage de WebSphere Application Server en tant que service Windows

Rational Quality Manager permet de créer des scripts de test faisant référence à des tests automatisés créés à l'aide d'autres outils de test. Ces tests automatisés peuvent s'effectuer sur des machines de test locales ou à des emplacements partagés du réseau. Les tests qui sont sauvegardés à des emplacements de réseau partagés sont accessibles via les partages UNC (Universal Naming Convention).

Par défaut, lorsque WebSphere Application Server s'exécute en tant que service Windows, il se connecte avec un compte système local. Dans ce cas, il est possible que Rational Quality Manager ne puisse pas accéder aux partages UNC car le compte système local ne possède pas de données d'identification de sécurité. Assurez-vous donc de définir le service WebSphere Application Server Windows de sorte qu'il se connecte avec un compte utilisateur spécifique associé à des données d'identification de sécurité. Le service pourra ainsi se connecter à n'importe quel partage UNC reconnaissant les données d'identification de sécurité de ce compte utilisateur.

Tâches associées
Mise à disposition des ressources de test partagées

Retour d'informations