Exécution de l'assistant de configuration (Configuration personnalisée)

L'assistant de configuration vous guide lors de la configuration de votre base de données, de vos paramètres de courrier électronique, du registre d'utilisateurs et de l'enregistrement d'applications. Il détecte les applications que vous venez d'installer et vous permet de les configurer.

Avant de commencer

En cas de nouvelle installation, si vous ne souhaitez pas utiliser les numéros de port par défaut, vous devez les changer avant d'utiliser l'assistant de configuration. Pour plus d'informations, voir Modification des numéros de port pour le serveur d'applications.

Si vous utilisez une base de données d'entreprise telle que DB2, Oracle, ou Microsoft SQL Server, vous devez avoir créé les bases de données pour chaque application et l'entrepôt de données. Pour plus d'informations, voir Configuration d'une base de données DB2, Configuration d'une base de données Oracle ou Configuration d'une base de données de serveur SQL. Notez que lorsque vous créez les bases de données, vous n'avez pas besoin de créer les tables de base de données en exécutant la commande repotools. Sur la page Configuration de la base de données de cet assistant, cliquez sur Créer des tables pour créer les tables de base de données.

Assurez-vous d'avoir démarré le serveur en suivant les instructions de la rubrique Déploiement et démarrage du serveur.

Pourquoi et quand exécuter cette tâche

Effectuez chaque étape de cet assistant pour configurer Jazz Team Server et les applications que vous venez d'installer. Si vous voulez apporter des modifications une fois la configuration terminée vous pouvez revenir à l'assistant et recommencer.

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 7, ci-dessous), indiquez l'URL de reconnaissance des applications installées sur les autres serveurs.
  4. Sur Tomcat, si vous souhaitez que les application réparties (CCM et uniquement QM. Les autres applications utilisent des authentification déléguées.) Pour que les applications réparties utilisent LDAP, après avoir configuré le registre d'utilisateurs à l'étape 8 ci-dessous, copiez les fichiers server.xml et web.xml et les attributs LDAP des fichiers teamserver.properties depuis le serveur avec Jazz Team Server sur les serveurs avec les autres applications, puis redémarrez tous les serveurs.
  5. Sur WebSphere Application Server, si vous souhaitez que les application réparties (CCM et uniquement QM. Les autres applications utilisent des authentification déléguées.) Pour que les applications réparties utilisent LDAP, après avoir configuré le registre d'utilisateurs à l'étape 8 ci-dessous, copiez les attributs LDAP des fichiers teamserver.properties depuis le serveur avec Jazz Team Server sur les serveurs avec les autres applications, puis redémarrez tous les serveurs.

  1. Entrez l'adresse suivante dans votre navigateur Web : https://[nom d'hôte qualifié complet]:9443/jts/setup
    Remarque : Le numéro de port par défaut sur les systèmes IBM i est 29443.
  2. La page de connexion à Jazz Team Server apparaît.
    • Entrez ADMIN (dépendant maj/min) dans les zones ID utilisateur et Mot de passe. Cliquez sur Se connecter.
    • N'utilisez pas ADMIN (dépendant maj/min) comme ID utilisateur et mot de passe si vous avez configuré des applications pour qu'elles utilisent le protocole LDAP (Lightweight Directory Access Protocol) dans WebSphere Application Server. Connectez-vous plutôt sous le nom d'un utilisateur enregistré LDAP qui a des droits JazzAdmin. Notez que l'utilisateur ou le groupe LDAP doit être mappé vers le groupe de référentiel. Pour mapper les rôles de sécurité vers un groupe d'utilisateurs ou un groupe de référentiel, voir l'étape 9 de cette rubrique.
    • 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. L'ID utilisateur et le mot de passe par défaut sur IBM i sont JTSADMIN et JTSADMPWD.
  3. Sur la page Bienvenue, deux options vous permettent de configurer le serveur : Configuration express et Configuration personnalisée. Pour plus d'informations sur les contraintes, voir Exécution de l'assistant de configuration (configuration express). Pour les environnements de production, sélectionnez Configuration personnalisée et cliquez sur Suivant.
  4. Dans la page Configuration de l'URI public, indiquez une racine d'URI public sous la forme https://[nom d'hôte complet]:9443/jts et cochez la case pour confirmer que vous avez lu et compris les recommandations définies sur cette page. Cliquez sur Tester la connexion. Une fois la connexion testée avec succès, cliquez sur Suivant.
    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.

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

    Si vous utilisez la base de données Derby, il ne devrait pas être nécessaire de changer les valeurs par défaut ni de 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 vous assurer 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 qu'aucun avertissement ou qu'aucune erreur ne s'affiche, cliquez sur Suivant.

  6. 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.
  7. 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 enregistrer 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 pour chaque application.
      Qu'est-ce qu'une adresse URL de reconnaissance ? : L'URL de reconnaissance est l'URL de ressource de contribution de service 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. Il n'est pas nécessaire qu'il existe dans le registre d'utilisateurs externe ou comme utilisateur dans le référentiel. Si l'utilisateur n'existe pas dan s le référentiel, il sera automatiquement créé.
    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 affiche maintenant les applications enregistrées ainsi que les sous-étapes.
  8. Sur la page Configuration du registre d'utilisateurs, indiquez les informations ci-dessous.
    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 pour configurer la connexion entre Jazz Team Server et le 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 d'un accès administrateur à 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 basée 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.
  9. 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.
    Important : Si vous avez l'intention d'utiliser Rational Reporting for Development Intelligence (RRDI), assurez-vous que vous utilisez une base de données autre que la base de données Derby par défaut. RRDI ne prend pas en charge Derby.
    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 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.1.Next, qui est la version la plus ancienne prenant en charge cette version de CLM.
          Important : Rational solution for Collaborative Lifecycle Management (CLM) v4.0 ne prend pas en charge Rational Insight v1.1 et versions antérieures. Rational solution for CLM v4.0 est censé prendre en charge la prochaine de version de Rational Insight (v1.1.Next), dont la sortie est prévue à une date ultérieure. Si vous utilisez actuellement Rational Insight comme solution de génération de rapports Development Intelligence, n'effectuez pas la mise à niveau vers Rational solution for CLM v4.0 tant que Rational Insight v1.1.Next n'est pas disponible. Pour plus de détails, consultez la rubrique Configuration requise de Rational solution for CLM.

        Après avoir mis à niveau Rational Insight à la version 1.1.Next, 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 Tomcat et 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 qui existe dans le registre externe.
      Remarque : L'ID utilisateur saisi pour l'utilisateur fonctionnel doit être différent de celui de l'administrateur utilisé actuellement pour configurer l'application. L'utilisateur fonctionnel doit être membre du groupe JazzAdmins.
    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 l'entrepôt de données Derby par défaut, cet avertissement ne s'affiche pas.
    9. Cliquez sur Next.
  10. 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 9, 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.

  11. 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 d'une application sont enregistré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 sur Régénérer l'index. Si vous configurez un environnement entièrement nouveau, il n'est pas nécessaire de 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 tous les serveurs sont définis à la même heure à l'aide du serveur de temps NTP.
  12. Dans la page Finalisation de la configuration pour l'application Lifecycle Project Administration, si le serveur a bloqué la fenêtre en incrustation permettant de finaliser LPA, cliquez sur Autoriser pour autoriser l'enregistrement. 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.
  13. Dans la page Récapitulatif, cliquez sur Terminer pour accéder à la page Administration de Jazz Team Server dans laquelle vous pouvez effectuer des tâches d'administration, telles que la gestion du serveur, des utilisateurs et des licences. Pour plus d'informations, voir Administration de Jazz Team Server.

Commentaires