Contenu d'installation commun - Fichier Content Reference

Apache Tomcat a été installé dans le répertoire JazzInstallDir/server/tomcat. L'application Web (jazz.war) a été installée dans le répertoire Apache Tomcat webapps. Dans une fenêtre de commande, établissez votre répertoire en cours dans JazzInstallDir/server. Les scripts de configuration et d'arrêt du serveur se trouvent dans ce répertoire.
  • Si vous souhaitez exécuter les scripts de démarrage et d'arrêt à partir d'un autre répertoire, vous devez modifier le fichier profiles.ini dans JazzInstallDir/server/conf/jazz/provision_profiles pour utiliser le chemin d'accès absolu. Voir Modification des fichiers profile.ini et license_profile.ini.
  • Apache Tomcat est configuré pour utiliser les ports 9080 et 9443 dans le fichier JazzInstallDir/server/tomcat/conf/server.xml. Le cas échéant, modifiez-les en fonction de votre système. Si nécessaire, mettez également à jour les paramètres de configuration des ports HTTP de référentiel du serveur Jazz dans la page de configuration concernant les propriétés avancées de l'interface utilisateur Web de l'administrateur Jazz.
  • Le répertoire JazzInstallDir/server/logs contient les fichiers journaux du serveur. Consultez-les si vous avez des difficultés à démarrer le serveur.
  • Le fichier JazzInstallDir/server/tomcat/conf/server.xml contient les paramètres SSL qui spécifient un algorithme uniquement disponible dans l'environnement JRE IBM. Pour exécuter le serveur avec un environnement JRE Sun, dans le fichier server.xml, modifiez les paramètres de Connector port="9443", de sorte que sslProtocol="TLS" au lieu de "SSL". Supprimez également le paramètre d'algorithme.

Jazz Team Server, le client Rational Team Concert, Build System Toolkit, ClearCase Connector , ClearQuest Connector et d'autres fichiers d'incubateur peuvent être téléchargés à partir de http://jazz.net. Pour vous procurer Rational Team Concert, accédez au site Web http://www.ibm.com/software/awdtools/rtc/, dans lequel vous pouvez télécharger une image installable ou commander un DVD.

Installations à l'aide d'Installation Manager

Cette procédure et ces remarques concernent un chemin d'installation Installation Manager

Avant de commencer

A propos de cette tâche

Si vous utilisez IBM Installation Manager, notez le répertoire d'installation sur la page Emplacement lors du processus d'installation. Le répertoire s'appelle JazzInstallDir.

  • Installation Web d'Installation Manager pour le client, le serveur et les composants facultatifs : ce fichier archive contient les emplacements du programme Installation Manager et du répertoire d'installation prédéfini. Il s'agit d'un fichier auto-extractible qui lance le programme IBM Installation Manager après l'extraction du contenu. Le module d'installation Web présente l'avantage de réduire la taille du téléchargement initial, le processus d'installation ne téléchargeant que les ressources que vous souhaitez installer.
    Remarque : L'installation Web requiert une connexion Internet lors du processus d'installation.
  • Fichier .zip Full DVD Contents : ce fichier archive contient le programme Installation Manager et une copie locale de toutes les ressources installables. L'utilisation du module d'installation local présente l'avantage de permettre l'installation sans connexion Internet. Il ne s'agit pas un fichier .zip d'auto-extraction.
  • Fichier .zip Client CD Contents - Installation locale d'Installation Manager pour le client : ce fichier archive contient le programme Installation Manager et une copie locale du client Rational Team Concert. L'utilisation du module d'installation local présente l'avantage de permettre l'installation sans connexion Internet. Ce fichier .zip n'est pas auto-extractible.
  • Installation Web d'Installation Manager pour le client, le serveur et les composants facultatifs : ce fichier archive contient les emplacements du programme Installation Manager et du répertoire d'installation prédéfini. Il s'agit d'un fichier auto-extractible qui va démarrer le programme IBM Installation Manager après l'extraction du contenu. Le module d'installation Web présente l'avantage de limiter le téléchargement initial, le processus d'installation ne téléchargeant que les ressources que vous avez choisi d'installer.
    Remarque : L'installation Web requiert une connexion Internet lors du processus d'installation.
  • Fichier .zip Full DVD Contents : ce fichier archive contient le programme Installation Manager et une copie locale de toutes les ressources installables. L'utilisation du module d'installation local présente l'avantage de permettre l'installation sans connexion Internet. Ce fichier .zip n'est pas auto-extractible.

Procédure

  1. Démarrez le programme de tableau de bord.

    Si Installation Manager ne fonctionne pas, démarrez-le.

    Remarque : Vous devez détenir les droits d'administrateur pour exécuter le tableau de bord.
    • Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire et un tableau de bord s'affiche.
      • Pour exécuter le fichier sous Windows, exécutez la commande suivante :
        RTC-édition-Full-version-Win-Web.exe
      • Pour exécuter le fichier sous Linux, exécutez la commande suivante :
        sh RTC-édition-Full-version-Linux-Web.sh
    • Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord.
      • Pour exécuter le fichier sous Windows, exécutez la commande suivante :
        launchpad.exe
      • Pour exécuter le fichier sous Linux, exécutez la commande suivante :
        sh launchpad.sh
  2. Démarrez le programme de tableau de bord.

    Si Installation Manager ne fonctionne pas, procédez comme suit pour le démarrer.

    Remarque : Vous devez détenir les droits d'administrateur pour exécuter le tableau de bord.
    Remarque : Les commandes Linux permettant de démarrer le programme de tableau de bord ne sont valables que pour Rational Team Concert pour l'environnement IDE Eclipse.
    Pour démarrer le fichier du tableau de bord sur :
    • Si vous utilisez le fichier .zip Client CD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord. Pour démarrer le fichier du tableau de bord sur :
      • Pour exécuter le fichier sous Windows, exécutez la commande suivante :
        launchpad.exe
      • Pour exécuter le fichier sous Linux, exécutez la commande suivante :
        sh launchpad.sh
    • Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire et un tableau de bord s'affiche. Pour lancer le fichier exécutable sur :
      • Pour exécuter le fichier sous Windows, exécutez la commande suivante :
        RTC-édition-Full-version-Win-Web.exe
      • Pour exécuter le fichier sous Linux, exécutez la commande suivante :
        sh RTC-édition-Full-version-Linux-Web.sh
    • Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord. Pour démarrer le fichier du tableau de bord sur :
      • Pour exécuter le fichier sous Windows, exécutez la commande suivante :
        launchpad.exe
      • Pour exécuter le fichier sous Linux, exécutez la commande suivante :
        sh launchpad.sh

Installations à l'aide du fichier .zip

Les éléments ci-dessous sont utilisés pour procéder à une installation à l'aide d'un fichier .zip.

task_context

Remarque : Si vous utilisez les fichiers archives compressés pour procéder à l'installation, notez le répertoire dans lequel vous allez extraire les fichiers. Le répertoire s'appelle JazzInstallDir dans les étapes à venir.

Procédure

  1. Téléchargez le/les fichier(s) sur votre ordinateur.
    • Téléchargez le fichier .zip du serveur
    • Téléchargez le fichier .zip du client
    • Facultatif : téléchargez le fichier .zip de la génération
    • Facultatif : téléchargez le/les fichier(s) .zip du connecteur
  2. Extrayez le contenu du module vers votre système de fichiers.
    Remarque : A l'issue de l'extraction des fichiers, il est recommandé de choisir un emplacement proche de la racine du système de fichiers. Les noms de chemin trop longs peuvent être à l'origine d'avertissements inutiles. Par exemple, extrayez les fichiers dans c:\IBM sous Windows® ou dans /opt/IBM sous Linux®.

Installations du client

task_context

Remarque : Si vous souhaitez installer le client dans un plan de travail Eclipse existant, utilisez IBM Installation Manager. IBM Installation Manager vous invite à choisir le plan de travail que vous souhaitez étendre et à gérer les futures mises à jour, annulations et modifications du plan de travail
Identification et résolution des incidents : ici vous sont proposées quelques techniques de gestion des incidents.
  • Commencez avec un espace de travail vide.
  • Les générations du client et du serveur doivent correspondre. Vérifiez les correspondances d'ID génération pour les distributions du client et du serveur.
  • Vérifiez que le serveur est en cours de fonctionnement. Confirmez l'URL de l'état : https://example.com:9443/jazz.
  • Sous Linux, si vous ne souhaitez pas démarrer le client à partir du répertoire JazzInstallDir/client/eclipse, vous devez modifier tous les fichiers dans JazzInstallDir/client/eclipse/links/ et inclure le chemin d'accès absolu vers le répertoire nommé. Par défaut, les chemins relatifs sont utilisés. Par exemple, JazzInstallDir/client/eclipse/links/build.link contient le texte "path=jazz/build". Si votre client est installé dans le répertoire /home/username/teamconcert, éditez le fichier de la manière suivante : "path=/home/username/teamconcert/jazz/client/eclipse/build".

Procédure


  1. Connectez-vous au serveur. Le moyen le plus facile de se connecter à un serveur consiste à utiliser une invitation d'équipe. Si vous ne disposez d'aucune invitation, vous pouvez vous connecter manuellement.
    1. Cliquez sur Fichier > Accepter une invitation d'équipe. L'assistant vous accompagne tout au long du processus.
      Remarque : Si vous ne disposez d'aucune invitation, vous avez besoin de l'URI ou de l'URL de l'administrateur de serveur. (https://example.com:9443/jazz, par exemple). Cliquez sur le lien hypertexte de connexion à une zone de projet existante qui apparaît dans le coin inférieur droit de la fenêtre Accepter une invitation d'équipe.
    2. Suivez les instructions de l'assistant pour configurer votre connexion.

Conref d'installation divers

task_context

Important : L'utilisation de Jazz Team Server avec une base de données Derby permet de prendre en charge jusqu'à 10 utilisateurs. Pour prendre en charge plus de 10 utilisateurs, utilisez une base de données DB2® Workgroup Server, DB2, Oracle ou Microsoft SQL Server. DB2 Workgroup Server est inclus dans les modules d'installation des éditions Enterprise, Standard et Express lorsque vous utilisez IBM Installation Manager. Si vous utilisez la méthode d'installation à l'aide du fichier .zip, le téléchargement DB2 Workgroup Server est disponible sur le même site que celui de Rational Team Concert. Une fois DB2 Workgroup Server installé, vous devez le configurer comme indiqué dans le manuel de configuration de l'installation.

Lors de la sauvegarde des fichiers de propriétés, l'application procède toujours à une copie de sauvegarde de la version précédente dans le même répertoire. Si vous souhaitez supprimer tous les fichiers contenant le mot de passe en texte clair, supprimez les fichiers de propriétés de sauvegarde à l'issue de la première configuration du serveur.

Remarque : Si vous prévoyez d'utiliser un serveur d'applications existant à la place du serveur Apache Tomcat inclus, décochez la case du module Apache Tomcat. Pour ce faire, installez uniquement les fichiers requis à utiliser avec votre serveur d'applications existant. Installation Manager vous invite à choisir l'emplacement d'installation de ces fichiers.
Remarque : Malgré la présence d'une base de données Derby dans la configuration par défaut ne nécessitant pas d'installation, cette base de données ne peut pas prendre en charge plus de 10 utilisateurs. Si vous souhaitez prendre en charge plus de 10 utilisateurs et n'avez accès à aucune base de données DB2 ou Oracle, installez l'édition DB2 Workgroup Server regroupée.

Si vous installez DB2 Workgroup Server, enregistrez l'ID utilisateur, le mot de passe et le numéro de port. Vous aurez besoin de ces informations plus tard. L'acceptation des valeurs par défaut lors de l'installation permet de simplifier la configuration de Jazz Team Server.

Démarrage du serveur

task_context

Si vous prévoyez d'utiliser le serveur d'applications Apache Tomcat inclus, vous êtes prêt à démarrer Jazz Team Server.

Si vous prévoyez d'utiliser WebSphere® Application Server, configurez votre environnement de serveur comme indiqué dans Configuration de WebSphere Application Server.

Si vous prévoyez d'utiliser WebSphere Application Server, configurez votre environnement de serveur comme indiqué dans la rubrique Configuration d'un système WebSphere Application Server.

Démarrage du serveur Apache Tomcat

Vous êtes désormais prêt à démarrer le serveur Apache Tomcat.
Apache Tomcat a été installé dans le répertoire JazzInstallDir/server/tomcat. L'application Web (jazz.war) a été installée dans le répertoire Apache Tomcat webapps. Dans une fenêtre de commande, établissez votre répertoire en cours dans JazzInstallDir/server. Les scripts de configuration et d'arrêt du serveur se trouvent dans ce répertoire.
  • Si vous souhaitez exécuter les scripts de démarrage et d'arrêt à partir d'un autre répertoire, vous devez modifier le fichier profiles.ini dans JazzInstallDir/server/conf/jazz/provision_profiles pour utiliser le chemin d'accès absolu. Voir Modification des fichiers profile.ini et license_profile.ini.
  • Apache Tomcat est configuré pour utiliser les ports 9080 et 9443 dans le fichier JazzInstallDir/server/tomcat/conf/server.xml. Le cas échéant, modifiez-les en fonction de votre système. Si nécessaire, mettez également à jour les paramètres de configuration des ports HTTP de référentiel du serveur Jazz dans la page de configuration concernant les propriétés avancées de l'interface utilisateur Web de l'administrateur Jazz.
  • Le répertoire JazzInstallDir/server/logs contient les fichiers journaux du serveur. Consultez-les si vous avez des difficultés à démarrer le serveur.
  • Le fichier JazzInstallDir/server/tomcat/conf/server.xml contient les paramètres SSL qui spécifient un algorithme uniquement disponible dans l'environnement JRE IBM. Pour exécuter le serveur avec un environnement JRE Sun, dans le fichier server.xml, modifiez les paramètres de Connector port="9443", de sorte que sslProtocol="TLS" au lieu de "SSL". Supprimez également le paramètre d'algorithme.

Démarrage du serveur sous Windows

Exécutez le fichier d'initialisation pour démarrer votre serveur sous Windows.

A propos de cette tâche

Procédure

  1. Pour démarrer le serveur, à partir du répertoire JazzInstallDir/server, exécutez la commande suivante :
    server.startup.bat
    Remarque : Une fenêtre console Apache Tomcat distincte s'ouvre. Ne la fermez pas ou le serveur cessera de fonctionner. De même, plusieurs messages d'information s'affichent, notamment un message concernant la bibliothèque native d'Apache Tomcat. Ces messages d'information n'ont aucun impact sur le fonctionnement de Jazz Team Server.
  2. Pour arrêter le serveur, à partir du répertoire JazzInstallDir/server, exécutez la commande suivante :
    server.shutdown.bat

Que faire ensuite

Remarque : L'exemple ci-dessus exécute les scripts de démarrage et d'arrêt directement à partir du répertoire JazzInstallDir/server. Si vous avez installé Jazz Team Server à l'aide d'IBM® Installation Manager, vous pouvez également exécuter les commandes à partir du menu de démarrage Windows de Jazz Team Server.

Une fois le serveur démarré, passez à la section Exécution de l'assistant de configuration.

Démarrage du serveur sous Linux

Exécutez le fichier d'initialisation suivant pour démarrer ou arrêter votre serveur sous Linux.

A propos de cette tâche

Procédure

  1. Pour démarrer le serveur, à partir du répertoire JazzInstallDir/server, en tant qu'utilisateur racine, exécutez la commande suivante :
    ./server.startup
    Si votre ID utilisateur détient les droits administrateur, exécutez la commande suivante :
    sudo ./server.startup

    Un fenêtre console Apache Tomcat distincte n'est pas visible. Vous pouvez suivre le déroulement du démarrage du serveur en affichant le fichier journal dans JazzInstallDir/server/logs/jazz.log.

  2. Pour arrêter le serveur, à partir du répertoire JazzInstallDir/server, en tant qu'utilisateur racine, exécutez la commande suivante :
    ./server.shutdown
    Si votre ID utilisateur détient les droits administrateur, exécutez la commande suivante :
    sudo ./server.shutdown

Que faire ensuite

Remarque : Cet exemple exécute les scripts de démarrage et d'arrêt directement à partir du répertoire JazzInstallDir/server. Si vous avez installé Jazz Team Server à l'aide d'IBM Installation Manager, vous pouvez également exécuter les commandes à partir du menu de démarrage de l'application Jazz Team Server.

Une fois créé le serveur, passez à la section Exécution de l'assistant de configuration.

Configuration d'un système WebSphere Application Server

Cette rubrique explique comment configurer Jazz Team Server pour travailler avec WebSphere Application Server. Cette configuration suppose d'installer Jazz Team Server sur le même poste que Websphere Application Server. Les instructions reposent sur WebSphere Application Server version 6.1.0.23. Il existe de légères différences pour la version 7.0.0.7 et les versions ultérieures. Ces différences sont précisées dans le texte, le cas échéant.

Avant de commencer

Avant d'entamer cette procédure, vérifiez que les étapes suivantes ont été réalisées :
  • WebSphere Application Server est déjà installé.
  • La base de données a été créée et ses paramètres ont été utilisés pour mettre à jour le fichier teamserver.properties.
  • Activation de la connexion tenant compte de la casse (facultatif) : si la méthode d'authentification du serveur d'applications permet d'utiliser les connexions tenant compte de la casse, vous pouvez indiquer à l'application Jazz de les accepter également. Vous pouvez activer cette fonction via la propriété "Utiliser la correspondance des ID utilisateur sans respect de la casse" dans la page des propriétés avancées de l'interface utilisateur Web d'administration. Le paramètre par défaut ne change pas ; les administrateurs doivent changer explicitement cette propriété pour activer la fonction.
  • L'option Sécurité Java™ 2 doit être désactivée. Si cette option est activée dans WebSphere Application Server, le démarrage de Jazz Team Server .war n'aboutit pas.
  • Vérifiez que le paramètre de sécurité WAS "Utiliser les données d'authentification disponibles quand un URI non protégé est accédé" est coché. Si vous utilisez WAS Integrated Solutions Console, vous pouvez procéder comme suit :
    1. Accédez à Sécurité -> Administration, applications et infrastructure sécurisées -> Sécurité Web - Paramètres généraux. (Dans WAS 7.0.0.7, accédez à Sécurité -> Sécurité globale -> Web et sécurité SIP -> Paramètres généraux.)
    2. Cochez la case "Utiliser les données d'authentification disponibles quand un URI non protégé est accédé".
  • Jazz Team Server inclut les fichiers nécessaires à l'exécution complète du serveur Apache Tomcat. Pour installer WebSphere, vous avez simplement besoin d'un sous-ensemble de fichiers Jazz Team Server que vous placez dans un répertoire de votre machine serveur WebSphere. D'autres instructions le nomment répertoire d'installation Jazz Team Server (ou JazzInstallDir en abrégé). A partir de ce répertoire, utilisez :
    • le fichier JazzInstallDir/server/tomcat/webapps/jazz.war.
    • le répertoire JazzInstallDir/server/update-site.
    • le répertoire JazzInstallDir/server/conf.
    • la base de données de référentiel par défaut dans JazzInstallDir/repositoryDB.
    • les outils de référentiel dans JazzInstallDir/repotools.
    • le répertoire JazzInstallDirserver/license-update-site.
    • le répertoire JazzInstallDir/server/nl1-update-site.
    • le répertoire JazzInstallDir/server/nl2-update-site.
Conseil : Si vous utilisez IBM Installation Manager pour installer Jazz Team Server afin de l'utiliser avec Rational Team Concert, les fichiers Jazz Team Server peuvent être installés dans un répertoire d'application Web. Lors du processus d'installation, il est recommandé de ne pas installer le serveur d'applications Apache Tomcat inclus. En effet, Installation Manager risque de demander un répertoire d'application Web et de n'installer que les fichiers nécessaires à WebSphere. Le répertoire par défaut est C:\Program Files\IBM\JazzTeamServer sous Windows ou /opt/IBM/JazzTeamServer sous Linux. Dans cette procédure, le répertoire d'installation s'appelle JazzInstallDir. Si vous utilisez IBM Installation Manager pour installer les fichiers dans le répertoire des applications Web de WebSphere Application Server, il n'est pas utile de déplacer manuellement le fichiers comme indiqué ci-dessus.

A propos de cette tâche

Remarque : Ce document n'explique pas comment configurer l'authentification WebSphere ou SSL, qui est une rubrique complexe. Des informations détaillées relatives aux différentes options d'authentification et de chiffrement de WebSphere sont présentées dans le centre de documentation de WebSphere. Pour plus d'informations, accédez à WebSphere Information Center et recherchez Securing applications and their environment. L'interface utilisateur Web Jazz requiert de configurer l'authentification afin de procéder aux autorisations et de personnaliser l'application.

Procédure

  1. Examinez et mettez à jour l'emplacement de la base de données du fichier teamserver.properties.
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Remarque : Il s'agit d'un exemple de configuration de DB2. Le fichier teamserver.properties doit être mis à jour en fonction du fournisseur de base de données (Oracle/MS-SQL).
  2. Vérifiez ou mettez à jour le niveau WebSphere Application Server.

    Jazz Team Server requiert WebSphere Application Server version 6.1 avec le groupe de correctifs IBM Java SDK 1.5 SR5 ou ultérieur, ou WebSphere Application Server version 7.0 avec au moins la version 7.0.0.7. La mise à jour d'IBM Java SDK 1.5 SR6 SDK est disponible dans http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Avec WebSphere 6.1 et GA IBM Java SDK, Jazz commence à rapporter les "erreurs de proxy" après un certain nombre d'opérations.

    Vous devez vous procurer les correctifs Internet WebSphere Application Server des correctifs d'IBM Java SDK 1.5 SR9 ou IBM Java SDK 1.6 SR4 nécessaires pour qu'IBM Rational Team Concert 2.0 fonctionne correctement. Si vous ne le faites pas, certains services du serveur risquent de ne pas démarrer correctement. Le correctifs sont disponibles dans les APAR WebSphere Application Server correspondants. Pour IBM Java SDK 1.5/WebSphere Application Server 6.1, le correctif APAR est PK85942 et vous pouvez télécharger les fichiers à partir du site 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/WebSphere Application Server 7.0, le correctif APAR est PK 86771 et vous pouvez télécharger les fichiers à partir du site ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Mettez à jour les arguments JVM.

    Jazz Team Server a besoin de certains paramètres spécifiques sur la machine virtuelle Java dans laquelle ils sont exécutés.

    La première propriété à définir dans les arguments JVM génériques est la valeur d'allocation de mémoire maximale par défaut, à l'aide du paramètre -Xmx. Cette valeur doit être définie en fonction de la taille de l'équipe prise en charge par le serveur et de la capacité de mémoire du serveur sur lequel Jazz Team Server fonctionne. Une équipe de taille moyenne peut utiliser la valeur -Xmx1536M, en fournissant une mémoire instantanée de 1 536 Mo au processus Jazz Team Server.

    Une seconde propriété à définir dans les arguments JVM génériques, spécifiquement pour Rational Quality Manager, est la taille de la pile de l'unité d'exécution. Une taille de pile standard pour Rational Quality Manager est -Xss786K.

    Si vous vous connectez à une base de données Oracle ou SQL Server, vous devez ajouter une propriété appelée "ORACLE_JDBC" ou "SQLSERVER_JDBC". Attribuez à la propriété le chemin d'accès absolu au fichier (par l'URL) des pilotes de périphérique JDBC appropriés.

    Les exemples ci-après illustrent les arguments JVM génériques permettant de se connecter aux bases de données Oracle et SQL Server, avec la valeur d'allocation de mémoire maximale par défaut et la taille de la pile de l'unité d'exécution. Remplacez JazzInstallDir par le répertoire de votre installation Jazz Team Server.

    -DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k

    Plusieurs autres propriétés système doivent être définies pour contrôler certains comportements du serveur. Ces propriétés sont incluses ci-après. Voici les caractéristiques de définition de ces propriétés JVM dans la console d'administration WebSphere Administrative Console. Remplacez JazzInstallDir par le répertoire de votre installation Jazz Team Server :

    1. Cliquez sur Serveurs > Serveurs d'applications.
    2. Cliquez sur server1.
    3. Cliquez sur Gestion des processus et Java > Définition des processus.
    4. Cliquez sur Machine virtuelle Java.
    5. Ajoutez la valeur 100 dans la zone Initial Heap (Segment mémoire initial).
    6. Ajoutez la valeur 1000 dans la zone Taille maximum de la pile.
    7. Cliquez sur Appliquer.
    8. Cliquez sur Logging and Tracing (Consignation et traçage). Cliquez sur Change Log Detail Levels (Modifier les niveaux de détails du journal). Le Jazz Team Server utilise le moteur de génération de rapports BIRT. Pour empêcher que les entrées d'information BIRT ne soient écrites dans le fichier journal WebSphere, définissez le niveau de consignation des modules org.eclipse.birt.* sur grave. Cliquez sur Appliquer.
    9. Cliquez sur Serveurs d'applications > {nom_serveur} > Définition des processus > Machine virtuelle Java > Propriétés personnalisées. L'une des propriétés personnalisées que vous devez ajouter est JAZZ_HOME, une propriété système qui indique l'emplacement de certains fichiers de configuration. Cette propriété utilise une adresse URL plutôt qu'un simple chemin d'accès. La valeur doit dont être spécifiée en tant que fichier://-style URL.
    10. Ajoutez les propriétés suivantes : Cliquez sur Nouveau, entrez le Nom et la Valeur, puis cliquez sur OK.
      • Nom : java.awt.headless Valeur : true
      • Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true
      • Nom: JAZZ_HOME Valeur : file///JazzInstallDir/server/conf
    11. Cliquez sur Sauvegarder directement dans la configuration principale.
    Important : Pour Solaris uniquement, vous devez également ajouter l'argument de ligne de commande Java suivant :
    -XX:MaxPermSize=256m
    Pour plus d'informations, voir le chapitre 2, "Configuring a Solaris environment for WebSphere Application Server" dans le redbook IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System.
  4. Redémarrez Websphere pour installer l'application Jazz.
    Dans les exemples de ligne de commande suivantes, WASInstallDir représente l'emplacement dans lequel est installé WebSphere Application Server sur votre serveur.
    • Sous Windows, la valeur par défaut du répertoire d'installation WebSphere est la suivante :
      C:\Program Files\IBM\WebSphere\AppServer
      Vous pouvez redémarrer le serveur avec les commandes suivantes sous Windows :
      cd WASInstallDir\bin 
      stopServer.bat server1 [for a secure server, include: -username {utilisateur_LDAP} -password {mot_de_passe_LDAP}] 
      startServer.bat server1
    • Sous Linux, la valeur par défaut du répertoire d'installation WebSphere est la suivante :
      /opt/IBM/WebSphere/AppServer
      Vous pouvez redémarrer le serveur avec les commandes suivantes sous Linux :
      cd WASInstallDir/bin 
      ./stopServer.sh server1 [pour un serveur sécurisé, inclure : -username {utilisateur_LDAP} -password {mot_de_passe_LDAP}] 
      ./startServer.sh server1
    1. Ouvrez la console d'administration de WebSphere Application Server.
    2. Cliquez sur Applications > Installation d'une nouvelle application. (Pour WebSphere Application Server 7.0.0.7 et les versions ultérieures, cliquez sur Applications > Nouvelle application > Nouvelle application d'entreprise. )
    3. Sous Chemin d'accès, cliquez sur Chemin d'accès au système de fichiers local.
    4. Sous Chemin d'accès complet, entrez :
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. Attribuez la valeur /jazz à Racine du contexte, puis cliquez sur Suivant.
      Remarque : Cette étape apparaît vers la fin de l'installation dans WebSphere Application Server 7.0.0.7 et les versions ultérieures.
    6. Cliquez sur Suivant et reprenez l'étape Installation d'une nouvelle application restante.
    7. Cliquez sur Terminer.
    8. Vérifiez que l'application jazz_war a été installée et cliquez sur Sauvegarder directement dans la configuration principale.
    9. Cliquez sur Applications > Applications d'entreprise.
    10. Cochez la case en regard de jazz_war, puis cliquez sur Démarrer.

      Une flèche verte apparaît et indique que l'application a bien démarré.

      Remarque : Les étapes restantes ne s'appliquent qu'à Rational Quality Manager.
    11. Vous êtes renvoyé à la page Installation d'une nouvelle application.
    12. 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_Jazz\server\tomcat\webapps\help.war.
    13. 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.
    14. 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.
    15. Cliquez sur Applications > Applications d'entreprise.
    16. Sélectionnez help_ war et cliquez sur Démarrer.

Que faire ensuite

Une fois créé le serveur, passez à la section Exécution de l'assistant de configuration.

Exécution de l'assistant de configuration

L'assistant de configuration vérifie que le serveur fonctionne correctement et vous accompagne tout au long de la procédure de configuration du serveur.

A propos de cette tâche

Pour vérifier que Jazz Team Server se connecte à la base de données, consultez le journal du serveur ou la sortie de la console. Les informations relatives à la connexion et à la base de données sont reprises lors de leur premier accès. Le répertoire JazzInstallDir/server/logs est utilisé pour les fichiers journaux du serveur.

Cette procédure suppose que votre serveur est disponible à l'aide du nom d'hôte, de l'hôte local et des ports par défaut 9443. Le cas échéant, remplacez l'hôte local par le nom d'hôte de votre serveur et remplacez le port 9443.

Procédure

Lancez l'assistant de configuration pour configurer votre serveur. Utilisez l'URL https://localhost:9443/jazz/setup.

Sur le serveur d'applications Apache Tomcat, connectez-vous avec le nom d'utilisateur et le mot de passe par défaut (ADMIN/ADMIN). La casse du nom d'utilisateur et du mot de passe doit être respectée.

Pour le serveur d'applications WebSphere et LDAP, vous devez configurer correctement des mappages d'utilisateurs pour que les utilisateurs du registre d'utilisateurs WAS ou les utilisateurs LDAP soient mappés vers les groupes Jazz correspondants (par exemple, JazzAdmins, JazzUsers, etc.). Une fois que les utilisateurs sont correctement mappés, vous pouvez vous connecter à Jazz Team Server à l'aide de votre compte WAS ou LDAP. Pour plus d'informations, voir Gestion des utilisateurs avec le protocole LDAP.

Choisissez un chemin de configuration. L'assistant de configuration comporte deux chemins principaux.
  • La configuration rapide du chemin d'accès utilise la configuration par défaut. Si vous souhaitez que le serveur s'exécute rapidement, la configuration rapide du chemin d'accès est une bonne option. Lors de la configuration rapide du chemin d'accès, configurez
    • le registre d'utilisateurs.
  • La configuration personnalisée permet de procéder à une configuration détaillée du serveur, y compris la possibilité d'activer les notifications par courrier électronique. Lors de la configuration personnalisée, configurez les éléments suivants :
    • Base de données
    • Notification par courrier électronique
    • Registre d'utilisateurs
    Remarque : Par défaut, le serveur est configuré de manière à utiliser Derby comme base de données. Pour utiliser une autre base de données, telle que DB2, sélectionnez le chemin d'accès de la configuration personnalisée et passez à l'étape 2 : Configuration de la base de données. Si vous n'avez pas créé de tables de base de données, un message vous demande de les créer à la fin du test de la connexion. Si vous choisissez la configuration rapide et que vous n'avez pas créé les tables de base de données, un message vous demande de passer à l'étape 2 et de les créer.

A l'issue de la configuration initiale, des options supplémentaires peuvent être configurées à partir de l'interface utilisateur Web de l'administrateur Jazz Team Server en utilisant l'URL https://localhost:9443/jazz/admin.

Que faire ensuite

Si l'assistant de configuration du serveur ne se charge pas, vérifiez les éléments suivants :
  • Vérifiez que le serveur d'applications a démarré. Utilisez l'URL http://localhost:9080.
  • Vérifiez que Jazz Team Server a démarré en vous connectant à l'interface utilisateur Web de l'administrateur Jazz Team Server à l'aide de l'URL https://localhost:9443/jazz/admin. Si la page ne se charge pas ou que le serveur comporte des erreurs, le serveur ne démarre pas correctement.
  • La racine URI du chemin Jazz Team Server doit être /jazz. Par exemple : https://example.com:9443/jazz doit être utilisé à la place de https://example.com:9443.

Retour d'informations