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

L'exécution d'Apache Tomcat en tant que service Windows peut être utile si vous souhaitez exécuter Jazz Team Server sur un ordinateur qui utilise Microsoft Windows sans vous connecter.

Avant de commencer

Conseil : Pour éviter tout problème, n'utilisez pas d'espaces dans les chemins de fichier. Pour le répertoire Program Files sur les systèmes 32 bits, 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 pour convertir l'emplacement BD en chemin absolu. Remplacez la valeur de la variable nom de l'application par le nom du répertoire d'application approprié (par exemple, jts, ccm, qm, rm) :
  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:/PROGRA~1/IBM/JazzTeamServer/server/conf/<nom de l'application>/derby/repositoryDB. Notez la barre oblique (/) dans le chemin d'accès.
  3. En outre, remplacez 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:/PROGRA~1/IBM/JazzTeamServer/server/conf/jts/derby/warehouseDB. Notez la barre oblique (/) dans le chemin d'accès.
Outre l'édition du fichier teamserver.properties, vous devez éditer le fichier log4j.properties afin d'indiquer un nom absolu de chemin de fichier journal. Remplacez la valeur de la variable nom de l'application par les noms de répertoire d'application appropriés (par exemple, jts, ccm, qm, rm, admin) et celle de la variable nom_application.log par le nom de chaque fichier journal d'application approprié (par exemple, jts.log, ccm.log, qm.log, rm.log, admin.log) :
  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_application.log> par log4j.appender.file.File=C:/PROGRA~1/IBM/JazzTeamServer/server/logs/<nom_application.log>. Notez la barre oblique (/) dans le chemin d'accès.
  3. Remplacez l'entrée log4j.appender.etl.File=logs/<app name.log> en log4j.appender.etl.File=C:/PROGRA~1/IBM/JazzTeamServer/server/logs/<app name.log>. Notez la barre oblique (/) dans le chemin d'accès.

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 et redémarrez le système. Pour définir la variable :
    1. Cliquez sur Démarrer > Panneau de configuration > Système.
    2. Cliquez sur l'onglet Options avancées, puis sélectionnez Variables d'environnement.
    3. Sous Variables système, cliquez sur Nouvelle.
    4. Dans Nom de variable, entrez CATALINA_HOME et dans valeur de variable, entrez C:\<RépInstallJazz>\server\tomcat.
  2. Ouvrez une invite de commande et exécutez la commande ci-après pour installer le service Tomcat:
    <RépInstallJazz>\server\tomcat\bin\service.bat install tomcat5
  3. Exécutez <JazzInstallDir>\server\tomcat\bin\tomcat5w.exe pour configurer ce service.
    Remarque : Sur les systèmes d'exploitation Windows disposant d'un compte UAC tels que le schell de commande Windows 7, doit être exécuté entre administrateur.
  4. Cliquez sur l'onglet Java, puis décochez la case Utiliser la valeur par défaut.
  5. 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
  6. Ajoutez les lignes suivantes à la fin de la zone de texte Options Java :
    -DJAZZ_HOME=file:///C:/<JazzInstallDir>/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=%TEMP%
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/<JazzInstallDir>/server/conf/startup_log4j.properties
    Si vous utilisez la base de données Oracle, ajoutez cette ligne en remplaçant le chemin par l'emplacement du pilote :
    -DORACLE_JDBC_DRIVER_FILE=[Path to the ojdbc5.jar file.]
    Si vous utilisez la base de données SQL Server avec JRE 6.0, ajoutez cette ligne en remplaçant le chemin d'accès par l'emplacement du pilote :
    -DSQLSERVER_JDBC_DRIVER_FILE=[Path to the sqljdbc4.jar file.]
    Si vous utilisez la base de données SQL Server avec JRE 5.0, ajoutez cette ligne en remplaçant le chemin d'accès par l'emplacement du pilote :
    -DSQLSERVER_JDBC_DRIVER_FILE=[Path to the sqljdbc.jar file.]
  7. Indiquez une taille de pool de mémoire maximal de 1200.
  8. Dans les pages Démarrage et Arrêt, vérifiez que jvm est sélectionné pour le paramètre Mode.
  9. 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.
  10. Démarrez le service pour tester le serveur.

Commentaires