Трассировка и ведение протоколов Rational Connector

Для многих ключевых операций Rational Connector доступны функции трассировки и ведения протокола.

По умолчанию ведение протокола включено и все ошибки коннектора регистрируются в файле connector.log, который расположен в каталоге Tomcat_directory/logs. Исключением является функция blueprintLogger, которая ведет собственный протокол blueprint.log в том же каталоге.

Трассировка предоставляет больше информации о работе коннектора для целей отладки. По умолчанию трассировка выключена. Ее можно включить с помощью консоли JMX. Если сервер настроен правильным образом, то трассировку можно включить с помощью любой консоли JMX. Данные инструкции относятся к консоли jconsole (консоль JMX, входящая в состав SDK Java™).

Настройка сервера

Сервер приложений Tomcat необходимо настроить для приема соединений консоли JMX.

  1. Остановите сервер приложений Tomcat.
  2. Для включения поддержки JMX добавьте следующие строки в раздел JAVA_OPTS файла catalina.bat, который по умолчанию расположен в каталоге 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

    The first line enables the JMX remote login. Вторая строка задает порт для приема входящих запросов консоли JMX. Следующие две строки выключают идентификацию и шифрование, что может быть недопустимо в рабочей среде.

  3. Перезапустите сервер.

Информацию о расширенных параметрах JMX можно найти в документации по Tomcat http://Tomcat.apache.org/tomcat-5.5-doc/monitoring.html#Enabling_JMX_Remote

Запуск консоли jconsole для подключения к серверу WebSphere Application Server

Для подключения консоли jconsole не требуется вносить изменения в свойства JVM WebSphere Application Server. Однако необходимо создать сценарий запуска и файл свойств. Пример сценария запуска:

@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

Этот пример сценария представляет собой файл .bat Windows. Вместо переменной WAS_HOME укажите путь к установочному каталогу WebSphere Application Server 8.3, а вместо переменной PROPS_DIR - каталог, содержащий файл свойств 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

Настройка соединения с клиентом

  1. После настройки сервера запустите jconsole. Расположение по умолчанию: java_home>\bin\jconsole.exe
  2. На вкладке Удаленный введите имя или IP-адрес хоста и номер порта (например 9004) сервера и нажмите кнопку Подключить.
  3. На вкладке Объекты MBeans разверните папку log4j. Будет показан список всех компонентов log4j, применяемых сервером приложений. Все программы ведения протоколов, имена которых начинаются с com.ibm.rational.connector.sap, принадлежат Rational Connector.
  4. Коннектор использует соглашения об именах com.ibm.rational.connector.sap.*Logger и com.ibm.rational.connector.sap.*Tracer, где символ * указывает конкретный компонент коннектора, управляемый функцией ведения протокола или трассировки.
  5. Щелкните на требуемой программе трассировки. Для того чтобы включить трассировку в поле приоритета вместо значения по умолчанию INFO введите значение TRACE.

    По умолчанию компоненты трассировки применяют уровень INFO, который соответствует низкому приоритету log4j. Уровень трассировки INFO означает, что в файле connectorTrace.log не регистрируются операторы трассировки коннекторов.

  6. Повторите шаг 5 для всех остальных требуемых программ трассировки. Изменения вступают в силу немедленно без перезапуска сервера.
Ниже приведено описание всех компонентов ведения протоколов и трассировки.
  • blueprint - - рекомендуется использовать в ходе передачи эскиза проекта из Solution Manager. Функция ведения протокола blueprint сохраняет данные в файле blueprint.log.
  • certs - рекомендуется использовать для устранения неполадок, связанных с сертификатами.
  • connector - обработка сообщений коннектора. Необходимо включать вместе с другими компонентами при оценке неполадки.
  • cq - рекомендуется использовать для отладки ошибок между коннектором и ClearQuest.
  • reqPro - рекомендуется использовать для отладки ошибок между коннектором и Rational RequisitePro.
  • rqm - рекомендуется использовать для отладки ошибок между коннектором и Rational Quality Manager.
  • rrc - рекомендуется использовать для отладки ошибок между коннектором и Rational Requirements Composer.
  • sdAdapter - рекомендуется использовать для отладки ошибок между Service Desk и коннектором.
  • serviceDesk - рекомендуется использовать для отладки ошибок между Service Desk и коннектором.
  • testData - рекомендуется использовать для отладки операций уровня проекта, таких как связывание, отмена связывания и повторное связывание коннектора и Solution Manager.
  • testresult - рекомендуется использовать для устранения неполадок, связанных с отсутствием результатов тестирования в Solution Manager.

Совместное применение нескольких компонентов трассировки позволяет получить оптимальные результаты. Для устранения неполадок необходимо включить программу трассировки коннектора. В ходе устранения неполадок Rational ClearQuest и Service Desk рекомендуется включать программы трассировки cq, sdAdapter и serviceDesk. В ходе передачи эскизов проекта помимо компонента трассировки blueprint включите серверы Rational, такие как rqm и reqPro.


Комментарии