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
- Utilisez cette procédure si vous venez de mettre à niveau Jazz Team
Server et au moins l'une des applications CLM vers la version 3.0.1. Dans ce cas, il recommandé d'exécuter Jazz Team
Server et l'assistant de configuration d'application pour configurer votre base de données, les paramètres de la messagerie et l'entrepôt de données, le registre des utilisateurs et pour enregistrer les applications. Il détecte les applications que vous venez d'installer et vous permet de les configurer.
- Si vous ajoutez une nouvelle application à un serveur Jazz Team
Server existant ou si vous ajoutez une seconde instance d'une application enregistrée, utilisez l'interface Web d'administration Jazz Team
Server pour effectuer la configuration. Pour plus d'informations, voir Enregistrement d'applications supplémentaires auprès de Jazz Team Server.
Procédure
Remarque : Si vous exécutez l'assistant pour configurer des applications réparties, effectuez les étapes suivantes dans l'ordre :
- 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.
- 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.
- 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.
- 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.
- Assurez-vous d'avoir démarré le serveur en suivant les instructions de la rubrique Déploiement et démarrage du serveur.
- Entrez l'adresse suivante dans votre navigateur Web : https://[nom d'hôte qualifié complet]:9443/jts/setup
- 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.
- Dans la page Introduction, cliquez sur Suivant.
- 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.
- 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.
- 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.
- 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.
- Facultatif : Si vous ne souhaitez pas energistrer une application, cliquez sur l'icône
à 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Cliquez sur Suivant après avoir effectué vos sélections.
- 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.
- 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.
- 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.
- 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.
- 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éé.
- 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.
- 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.
- 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.
- 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é.
- Cliquez sur Suivant.
- 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.
- 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.
- 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.
- Dans la page Récapitulatif, vous pouvez réviser les paramètres du serveur et choisir l'une des options suivantes :
- Cliquez sur Créer des utilisateurs ou Terminer pour accéder à l'interface utilisateur d'administration de Jazz Team
Server dans laquelle vous pouvez gérer le serveur, les utilisateurs et les licences. Voir Administration de
Jazz Team
Server pour plus d'informations.
- Cliquez sur Créer des projets de cycle de vie pour accéder à l'application Administration des projets de cycle de vie dans laquelle vous pouvez créer des projets pour gérer les relations entre applications. Voir Création et gestion des projets de cycle de vie pour plus d'informations.