傳訊引擎疑難排解要訣

請利用這一組特定提示來協助您進行服務整合傳訊引擎問題的疑難排解。

執行時期尚未起始設定,導致傳訊引擎啟動失敗

傳訊引擎無法啟動,WebSphere® Application Server 管理主控台顯示下列錯誤:

無法啟動 <name> 傳訊引擎,因為沒有針對它來起始設定
的執行時期,請在執行時期起始設定之後,再重試作業。
如果這個匯流排已啟用動態配置重新載入,就必須重新
啟動伺服器。

在嘗試重新啟動傳訊引擎之前,請確定您已重新啟動伺服器。 執行時期要順利起始設定,必須啟動應用程式伺服器。

如果要知道是不是啟動問題造成傳訊引擎執行時期無法起始設定,請檢查代管伺服器 SystemOut.log 中的錯誤訊息。
註: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.log、SystemErr.log, trace.log 及 activity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。

由於 Informix JDBC 驅動程式 3.00JC1 一項已知的錯誤,傳訊引擎無法啟動

當試圖利用 Informix® JDBC 驅動程式 3.00JC1 來儲存資料時,傳訊引擎無法啟動,在 WebSphere Application Server SystemOut.log 檔中,可能會出現下列錯誤訊息:

00000022 SibMessage E [RetireBus:retire_web.000- RetireBus] CWSIS0002E:
The messaging engine encountered an exception while starting.
Exception: com.ibm.ws.sib.msgstore.PersistenceException: CWSIS1501E:
The data source has produced an unexpected exception: java.sql.BatchUpdateException:
Unique constraint (informix.u114_62) violated.
00000022 SibMessage E [RetireBus:retire_web.000- RetireBus] CWSID0035E:
Messaging engine retire_web.000-RetireBus cannot be started;
detected error reported during com.ibm.ws.sib.msgstore.impl.MessageStoreImpl start()
00000022 SibMessage E [RetireBus:retire_web.000- RetireBus] CWSID0027I:
Messaging engine retire_web.000-RetireBus cannot be restarted because a
serious error has been reported.T]
00000022 SibMessage I [RetireBus:retire_web.000- RetireBus] CWSID0016I:
retire_web.000-RetireBus 傳訊引擎在「已停止」狀態中。

這是 Informix JDBC 驅動程式 3.00JC1 中的一項已知問題 (PTS 172471)。 如果要避免這個錯誤,請將 Informix JDBC 驅動程式升級至 3.00JC2。

資料儲存庫的問題判斷

您可以採用縮減的形式來建立傳訊引擎資料儲存庫中之資料的傾出。 輸出是給 IBM 服務人員使用。 請聯絡您的支援組織,以取得如何執行指令的相關資訊。
如果資料儲存庫中的資料有問題,很難從追蹤輸出來進行診斷。 不過,您可以採用 XML 格式來建立資料儲存庫中之資料的傾出。 在這個方式之下,會更容易診斷,因為它是可供人類閱讀的表示法,可以依照需要來轉換成其他格式。 您可以在 wsadmin 工具中輸入下列指令來建立資料儲存庫傾出:
  • 使用 Jython:
    AdminControl.invoke(AdminControl.queryNames("type=SIBMessagingEngine,
     name=messagingenginename,*"),
     "dump", "com.ibm.ws.sib.msgstore.*")
  • 使用 Jacl:
    $AdminControl invoke [$AdminControl queryNames type=SIBMessagingEngine,
     name=messagingenginename,*]
     dump com.ibm.ws.sib.msgstore.*

所建立的傾出是 $WAS_HOME/logs/server1 目錄中的一個 XML 檔。 這個檔案的命名格式如下:messaging_engine_nameUUIDtimestamp.xml

下列範例說明這個檔案的格式:
<MessageStore>
    <itemStreams>
        <ItemStreamLink id="0" state="Available">
            <class>com.ibm.ws.sib.msgstore.ItemStream</class>
            <priority>5</priority>
            <canExpireSilently></canExpireSilently>
            <storageStrategy>STORE_NEVER</storageStrategy>
            <expiryTime>0</expiryTime>
            <sequence>0</sequence>
            <tranID>null</tranID>
            <tickValue>0</tickValue>
            <items>
                <ItemLink id="2" state="Available" refCount="3" refCountDecreasing="false">
                    <class>com.ibm.ws.sib.msgstore.Item</class>
                    <priority>5</priority>
                    <canExpireSilently></canExpireSilently>
                    <storageStrategy>STORE_NEVER</storageStrategy>
                    <expiryTime>0</expiryTime>
                    <sequence>1</sequence>
                    <tranID>null</tranID>
                    <tickValue>0</tickValue>
                </ItemLink></items></ItemStreamLink></itemStreams></MessageStore>

傳訊引擎引起資料庫競用訊息

當傳訊引擎利用某個資料儲存庫來作為訊息儲存庫時,如果意外啟動同一個傳訊引擎兩次,會顯示一則資料庫競用訊息:
CWSIS1546I: The messaging engine, ME_UUID={0}, INC_UUID={1}, has lost
an existing lock or failed to gain an initial lock on the data store.
如果要解決這個問題,請執行下列動作:
  • 檢查資料庫問題,例如,資料庫無法使用。
  • 檢查網路問題。比方說,如果網路超載,兩部應用程式伺服器也許可以連接到資料庫,但有可能無法彼此連接,從而導致資源協調問題。

XAResourceNotAvailableException 異常狀況的可能原因,以及如何採取適當的動作

當利用 deleteNode 指令來處理代管傳訊引擎的節點時,會刪除這些傳訊引擎。 當在 addNode 指令之後重建傳訊引擎時,它們會有不同的 ID,因此在交易回復期間,不可能連接到舊的傳訊引擎。 在代管傳訊引擎的各伺服器的 SystemOut.log 檔中,會產生一則識別 XAResourceNotAvailableException 異常狀況的訊息。

如果要解決這個問題,您必須遵循解析不確定的交易中所說明的程序。

重建服務整合匯流排時的問題

如果您刪除某個服務整合匯流排,後來又建立同名的匯流排,傳訊引擎會無法啟動,在 SystemOut.log 中,會出現類似下列訊息:
[8/11/04 21:55:01:439 CDT] 0000000f SibMessage    I
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine suffered common mode error.
Correct error (see logs) and restart server.
[8/11/04 21:55:01:468 CDT] 0000000f SibMessage    I
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine will be stopped
because of common mode error.
No failover will occur.
[8/11/04 21:55:01:493 CDT] 0000000f SibMessage    I
[LateBus:xyzsun15.server1-LateBus] Messaging Engine
xyzsun15.server1-LateBus not in state from which stop is valid: Starting
[8/11/04 21:55:01:513 CDT] 0000000f SibMessage    I
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine stopped because
of common mode error. Correct error (see logs) and restart server.
[8/11/04 21:57:01:431 CDT] 0000000e SibMessage    I
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine suffered
common mode error.
Correct error (see logs) and restart server.

傳訊引擎無法啟動,因為在刪除匯流排之後,傳訊引擎的資料庫目錄仍存在,您必須手動移除它。 如果要刪除不存在的傳訊引擎的 Apache Derby 資料庫,您必須在 profile_root/databases/com.ibm.ws.sib 中的資料庫目錄,其中 profile_root 是儲存設定檔特定資訊的目錄。

在刪除資料庫檔案之前,您必須先停止 WebSphere Application Server。

對於其他資料庫,您可以刪除資料儲存庫表格中所有列,也可以捨棄所有資料儲存庫表格。 這些表格在資料儲存庫所配置的綱目中。 如需表格的清單,請參閱資料儲存庫表格。

如需相關資訊,請參閱資料儲存庫生命週期。

與外部匯流排通訊的問題

如果要啟用匯流排之間的通訊,必須建立外部匯流排和服務匯流排整合鏈結。 在第一個匯流排上,外部匯流排的名稱必須符合為外部匯流排的第二個匯流排的名稱,這第二個匯流排的外部匯流排的名稱必須符合第一個匯流排的名稱。 在這兩個匯流排上,服務整合匯流排鏈結必須有相同的名稱。

如果您的配置不正確,例如,因為服務整合匯流排鏈結不符,您可能會遇到下列錯誤類型:

SibMessage    E   [TechBus:TechCluster.000-TechBus]
CWSIT0057E: The inter-bus connection BookstoreBus failed in the remote
messaging engine on host aixp401.rchland.ibm.com with reason:
CWSIT0067E: Inter-bus connection BookstoreBus in bus BookstoreBus
is not available.

試圖與重新命名的外部匯流排通訊時發生問題

您也可以利用配置服務整合匯流排鏈結內容時所用的管理主控台畫面來變更鏈結所指向的外部匯流排名稱。 不過,外部匯流排配置好之後,您就不能變更外部匯流排的名稱。 如果您這麼做,在外部匯流排名稱重設為先前的值之前,任何已存放了鏈結狀態資訊的傳訊引擎都會無法使用這個鏈結。

包裝了 SILimitExceeded 異常狀況之 JMSException 的可能原因

當目的地所存放的訊息數目達到限制的臨界值時,只要試圖將訊息傳送到這個目的地,一律會失敗,且會出現包裝了 SILimitExceeded 異常狀況的 JMSException。 目的地會持續失敗,並出現這個異常狀況,直到目的地所存放的訊息數目降低到限制的臨界值之下。

如果要取得可用訊息數目的精確計數,您可以監視佇列和主題空間目的地的「可用訊息計數 PMI」統計資料。 如果可用訊息的數目有所增加,請採取動作來平衡系統。 在目的地消費可用的訊息之前,請考慮讓生產者停止傳送新的訊息。

請檢查下列清單,找出這個問題的可能原因和解決方案:
  • 對於所投射的訊息數目,目的地的高臨界值太低。 目的地不會處理部分的訊息。 高臨界值的預設值是 50000。
    解決方案: 請增加目的地的高臨界值。
  • 應用程式產生的訊息數目超出目的地的處理能力。

    理想的平衡狀況是在一段時間內,產生的訊息數目與消費的訊息數目相等。 如果您系統不平衡,生產端應用程式傳送的訊息數目超出目的地的消費能力,生產端應用程式最終會擲出 JMSException。

    解決方案: 致力於在產生的訊息數目與消費的訊息數目之間取得平衡。
    提示: Object Request Broker (ORB) 執行緒儲存區的預設值是 100 個執行緒。 對於某些應用程式而言,這可能會讓 100 個應用程式將訊息傳送到相同的目的地。 請考慮將 ORB 執行緒儲存區調整為最多有 10 個執行緒。 這個較低的設定會減少生產者所能傳送的訊息數目,這有可能增加整體的通訊量。
  • 應用程式處理目的地的訊息太慢。
    解決方案: 可能需要增加用戶端應用程式消費的訊息數目。 當有多個消費者讀取一個目的地時,這個目的地會處理較多訊息。

    在非叢集環境中,請考慮在多部伺服器之間複製您的應用程式。 依預設,在叢集伺服器環境中,會複製應用程式。 如果要啟用非叢集環境中的訂閱者,請在 DurableSubscriptions 的 TopicConnectionFactory JNDI 設定中設定 cloned 旗標。

    限制: 這個解決方案不適合需要總體訊息排序的應用程式。
  • 訊息的服務品質屬性優於「最大努力非持續性」。
    解決方案: 請使用服務品質屬性是「最大努力非持續性」的訊息。 如果系統中有太多訊息,目的地會捨棄最大努力非持續性訊息。
    限制: 這個解決方案不適合必須接收所有訊息的應用程式。

系統重新啟動時的毀損問題

雖然不常見,但傳訊引擎、目的地或鏈結有可能在系統重新啟動之後毀損。 如果發生這個毀損情況,您會看到一則訊息指出這個問題。 如果是傳訊引擎有問題,傳訊引擎將無法啟動。 如果是目的地或鏈結毀損,相關的傳訊引擎會啟動,但在這個傳訊引擎上,目的地或鏈結將無法使用。

如果您不知道問題原因,在嘗試解決這個狀況之前,請聯絡 IBM 客戶服務代表來建立原因。

如果您知道問題原因,例如,您知道資料庫有問題,請完成下列步驟來加以解決:
  1. 利用管理主控台來導覽至 系統管理 -> 節點 然後按一下完整重新同步化,以確保系統的各配置檔已經同步。 執行這個作業,可能需要幾分鐘。
  2. 如果仍有問題,請完成下列其中一項作業:
    • 刪除毀損的物件,再加以重建。會失去毀損之前所產生或接收的訊息。
    • 從備份中還原您的系統,請參閱還原資料儲存庫及回復它的傳訊引擎。 建立備份之後所產生或接收的訊息會遺失。

在管理主控台中擷取傳訊引擎的狀態

如果要能夠擷取傳訊引擎的狀態,您至少必須用監視權限來登入管理主控台。 如果您沒有這個權限,即使傳訊引擎已啟動,傳訊引擎狀態也會顯示為「無法使用」。

如果未以擷取傳訊引擎狀態所需要的權限來登入,在伺服器 systemOut 日誌檔中,會記載類似下列中的錯誤訊息:
[4/20/05 10:49:57:083 CDT] 0000004b RoleBasedAuth A
SECJ0305I: The role-based authorization check failed for admin-authz
operation SIBMessagingEngine:stateExtended.
The user UNAUTHENTICATED (unique ID: unauthenticated) was not granted any of
 the following required roles: administrator, operator, configurator, monitor.
訊息中所顯示的使用者 ID 是您用來登入管理主控台的使用者 ID。

在啟動必要的傳訊引擎之前,啟用要啟動的應用程式

如果應用程式有賴於傳訊引擎可供使用,在執行應用程式之前,必須先啟動傳訊引擎。 如果您想要應用程式伺服器能夠自動啟動應用程式,您應該將應用程式開發成會測試任何必要的傳訊引擎是否已啟動,且在必要之時,會等待傳訊引擎。 如果在啟動 Bean 中使用這個技術,啟動 Bean 方法應該在個別執行緒中執行這個測試和等待工作(使用標準 WorkManager 方法),以免延遲應用程式伺服器的啟動。

如需測試和等待傳訊引擎的程式碼範例,請參閱相依於傳訊引擎可用性的應用程式。


指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rjk_prob0
檔名:rjk_prob0.html