Rational Connector 追蹤和記載

Rational® Connector 提供它的許多主要作業的記載和追蹤功能。

依預設,會啟用記載功能,且會將連接器在其作業期間所發現的所有錯誤,輸出到 Tomcat_directory/logs 目錄下的 connector.log 檔中。唯一的例外是 blueprintLogger,它會在相同目錄之下,寫入它自己的日誌 blueprint.log 中。

追蹤會提供連接器作業的其他非錯誤相關資訊,以供進行除錯。依預設會停用追蹤。您可以利用 JMX 主控台來啟用它。如果已適當配置伺服器,任何 JMX 主控台都可以用來啟用追蹤。這些是 jconsole 的指示,它是 Java™ SDK 所提供的 JMX 主控台。

設定伺服器

Tomcat Application Server 必須配置為接受來自 JMX 主控台的連線。

  1. 停止 Tomcat Application Server。
  2. 如果要啟用 JMX 功能,請將下面這幾行新增到 Tomcat catalina.bat 檔的 JAVA_OPTS 區段中,這個檔案通常可以在 Tomcat_install_dir/bin 目錄中找到。
    Dcom.sun.management.jmxremoteDcom.sun.management.jmxremote.port=9004Dcom.sun.management.jmxremote.authenticate=falseDcom.sun.management.jmxremote.ssl=false

    第一行會啟用 JMX 遠端登入。第二行指定用來接聽送入的 JMX 主控台要求的埠。下兩行則停用鑑別和加密,這在正式作業環境中可能並不恰當。

  3. 請重新啟動伺服器。

如需更進階的 JMX 配置,請參閱位於 http://Tomcat.apache.org/tomcat-5.5-doc/monitoring.html#Enabling_JMX_Remote 的 Tomcat 說明文件

啟動 jconsole 來連接到 WebSphere Application Server

不需對 WebSphere® Application Server JVM 內容進行任何變更,即可利用 jconsole 來連接。 不過,您必須建立啟動 Script 和內容檔。啟動 Script 範例如下:

@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

範例 Script 是寫成 Windows .bat Script。您需要將 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

# 從這裡開始,全部是 false

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

# 不需要
#com.ibm.ssl.alias=DefaultSSLSettings

com.ibm.CORBA.requestTimeout=180

設定用戶端連線

  1. 伺服器適當配置之後,請啟動 jconsole。預設位置是 java_home>\bin\jconsole.exe
  2. 遠端標籤中,輸入伺服器的主機名稱或 IP 以及埠號(例如,9004),然後按一下連接
  3. MBean 標籤中,展開 log4j 資料夾。您會看到一份清單,列出由應用程式伺服器使用中的所有 log4j 元件。開頭為 com.ibm.rational.connector.sap 的任何日誌程式都是屬於 Rational Connector。
  4. 連接器會使用 com.ibm.rational.connector.sap.*Loggercom.ibm.rational.connector.sap.*Tracer 命名慣例,其中星號 * 代表日誌程式或追蹤器所控制的特定連接器元件。
  5. 按一下您感興趣的追蹤器。如果要對所選日誌程式啟用追蹤,請在「優先順序」欄位,刪除預設的 INFO 文字,然後輸入 TRACE

    依預設,追蹤器會設定為 INFO 層次,這在 log4j 中是低優先順序。INFO 追蹤層次表示連接器內的追蹤陳述式不會輸出到 connectorTrace.log 檔中。

  6. 對所有其他感興趣的追蹤器重複步驟 5。變更會立即生效,不需要伺服器重新啟動。
以下是日誌程式和追蹤器元件的完整清單以及其功能。
  • blueprint - 適用於從 Solution Manager 推播藍圖之時。藍圖日誌程式會寫入 blueprint.log 中。
  • certs - 適用於憑證有問題之時。
  • connector - 連接器的一般訊息處理。在評估問題時,必須隨同其他元件啟用此追蹤器。
  • cq - 適用於在連接器和 ClearQuest® 之間進行除錯之時。
  • reqPro - 適用於在連接器和 Rational RequisitePro® 之間進行除錯之時。
  • rqm - 適用於在連接器和 Rational Quality Manager 之間進行除錯之時。
  • rrc - 適用於在連接器和 Rational Requirements 之間進行除錯之時。
  • sdAdapter - 適用於在 Service Desk 和連接器之間進行除錯之時。
  • serviceDesk - 適用於在 Service Desk 和連接器之間進行除錯之時。
  • testData - 適用於在連接器和解決方案管理程式之間進行專案層次作業除錯之時,例如:關聯、取消關聯及重新關聯等作業。
  • testresult - 適用於調查 Solution Manager 中未顯示測試結果的問題。

使用多種追蹤器的組合通常能得出最佳結果。在調查問題時,請確定已啟用連接器的追蹤器。在調查 Rational ClearQuest 和 Service Desk 之間的問題時,請啟用 cq、sdAdapter 和 serviceDesk 追蹤器。在執行藍圖推播時,除了藍圖追蹤器,也請啟用 Rational 伺服器(如 rqm 和 reqPro)。


意見