Mettre en place un serveur Tomcat pour Rational Engineering Lifecycle Manager

Le déploiement et le démarrage de Jazz Team Server commence par la sélection du serveur d'applications qui héberge Jazz Team Server et ses applications.

Pourquoi et quand exécuter cette tâche

Le déploiement et le démarrage de Jazz Team Server commence par la sélection du serveur d'applications qui héberge Jazz Team Server et ses applications.

Si vous envisagez d'utiliser le serveur d'applications Apache Tomcat inclus comme environnement d'hébergement de Jazz Team Server, cliquez sur le lien de déploiement et de démarrage du serveur Apache Tomcat server.

Si vous envisagez d'utiliser IBM® WebSphere Application Service comme environnement d'hébergement, cliquez sur le lien de déploiement et de démarrage de WebSphere Application Server.

Résolution d'une erreur lors du démarrage du serveur RM en mode sans interface graphique sur Linux. L'application RM comprend un convertisseur qui fournit un rendu visuel des artefacts graphiques, tels que les diagrammes de processus métier, les diagrammes de cas d'utilisation, les pièces détachées, les esquisses, les storyboards et les flux d'écran. Le convertisseur s'exécute sur le serveur. Lors du démarrage du serveur RM en mode sans interface graphique (console) sur Linux, l'action échoue sans avertissement et une erreur CRRRW8010E se produit. Dans ce cas, vous devez arrêter le processus Java™ et exécuter une action corrective pour pouvoir lancer le serveur. Pour plus d'informations, voir la page Wiki suivante : https://jazz.net/wiki/bin/view/Main/RRCConverterTroubleshooting.

Exécution dans Apache Tomcat en tant que service Windows (64 bits)

Pour exécuter Jazz Team Server en tant que service sur un ordinateur 64 bits, vous devez configurer la version 64 bits de Tomcat fournie avec Jazz Team Server.

Avant de commencer

Conseil : Pour éviter tout problème, n'utilisez pas d'espaces dans les chemins de fichier. Par exemple, pour le répertoire Program Files, vous pouvez utiliser PROGRA~1.
Si vous utilisez la base de données Derby pour votre référentiel Jazz, modifiez le fichier teamserver.properties pour chaque application en spécifiant pour les emplacements de base de données un chemin d'accès. Remplacez la valeur de la variable nom de l'application par le nom du répertoire d'application approprié (par exemple, jts, ccm, qm). Dans les exemples ci-dessous, répertoire_installation_Jazz fait référence à l'emplacement où Jazz Team Server est installé.
  1. Ouvrez le fichier rép_install_Jazz\server\conf\nom_application\teamserver.properties.
  2. Remplacez l'entrée com.ibm.team.repository.db.jdbc.location=conf/nom de l'application/derby/repositoryDB par com.ibm.team.repository.db.jdbc.location=C:/répertoire_installation_Jazz/server/conf/nom de l'application/derby/repositoryDB. Notez la barre oblique (/) dans le chemin d'accès.
  3. Remplacez également l'entrée com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/conf/jts/derby/warehouseDB par com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/C:/répertoire_installation_Jazz/server/conf/jts/derby/warehouseDB pour les applications. Remplacez l'entrée com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB par com.ibm.team.datawarehouse.db.jdbc.location=C:/répertoire_installation_Jazz/server/conf/jts/derby/warehouseDB pour JTS. Notez la barre oblique (/) dans le chemin d'accès.
Outre la modification du fichier teamserver.properties, vous devez également modifier le fichier log4j.properties en spécifiant un nom de chemin d'accès absolu au fichier journal. Remplacez la variable nom de l'application par les noms de répertoire d'application appropriés, par exemple, jts, ccm, qm, rm, admin. Remplacez les valeurs des variables nom de l'application.log et nom de l'application-etl.log par chaque nom de fichier journal d'application approprié, par exemple jts.log, ccm.log, qm.log, rm.log, admin.log et jts-etl.log, ccm-etl.log, qm-etl.log (il n'y pas de fichier *-etl.log pour admin et rm) :
  1. Ouvrez le fichier rép_install_Jazz\server\conf\nom_application\log4j.properties.
  2. Remplacez l'entrée log4j.appender.file.File=logs/nom de l'application.log par log4j.appender.file.File=C:/répertoire_installation_Jazz/server/logs/appName.log. Notez la barre oblique (/) dans le chemin d'accès.
  3. Remplacez l'entrée log4j.appender.etl.File=logs/nom de l'application-etl.log par log4j.appender.etl.File=C:/répertoire_installation_Jazz/server/logs/nom de l'application-etl.log. Notez la barre oblique (/) dans le chemin d'accès.
Remarque : Si vous ignorez cette étape et n'indiquez pas de chemins pour les fichiers journaux, les fichiers journaux sont placés dans le répertoire par défaut Windows. Par exemple, sous Windows 7, le répertoire des journaux est C:\Windows\System32\LogFiles.

Vérifiez que le service n'est pas installé. Si le service est installé, désinstallez-le, puis redémarrez l'ordinateur. Installez ensuite le nouveau service.

Procédure

  1. Définissez la variable CATALINA_HOME en effectuant les opérations suivantes :
    1. Dans le panneau de configuration Windows, ouvrez la fenêtre Propriétés système.
    2. Cliquez sur l'onglet Avancé, puis sur Variables d'environnement.
    3. Sous Variables d'environnement, cliquez sur Nouvelle.
    4. Dans Nom de la variable entrez CATALINA_HOME et dans Valeur de la variable entrez C:\rép_install_Jazz\server\tomcat.
  2. Redémarrez le serveur pour appliquer la variable.
  3. Ouvrez une invite de commande et installez le nouveau service 64 bits en accédant au répertoire répertoire_installation_Jazz\server\tomcat\bin et en tapant la commande suivante :

    service.bat install tomcat7.

    Remarque : Sur les systèmes d'exploitation Windows disposant d'un compte UAC tels que le shell de commande Windows 7, doit être exécuté entre administrateur.
  4. Exécutez le programme répertoire_installation_Jazz\server\tomcat\bin\tomcat7w.exe pour configurer le service.
  5. Cliquez sur l'onglet Java, puis décochez la case Utiliser la valeur par défaut.
  6. Ajoutez le chemin d'accès suivant à la Machine virtuelle Java. Vous pouvez également cliquer sur l'icône en points de suspension pour rechercher le fichier jvm.dll.
    RépInstallJazz\server\jre\bin\j9vm\jvm.dll
  7. Ajoutez les lignes suivantes à la fin de la zone de texte Options Java :
    Remarque : Le chemin de -DJAZZ_HOME et -Dlog4j.configuration doit être un chemin d'URL. Notez les trois barres obliques (///) après "file:" et les barres obliques dans le chemin. Le chemin de répertoire_temporaire doit être un chemin absolu.
    -DJAZZ_HOME=file:///C:/répertoire_installation_Jazz/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=C:\répertoire_installation_Jazz\server\tomcat\temp
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/répertoire_installation_Jazz/server/conf/startup_log4j.properties
    -Xmx4g
    -Xms4g
    -Xgcpolicy:gencon
    -Xcompressedrefs 
    Si votre serveur Jazz Team Server est installé sur une plateforme Windows et que vous utilisez DB2 comme serveur de base de données z/OS, ajoutez cette ligne pour remplacer le chemin par l'emplacement du pilote.
    Remarque : Le chemin du pilote doit être un chemin de fichier avec une barre oblique.
    -DDB2Z_JDBC=D:/répertoire_installation_Jazz/server/db2z
    Si vous utilisez la base de données Oracle, ajoutez cette ligne en remplaçant par l'emplacement du pilote.
    Remarque : Le chemin du pilote doit être un chemin de fichier.
    -DORACLE_JDBC_DRIVER_FILE=C:\emplacement_OJDBC\ojdbc6.jar
    Si vous utilisez la base de données SQL Server, ajoutez cette ligne en remplaçant le chemin par l'emplacement du pilote.
    Remarque : Le chemin du pilote doit être un chemin de fichier.
    -DSQLSERVER_JDBC_DRIVER_FILE=C:\emplacement_JDBC_SQL\sqljdbc4.jar
  8. Dans Pool de mémoire maximum, indiquez une taille de 4000.
  9. Dans les pages Démarrage et Arrêt, vérifiez que jvm est sélectionné pour le paramètre Mode.
  10. Cliquez sur l'onglet Général et modifiez le Type de démarrage en Automatique pour lancer automatiquement le service au démarrage de Windows.
  11. Une fois que le service est démarré, vérifiez que le serveur est actif en vous y connectant à partir de votre navigateur.

Commentaires