La présente rubrique explique comment configurer IBM® Rational Quality Manager pour l'utiliser avec WebSphere Application Server. Cette configuration suppose que vous installez le serveur Jazz sur le même système que WebSphere Application Server.
Planification de la configuration
Avant de commencer, vous devez disposer des éléments suivants :
- Jazz Team Server requiert WebSphere Application Server
Version 6.1 avec le groupe de correctifs IBM Java™ SDK 1.5 SR5 ou une version ultérieure,
ou WebSphere Application
Server Version 7.0.0.3 ou une version ultérieure.
La mise à jour du programme IBM Java SDK
1.5 SR6 est disponible à l'adresse suivante : http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492.
Si vous utilisez WebSphere 6.1 et
GA IBM Java SDK sans ce correctif, Jazz signale des erreurs de serveur proxy après un certain nombre d'opérations.
Vous devez impérativement vous procurer les correctifs WebSphere Application Server
pour IBM Java SDK 1.5 SR9 ou IBM Java SDK
1.6 SR4 pour que IBM Rational Team Concert 2.0 fonctionne
correctement. A défaut, certains services du serveur ne démarreront pas. Le correctifs sont disponibles dans les APAR WebSphere Application Server
correspondants. Pour IBM Java SDK 1.5 et WebSphere Application Server 6.1, l'APAR correspondant est disponible sous la référence PK85942. Vous pouvez le télécharger à l'adresse ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/.
Installez au minimum le groupe de correctifs WebSphere Application
Server 6.1 Fixpack 19 avant d'installer le correctif JRE. Pour IBM Java SDK
1.6 et WebSphere Application Server 7.0, l'APAR correspondant est disponible sous la référence PK 86771. Vous pouvez le télécharger à l'adresse ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.
- Le fichier teamserver.properties est mis à jour avec les paramètres de base de données.
- Pour connaître la configuration de sécurité et désactiver la propriété qui annule les distinctions entre les majuscules et les minuscules, reportez-vous à la documentation WebSphere.
- L'option Sécurité Java 2 doit être désactivée. Si cette option est activée dans WebSphere Application Server, le lancement du fichier jazz.war échoue.
- Vérifiez que le paramètre de sécurité WAS "Utiliser les données d'authentification disponibles quand un URI protégé est accédé" est sélectionné. Pour effectuer cette opération dans la console WAS Integrated Solutions, procédez comme suit :
- Dans la version 6.1, accédez à Sécurité -> Administration, applications et infrastructure sécurisées -> Sécurité Web - Paramètres généraux. Dans la version 7, accédez à Sécurité->Sécurité globale->Sécurité Web et SIP->Paramètres généraux.
- Cochez la case "Utiliser les données d'authentification disponibles quand un URI protégé est accédé".
Configuration de WebSphere Application Server
Pour configurer WebSphere Application
Server :
- S'il n'est pas encore démarré, démarrez le service WebSphere Application Server.
- Recherchez la console d'administration de WebSphere Application Server.
- Authentifiez-vous auprès du serveur en tant que ressource administrateur.
Remarque : La personne qui a installé le logiciel WebSphere a indiqué l'ID utilisateur et le mot de passe de la ressource d'administration lors de l'installation.
- Une fois authentifié, cliquez sur .
- 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.
- Dans la page Définition des processus, accédez à la section Propriétés supplémentaires et cliquez sur Machine virtuelle Java.
- Augmentez la valeur Taille maximale du segment Java à 1000 et cliquez sur Appliquer.
- 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 sous Windows® :
-Dcom.ibm.team.server.configURL=file:///D:/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///D:/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///D:/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///D:/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///D:/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k
Exemple sous Linux® :
-Dcom.ibm.team.server.configURL=file:///opt/IBM/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///opt/IBM/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///opt/IBM/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///opt/IBM/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///opt/IBM/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k
où D:/RQM20 est le répertoire d'installation sous Windows et opt/IBM/RQM20 est le 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 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.
- Sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
- Cliquez sur Nouveau et ajoutez les valeurs suivantes :
- Sauvegardez les modifications dans le fichier de configuration maîtresse.
- Arrêtez, puis 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
Paramètre de sécurité pour WebSphere Application Server
Pour améliorer la prise en charge pour OAuth, installations à l'aide de WebSphere Application Server, vous devez utiliser le paramètre de sécurité Web suivant :
- A l'aide de la console de solutions d'intégration WAS, accédez à .
- Vérifier que Utiliser les données d'authentification disponibles quand un URI protégé est accédé est sélectionné.
Configuration de Rational Quality Manager et de l'aide associée sous WebSphere Application
Server
Pour configurer le produit et l'aide IBM Rational Quality Manager dans un environnement WebSphere Application
Server, procédez comme suit :
- Démarrez l'interface de la console d'administration de WebSphere et authentifiez-vous auprès du serveur à l'aide de l'ID administrateur de WebSphere Application Server.
- Développez Applications et cliquez sur Installation d'une nouvelle application.
- Sous Chemin de la nouvelle application, recherchez l'emplacement du fichier jazz.war dans le système de fichiers local et sélectionnez-le.
- Entrez la racine de contexte sous la forme /jazz et cliquez ensuite sur Suivant.
Remarque : Le fichier jazz.war se trouve dans répertoire_installation_RQM\server\tomcat\webapps\jazz.war.
- 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.
- 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.
- Vous êtes renvoyé à la page Installation d'une nouvelle application.
- 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 répertoire_installation_RQM\server\tomcat\webapps\help.war.
- 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.
- 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.
- Développez la section Application d'entreprise dans l'option Applications.
- Sélectionnez jazz_war et cliquez sur Démarrer.
- Sélectionnez help_ war et cliquez sur Démarrer.
Configuration de LDAP sous WebSphere Application Server pour Rational Quality Manager
Pour configurer LDAP :
- A partir de la console d'administration Websphere, cliquez sur .
- 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
- Cliquez sur Appliquer et sauvegardez les modifications.
- Dans la section Configuration, cliquez sur Tester la connexion.
- Dans la section Propriétés supplémentaires, cliquez sur Advanced Lightweight
Directory Access Protocol (LDAP).
- 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
- Lorsque vous avez terminé, cliquez sur Appliquer et sauvegardez les modifications.
- 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.
- Arrêtez puis redémarrez WebSphere Application Server.
- Une fois que WebSphere Application
Server a redémarré, validez les modifications en vous connectant à la console d'administration.
- Pour mapper les groupes d'utilisateurs vers les applications spécifiques, cliquez sur .
- Dans la liste des applications d'entreprise, sélectionnez l'application jazz_war et cliquez sur Arrêter.
- Une fois l'application arrêtée, cliquez dessus pour l'ouvrir et la modifier.
- Dans la section Propriétés du détail, cliquez sur Mappage rôle de sécurité-utilisateur/groupe.
- 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 à 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.
- 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.
- Dans la liste des groupes disponibles renvoyée, sélectionnez un groupe et transférez-le dans la colonne Sélectionné.
- Cliquez sur OK pour mapper les groupes LDAP à des groupes Jazz.
- 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 ?.
- Sauvegardez les modifications et redémarrez l'application jazz_war.
- 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 :
- Créez un répertoire nommé WAS_Security à l'emplacement de votre choix puis ajoutez les fichiers users.props et groups.props dans ce répertoire.
Pour plus d'informations sur le format de ces fichiers, voir user.props et groups.props.
- Cliquez sur 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é.
- A l'étape 1 de l'assistant de configuration des paramètres de sécurité, sélectionnez Activer la sécurité des applications.
- A l'étape 2, sélectionnez Registre personnalisé autonome.
- 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) :
- A l'étape 4, consultez le récapitulatif et cliquez ensuite sur Terminer.
- Sauvegardez les modifications en cliquant sur Sauvegarde dans la configuration maîtresse. Dans , sélectionnez jazz.war
et cliquez ensuite sur Arrêter (sauf si une croix rouge indique que le processus est déjà arrêté).
- Cliquez sur le lien jazz.war et sélectionnez ensuite Mappage rôle de sécurité-utilisateur/groupe.
- Sélectionnez JazzAdmins et cliquez ensuite sur Rechercher des groupes :
- Cliquez sur Rechercher des groupes et sélectionnez ensuite admins dans
la liste disponible.
- Ajoutez à la liste sélectionnée. Répétez les étapes 9 et 10 pour JazzDWAdmins en sélectionnant à nouveau admins.
- Pour JazzUsers et JazzGuests, suivez les étapes 9 et 10, mais sélectionnez users pour les rôles.
- Sauvegardez les modifications en cliquant sur Sauvegarde dans la configuration maîtresse.
- 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.