適用於 Microsoft Windows 的 Sun Java System Message Queue 3.7 UR1 版本說明

第 1 章 適用於 Microsoft Windows 的 Sun Java System Message Queue 3.7 UR1 版本說明

此版本說明包含在 Sun Java™ System Message Queue 3.7 UR1 (「Message Queue」) 發行時所提供的重要資訊。其中包括新增功能和增強功能、已知的問題與限制以及其他資訊。開始使用 Message Queue 之前,請先閱讀此文件。

此版本說明的最新版本可在 Sun 文件網站中找到,網址為 http://docs.sun.com。請在安裝與設定軟體之前瀏覽此網站,且日後定期檢視最新版本說明與產品文件。

此版本說明包含下列各節︰

本文件中提供了協力廠商 URL 以供參考,另亦提供其他相關的資訊。

Sun 對本文件中提到的協力廠商網站的可用性不承擔任何責任。對於此類網站或資源中的 (或透過它們所取得的) 任何內容、廣告、產品或其他材料,Sun 並不表示認可,也不承擔任何責任。對於因使用或依靠此類網站或資源中的 (或透過它們所取得的) 任何內容、產品或服務而造成的、名義上造成的或連帶產生的任何實際或名義上之損壞或損失,Sun 概不負責,也不承擔任何責任。

關於 Message Queue 3.7 UR1

Sun Java System Message Queue 為全方位功能的訊息服務,可提供符合 Java Messaging Specification (JMS) 1.1 規格且可靠的非同步訊息傳送。此外,Message Queue 還提供多種 JMS 規格以外的功能,以滿足大型企業的使用需求。

Message Queue 3.7 UR1 是 Message Queue 3.6 的維護版本,包含錯誤修正與一些略微增強的功能。本節包含下列資訊:

此發行版本的新增功能

以下各節說明 Message Queue 3.7 UR1 的新增功能:

將 Platform 功能與 Enterprise 功能合併在同一版本中

為簡化產品提供,從 Message Queue 3.7 UR1 開始,Sun Java Message Queue 的 Platform Edition 和 Enterprise Edition 已合併為單一版本。如此可確實取消獨立發行軟體的功能限制,理應能簡化本產品的使用方式。

合併版本也可以使 Message Queue 與 Solaris Enterprise System 更加一致,使您能長期使用 Enterprise Edition 功能,而無需支援、維護或補充功能。與之前發行版本相同,我們將繼續提供支援與維護服務的多項授權方案。Java Enterprise System 與 Application Platform Suite 會繼續隨附 Message Queue。請查看位於 http://www.sun.com 的線上商店或洽詢當地銷售代表,以選擇最適合您需求的方案。下表說明升級至新的 Message Queue 單一版本的路徑。

表 1–1 Message Queue 3.7 UR1 的升級路徑

先前的版本 

升級路徑 

說明 

Platform Edition 

Sun Java System Message Queue 3.7 UR1 

現在使用此版本的客戶可使用所有的功能。若不購買授權,將無法選擇支援方案。 

Enterprise Edition 

Sun Java System Message Queue 3.7 UR1 

功能未變更。提供多種授權與支援方案。 

Platform Edition 支援合約 

升級為 Enterprise Edition 支援合約 

先前的 Platform Edition 發行版本的現有支援合約可繼續續約。Sun 不會為先前的 Platform Edition 發行版本核發新的 Platform Edition 合約。 

Enterprise Edition 支援合約 

無變更。 

現有合約可繼續續約。會核發新的合約。 

下表說明各項 Message Queue 產品的提供來源變更。

表 1–2 Message Queue 產品的提供來源變更

產品 

先前的提供來源 

新的提供來源 

說明 

Message Queue 

不適用 

Sun 下載中心的產品頁面 

獨立下載。僅支援社群。無支援合約。 

Message Queue Platform Edition 

透過 Sun 下載中心的 Message Queue 產品頁面 

不再提供 

頁面將全部指向 Message Queue 的單一版本 

Message Queue Enterprise Edition 試用版 (透過 Platform Edition) 

透過 Sun 下載中心的 Message Queue 產品頁面 

目前不再需要試用授權 

不再需要 

Message Queue Enterprise Edition 90 天試用版 (透過 Java Enterprise System 下載或 DVD) 

Java Enterprise System 下載中心 (適用於版本 3 GA (2006 年 3 月) 之前的版本) 

Solaris Enterprise System 下載中心 

Solaris Enterprise System 授權。沒有產品授權將無法使用支援方案。 

透過 SunStore、DVD、獨立授權、Java Enterprise System 授權、Suite 授權,以及由 Java Enterprise System 所提供的 Message Queue Enterprise Edition 

Java Enterprise System 或 Suite 下載中心、媒體 

Solaris Enterprise System 或 Suite 下載中心、媒體提供 

無變更。 

C-API 與 C 用戶端執行階段的介面變更

永久性存放區格式變更

為了改善效能,已對 Message Queue 的永久性存放區格式做了兩項變更。其中一項變更是針對檔案存放區,另一項是針對 JDBC 存放區。

由於這些變更會影響存放區的相容性,因此存放區版本已從 350 變更為 370。Message Queue 3.7 UR1 支援將永久性存放區 (JDBC 存放區與檔案式存放區) 從舊的 200 與 350 版本自動轉換為 370 版本。初次啟動 imqbrokerd 時,如果公用程式偵測到舊版存放區,則會將該存放區遷移至新的格式,同時保留舊版存放區。

如果需要回復此升級動作,請解除安裝 Message Queue 3.7 UR1,然後重新安裝之前執行的版本。由於舊版的存放區副本保留不變,因此代理程式可利用舊版的存放區副本執行。

硬體與軟體需求

「Sun Java Enterprise System Installation Guide」中提供了 Message Queue 的硬體與軟體需求。

此版本中已修正的錯誤

本節說明 Message Queue 3.7 UR1 中已修正的錯誤。

表 1–3 Message Queue 3.7 UR1 中已修正的錯誤

錯誤編號 

說明 

6193884 

在非 C 語言環境中,Message Queue 輸出無用訊息到 syslog。 

6251450 

叢集關機期間,遍歷 connectList 物件時發生 ConcurrentModificationException

6252763 

java.nio.HeapByteBuffer.putLong/Int 中發生 java.nio.BufferOverflowException

6260076 

使用 Oracle 儲存,自代理啟動第一則訊息發佈後,訊息發佈變慢。 

6264003 

佇列瀏覽器顯示未經確定的訊息。 

6260814 

處理 JMSXUserID 的選擇器一律視為 false

6271876 

連線流量控制在關閉具有未使用訊息的用戶時,無法正常運作。 

6284769 

即使在每次列舉時建立新瀏覽器並關閉,QueueBrowser 仍然發生記憶體錯誤。 

6294767 

Message Queue 代理程式需要在它開啟的網路通訊端上設定 SO_REUSEADDR

6304043 

代理程式未驗證共用非長期訂閱的 clientID 是否不為空值。

6307056 

txn 記錄是效能瓶頸。 

6320138 

Message Queue C API 無法從回覆傳送標頭判斷佇列的名稱。 

6320325 

在 Solaris 作業系統上,即使同時安裝了 JDK 1.4 與 JDK 1.5 版本,代理程式有時仍會先選擇 JDK 1.4。 

6321117 

多代理程式叢集初始化丟出 java.lang.NullPointerException

6330053 

確認訂閱者的作業事件時,jmsclient 丟出 java.lang.NoClassDefFoundError

6340250 

C-API 支援 MESSAGE 類型。

6351293 

新增對 Derby 資料庫的支援。 

6381693 

用戶代理程式重新啟動後,重新傳送給遠端用戶的訊息之 JMSRedelivered 旗標設定為 false。

6388049 

無法清除不完整的 XA 作業事件。 

6403968 

新增以用戶為基礎的流量控制協定,為多個接收者進行負載平衡。 

6403958 

當停用的訊息佇列嘗試移除最舊的非永久性訊息時,發生代理程式異常。 

6406862 

代理程式錯誤「監視目標錯誤 mq.metrics.destination.queue.Name」。

6415068 

作業事件回復在 AS 8.1 UR2 (JMS Message Queue 的通用資源介面) 中失敗。 

6421781 

支援使用下列語法連線到代理程式 

—b mqtcp://hostName:portNumber/serviceName

6423696 

實際上,Session.rollback 不會在 COMMIT REPLY 錯誤之後回復已使用的訊息。

6314103 

如果目錄名稱包含空格,則無法安裝 Message Queue 。 

6314088 

6392963 

如果目錄名稱多於 6 個字元,則無法安裝 Message Queue。例如 C:\Software\Sun

重要資訊

本節包含核心產品文件中所沒有的最新資訊。本節涵蓋下列主題:

安裝說明

如需在 Solaris、Linux 和 Windows 平台上安裝 Message Queue (獨立產品) 的安裝前指示、升級程序和其他所有相關資訊,請參閱「Sun Java System Message Queue 3.7 UR1 Installation Guide」。

如需在 Solaris、Linux、HPUX 和 Windows 作業系統上安裝 Message Queue 產品 (隨附於 Java Enterprise System) 的安裝前指示和其他所有相關資訊,請參閱「Sun Java Enterprise System Installation Guide」。

如需在 Solaris、Linux、HPUX 和 Windows 作業系統上升級至 Message Queue (作為 Java Enterprise System 的一部分) 的升級和遷移相關資訊,請參閱「 Sun Java Enterprise System Upgrade and Migration Guide」。

相容性問題

本節涵蓋 Message Queue 3.7 UR1 中的相容性問題。

介面穩定性

Message Queue 使用許多介面,這些介面可能會隨時間而有所變更。「Sun Java System Message Queue 3.7 UR1 Administration Guide」中的附錄 B「Stability of Message Queue Interfaces」根據介面穩定性對其進行分類。介面愈穩定,在後續版本中變更的可能性愈小。

與下一個主要 Message Queue 發行版本相關的問題

Message Queue 的下一個主要發行版本可能會引入新的變更,而導致您的用戶端與該發行版本不相容。現在提供這個資訊是為了讓您對這些變更做好準備。

Message Queue 3.7 UR1 的文件更新

下列各節說明 Message Queue 文件除了略微修正與增訂之外,還有哪些更新以及變更。

安裝指南

Sun Java System Message Queue 3.7 UR1 Installation Guide」(說明 Message Queue 獨立版本的安裝資訊) 已更新,以反映特定平台的資訊。

C 用戶端的開發者指南

Sun Java System Message Queue 3.7 UR1 Developer’s Guide for C Clients」已更新,因為已經有新的 MQGetDestinationName 函數、MQ_Message 訊息類型,以及 MQ_UPDATE_RELEASE_PROPERTY 連線特性。

Java 用戶端的開發者指南

Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients」已更新,加入設定安全用戶端,以及用戶端如何處理自動重新連線期間發生的異常之相關資訊。

管理指南

「Sun Java System Message Queue 3.7 UR1 Administration Guide」已更新,提供代理程式資料庫表格,及配置代理程式以使用固定連接埠的相關資訊。

已知的問題與限制

本節包含 Message Queue 3.7 UR1 的已知問題清單。涵蓋以下的產品區域:

如需目前錯誤、錯誤狀態以及解決方法的清單,Java Developer ConnectionSM 成員請檢視 Java Developer Connection 網站上的「Bug Parade」頁面,網址為 http://bugs.sun.com/bugdatabase/index.jsp。在您報告新的錯誤之前,請先檢視此頁面。雖然此頁面未列出所有的 Message Queue 錯誤,但若想知道某一問題是否已有人報告,這會是個不錯的起點。


備註 –

可免費獲得 Java Developer Connection 成員資格,但需要註冊。Sun 的「For Developers」網頁上會提供有關如何成為 Java Developer Connection 成員的詳細資訊。


若要報告新的錯誤或提交功能請求,請將電子郵件傳送至 imq-feedback@sun.com

一般問題

LDAP 使用者儲存庫特性

在 Message Queue 3.7 UR1 中,將 LDAP 伺服器當成使用者儲存庫使用的代理程式配置範例,會列在 config.properties 的註釋區中。default.properties 檔案中的 LDAP 使用者儲存庫範例則會標示為註釋。

若之前使用的特性值,屬於 default.properties 檔案中指定的任何範例 LDAP 使用者儲存庫特性,一旦您升級到 Message Queue3.7 UR1 之後,JMS 應用程式用戶端在嘗試建立 JMS 連線時,會收到安全性異常。

當 JMS 用戶端嘗試連線到 Message Queue 3.7 UR1 代理程式時,會將錯誤記錄到您的代理程式記錄檔中,同時 JMS 用戶端亦會收到下列異常:

SecurityException.
20/Aug/2004:11:16:41 PDT] ERROR [B4064]: Ldap repository ldap property
.uidattr not defined for authentication type 
basic:com.sun.messaging.jmq.auth.LoginException: 
[B4064]: Ldap repository ldap property .uidattr not defined 
for authentication type basic

解決方法:遵照「Sun Java System Message Queue 3.7 UR1 Administration Guide」中的第 7 章「Managing Security」中的指示,設定代理程式特性 imq.user_repository.ldap.uidattr

代理程式叢集

下列項目與使用代理程式叢集相關。

管理/配置

下列問題與 Message Queue 的管理及配置相關。

代理程式問題

下列問題會影響 Message Queue 代理程式。

文件

Message Queue 3.7 UR1 沒有獨立產品。如需此發行版本,必須使用 Java Enterprise System 安裝程式安裝 Message Queue。請參閱「Sun Java System Installation Guide」以取得相關指示。

安裝問題

可再分發的檔案

Sun Java System Message Queue 3.7 UR1 包含的下列檔案集,可讓您以二進位格式使用和分發:

jms.jar

libmqcrt.so (UNIX)

imq.jar

libmqcrt.so (HPUX)

imqxm.jar

mqcrt1.dll (Windows)

fscontext.jar

 

此外,您還可以重新分發 LICENSECOPYRIGHT 檔案。

為殘障人士提供的無障礙功能

欲獲得此媒體發佈以來已發行的無障礙功能,請向 Sun 索取依據美國「Section 508」法規進行產品評估所得之結果文件,以便決定最適合部署無障礙功能解決方案的版本。以下網址將提供應用程式的更新版本:

http://sun.com/software/javaenterprisesystem/get.html

如需有關 Sun 在無障礙功能方面之成果的資訊,請至 http://sun.com/access

如何報告問題和提供建議

如果您對 Sun Java System Message Queue 存有任何疑問,請使用以下任一機制與 Sun 客戶支援中心連絡:

為了讓我們能更有效地幫助您解決問題,當您與支援人員連絡時,請準備好以下資訊:

Message Queue 軟體論壇

Sun Java System Message Queue 的論壇位於:http://swforum.sun.com/jive/forum.jspa?forumID=24

我們非常歡迎您的加入討論。

Java 技術論壇

您可能會對 Java 技術論壇中的 JMS 論壇感到興趣,位址在:http://forum.java.sun.com

Sun 歡迎您提出寶貴意見

Sun 致力於提高文件品質,因此誠心歡迎您提出意見與建議。

若要分享您的意見,請至 http://docs.sun.com,並按一下 [Send Comments (傳送您的意見)]。在線上表單中,請提供文件標題和文件號碼。文件號碼是一個七位或九位的數字,可以在書的標題頁面或文件的頂部找到。例如,本書的書名是「適用於 Microsoft Windows 的 Sun Java System Message Queue 3.7 UR1 版本說明」,文件號碼為 820-1812。

在您提出意見時,可能需要在表單中輸入英文版書名和文件號碼,本書的英文版文件號碼和書名為:819-5693 和「Sun Java System Message Queue 3.7 UR1 Release Notes for Microsoft Windows」。

其他 Sun 資源

您可在下列網際網路位置找到有用的 Message Queue 資訊: