歡迎使用 IBM WebSphere Message Broker 和 IBM WebSphere Event Broker。本 Readme 檔適用於 Fix Pack 2(執行時期),並且與開發工具及執行時期元件的 6.0.0.2 版相關。
The fix packs for the Runtime and Tooling components can be installed independently of each other, so you can choose to install either or both of them.
本 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 安裝手冊。這些手冊說明您必須在安裝產品前所要完成的作業。請在線上 IBM Publications Center 存取安裝手冊,網址是:
http://publib.boulder.ibm.com/epubs/pdf/c3466212.pdf (Message Broker)
http://publib.boulder.ibm.com/epubs/pdf/c3466222.pdf (Event Broker)
GA 之後,更新管理程式 (Update Manager) 將提供資訊中心的翻譯版本。
WebSphere Documentation CD 提供 WebSphere Message Broker 及 WebSphere Event Broker 的獨立式資訊中心,而且您可以在下列網址中取得: http://www.ibm.com/software/integration/wbimessagebroker/library/
您也可以從以下位址下載:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_lin.zip(Linux 版)
以及
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip(Windows 版)。
請閱讀 wmb_help_lin.zip 及 wmb_help_win.zip 檔中所包含的 installing_and_managing.htm 檔。
您可在以下位址找到可用於列印的資訊主題清單,以及 Rules and Formatter 的所有說明文件:
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 所支援的特定作業系統與資料庫版本的最新狀態,請參閱 WebSphere MQ Family Supported Software 網頁,網址如下:
http://www.ibm.com/support/docview.wss?uid=swg27007065
本節依元件概述 WebSphere Message Broker 及 WebSphere Event Broker 的限制。
如果您要在 Windows 上安裝執行時期元件,而且就在程序完成前顯示下列訊息,這表示已建立所需的安全群組:
mqsisetsecurity.exe 發生問題,而且需要關閉
發生這個問題的原因,是因為您解除安裝 Windows 元件中 Microsoft Networks 的「檔案及印表機共用」。 視不同 API 而由這個元件提供安全程式,而且除非安裝該元件否則無法順利完成。 如果非必要,無法停用該元件。
若要順利執行安裝程式,請完成下列步驟:
在任何 UNIX 平台上,如果沒有分配管理系統就安裝配置管理程式,隨後將分配管理系統安裝到相同的目錄,那麼幾個檔案符號鏈結將從分配管理系統的 lil 及 lil64 目錄中遺漏。 若要避免這個問題,您可以:
To upgrade the Message Brokers Toolkit to Version 6.0.0.2 (from either Version 6.0 or Version 6.0.0.1), you must use the Rational Product Updater (RPU), which must be at level 6.0.1 or later. If you are currently using an earlier version of the RPU, you must upgrade it to Version 6.0.1 before upgrading the Message Brokers Toolkit. For information on ugrading the RPU, see the WebSphere Message Broker Installation Guide (Third Edition, March 2006).
You can use the RPU to install the Message Brokers Toolkit (V6.0.0.2) either directly from the Web, or from a local system. The procedure for upgrading to Version 6.0.0.2 using the RPU is the same as that documented in the WebSphere Message Broker Installation Guide for upgrading to Version 6.0.0.1.
Additional instructions for upgrading the Message Brokers Toolkit and the Rational Product Updater are available from the WebSphere Message Broker and Event Broker V6.0 Toolkit Fix Pack 6.0.0.1 support page.
If you are using the RPU to install the package from a local system (rather than directly from the Web), the package you need to download varies according to the version you are upgrading from (Version 6.0 or Version 6.0.0.1):
在您將 6.0 版升級到 6.0.0.2 版 (Fix Pack 2) 後,您需要執行以下:
使用無聲自動安裝的回應檔時,檔案中會包含不正確的設定旗號。因此,如果選擇安裝一或多個特定元件,而不是整個產品,系統會忽略當初您所做的選擇,而安裝整個產品。若要克服這個問題,您需要編輯回應檔,並修改適當的旗號如下:
下面的指令行:
-W setupTypes.selectedSetupTypeId=custom
應改為:
-W setupTypes.selectedSetupTypeId=
(也就是不做設定)以避免執行一般預設或自訂安裝作業(即安裝所有元件)。
Technotes 包含數個關於 Message Broker 及 Event Broker Toolkit 安裝作業與 Rational Application Developer (RAD) 或 Rational Software Architect (RSA) 產品的重要問題。我們強烈建議您安裝 Message Brokers Toolkit 時,務必參考這些 Technotes。關於如何存取這些 Technotes 的資訊,都可在這份 Readme 中的支援一節取得。
如果您開發的訊息流程中,需要在「多重播送 PGM」支援使用 WebSphere MQ Real-time Transport with Multicast PGM, 就必須在受到影響的每個分配管理系統上,安裝 WebSphere MQ Version 6.0 或更新版本。 您也需要套用 APAR IC47032 及 USERMOD ANPGM01。
廣域區域或 root 非廣域區域都支援訊息分配管理系統,而且必須分別安裝在每個區域。
如果您已安裝 WebSphere Message Broker 的一或多個元件,然後再嘗試安裝其他元件,InstallShield 會檢查並判斷是否有足夠的空間來安裝整個產品,而不是只有您想要安裝的其他元件。因此,即使電腦上有足夠的空間可以安裝這些元件,您可能也無法順利執行。如果空間足以安裝整個產品,您才能夠順利地安裝所選取的元件。但是,如果空間不足,您將必須解除安裝先前已安裝的元件,然後重新開始。
「指令輔助精靈」目前無法管理配置管理程式元件。修正程式將會更正這個情形。
如果想要安裝 WebSphere MQ V6 Explorer 外掛程式以便能使用 WebSphere Message Brokers Toolkit,您可以使用 Eclipse Update Manager。然而,您必須先幫 WebSphere MQ 第 6 版安裝 6.0.1 版 Refresh Pack。
從 Eclipse 工具列,選取 說明 > 軟體更新 > 尋找和安裝。選取新特性選項。 新增 <WebSphere MQ 安裝目錄>/eclipse 為新的本端來源檔,接著便會顯示可安裝的 Explorer 功能。
在可以使用 6.0.1 版更新套件之前,您可以先手動複製包含 WebSphere MQ Explorer 功能的目錄,然後外掛至 WebSphere Message Brokers Toolkit 目錄。重新啟動 WebSphere Message Brokers Toolkit 後,就可以開啟 WebSphere MQ Explorer 成為新的視景。
當您使用 -options-record 旗標來建立回應檔,以便在無生自動安裝期間使用,該回應檔包含了一個設定不正確的旗標。因此,如果選擇安裝一或多個特定元件,而不是整個產品,系統會忽略當初您所做的選擇,而解除安裝整個產品。
若要克服這個問題,您需要編輯回應檔,並且修改每行指定是否解除安裝個別元件。 這表示您需要變更所有下列字串實例:
-P feature.active=true為以下:
-P feature.activeForUninstall=true其中 feature 是要解除安裝的元件名稱。
您也必須變更所有下列串實例:
-P feature.active=false為以下:
-P feature.activeForUninstall=false其中 feature 是您不要解除安裝的元件名稱。
您必須確認每個元件中都有這些陳述式中的其中之一(activeForUninstall=true 或 ctiveForUninstall=false)。
然而,在所產生的回應檔中,也可能有與尚未安裝元件有關的 activeForUninstall 陳述式。 如果有這樣的陳述式,請確認每個這些元件的 activeForUninstall 選項已設定為 true。如果這些陳述式的 activeForUninstall 選項已設定為 false,解除安裝程式就會失敗。
所有以下 Dublin Adapter 解決方案的使用者應該聯絡「Dublin Adapters 支援 (dubadsup@ie.ibm.com)」,以取得已在訊息分配管理系統第 6 版測試過的版本解決方案。請不要只有移轉第 5 版解決方案,因為這樣會導致運作上部分細微的差異。
在試圖移轉第 6 版解決方案之前,所有以下 Dublin Adapter 解決方案的使用者應該聯絡「Dublin Adapters 支援 (dubadsup@ie.ibm.com)」,確認是否有在訊息分配管理系統第 6 版測試過的版本解決方案可用,而且是否有任何其他問題:
如果您要從 WebSphere MQ Integrator 2.1 版移轉訊息集,且該訊息集包含了業界標準的 TDS 實體格式,例如 SWIFT,再加上您如果要部署該訊息及至 2.1 版分配管理系統(或至服務層次為 Fix Pack 3 之前的第 5 版分配管理系統),您需要在使用 mqsimigratemsgsets 指令後,完成以下步驟:
如果您不作此更新,在您新增訊息集至 BAR 檔(訊息中的 CSD3 指修正套件 3)時, 會出現以下訊息:
BIP0202W 本字典檔需要第 5 版 CSD3 或更新版本的分配管理系統。TDS 格式 "SWIFT" 使用「嚴格數值檢查」。第 5 版 CSD 3 之前的分配管理系統不支援此選項。
在正確部署 BAR 檔前,您必須更正此錯誤。
使用 Real-timeInput 節點及發佈/訂閱應用程式時,在所有分散式平台上可能發生 DataFlowEngine 程序的記憶洩漏。DataFlowEngine 程序所使用的記憶體不斷地增加,而這要視平台及發佈/訂閱用戶端的數量而定。
如果記憶體不夠執行 DataFlowEngine 程序時,程序便會停止。在 Windows,'errors' 資料夾會產生 ABEND 檔及傾出的現象。在其他系統上,則產生 ABEND 檔及核心檔。然後便重新啟動 DataFlowEngine 程序。
例如,在分配管理系統的執行群組中使用單一訊息流程(以及其他實例),加上 80 個發佈/訂閱用戶端在 4 向 - 4GB 電腦執行 Windows,大約 1.5 小時之後 DataFlowEngine 程序就會停止。
您有可能在系統事件日誌中看到的錯誤如下:
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 Virtual Machine Heap 大小。如果您使用 Real-timeOptimizedFlow 節點代替 Real-timeInput 節點,您可以排除部分記憶體問題。
z/OS 平台:如果併入 Trace 節點,且該節點的目的地內容設定為 "User Trace",那麼在高傳輸量的訊息流程中,會停止擁有執行群組(異常終止 S2C1)。由於 Trace 節點都在作用中,正常來說應該併入生產流程。不過為了避免這個問題,請確認所連結的 Trace 節點沒有併入高傳輸量的流程,且一律處於作用中的狀態,因為這些節點將會有大量的 I/O 負擔。
如果您要使用流程除錯器,不論電腦的語言環境為何,分配管理系統和執行群組的名稱都必須使用英文字母。
如果 /usr/lib 沒有鏈結到 Oracle 支援 32 位元用戶端程式庫的 'libclntsh.a',那麼安裝 WebSphere MQ queue manager 並啟用 XA 的 AIX 無法明確地開機。
若要解決這個問題,請以 root 的身分發出下列指令:
ln -s $ORACLE_HOME/lib32/libclntsh.a /usr/lib/libclntsh.a
如此一來,佇列管理程式便能明確地開機。
請注意這個方式不適用於 WebSphere MQ 第 6 版。
如果您將 Oracle9i 或 Oracle10g 與 DB2v8 一起安裝在同一個 HP-UX 系統上,您有可能遇到在 Oracle 分配管理系統資料庫上使用分配管理系統的問題。
分配管理系統可避免啟動後發生問題,而且建立了異常終止檔。您可以在檔案中看到 Oracle 程式庫在 DB2 程式庫中所解析的符號,引起區段違規。
如果您要在 Oracle 系統上使用分配管理系統,且在相同的 (HP-UX) 電腦上安裝 DB2,請停用 <install_dir>/lib/imbdfdb2.lil 檔。最簡單的方法就是以其他名稱重新命名 imbdfdb2.lil。這樣就可以停止分配管理系統取得 DB2 程式庫,然後使用 HP-UX 作業系統來解析 Oracle 符號。
含有 64 位元 EG 的 AIX、Solaris,以及 HP-UX不支援 Oracle XA。
不支援 Unicode 資料的操作。
除了資訊中心的 "Supported Databases" 主題中所說明的限制,請注意所支援的只有 32 位元的 Informix Dynamic Server 及 32 位元 Client SDK。目前不支援 64 位元 Informix 伺服器或用戶端。
Informix 用戶端的最少所需的版本是 SDK V2.90(含 UC4X8 Fix Pack);請聯絡 Informix 以取得這個 Fix Pack。
In addition to the database support described in the Databases section of this chapter, WebSphere Message Brokers Version 6.0.0.2 (Fix Pack 2) also includes the following database support on Solaris (x86 platform):
For further details about support and configuration, see the information center.
本章關於主控台模式有無效選項
-accessibility的說明。 不過這個選項是不存在的。在主控台模式中指定僅用選項
-console來安裝程式。 這個選項代表文字介面,適用於安裝過程中只用鍵盤來選擇值與導覽的使用者,以及內含像是 JAWS 的螢幕閱讀器軟體。
On Linux and Windows, some of the samples have minor usability problems. Before using them, refer to the
following Technote:
http://www.ibm.com/support/docview.wss?rs=849&context=SSKM8N&context=SSKMAB&q1=samples&uid=swg21239255&loc=en_US&cs=utf-8&lang=en
本資訊是針對 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 Fix Pack
您可以從 CDROM 取得 DB2 Fix Pack,或可以從 Web 下載。不過,請注意,Fix Pack 可能很大,所以您可以申請 CDROM 版本,以免下載時間過長。
如果您有現行的支援合約,就可以聯絡 DB2 支援中心來訂購 CDROM 版的 DB2 Fix Pack。
聯絡的詳細資料提供於下列位置:
http://www.ibm.com/software/data/db2/udb/support.html
您也可以由同一個網站下載。
WebSphere MQ Fix Pack
http://www.ibm.com/software/integration/wmq/support/
WebSphere Message Brokers Fix Pack
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367
WebSphere Message Broker and WebSphere Event Broker 需求
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
以及
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_lin.zip
Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip
WebSphere Message Brokers V6 線上說明
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 Basics (紅皮書)
http://www.redbooks.ibm.com/abstracts/sg247137.html
Migration to WebSphere Message Broker V6 (紅皮書)
http://www.redbooks.ibm.com/abstracts/sg247198.html