Per impostazione predefinita, la registrazione log è abilitata e tutti gli errori rilevati dal connettore durante l'esecuzione sono stampati nel file connector.log nella directory Tomcat_directory/logs . L'unica eccezione è blueprintLogger che scrive nel proprio log, blueprint.log, nella stessa directory.
La traccia fornisce più informazioni non relative agli errori sulle operazioni del connettore a scopo di debug. Per impostazione predefinita, la traccia è disabilitata. È possibile abilitarla attraverso l'uso di una console JMX. Se il server è correttamente configurato, è possibile utilizzare qualsiasi console JMX per abilitare la traccia. Le istruzioni sono relative a jconsole, che è una console JMX fornita con un SDK Java™.
L'application server Tomcat deve essere configurato per accettare le connessioni da una 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 prima riga abilita il login remoto JMX. La seconda riga specifica la porta di ascolto per le richieste della console JMX in entrata. Le due righe successive disabilitano l'autenticazione e la crittografia, che potrebbe essere non desiderabile negli ambienti di produzione.
Per configurazioni JMX più avanzate, consultare la documentazione Tomcat all'indirizzo http://Tomcat.apache.org/tomcat-5.5-doc/monitoring.html#Enabling_JMX_Remote
Non è necessaria alcuna modifica alle proprietà JVM di WebSphere Application Server per utilizzare la jconsole per la connessione. Tuttavia, è necessario creare uno script di avvio e un file delle proprietà. Di seguito è riportato un esempio di script di avvio:
@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
Lo script di esempio è stato scritto come uno script .bat di Windows. È necessario modificare i valori per WAS_HOME con il percorso 8.3 della directory di installazione di WebSphere Application Server e PROPS_DIR con la directory con il seguente file delle proprietà denominato 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
Per impostazione predefinita, i programmi di traccia vengono impostati ad un livello di INFO, che è una priorità bassa in log4j. Un livello di traccia di INFO significa che le istruzioni di traccia nei connettori non vengono stampate nel file connectorTrace.log .
Utilizzare una combinazione di diversi programmi di traccia spesso produce un risultato migliore. Quando si esaminano i problemi, accertarsi che il programma di traccia del connettore sia abilitato. Quando si esaminano i problemi tra Rational ClearQuest e Service Desk, abilitare i programmi di traccia cq, sdAdapter e serviceDesk. Quando si esegue un invio blueprint, abilitare i server Rational, come rqm e reqPro, oltre al programma di traccia blueprint.