Traçage et consignation de Rational Connector

Rational Connector fournit des fonctions de consignation et de traçage pour la plupart de ses opérations clés.

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™.

Configuration du serveur

Le serveur d'applications Tomcat doit être configuré pour accepter les connexions d'une console JMX.

  1. Arrêtez le serveur d'applications Tomcat.
  2. Pour activer les fonctions JMX, ajoutez les lignes suivantes à la section JAVA_OPTS du fichier Tomcat catalina.bat qui se trouve généralement dans le répertoire Tomcat_install_dir/bin.
    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.

  3. Redémarrez le serveur.

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

Démarrage de jconsole pour se connecter à WebSphere Application Server

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

Configuration de la connexion client

  1. Le serveur étant correctement configuré, démarrez jconsole. L'emplacement par défaut est java_home>\bin\jconsole.exe
  2. Dans l'onglet Remote, entrez le nom de l'hôte ou l'adresse IP de votre serveur et le numéro de port (par exemple 9004), puis cliquez sur Connect.
  3. Dans l'onglet MBeans, développez le dossier log4j. Vous pouvez voir la liste de tous les composants log4j utilisés par le serveur d'applications. Tout nom de consignateur commençant par com.ibm.rational.connector.sap appartient à Rational Connector.
  4. Le connecteur utilise la convention de dénomination com.ibm.rational.connector.sap.*Logger et com.ibm.rational.connector.sap.*Tracer, où * indique le composant du connecteur contrôlé par le consignateur ou un traceur.
  5. Cliquez sur le traceur approprié. Pour activer le traçage du consignateur sélectionné, supprimez le texte par défaut INFO dans la zone de priorité et entrez TRACE.

    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 .

  6. Répétez l'étape 5 pour tous les autres traceurs qui vous intéressent. Les changements prennent immédiatement effet et ne nécessitent pas de redémarrage du serveur.
Tous les composants consignateurs/traceurs et leurs capacités sont décrits ci-dessous.
  • blueprint : pour insérer un plan directeur depuis Solution Manager. Le consignateur de plan directeur écrit dans le fichier blueprint.log.
  • certs : pour résoudre les problèmes de certificats.
  • connector : message général de gestion du connecteur. Il doit être activé avec les autres composants lors de l'analyse d'un problème.
  • cq : pour éliminer les erreurs entre le connecteur et ClearQuest
  • reqPro : pour éliminer les erreurs entre le connecteur et Rational RequisitePro.
  • rqm : pour éliminer les erreurs entre le connecteur et Rational Quality Manager.
  • rrc : pour éliminer les erreurs entre le connecteur et Rational Requirements Composer.
  • sdAdapter : pour éliminer les erreurs entre le centre de services et le connecteur.
  • serviceDesk: pour éliminer les erreurs entre le centre de services et le connecteur.
  • testData : pour résoudre les problèmes liés aux opérations au niveau du projet, telles que association, désassociation et réassociation entre le connecteur et Solution Manager.
  • testresult - pour analyser les problèmes liés aux résultats de test qui ne figurent pas dans le gestionnaire de solution.

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.


Commentaires en retour