歡迎使用 IBM WebSphere Message Broker 和 IBM WebSphere Event Broker。本 Readme 檔支援執行時期元件 6.0.0.7 版(修正套件 7)與工具集 6.0.2.0 版。
本 Readme 將說明已知問題,並包含有關產品文件可用層級的更新項目。
請務必使用最新版的 Readme 檔,以下網站有提供檔案(僅英文版):
http://www.ibm.com/support/docview.wss?rs=171&uid;=swg27006917
以下網址提供了 Readme 檔的翻譯版本: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0
若要完成安裝,請參閱 WebSphere Message Broker 安裝手冊或 WebSphere Event Broker 安裝手冊。這些手冊將說明在安裝本產品之前所需完成的作業。其中也包括 HP-UX(Integrity 平台)支援的相關資訊。
安裝手冊可於 IBM 出版品中心線上存取,網址為:
Message Broker 為
http://publib.boulder.ibm.com/epubs/pdf/c3466213.pdf
Event Broker 為 http://publib.boulder.ibm.com/epubs/pdf/c3466223.pdf
如安裝手冊(第 4 版,2006 年 12 月)所述,手冊可用於執行時期元件 6.0.0.3 版,也適用於 6.0.0.4 版。本供應產品的安裝手冊將不再重新發行。如需安裝手冊的最新更正內容,請參閱本 Readme 檔的說明文件一節。
WebSphere Message Broker 與 WebSphere Event Broker 的資訊中心反映執行時期元件的 6.0.0.4 版及工具元件的 6.0.2.0 版。資訊中心目前已有更新版本,內含最新產品加強功能的相關資訊。
WebSphere Message Broker 與 WebSphere Event Broker 的獨立資訊中心可從以下網址存取: http://www.ibm.com/software/integration/wbimessagebroker/library/library60.html
或從以下網址下載:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_linux.tgz
(Linux® 版)
及
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip
(Windows® 版)
請閱讀 wmb_help_linux.tgz 與 wmb_help_win.zip 內的 installing_and_managing.htm 檔。
以下網址提供了可攜性文件格式 (.pdf) 的資訊主題集,以及使用規則與格式製作程式的專用文件:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/
問題報告:本 Readme 文件內含問題報告編號。這些編號是代表內部的 IBM 問題編號;在與您的 IBM 客戶服務代表討論問題時,這些編號可能會有所幫助。
Technotes:如需已知問題以及可用修正程式的最新資訊,請查看:
http://www.ibm.com/software/integration/wbimessagebroker/support/
再以下列一項方法來尋找資訊:
版本:如需 WebSphere
Message Broker 及 WebSphere Event Broker 所支援之特定作業系統與資料庫版本的最新狀態,請參閱 System requirement and library 網頁,網址為:
http://www.ibm.com/support/docview.wss?uid=swg27007065
WebSphere Message
Broker 6.0.0.3 版已根據 EAL4 層級的「共用準則綱目」完成評估。如需已評估配置與其他考量的進一步資訊,請以您的 IBM ID 登入 WebSphere Message Broker 6.0 版下載網站:
https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?lang=en_US&source=wbimbv6
選取供應項目 "WebSphere Message Broker V6 Fix Pack 3 Common Criteria",然後下載 "Common Criteria README"。
若您未有 IBM ID,可在此網站註冊。
本節將根據元件,概述 WebSphere Message Broker 與 WebSphere Event Broker 的限制。
在安裝手冊,以及資訊中心主題「New function added in Version 6.0 fix packs」 所提及的 WebSphere Message Broker Extensions, Samples, and Demos 光碟僅適用於 Windows XP。
在任何 UNIX® 平台上,若安裝配置管理程式元件時尚未安裝分配管理系統的元件,並在相同目錄中安裝分配管理系統,配管理系統的 lil 和 lil64 目錄將會遺漏數個檔案符號鏈結。若要避免此問題,請:
若要將 Message Brokers 工具集升級至 6.0.2.0 版(從 6.0 版、6.0.0.1 版或 6.0.0.2 版),您必須使用 6.0.2 層次或更高層次的 Rational® 產品更新程式 (RPU)。若目前正使用舊版 RPU,必須先將 RPU 升級至 6.0.2 版,再開始升級 Message Brokers 工具集。如需升級 RPU 的相關資訊,請參閱 WebSphere Message Broker 安裝手冊。
可直接從網站或本端系統,使用 RPU 安裝 Message Brokers 工具集(6.0.2.0 版)。使用 RPU 升級至 6.0.2.0 版的程序已在 WebSphere Message Broker 安裝手冊加以說明。
有關升級 Message Brokers 工具集和 Rational 產品更新程式的額外指示,請至 WebSphere Message Broker 和 Event Broker 6.0.2.0 版的支援網頁。
警告:RPU 可能顯示安裝產品為 1.0.0 版,也可能在日誌、或在啟動工具集時出現蹦現視窗,顯示 "License not found" 錯誤。安裝日誌也可能顯示下列錯誤:
"Command failed: D:\Program Files\IBM\MessageBrokersToolkit\6.0\rationalsdp.exe -clean -nosplash -application com.ibm.jxesupport.initialize"以下的 Technote 說明了此問題及解決方法:
若使用 RPU 從本端系統(而非直接從網站)安裝套件,需要下載的套件會根據已安裝的版本而有所不同:
升級至 6.0.2.0 版之後,必須完成下列步驟:
當您安裝 RAC 時,您必須在安裝精靈的 Java Runtime 頁中輸入 Java™ Runtime 檔案 java.exe 的位置。您必須指定已安裝 Java Runtime 檔案的路徑。基於此目的,請不要指定與 WebSphere Message Broker 一起安裝的 JRE,您必須使用替代 JRE。
目前提供一些 TechNotes,說明有關 Message Broker 和 Event Broker 工具集與 Rational Application Developer (RAD) 或 Rational Software Architect (RSA) 產品一起安裝的數個重要問題。強烈建議您在安裝 Message Brokers 工具集時先參閱這些 TechNotes。本 Readme 檔的支援一節將提供如何存取這些 TechNotes 的相關資訊。
當您第一次執行「預設配置」精靈時,它在建立接聽器時失效。若要解決此問題,請執行「移除預設配置」精靈,然後再次執行「建立預設配置」精靈。若仍無法更正問題,必須在 MQSI 指令視窗發出下列指定,以手動啟動接聽器,再重新執行「建立預設配置」精靈:
runmqlsr -t tcp -p 1414 -m WBRK6_QUEUE_MANAGER
當您在無聲自動安裝時使用回應檔,其中可能會包含錯誤的設定旗號。 因此,若選擇安裝一或多個特定元件(而非安裝完整產品),系統將不處理選擇,仍然安裝完整產品。若要解決此問題,必須編輯回應檔,如下修改適當的旗標:
修改下列的行:
-W setupTypes.selectedSetupTypeId=custom
變更為:
-W setupTypes.selectedSetupTypeId=
(也就是設定為「無」),以防止執行預設的一般或自訂安裝(即安裝所有元件)。
若開發的訊息流程會使用具備多重播送 PGM 支援的 WebSphere MQ 即時傳輸,必須在所有受影響的分配管理系統安裝 WebSphere MQ 6.0 版或更新版本,並須套用 APAR IC47032 與 USERMOD ANPGM01。
在全域區域或整個根目錄非全域區域,WebSphere Message Broker 均受到支援,必須個別在每個區域中進行安裝。
若已在電腦上安裝一或多個 WebSphere Message Broker 元件,並嘗試安裝其他元件,InstallShield 不僅為安裝之額外元件,更為完整產檢查是否有充足的磁碟空間用於安裝。因此,即使電腦有充足的可用空間,也可能無法安裝額外元件。若有充足的空間可安裝完整產品,即可成功安裝所選的元件。否則,必須解除已安裝的元件,再重新安裝。
指令輔助精靈目前無法管理配置管理程式元件。此問題將有修正程式。
可以使用 Eclipse 更新管理程式安裝 WebSphere MQ V6 探險家外掛程式,以搭配 WebSphere Message Brokers 工具集一起使用。然而,必須先安裝 WebSphere MQ 第 6 版的 6.0.1 版的產品更新套件。
請在 Eclipse 工具列選取「說明」>「軟體更新」>「搜尋並安裝」。選取「新增特性」選項。新增 <WebSphere MQ 安裝目錄>/eclipse 作為新的本端來源,探險家功能將顯示為可以安裝。
也可以將內含 WebSphere MQ 探險家功能與外掛程式的目錄,手動複製到 WebSphere Message Brokers 工具集目錄中,作為 6.0.1 版更新項目之前的暫行解決方法。重新啟動 WebSphere Message Brokers 工具集之後,即可開啟 WebSphere MQ 探險家作為新的視景。
在於無聲自動解除安裝,使用 -options-record 旗標建立回應檔時,回應檔會包含設定不正確的旗標。因此,若選擇解除安裝一或多個特定元件(而非解除安裝完整產品),系統將不處理選擇,仍然解除安裝完整產品。
若要解決此問題,必須編輯回應檔,將指定個別元件是否解除安裝的每一行逐一修改。即必須修改下列字串的所有實例:
-P feature.active=true變更為下列字串:
-P feature.activeForUninstall=truefeature 是需要解除安裝的元件名稱。
也必須修改下列字串的所有實例:
-P feature.active=false變更為:
-P feature.activeForUninstall=falsefeature 是不需要解除安裝的元件名稱。
必須確保每個元件都有下列一種陳述式(activeForUninstall=true 或 ctiveForUninstall=false )。
然而,與尚未解除安裝之元件有關的 activeForUninstall 陳述式,可能會出現在產生的回應檔中。若出現這類陳述式,請確保這些元件的 activeForUninstall 選項都設定為 true。若這些元件的 activeForUninstall 選項設定為 false,解除安裝程式將會失敗。
若使用下列 Dublin 配接器解決方案,請聯絡 Dublin 配接器支援部門 (dubadsup@ie.ibm.com),以取得通過第 6 版 Message Broker 測試的解決方案版本。請勿直接移轉第 5 版解決方案,第 5 版將導致行為出現細微差異:
嘗試移轉解決方案至第 6 版之前,若使用下列 Dublin 配接器解決方案,請聯絡 Dublin 配接器支援部門 (dubadsup@ie.ibm.com),以暸解是否有通過第 6 版 Message Broker 測試的版本,以及最新的版本:
若要從 WebSphere MQ Integrator 2.1 版移轉訊息集,而該訊息集內含業界標準 TDS 發訊格式,例如 SWIFT,在部署該訊息集至 2.1 版分配管理系統時(或部署第 5 版分配管理系統,而系統之服務層次為修正套件 3 以前), 需要先使用 mqsimigratemsgsets 指令,完成下列步驟:
如果您不作此更新,在您新增訊息集至 BAR 檔(訊息中的 CSD3 指修正套件 3)時, 會出現以下訊息:
BIP0202W 本字典檔需要第 5 版 CSD3 或更新版本的分配管理系統。TDS 格式 "SWIFT" 使用「嚴格數值檢查」。第 5 版 CSD 3 之前的分配管理系統不支援此選項。
在正確部署 BAR 檔前,您必須更正此錯誤。
同時使用 Real-timeInput 節點與發佈/訂閱應用程式時,所有分散式平台可能在 DataFlowEngine 的程序發生記憶體洩漏。根據平台及發佈/訂閱用戶端的數量,DataFlowEngine 程序所用的記憶體會穩定增加。
若 DataFlowEngine 程序的記憶體不足,程序將停止運作。 在 Windows 上,'errors' 資料夾中產生一個 ABEND 檔案及一份傾出。 其他系統上則會產生一個 ABEND 檔案和一個核心檔案。然後 DataFlowEngine 程序將重新啟動。
例如,在具有一個執行群組的分配管理系統中,使用單一訊息流程(沒有額外實例),且在執行 Windows 的 4 通道 - 4GB 電腦上有 80 個發佈/訂閱用戶端,則 DataFlowEngine 程序約在 1.5 小時後停止運作。
系統事件日誌中不太可能出現下列錯誤:
Java Virtual Machine OutOfMemoryError occurred. The JVM has reported an OutOfMemoryError situation.
ABEND 檔案可能包含下列錯誤:
File: F:\build\S000_P\src\DataFlowEngine\JavaNodeLibrary\ImbJmsIpJNIJmsIpNode.cpp Line: 417 Function: Java_com_ibm_broker_server_JmsIpNode_logFatalError AbendAction: 3
若要解決此問題,可能需要停止並重新啟動分配管理系統,並增加 Java 虛擬機器 (JVM) 的資料堆大小。 若使用 Real-timeOptimizedFlow 節點而非 Real-timeInput 節點,即可減少部分記憶體問題。
在 z/OS 平台上:若納入 Trace 節點,並將其目的地屬性設定為「使用者追蹤」,在高處理量的訊息流程中,其擁有的執行群組可能停止運作(異常終止 S2C1)。由於 Trace 節點一直都在作用中,一般不會納入生產流程。若要避免此問題,請確保已連接的 Trace 節點並未納入高處理量的流程中,因為這些節點一直都在作用中,會產生極高的 I/O 負載。
為了讓 Mapping 節點與 MIME 網域剖析器搭配運作,必須使用「訊息分配管理系統之 IBM 提供訊息定義」所提供的 mime_multipart.xsd 或 mime_nested_multipart.xsd。
若要讓訂閱者接收保留的發佈資訊,必須在「發佈/訂閱」網域中,停止並重新啟動分配管理系統。
若要使用流程除錯器,不論電腦的語言環境為何,分配管理系統及執行群組的名稱必須使用英文字母。
在 AIX® 上,若 Oracle 提供的 32 為元用戶端程式庫 'libclntsh.a'未與 /usr/lib 建立鏈結 ,由 XA 啟用的 WebSphere MQ 佇列管理程式(於 WebSphere MQ 第 5 版)將無法明確啟動。
若要解決問題,請發出下列指令(以 root 身分):
ln -s $ORACLE_HOME/lib32/libclntsh.a /usr/lib/libclntsh.a
此指令可以明確啟動佇列管理程式。
此問題的情況不適於 WebSphere MQ 第 6 版。
若在相同的 HP-UX 系統上,安裝了 Oracle9i 或 Oracle10g 與 DB2v8,將管理系統與 Oracle 分配管理系統資料庫搭配使用時可能發生問題。
分配管理系統將無法啟動,並建立異常終止檔案。在檔案中,可以看到來自 Oracle 程式庫的符號在 DB2 程式庫中進行解析,導致區段違規。
若要搭配使用 Oracle 與分配管理系統,並在相同的 HP-UX 電腦上安裝 DB2,請將 imbdfdb2.lil 重新命名,以停用 <install_dir>/lib/imbdfdb2.lil 檔案。重新命名會讓分配管理系統停用 DB2 程式庫,避免 HP-UX 作業系統該程式庫解析 Oracle 符號。
Oracle XA 不支援與 AIX、Solaris 和 HP-UX 上的 64 位元執行群組一起運作。
不支援在資料庫中操作 Unicode 資料。
除了資訊中心 「Supported Databases」 主題中所述的限制之外,須注意只支援 32 位元 Informix Dynamic Server 與 32 位元用戶端 SDK。並不支援 64 位元 Informix 伺服器與用戶端。
Informix 用戶端的最低要求版本為備有 UC4X8 修正套件的 SDK 2.90 版,請聯絡 Informix 以索取這份修正套件。
無法在分配管理系統中,將訊息流程部署到 32 位元執行群組,而該分配管理系統是在 HP-UX(PA-RISC 平台)和 HP-UX(Integrity 平台)系統上啟動,並執行配備 DB2 9.1 版的 HP-UX 11.23。
在 64 位元執行群組上的部署則不受影響。
在資訊中心裡,說明 obbc.ini 範例檔案的主題(主題 ah14449_)並不完整:
在「WebSphere Message Broker 安裝手冊」及「WebSphere Event Broker 安裝手冊」提及的 HP-UX(Itanium 平台)已重新命名為 HP-UX(Integrity 平台)。
在「WebSphere Message Broker 安裝手冊」的第 1 章中,附有表格(表 4)提供支援資料庫的相關資訊,當中有關 Informix 的支援資訊並不正確。Informix 支援的正確資料如下:
未列於上方的平台皆不支援 Informix 資料庫。
在說明 ROUND 函數的資訊中心主題,例子在 MODE 與 RoundingMode 之間錯誤顯示了底線字元,底線字元應為空格。例如:
ROUND(5.5, 0 MODE_ROUND_UP); returns 6是不正確的,正確格式應為:
ROUND(5.5, 0 MODE ROUND_UP); returns 6
資訊中心的下列主題將說明在對映編輯器中拖放元素的能力。
然而,在 Linux 上的對映編輯器,無法正常使用拖放功能。因此無法從來源窗格,將來源元素拖曳到目標窗格的目標元素,也無法從來源窗格將來源元素拖曳到編輯窗格中。此外,也無法在 MapScript 窗格以拖放的方式,將元素上移或下移。這些動作的替代方法已記錄於資訊中。若要在 MapScript 窗格中移動元素,可以使用「複製及貼上」,或「刪除及重建/填入」動作。
在資訊中心有關 ACL 許可權的主題(主題 ap12520_),表格應包含 ConfigManagerProxy 物件一節,如下表所示:
物件 | 許可權 | 權限 |
---|---|---|
ConfigManagerProxy | 完整控制 |
|
檢視 |
|
此外,下列資訊也應該新增至表格的「拓蹼」小節中:
物件 | 許可權 | 權限 |
---|---|---|
拓蹼 | 完整控制 | 所有分配管理系統的完整控制權 |
用於 JavaCompute 節點的 GoogleAPINode 範例是「範例展示區」中的五種 JavaCompute 範例之一,由於使用的 Google API 發生變更會,導致其不能運作。目前無法使用此範例。
在 Linux 和 Windows 上,部分範例有輕微的可用性問題。請於使用前參閱下列 Technote:
http://www.ibm.com/support/docview.wss?rs=849&uid;=swg21239255
本資訊是針對 IBM 在美國所提供之產品與服務開發出來的。
IBM 不見得有提供本資訊中所提的各項產品、服務或功能。 請洽詢當地的 IBM 業務代表,以取得當地目前提供的產品和服務之相關資訊。這份文件在提及 IBM 的產品、程式或服務時,不表示或暗示只能使用 IBM 的產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,任何非 IBM 的產品、程式或服務,使用者必須自行負責作業的評估和驗證責任。
本資訊所說明的主題內容,IBM 可能擁有其專利或專利申請案。 提供本資訊不代表提供這些專利的授權。您可以書面提出授權查詢,來函請寄到:
如果是有關雙位元組 (DBCS) 資訊的授權查詢,請洽詢所在國的 IBM 智慧財產部門,或書面提出授權查詢,來函請寄到:
下列段落若與該國之法律條抵觸時,即視為不適用:
IBM 公司只依「現況」提供本出版品,不提供任何明示或默示之保證, 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。有些地區在特定交易上,不允許排除明示或暗示的保證,因此,這項聲明不一定適合您。
這項資訊中可能會有技術上或排版印刷上的訛誤。 因此,IBM 會定期修訂;並將修訂後的內容納入新版的資訊中。 IBM 隨時會改進及/或變更本資訊所提及的產品及/或程式,不另行通知。
這份資訊中所提及的任何非 IBM 網站只供參考,IBM 不為這些網站提供保證。 這些網站所提供的素材不是 IBM 本產品的素材內容,如果要使用這些網站的素材,您必須自行承擔風險。
IBM 得以各種適當的方式使用或散布由您提供的任何資訊,無需對您負責。
如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式(包括本程式)之間交換資訊, 以及 (ii) 相互使用所交換的資訊,因而需要相關的資訊,請洽詢:
這些資訊可依適當條款而取得,在某些情況下必須付費方得使用。
IBM 基於雙方之 IBM 國際程式設計授權合約(或任何同等合約)條款, 提供本資訊所提及的授權程式與其所有適用的授權資料。
本書所提及之非 IBM 產品資訊,取自產品的供應商,或其發布的聲明或其他 公開管道。IBM 並未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、 相容性或任何對產品的其他主張是否完全無誤。有關非 IBM 產品的性能問題應直接洽詢該產品供應商。
這份資訊含有日常商業運作所用的資料和報告範例。 為了要使它們儘可能完整,範例包括個人、公司、品牌和產品的名稱。 所有這些名稱都是虛構的,如有任何類似實際企業所用的名稱及地址之處,純屬巧合。
著作權:
這份資訊含有原始語言的範例應用程式,用以說明各作業平台中的程式設計技術。 您可以基於研發、使用、銷售或散布符合作業平台(撰寫範例程式的作業平台)之應用程式介面的應用程式等目的,以任何形式複製、修改及散布這些範例程式,而不必向 IBM 付費。 此些範例並未在所有情況下完整測試。因此,IBM 不保證或暗示這些程式的可靠性、有用性或功能。 您可以免費為了開發、使用、銷售或散布應用程式,利用任何形式來複製、修改和散布這些程式範例,不過,這些應用程式必須符合 IBM 的應用程式設計介面。
下列詞彙是 IBM 公司在美國及/或其他國家或地區的商標:
AIX、DB2、Everyplace、IBM、Universal Database、WebSphere、z/OS、zSeries。
Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。
Microsoft 和 Windows 是 Microsoft 公司在美國及/或其他國家或地區的商標。
UNIX 是 The Open Group 在美國及/或其他國家或地區的註冊商標。
Linux 是 Linus Torvalds 在美國及/或其他國家或地區的商標。
其他公司、產品或服務名稱,可能是第三者的商標或服務標記。
DB2 修正套件
您可以在 CDROM 或從 Web 下載取得 DB2 修正套件。然而,修正套件可能很大,因此建議索取 CDROM 版本,以免下載時間過長。
如果您有現行的支援合約,就可以聯絡 DB2 支援中心來訂購 CDROM 版的 DB2 修正套件。
聯絡的詳細資料提供於下列位置:
http://www.ibm.com/software/data/db2/udb/support.html
相同網站也有提供修正套件的下載。
WebSphere MQ 修正套件
http://www.ibm.com/software/integration/wmq/support/
WebSphere Message Brokers 修正套件
http://www.ibm.com/support/docview.wss?rs=171&uid;=swg27006367
WebSphere Message Broker 和 WebSphere Event Broker 需求
http://www-1.ibm.com/support/docview.wss?rs=849&uid;=swg27006548
及
http://www.ibm.com/software/integration/wbieventbroker/requirements/
WebSphere Message Broker 和 WebSphere Event
Broker Readme
http://www.ibm.com/support/docview.wss?rs=171&uid;=swg27006917
WebSphere Message Broker 和 WebSphere Event Broker 獨立資訊中心
Linux:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_linux.tgz
Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip
WebSphere Message Brokers 第 6 版線上說明
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r0m0/index.jsp
IBM Centre for Java Technology Development Downloads
http://www.ibm.com/developerworks/java/jdk/
Web 服務說明語言 (WSDL) 規格
http://www.w3.org/TR/wsdl
WebSphere
Message Broker 基礎概念(IBM Redbooks™ 出版品)
http://www.redbooks.ibm.com/abstracts/sg247137.html
移轉至 WebSphere Message Broker 第 6 版 (IBM Redbooks 出版品)
http://www.redbooks.ibm.com/abstracts/sg247198.html