Configuration d'un système WebSphere Application Server

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 :

Configuration de WebSphere Application Server

Pour configurer WebSphere Application Server :

  1. S'il n'est pas encore démarré, 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 : 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.
  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 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

    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.
  9. Sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
  10. Cliquez sur Nouveau et ajoutez les valeurs suivantes :
    • Nom : JAZZ_HOME Valeur : file:///répertoire_installation_RQM/server/conf/
    • Nom : log4j.configuration Valeur : file:///répertoire_installation_RQM/server/log4j.properties
    • Nom : java.awt.headless Valeur : true
    • Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true

      Par exemple, ajoutez les valeurs indiquées comme suit : RQM_install_dir = C:/IBM/RQM20

  11. Sauvegardez les modifications dans le fichier de configuration maîtresse.
  12. 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 :

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 :

  1. 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.
  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 répertoire_installation_RQM\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 répertoire_installation_RQM\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 à 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 à des 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 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.

  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.


Retour d'informations