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 Jazz Team Server est installé sur une plateforme Windows mais que vous utilisez le serveur de base de données DB2 for z/OS, ajoutez la ligne suivante en remplaçant 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