Par défaut, la consignation est activée et le connecteur imprime les erreurs qu'il détecte en cours d'exécution dans le fichier connector.log du répertoire Tomcat_directory/logs. La seule exception est le blueprintLogger qui écrit dans son propre journal blueprint.log qui se trouve dans le même répertoire.
Le traçage fournit des informations supplémentaires sur les opérations du connecteur à des fins de débogage. Par défaut, le traçage est désactivé. Vous pouvez l'activer par le biais d'une console JMX. Si le serveur est correctement configuré, toute console JMX permet d'activer le traçage. Les instructions supposent l'utilisation de jconsole, qui est une console JMX fournie avec le kit SDK Java™.
Le serveur d'applications Tomcat doit être configuré pour accepter les connexions d'une console JMX.
Dcom.sun.management.jmxremote
Dcom.sun.management.jmxremote.port=9004
Dcom.sun.management.jmxremote.authenticate=false
Dcom.sun.management.jmxremote.ssl=false
La première ligne active la connexion JMX distante. La deuxième ligne définit le port sur lequel doivent être écoutées les demandes entrantes de console JMX. Les deux lignes suivantes désactivent l'authentification et le chiffrement, qui peuvent être indésirables dans un environnement de production.
Pour les configurations JMX avancées, consultez la documentation Tomcat située à l'adresse http://Tomcat.apache.org/tomcat-5.5-doc/monitoring.html#Enabling_JMX_Remote
Aucune modification des propriétés JVM WebSphere Application Server n'est nécessaire pour pouvoir utiliser jconsole pour se connecter. Toutefois, vous devez créer un script de démarrage et un fichier de propriétés. Voici un exemple de script de démarrage :
@echo off
set WAS_HOME=C:\PROGRA~2\IBM\SDP\runtimes\base_v7
set HOST=localhost:2809
set PROPS_DIR=c:\temp
:: properties
set PROPS=
set PROPS=%PROPS% -Dcom.ibm.CORBA.ConfigURL=file:/%PROPS_DIR%/sas.client.props
set PROPS=%PROPS% -Djava.naming.provider.url=corbaname:iiop:%HOST%
:: classpath
set CLASSPATH=
set CLASSPATH=%CLASSPATH%;%WAS_HOME%\java\lib\tools.jar
set CLASSPATH=%CLASSPATH%;%WAS_HOME%\runtimes\com.ibm.ws.admin.client_7.0.0.jar
set CLASSPATH=%CLASSPATH%;%WAS_HOME%\runtimes\com.ibm.ws.ejb.thinclient_7.0.0.jar
set CLASSPATH=%CLASSPATH%;%WAS_HOME%\runtimes\com.ibm.ws.orb_7.0.0.jar
set CLASSPATH=%CLASSPATH%;%WAS_HOME%\java\lib\jconsole.jar
:: start jconsole using was jdk
start %WAS_HOME%\java\bin\javaw.exe -classpath %CLASSPATH% %PROPS% sun.tools.jconsole.JConsole service:jmx:iiop://%HOST%/jndi/JMXConnector
Le script exemple est un script Windows .bat. Vous devez remplacer les valeurs de WAS_HOME par le chemin 8.3 du répertoire d'installation de votre WebSphere Application et de PROPS_DIR par le répertoire qui contient le fichier de propriété suivant, intitulé sas.client.props :
com.ibm.CORBA.securityEnabled=true
com.ibm.CORBA.authenticationTarget=BasicAuth
com.ibm.CORBA.authenticationRetryEnabled=true
com.ibm.CORBA.authenticationRetryCount=3
com.ibm.CORBA.validateBasicAuth=true
com.ibm.CORBA.securityServerHost=
com.ibm.CORBA.securityServerPort=
com.ibm.CORBA.loginTimeout=300
com.ibm.CORBA.loginSource=prompt
com.ibm.CORBA.loginUserid=
com.ibm.CORBA.loginPassword=
com.ibm.CORBA.krb5ConfigFile=
com.ibm.CORBA.krb5CcacheFile=
com.ibm.CSI.performStateful=true
com.ibm.CSI.performClientAuthenticationRequired=false
com.ibm.CSI.performClientAuthenticationSupported=true
# all false from here
com.ibm.CSI.performTLClientAuthenticationRequired=false
com.ibm.CSI.performTLClientAuthenticationSupported=false
com.ibm.CSI.performTransportAssocSSLTLSRequired=false
com.ibm.CSI.performTransportAssocSSLTLSSupported=false
com.ibm.CSI.performMessageIntegrityRequired=false
com.ibm.CSI.performMessageIntegritySupported=false
com.ibm.CSI.performMessageConfidentialityRequired=false
com.ibm.CSI.performMessageConfidentialitySupported=false
# not needed
#com.ibm.ssl.alias=DefaultSSLSettings
com.ibm.CORBA.requestTimeout=180
Par défaut, les traceurs ont le niveau INFO, ce qui correspond à une priorité basse dans log4j. Cela implique que les instructions de traçage dans le connecteur ne seront pas imprimées dans le fichier connectorTrace.log .
Utiliser une combinaison de traceurs est généralement plus efficace. Lors de l'analyse des problèmes, assurez-vous que le traceur du connecteur est activé. Lors de l'analyse des problèmes entre Rational ClearQuest et le centre de services, activez les traceurs cq, sdAdapter et serviceDesk. Lors de l'insertion d'un plan directeur, activez les serveurs Rational, tels que rqm et reqPro, ainsi que le traceur de plan directeur.