De forma predeterminada, el registro está habilitado y todos los errores encontrados por el conector durante su ejecución se registran en el archivo connector.log, ubicado en el directorio directorio_Tomcat/logs. La única excepción es blueprintLogger, que graba en su propio registro, blueprint.log, ubicado en el mismo directorio.
El rastreo suministra más información no relacionada con errores acerca de las operaciones del conector a efectos de depuración. De manera predeterminada, el rastreo está inhabilitado. Puede habilitarse mediante una consola JMX. Si el servidor está correctamente configurado, puede utilizarse cualquier consola JMX para habilitar el rastreo. Las instrucciones son para jconsole, que es una consola JMX suministrada con un SDK de Java™.
El servidor de aplicaciones Tomcat debe configurarse para aceptar conexiones desde una consola JMX.
Dcom.sun.management.jmxremote
Dcom.sun.management.jmxremote.port=9004
Dcom.sun.management.jmxremote.authenticate=false
Dcom.sun.management.jmxremote.ssl=false
La primera línea habilita el inicio de sesión remoto de JMX. La segunda línea especifica el puerto de escucha de las solicitudes de consola JMX entrantes. Las dos líneas siguientes inhabilitan la autenticación y el cifrado que pueden no ser deseables en entornos de producción.
Para conocer configuraciones de JMX más avanzadas, consulte la documentación de Tomcat en http://Tomcat.apache.org/tomcat-5.5-doc/monitoring.html#Enabling_JMX_Remote
No es necesario realizar cambios en las propiedades de la JVM de WebSphere Application Server para utilizar jconsole para la conexión. Sin embargo, debe crear un script de inicio y un archivo de propiedades. A continuación figura un ejemplo de script de inicio:
@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
:: iniciar jconsole con el jdk de was
start %WAS_HOME%\java\bin\javaw.exe -classpath %CLASSPATH% %PROPS% sun.tools.jconsole.JConsole service:jmx:iiop://%HOST%/jndi/JMXConnector
El script de ejemplo se ha escrito como un script .bat de Windows. Debe cambiar los valores de WAS_HOME por la vía de acceso 8.3 para el directorio de instalación de WebSphere Application Server y de PROPS_DIR por el directorio con el archivo de propiedades siguiente, llamado 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
# todo false a partir de aquí
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
# no es necesario
#com.ibm.ssl.alias=DefaultSSLSettings
com.ibm.CORBA.requestTimeout=180
De forma predeterminada, los rastreadores se establecen en un nivel de INFO, que es de prioridad baja en log4j. Un nivel de rastreo INFO significa que las sentencias de rastreo de los conectores no se registrarán en el archivo connectorTrace.log.
Con una combinación de varios rastreadores, con frecuencia se obtiene un mejor resultado. Cuando investigue problemas, asegúrese de que el rastreador del conector esté habilitado. Al investigar problemas entre Rational ClearQuest y Service Desk, habilite los rastreadores cq, sdAdapter y serviceDesk. Al realizar una inversión de dirección de modelos, habilite los servidores Rational, como por ejemplo rqm y reqPro, además del rastreador de modelos.