Configuration de Jazz Team Server et de la première application après la mise à niveau

Une fois que vous avez effectué la mise à niveau et démarré Jazz Team Server (ainsi que des serveurs d'applications CLM répartis), vous devez configurer Jazz Team Server et l'application CLM.

Avant de commencer

Avant de configurer le serveur, ouvrez votre navigateur Web et supprimez le contenu de la mémoire cache du navigateur.

Vous devez connaître l'URI public de Jazz Team Server et de toutes les applications que vous enregistrez. L'URI public d'une version précédente de Jazz Team Server ou d'une application ne peut pas être modifié. Pour plus d'informations sur la planification des URI, voir Planification de vos URI.

Pourquoi et quand exécuter cette tâche

Procédure

Remarque : Si vous exécutez l'assistant pour configurer des applications réparties, effectuez les étapes suivantes dans l'ordre :
  1. Installez l'application Jazz Team Server et les licences d'évaluation sur le premier serveur. Démarrez le premier serveur mais n'exécutez pas l'assistant de configuration sur celui-ci.
  2. Installez les applications Gestion des modifications et de la configuration, Gestion de la qualité ou Gestion des exigences sur le deuxième serveur (ou sur un serveur pour chaque application, comme décrit dans Exemples de topologies d'entreprise). Démarrez les serveurs mais n'exécutez pas l'assistant de configuration.
  3. Exécutez l'assistant de configuration sur le premier serveur (avec l'application Jazz Team Server), en commençant à l'étape 2 ci-dessous. Lorsque vous arrivez à la page Enregistrement des applications de l'assistant de configuration (voir étape 8, ci-dessous), indiquez l'URL de reconnaissance des applications installées sur les autres serveurs.
  4. Si vous souhaitez que les applications réparties utilisent LDAP, après avoir configuré le registre d'utilisateurs dans l'étape 9 ci-dessous, copiez les fichiers LDAP du serveur avec Jazz Team Server sur les serveurs avec les autres applications, puis redémarrez tous les serveurs.

  1. Assurez-vous d'avoir démarré le serveur en suivant les instructions de la rubrique Déploiement et démarrage du serveur.
  2. Entrez l'adresse suivante dans votre navigateur Web : https://[nom d'hôte qualifié complet]:9443/jts/setup
  3. La page de connexion à Jazz Team Server apparaît.
    • Pour une nouvelle installation, saisissez ADMIN (case-sensitive) dans les deux zones ID utilisateur et Mot de passe. Cliquez sur Se connecter.
      Remarque :
      • N'utilisez pas ADMIN (dépendant maj/min) comme ID utilisateur et mot de passe si vous avez activé l'utilisation du protocole LDAP (Lightweight Directory Access Protocol) pour les applications sur WebSphere Application Server. Connectez-vous plutôt en tant qu'utilisateur LDAP enregistré disposant des droits JazzAdmin.
      • Pour le serveur d'application WebSphere sur z/OS avec la sécurité RACF ou le serveur d'application WebSphere sur IBM® i avec authentification OS locale, utilisez un ID utilisateur disposant de privilèges JazzAdmin sur le système.
    • Pour une mise à niveau, connectez-vous avec un ID administrateur utilisé dans la version précédente, puis cliquez sur Suivant.
      Remarque : Si vous ne parvenez pas à vous connecter ou que l'utilisateur ne dispose pas d'un accès administrateur, vérifiez que les tâches suivantes ont été effectuées :
      • Sous Apache Tomcat :
        • Si vous utilisez la base de données des utilisateurs Tomcat, vérifiez que le fichier tomcat-users.xml a été correctement copié.
        • Si vous utilisez LDAP, vérifiez que les paramètres LDAP ont été correctement fusionnés dans le fichier server.xml.
      • Sur WebSphere Application Server :
        • Vérifiez que vous avez correctement configuré les mappages des rôles au groupe pour toutes les applications.
  4. Dans la page Introduction, cliquez sur Suivant.
  5. Sur la page Configuration de l'URI public, indiquez la racine de l'URI public sous la forme https://[nom d'hôte qualifié complet]:9443/jts et cochez la case J'ai lu et compris les recommandations de configuration de l'URI public, et confirme qu'il est défini correctement. Cliquez sur Tester la connexion. Une fois la connexion testée avec succès, cliquez sur Suivant. Si vous mettez à niveau de Jazz Team Server, vous ne pouvez pas modifier l'URI public.
    Important :

    Le [nom d'hôte qualifié complet] est le nom d'hôte associé à la référence du domaine DNS de la machine sur laquelle Jazz Team Server est installé.

    Exemple de [nom d'hôte qualifié complet] correct : clmwb.exemple.com.

    Exemples de [nom d'hôte qualifié complet] incorrects : localhost et une adresse IP.

  6. Dans la page Configuration de la base de données, indiquez les informations de configuration d'une connexion à la base de données.

    Pour une mise à niveau, vous devez voir la configuration de base de données que vous avez indiquée pendant le processus de mise à niveau. Confirmez que les valeurs correspondent aux valeurs attendues.

    Si vous utilisez la base de données Derby, vous ne devriez pas avoir à modifier les valeurs par défaut ni être invité à créer des tables de base de données.

    Si vous modifiez les valeurs par défaut ou définissez une base de données d'entreprise telle que DB2, Oracle ou SQL Server, cliquez sur Tester la connexion pour vérifier que la connexion est correctement configurée.

    Si vous n'avez pas utilisé repotools auparavant pour créer les tables de base de données, il se peut qu'un avertissement s'affiche pour vous indiquer que la base de données existe mais qu'elle ne contient aucune table. Pour créer les tables, cliquez sur Créer des tables. Plusieurs minutes peuvent être nécessaires à l'exécution complète de la commande.

    Si vous avez testé la connexion et que vous ne voyez pas d'avertissements ni d'erreurs, cliquez sur Suivant.

  7. Dans la page Activation de la notification par message électronique, activez ou désactivez les notifications par message électronique. Si vous choisissez d'activer les notifications, vous devrez fournir des informations sur votre serveur de messagerie et tester la connexion à ce dernier. Cliquez sur Suivant après avoir effectué vos sélections et testé la connexion.
  8. Dans la page Enregistrement des applications, l'assistant détecte les applications qui ont été installées avec le Jazz Team Server. La reconnaissance des applications et leur ajout à la liste des applications à enregistrer peut prendre une minute. L'assistant détecte également l'application Lifecycle Project Administration, qui doit se trouver sur le même serveur que l'application Jazz Team Server. L'assistant ne détecte pas les applications installées sur un autre serveur. Vous devez les ajouter manuellement. Voir l'étape c ci-dessous.
    1. Facultatif : Si vous ne souhaitez pas energistrer une application, cliquez sur l'icône Fermer à l'extrême droite du nom de l'application. En général, vous devez enregistrer toutes les applications mais vous pouvez, si vous le souhaitez, ne pas enregistrer une ou plusieurs applications dans les situations suivantes :
      • Vous avez téléchargé et déployé toutes les applications, mais vous ne souhaitez pas les utiliser toutes.
      • Vous ne disposez pas des licences permettant d'accéder à une application.
      • Vous configurez cette application Jazz Team Server en tant que serveur flottant autonome ou à licence à jeton.
    2. Vérifiez le type d'application et l'URL de reconnaissance des applications installées. L'assistant crée des ID utilisateur fonctionnels préautorisés par défaut pour chaque application.
      Qu'est-ce qu'une adresse URL de reconnaissance ? : L'adresse URL de reconnaissance est l'adresse URL de la ressource de contribution de service (SCR) d'une application. En général, l'adresse URL SCR est obtenue en ajoutant /scr à l'adresse URI publique de l'application. Par exemple, si l'adresse URI publique de l'application Gestion des modifications et de la configuration est https://[nom d'hôte qualifié complet]:9443/ccm, l'adresse URL SCR correspondante est https://[nom d'hôte qualifié complet]:9443/ccm/scr. Pour des applications installée en local, l'adresse URL et un ID utilisateur fonctionnel seront indiqués par l'assistant de configuration.
    3. Facultatif : Pour ajouter une application installée sur un serveur différent, cliquez sur Ajouter application et donnez le nom de l'application et l'URL de découverte. Après avoir fourni le nom de l'application et l'URL de découverte, l'ID utilisateur fonctionnel est généré et renseigné automatiquement. L'ID utilisateur fonctionnel sera utilisé pour exécuter des tâches en arrière-plan. L'ID utilisateur fonctionnel n'a pas besoin d'exister dans le registre d'utilisateurs externe ou en tant qu'utilisateur du référentiel. S'il ne figure pas dans le référentiel, il sera créé automatiquement.
    4. Cliquez sur Enregistrement des applications.
      Remarque : L'assistant crée des relations amies, enregistre les applications et génère une clé de consommateur et une valeur confidentielle pour chaque application.
    5. Une fois l'enregistrement effectué, cliquez sur Suivant pour configurer les applications enregistrées.
      Remarque : Notez que le menu de gauche répertorie désormais l'application enregistrée avec des sous-étapes.
  9. Sur la page Configuration du registre d'utilisateurs, indiquez les informations ci-dessous. Pour une mise à niveau, votre registre d'utilisateurs sera déjà configuré et vous devrez affecter une licence à l'administrateur.
    1. Sélectionnez le type de registre d'utilisateurs que vous allez utiliser.
      Remarque :
      • Si vous sélectionnez un registre d'utilisateurs LDAP, vous devez fournir des informations permettant de configurer la connexion entre Jazz Team Server et votre serveur LDAP. Vous devrez peut-être demander ces informations auprès de votre administrateur LDAP.
      • Pour le serveur d'application WebSphere sur z/OS avec la sécurité RACF ou le serveur d'application WebSphere sur IBM i avec authentification OS locale, sélectionnez un registre externe non LDAP.
    2. Indiquez l'ID utilisateur, le nom, le mot de passe et l'adresse électronique de l'utilisateur qui disposera de droits d'administration sur Jazz Team Server.
    3. Selon les applications installées, sous Rational Requirements Composer, Rational Team Concert, et Rational Quality Manager sélectionnez les licences d'accès client que vous voulez attribuer aux administrateurs. Vous pouvez attribuer un seul type de licence d'accès client reposant sur des rôles à l'administrateur. Par exemple, vous ne pouvez attribuer à l'administrateur qu'une licence d'accès client Rational Team Concert - Developer ou une licence d'accès client Rational Team Concert - Stakeholder CAL, mais pas les deux. La même règle s'applique aux autres applications.

      Si vous avez installé les licences d'évaluation, vous devez accepter les termes d'une licence pour pouvoir l'attribuer à l'administrateur. Pour activer une licence, cliquez sur Activer la période d'essai. Ensuite, dans la fenêtre Contrat de licence Client Access, cliquez sur J'accepte les termes du contrat de licence, puis sur Terminer.

      Conseil : Pour plus d'informations sur les différents niveaux d'accès aux fonctionnalités des applications de la version courante, voir Présentation de la gestion des licences d'accès client.
    4. Cliquez sur Suivant après avoir effectué vos sélections.
  10. Sur la page Configuration de Data Warehouse, fournissez les informations requises pour configurer une connexion avec l'entrepôt de données. L'entrepôt de données est une base de données utilisée pour la génération de rapports et d'analyses. Par défaut, l'application est configurée pour utiliser la base de données Derby, laquelle est incluse avec l'application. Si votre base de données est préparée sur une serveur de base de données d'entreprise, tel que DB2 ou Oracle, vous devez configurer Jazz Team Server de manière à ce qu'il utilise cette base de données.
    1. Facultatif : Pour ne pas configurer l'entrepôt de données à ce moment, cliquez sur Je ne souhaite pas configurer l'entrepôt de données pour l'instant. Ignorez l'entrepôt de données uniquement dans les circonstances suivantes :
      • Vous souhaitez mettre à niveau une application Rational Gestion de la qualité de version 2 existante et toutes les affirmations suivantes sont vraies :
        • Vous avez utilisé Rational Common Reporting avec Rational Quality Manager ;
        • Vous ajouterez l'application Rational Quality Manager à cet environnement Jazz Team Server ;
        • Vous souhaitez utiliser votre base de données Rational Common Reporting existante en tant qu'entrepôt de données de vos produits CLM ;
        • Vous ne mettez pas à niveau cette application Rational Quality Manager pour l'instant.

        Lorsque vous mettez à niveau votre application Rational Quality Manager, vous pouvez revenir à l'assistant de configuration et configurer Jazz Team Server ainsi que les autres applications de manière à ce qu'ils utilisent la base de données Rational Common Reporting existante.

      • Vous avez utilisé Rational Insight et toutes les affirmations suivantes sont vraies :
        • Vous souhaitez utiliser votre base de données Rational Insight existante en tant qu'entrepôt de données de vos produits CLM ;
        • Vous n'avez pas encore effectué la mise à niveau à Rational Insight version 1.0.1.1, qui est la version la plus ancienne prenant en charge CLM.

        Après avoir mis à niveau Rational Insight à la version 1.0.1.1, vous pouvez revenir à l'assistant de configuration et configurer Jazz Team Server ainsi que les autres applications de manière à ce qu'ils utilisent la base de données Rational Insight existante.

      Si vous ne configurez pas l'entrepôt de données, vos applications seront fonctionnelles mais vous ne pourrez enregistrer aucune donnée de reporting et la plupart des rapports ne fonctionneront pas.

    2. Dans la section Configuration du fournisseur de base de données Data Warehouse et du type de connexion, sélectionnez votre Fournisseur de base de données et le Type de connexion de ce fournisseur de base de données. Par défaut,la base de données Derby pré-configurée incluse doit être utilisée avec une connexion JDBC. Vous pouvez conserver cette valeur par défaut ou choisir un autre fournisseur de base de données et un autre type de connexion.
    3. Si vous n'utilisez pas la base de données Derby, dans la section Configuration des propriétés de connexion à la base de données Data Warehouse, entrez les propriétés de connexion à utiliser pour votre base de données. Les valeurs requises dépendent du fournisseur de base de données et du type de connexion.
    4. Pour Oracle ou Microsoft SQL Server, dans la zone Dossier de l'espace de table de base de données, saisissez le chemin d'accès à un référentiel existant sur le serveur de base de données sur lequel l'espace de table sera créé.
    5. Si vous avez utilisé Rational Common Reporting ou Rational Insight et que vous souhaitez utiliser la base de données existante en tant qu'entrepôt de données pour vos produits CLM, indiquez les informations nécessaires pour se connecter à cette base de données existante. Vous serez invité à ajouter des tables à votre base de données Rational Common Reporting ou Rational.
    6. Entrez les informations de connexion d'un utilisateur fonctionnel qui exécutera les travaux de collecte de données. Si vous utilisez la base de données utilisateur Tomcat intégrée, cet utilisateur sera créé dans le registre. Si vous utilisez LDAP ou un autre registre externe, vous devez spécifier un utilisateur existant dan ce registre.
      Remarque : L'ID utilisateur saisi pour l'utilisateur fonctionnel doit être différent de celui de l'administrateur utilisé actuellement pour configurer l'application.
    7. Cliquez sur Tester la connexion pour vérifier que le serveur peut communiquer avec la base de données à l'aide des informations de connexion que vous avez fournies.
    8. Si n'avez pas utilisé la commande repotools précédemment pour créer les tables de base de données, il se peut qu'un avertissement indiquant que la base de données existe mais qu'elle ne contient aucune table s'affiche. Pour créer les tables, cliquez sur Créer des tables. Plusieurs minutes peuvent être nécessaires à l'exécution complète de la commande. Si vous utilisez la base de données par défaut derby, cet avertissement ne sera pas affiché.
    9. Cliquez sur Suivant.
  11. Pour chaque application, configurez la base de données et l'entrepôt de données en suivant la procédure précédente.
    Remarque : La gestion des exigences utilise la même base de données que Jazz Team Server. Par conséquent, les étapes de configuration des bases de données ne sont pas disponibles dans le menu de la Gestion des exigences.

    Si vous n'avez pas configuré l'entrepôt de données pour Jazz Team Server à l'étape 10, sur la page Configuration de l'entrepôt de données de l'application, sélectionnez Je ne souhaite pas configurer l'entrepôt de données pour l'instant.

    pour l'utilisateur qui exécute les tâches de collecte de données, vous devez saisir un ID utilisateur différent de celui que vous avez utilisé pour configurer l'application.

  12. Dans la page Finalisation de la configuration de chaque application, cliquez sur Finaliser la configuration d'application. Au cours de cette étape, la clé de consommateur et la valeur confidentielle de l'application sont stockées et les utilisateurs de Jazz Team Server sont synchronisés. Pour l'application Gestion des exigences, si vous effectuez une mise à niveau depuis Rational Requirements Composer version 2 ou si vous ajoutez une application Gestion des exigences à un environnement Jazz Team Server existant, cliquez également Régénérer l'index. Si vous configurer un environnement totalement nouveau, vous n'avez pas à régénérer l'index. Une fois que vous avez vu s'afficher un message indiquant que la procédure est terminée, cliquez sur Suivant.
    Remarque : Si les applications se trouvent sur des serveurs distincts et que le message d'erreur "500 error - unexpected error occurred failure during finalize application step" s'affiche, vérifiez que les serveurs sont définis aux mêmes date, heure et fuseau horaire.
  13. Dans la page Finalisation de la configuration de l'application Administration de projet de cycle de vie, cliquez sur Autoriser. Il se peut que vous ayez à vous connecter à des applications enregistrées ; connectez-vous en tant qu'administrateur (utilisez le même ID utilisateur que celui que vous avez utilisé dans l'assistant de configuration). Ensuite, cliquez sur Finaliser la configuration d'application. Une fois la procédure terminée, cliquez sur Suivant.
  14. Dans la page Récapitulatif, vous pouvez réviser les paramètres du serveur et choisir l'une des options suivantes :

Commentaires