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é.
- Ouvrez le fichier rép_install_Jazz\server\conf\nom_application\teamserver.properties.
- 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.
- 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) :
- Ouvrez le fichier rép_install_Jazz\server\conf\nom_application\log4j.properties.
- 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.
- 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
- Définissez la variable CATALINA_HOME en effectuant les opérations suivantes :
- Dans le panneau de configuration Windows, ouvrez la fenêtre Propriétés système.
- Cliquez sur l'onglet Avancé, puis sur
Variables d'environnement.
- Sous Variables d'environnement, cliquez sur Nouvelle.
- Dans Nom de la variable entrez CATALINA_HOME et dans
Valeur de la variable entrez C:\rép_install_Jazz\server\tomcat.
- Redémarrez le serveur pour appliquer la variable.
- 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.
- Exécutez le programme répertoire_installation_Jazz\server\tomcat\bin\tomcat7w.exe
pour configurer le service.
- Cliquez sur l'onglet Java, puis décochez la case Utiliser la valeur par défaut.
- 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
- 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
- Dans Pool de mémoire maximum, indiquez une taille de 4000.
- Dans les pages Démarrage et Arrêt,
vérifiez que jvm est sélectionné pour le paramètre Mode.
- 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.
- Une fois que le service est démarré, vérifiez que le serveur est actif en
vous y connectant à partir de votre navigateur.