第 1 章 リリースノート

Version 4.4

Part No. 821-0892-05

このリリースノートには、Sun GlassFish メッセージキュー 4.4 のリリース時点で入手できる重要な情報が含まれています。ここでは、新機能、拡張機能、既知の問題、制限事項などについて説明します。メッセージキュー 4.4 をご使用になる前に、このリリースノートをお読みください。

このリリースノートには、メッセージキュー 4.3、4.2、4.1 および 4.0 のリリースに関する情報も含まれています。たとえば、各リリースで導入された機能については、「メッセージキュー 4.2 の新機能」、「メッセージキュー 4.1 の新機能」、および「メッセージキュー 4.0 の新機能」をそれぞれ参照してください。

これらのリリースノートの最新版は、Sun GlassFish メッセージキュー ドキュメント Web サイト (http://docs.sun.com/coll/1307.7) から入手できます。ソフトウェアをインストールおよび設定する前だけでなく、それ以降も定期的にこの Web サイトをチェックして、最新のリリースノートと製品ドキュメントを確認してください。

このリリースノートは、次の節で構成されています。

• 「リリースノート改訂履歴」

• 「メッセージキュー 4.4 の概要」

• 「メッセージキュー 4.4 でサポートされるプラットフォームとコンポーネント」

• 「メッセージキュー 4.4 の新機能および最近のリリース」

• 「今後のリリースで使用されなくなる機能」

• 「メッセージキュー 4.4 で修正されたバグおよび最近のリリース」

• 「メッセージキュー 4.4 のドキュメントの更新」

• 「既知の問題点と制限事項」

• 「再配布可能なファイル」

• 「障害を持つユーザー向けのアクセシビリティー機能」

• 「問題の報告とフィードバックの方法」

• 「このドキュメントに関するコメント」

• 「その他の情報」

このドキュメント内で参照している第三者の URL は、追加の関連情報を提供します。

このドキュメント内で引用する第三者の Web サイトの可用性について Sun は責任を負いません。こうしたサイトやリソース上の、またはこれらを通じて利用可能な、コンテンツ、広告、製品、その他の素材について、Sun は推奨しているわけではなく、Sun はいかなる責任も負いません。こうしたサイトやリソース上の、またはこれらを経由して利用可能な、コンテンツ、製品、サービスを利用または信頼したことに伴って発生した (あるいは発生したと主張される) いかなる損害や損失についても、Sun は一切の責任を負いません。

リリースノート改訂履歴

次の表は、メッセージキュー 製品のすべての 4.x リリースの日付と、各リリースに関連するこのドキュメントの変更内容を示しています。

メッセージキュー 4.4 の概要

Sun GlassFish メッセージキュー は、多くの機能を備えるメッセージサービスで、Java Messaging Specification (JMS) 1.1 に準拠する信頼性の高い非同期メッセージングを提供します。メッセージキュー では、JMS 仕様を超える機能も用意され大規模企業のシステム配備のニーズにも対応できるようになっています。

メッセージキュー 4.4 は、Sun GlassFish Application Server の 2.1.1 リリースに追加するために作成されたマイナーリリースです。したがって メッセージキュー 4.4 については、個別にダウンロードおよびインストール可能な配布はありません。

メッセージキュー 4.4 でサポートされるプラットフォームとコンポーネント

この節は、メッセージキュー 4.4 システム要件に関する次のトピックで構成されています。

• 「オペレーティングシステムプラットフォーム のサポート」

• 「システムの仮想化のサポート」

• 「コンポーネントの依存関係」

オペレーティングシステムプラットフォーム のサポート

メッセージキュー 4.4 は、Solaris、Linux、Windows、および AIX オペレーティングシステムのプラットフォームでサポートされます。表 1–2 に、サポートされる各プラットフォームのバージョンを示します。各プラットフォームのハードウェア要件については、『Sun GlassFish Message Queue 4.4 Installation Guide 』を参照してください。

システムの仮想化のサポート

システムの仮想化は、複数のオペレーティングシステム (OS) インスタンスを共用ハードウェア上で個別に実行できるようにするテクノロジです。機能的にいうと、仮想化された環境でホストされる OS に配備されたソフトウェアは、通常はベースとなるプラットフォームが仮想化されていることを認識しません。Sun では、精選されたシステムの仮想化と OS の組み合わせについて、その Sun Java System 製品のテストを行なっています。これは、Sun Java System 製品が、適切な規模と構成の仮想化環境でも、仮想化されていないシステム上の場合と同様に機能することを効果的に確認するためのテストです。仮想化された環境での Sun Java System 製品に対する Sun のサポートの詳細は、http://download.oracle.com/820-4651 を参照してください。

コンポーネントの依存関係

プラットフォーム固有の要件のほかに、メッセージキュー 4.4 は特定の基本コンポーネントにも依存します。メッセージキュー クライアントを開発して実行する場合は、それらのコンポーネントをインストールしてください。表 1–3 に、それらのコンポーネントを示します。ほかのバージョンまたはベンダー製品も実装できますが、それらは Sun Microsystems によるテストが実施されていないため、公式にはサポートされません。

Solaris、Linux、および Windows プラットフォームの メッセージキュー インストーラでは、既存の JDK/JRE を選択したり、JDK バージョン (1.5.0_15) をインストールすることができます。

表 1–4 に、メッセージキュー クライアントのサポートを追加するためにインストールできるその他のコンポーネントを示します。一覧に示されているコンポーネントのすべてが必要とは限りません。たとえば、C クライアントを作成しない場合は、C コンパイラ、C++ 実行時ライブラリ、NSPR、または NSS は必要ありません。

メッセージキュー 4.4 の新機能および最近のリリース

メッセージキュー 4.4 の新機能と、メッセージキュー 4.x ファミリのこれまでのリリースの新機能を、次の節に示します。

• 「メッセージキュー 4.4 の新機能」

• 「メッセージキュー 4.3 の新機能」

• 「メッセージキュー 4.2 の新機能」

• 「メッセージキュー 4.1 の新機能」

• 「メッセージキュー 4.0 の新機能」

メッセージキュー 4.4 の新機能

メッセージキュー 4.4 は、多数の機能拡張とバグ修正を含むマイナーリリースです。この節では、このリリースに含まれる新しい機能を説明します。

• 「JMS ブリッジサービス」

• 「STOMP ブリッジサービス」

• 「その他の拡張機能」

JMS ブリッジサービス

JMS の仕様では、ブローカとクライアント間の通信に使用するワイヤープロトコルが定義されていないため、メッセージキュー を含む各 JMS プロバイダは、独自のプロトコルを定義して使用しています。この状況により、JMS プロバイダ間の相互運用性が失われてきました。

メッセージキュー 4.4 の JMS ブリッジサービスは、メッセージキュー ブローカが自身の送信先を外部 JMS プロバイダにある送信先にマッピングできるようにすることで、相互運用性の問題を解消します。実際にこのマッピングにより、メッセージキュー ブローカは外部 JMS プロバイダのクライアントと通信できるようになります。

JMS ブリッジサービスは、次のような外部 JMS プロバイダにある送信先のマッピングをサポートします。

• JMS 1.1 に準拠している

• JNDI 管理オブジェクトをサポートしている

• javax.jms.ConnectionFactory または javax.jms.XAConnectionFactory タイプの接続ファクトリを使用している

• トランザクションマッピングで、XA インタフェースをリソースマネージャーとしてサポートしている

オープンソースおよび商用の JMS プロバイダの多くは、これらの要件を満たしています。したがって JMS ブリッジサービスは、ほかの JMS プロバイダを使用している既存のメッセージング環境に メッセージキュー を統合するための効果的な方法となります。

JMS ブリッジサービスの詳細は、次の情報を参照してください。

• JMS ブリッジサービスのアーキテクチャー、サブコンポーネント、および機能については、『Sun GlassFish Message Queue 4.4 Technical Overview』の「JMS Bridge Service」を参照してください。

• ブローカで JMS ブリッジを設定および管理する方法については、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Configuring and Managing JMS Bridge Services」を参照してください。

STOMP ブリッジサービス

すでに説明したように、JMS 仕様にはブローカとクライアント間の通信に使用するワイヤープロトコルが定義されていません。STOMP (Streaming Text Oriented Messaging Protocol) オープンソースプロジェクト (http://stomp.codehaus.org) は、任意の言語で記述されたクライアントが STOMP プロトコルをサポートするメッセージングプロバイダとの通信に使用できる、単純なワイヤープロトコルを定義します。

メッセージキュー 4.4 は、STOMP ブリッジサービスを通して STOMP プロトコルのサポートを提供します。このサービスにより、メッセージキュー ブローカは STOMP クライアントと通信できます。

STOMP ブリッジサービスの詳細は、次の情報を参照してください。

• STOMP ブリッジサービスのアーキテクチャーと機能については、『Sun GlassFish Message Queue 4.4 Technical Overview』の「STOMP Bridge Service」を参照してください。

• ブローカで STOMP ブリッジを設定および管理する方法については、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Configuring and Managing STOMP Bridge Services」を参照してください。

その他の拡張機能

メッセージキュー 4.4 には、次の拡張機能も追加されています。

• 「新しい Universal Message Service (UMS) の機能」

• 「IPS パッケージのサポート」

新しい Universal Message Service (UMS) の機能

UMS には、HTTP GET を使用して次のようなサービスを提供する機能が追加されました。

• ssend: 単純なテキストメッセージを送信します。

• sreceive: 単純なテキストメッセージを受信します。

• getBrokerInfo: ブローカに関する情報を取得します。

• getConfiguration: UMS 設定に関する情報を取得します。

• debug: UMS サーバーのデバッグロギング機能をオンまたはオフにします。

• ping: ブローカと通信し、動作を確認します。

UMS の概要については、「Universal Message Service (UMS)」を参照してください。UMS API のドキュメントについては、https://mq.dev.java.net/4.3-content/ums/protocol.html を参照してください。各言語のプログラミング例については、https://mq.dev.java.net/4.3-content/ums/examples/README.html を参照してください。

IPS パッケージのサポート

現在の メッセージキュー は、オープンソースの Image Packaging System (IPS) を使用して配布用にパッケージされています。IPS は、pkg(5) システムとも呼ばれます。このパッケージ方法は、メッセージキュー を Sun GlassFish Enterprise Server 2.1.1 に統合するために追加されました。

メッセージキュー 4.3 の新機能

メッセージキュー 4.3 は、多数の機能拡張とバグ修正を含むマイナーリリースです。この節では、このリリースに含まれる新しい機能を説明します。

• 「Universal Message Service (UMS)」

• 「AIX プラットフォームのサポート」

• 「新しい ZIP ベースのインストーラ」

• 「プラットフォームサポートの拡張」

Universal Message Service (UMS)

メッセージキュー 4.3 では、HTTP 対応デバイスから Message Queue にアクセスするための、新しい UMS (Universal Message Service) とメッセージング API が導入されました。これにより、ほとんどのアプリケーションがほかのアプリケーションと通信できるようになり、JMS メッセージングの信頼性と保証された配信による利益を受けられるようになりました。また、UMS は JMS メッセージングのスケーラビリティーを拡張し、メッセージングクライアントの数がインターネットクラスの規模に達する場合でも対応できます。

アーキテクチャー

基本的な UMS のアーキテクチャーを次の図に示します。

図 1–1 UMS のアーキテクチャー

UMS は Web サーバーで動作し、言語的に中立でプラットフォームに依存しません。UMS は、非 JMS クライアントアプリケーションと JMS プロバイダ間のゲートウェイとして機能します。UMS API を使用して送信されたメッセージを受信し、受信したメッセージを JMS メッセージに変換して、JMS プロバイダのネイティブプロトコルを使用してプロバイダ内の送信先に送信します。同様に、JMS プロバイダの送信先からメッセージを受信してテキストまたは SOAP メッセージに変換し、UMS API を通してクライアントから要求されたとおりに、非 JMS クライアントにメッセージを送信します。

単純で言語に依存しないプロトコルベースの UMS API は、Web ベースのアプリケーションと非 Web ベースのアプリケーションの両方をサポートし、スクリプトおよびプログラミング言語の両方で使用できます。API は、REST (Representational State Transfer) 形式のプロトコルを使用する単純なメッセージング API と、SOAP メッセージヘッダーにプロトコルを埋め込む XML メッセージング API の、2 つの形式で提供されます。どちらの場合も、API は単一の http 要求だけを使用して、メッセージの送信または受信を行います。

UMS API の単純性と柔軟性により、AJAX、.NET、Python、C、Java、およびその他の多くのアプリケーションで、JMS 送信先にテキストメッセージや SOAP (添付ファイルを含む) メッセージを送信したり、JMS 送信先からメッセージを受信することができます。たとえば、Python アプリケーションは .NET アプリケーションと通信でき、iPhone は Java アプリケーションと通信することができます。

メッセージキュー 4.3 では、UMS は JMS プロバイダとして メッセージキュー のみをサポートします。

その他の機能

UMS は、先に述べた単純なゲートウェイとして機能するだけではありません。ステートレスクライアントセッションだけでなくステートフルセッションもサポートします。クライアントから要求された場合、UMS はクライアントアプリケーションのセッション状態を複数のサービス要求間で維持します。UMS でコンテナ管理による認証を使用したり、Message Queue ブローカとクライアントを認証するように設定することもできます。UMS はトランザクションもサポートするため、クライアントアプリケーションは複数のサービス要求を単一の不可分な単位としてコミットまたはロールバックすることができます。

UMS は Message Queue ブローカとの単一の接続上で多数のクライアントをサポートできるため、スケーラビリティーが最大となるように、ブローカの接続サービス上の負荷を軽減します。また、UMS の能力を水平方向に拡大することで、インターネットクラスの規模のメッセージング負荷に対応することもできます。

プロトコルベースの UMS API は単純であるため、クライアント側にクライアントライブラリは必要ありません。したがって、将来的に API を拡張して、クライアントアプリケーションをアップグレードすることなく、JMS の追加機能を実装することができます。

UMS の使用法

UMS を使用するには、Servlet 2.4 以降の仕様をサポートする Web コンテナに UMS を配備し、Message Queue ブローカを起動します。次に、適切な送信先を作成し、UMS API を使用してメッセージを送受信するメッセージングアプリケーションを作成します。

メッセージキュー 4.3 の配布に含まれる UMS の imqums.war ファイルは、プラットフォームごとに次の場所にインストールされます。

.war ファイルの名前は、必要に応じて変更できます。

imqums.war を localhost:port で Web コンテナに配備した場合、UMS のドキュメントは次の場所で参照できます。

http://localhost:port/imqums

または、次の場所でも UMS のドキュメントを参照できます。

• UMS の設定については、https://mq.dev.java.net/4.3-content/ums/config.html を参照してください。

• UMS API のドキュメントについては、https://mq.dev.java.net/4.3-content/ums/protocol.html を参照してください。

• 各言語のプログラミング例については、https://mq.dev.java.net/4.3-content/ums/examples/README.html を参照してください。

サポートされる Web コンテナ

現在、UMS は次の Web コンテナでサポートされます。

• Sun GlassFish Enterprise Server, Version 2.1 および Version 3 Prelude

• Tomcat, Versions 5.5 および 6.0

AIX プラットフォームのサポート

メッセージキュー 4.3 には、AIX プラットフォームのパッケージと、これらをインストールするためのインストーラが用意されています。

メッセージキュー の AIX 実装では、次のソフトウェアがサポートされます。

• AIX v 6.1 以降 (これより前のバージョンは、Unix/Java のみのバンドルでサポートされます)

• DB2 サポート

• IBM XL C/C++ Compiler V9.0

• JDK 1.5 以降

インストールの手順については、『Sun GlassFish Message Queue 4.4 Installation Guide』の第 4 章「AIX Installation」を参照してください。

AIX プラットフォームでは、メッセージキュー のファイルは メッセージキュー のホームディレクトリ (IMQ_HOME) 以下にだけインストールされます。IMQ_HOME は、mqInstallHome/mq ディレクトリを表します。mqInstallHome は、製品のインストール時に指定したインストールのホームディレクトリです (デフォルトでは、home-directory /MessageQueue)。

結果として メッセージキュー のディレクトリ構造は、Windows プラットフォームの場合と同じになります。『Sun GlassFish Message Queue 4.4 Administration Guide』の付録 A「Platform-Specific Locations of Message Queue Data」の Windows の節を参照してください。

メッセージキュー の AIX プラットフォームのサポートには、メッセージキュー C-API のサポートも含まれます。AIX プラットフォームで C アプリケーションをビルドおよびコンパイルする手順については、XREF を参照してください。

新しい ZIP ベースのインストーラ

メッセージキュー 4.3 では、ネイティブパッケージ配布ではなく、ZIP ベースの配布用に新しいインストーラが導入されました。インストーラは、メッセージキュー の新しい ZIP 形式の配布を AIX プラットフォームにインストールするために使用します。

新しいインストーラは、メッセージキュー の .ZIP ファイルをユーザーが書き込み可能な (root 特権を必要としない) 任意のディレクトリに展開し、メッセージキュー のインストールを Sun Connection に登録できるようにします。

ダウンロードバンドルのサイズを最小化するために、ZIP ベースの配布には Java ランタイムが含まれていません (ほとんどのサイトでは、すでにインストールされているはずです)。したがって、installer コマンドでは、JAVA_HOME 環境変数を使用するか、次のようにコマンド行に -j オプションを使用して、JDK または JRE を指定する必要があります。

$ installer -j JDK/JRE-path

JDK/JRE-path は、指定する JDK または JRE のパスです。

プラットフォームサポートの拡張

メッセージキュー では、次の更新されたプラットフォームサポートが保証されます。

• Oracle 11g

• Windows Server 2008

その他の拡張機能

メッセージキュー には、次の拡張機能も追加されています。

• 「Windows プラットフォームでの新しいディレクトリ構造」

• 「新しいブローカのプロパティー」

• 「JMX 管理 API の機能強化」

• 「ワイルドカードサブスクライバの永続サブスクリプションの一覧表示」

Windows プラットフォームでの新しいディレクトリ構造

Windows プラットフォームでは、メッセージキュー のインストールディレクトリの構造が、AIX プラットフォームでのディレクトリ構造に一致するように以前のバージョンから変更されました。このディレクトリ構造は、今後 Solaris および Linux プラットフォームでも採用される予定で、単一のコンピュータへの複数のインストールや Sun Connection を利用した メッセージキュー の自動更新が容易になります。Sun Connection は、Sun のハードウェアとソフトウェアの追跡、構成、および維持を支援するために Sun が提供するサービスです。「インストーラでの Sun Connection 登録のサポート」を参照してください。

新しいブローカのプロパティー

ブローカの設定に、次の新しいプロパティーを使用できます。

JMX 管理 API の機能強化

新しい属性と複合データキーが、次のように JMX API に追加されました。

• NextMessageID 属性は、送信先監視 MBean に追加され、コンシューマに配信される次のメッセージの JMS メッセージ ID を示します。

• 複合データの NextMessageID キーは、コンシューママネージャーの監視 MBean に追加され、コンシューマに配信される次のメッセージの JMS メッセージ ID を示します。

• 複合データの NumMsgsPending キーは、コンシューママネージャーの監視 MBean に追加され、コンシューマにディスパッチされているメッセージの数を示します。

詳細は、『Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients』の第 3 章「Message Queue MBean Reference」を参照してください。

ワイルドカードサブスクライバの永続サブスクリプションの一覧表示

永続サブスクリプションを一覧表示するコマンドは次のとおりです。

list dur [-d topicName]

このコマンドは、トピック名の指定を省略できるように拡張されています。トピックを指定しない場合、コマンドはすべてのトピック (ワイルドカード命名規則によるトピックを含む) について、すべての永続サブスクリプションを表示します。

メッセージキュー 4.2 の新機能

メッセージキュー 4.2 は、いくつかの新機能、機能拡張、およびバグ修正を実装したマイナーリリースです。ここでは 4.2 リリースの新機能について説明するとともに、詳細な情報の参照先を示します。

• 「パブリッシャーまたはサブスクライバの複数の送信先」

• 「XML ペイロードメッセージのスキーマ検証」

• 「分散トランザクションの C-API サポート」

• 「インストーラでの Sun Connection 登録のサポート」

• 「MySQL データベースのサポート」

• 「その他の拡張機能」

メッセージキュー 4.1 および 4.0 で導入された機能については、それぞれ、「メッセージキュー 4.1 の新機能」および「メッセージキュー 4.0 の新機能」を参照してください。

パブリッシャーまたはサブスクライバの複数の送信先

メッセージキュー 4.2 では、パブリッシャーは複数のトピック送信先にメッセージを発行でき、サブスクライバは複数のトピック送信先からメッセージを消費できます。この機能は、トピック送信先の名前にワイルドカード文字を使用して、複数の送信先を表すことにより実現されます。そのような記号名を使用することにより、管理者は、必要な場合に、ワイルドカードのネーミングスキームに整合する追加のトピック送信先を作成できます。送信先が追加されると自動的に、パブリッシャーはその送信先に発行し、サブスクライバはその送信先から消費するようになります。ワイルドカードトピックのサブスクライバの方が、パブリッシャーよりも一般的です。

この機能は、キュー送信先には適用されません。

記号によるトピック送信先名の形式と使用例については、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Supported Topic Destination Names」を参照してください。

XML ペイロードメッセージのスキーマ検証

この機能は メッセージキュー 4.2 で導入され、メッセージがブローカに送信された時点で、テキスト (オブジェクトではない) の XML メッセージの XML スキーマを検証できます。XML スキーマ (XSD) の場所は、Message Queue 送信先のプロパティーとして指定されます。XSD の場所が指定されていない場合は、XML ドキュメント内の DTD 宣言を使用して DTD 検証が実行されます。データ型および値の範囲の検証を含む XSD 検証は、DTD 検証よりも厳格です。

この機能の使用法については、「XML ペイロードメッセージのスキーマ検証」を参照してください。

分散トランザクションの C-API サポート

X/Open 分散トランザクションモデルに従って、分散トランザクションのサポートは、1 つ以上のリソースマネージャーで実行される操作の追跡と管理を行う分散トランザクションマネージャーに依存します。メッセージキュー 4.2 では、Message Queue C-API で XA インタフェース (分散トランザクションマネージャーと、XA 準拠のリソースマネージャーとしての Message Queue の間のインタフェース) がサポートされます。それにより、BEA Tuxedo などの分散トランザクション処理環境で実行される Message Queue C-API クライアントが、分散トランザクションに参加できます。

この分散トランザクションのサポートは、次に示す、XA インタフェース仕様を実装するための新しい C-API 関数 (および新しいパラメータとエラーコード) から成ります。

MQGetXAConnection()
MQCreateXASession()

C クライアントアプリケーションを分散トランザクションのコンテキストで使用する場合は、MQGetXAConnection() を使用して接続を取得し、MQCreateXASession() を使用して、メッセージを生成および消費するためのセッションを作成します。すべての分散トランザクションの開始、コミット、およびロールバックは、分散トランザクションマネージャーが提供する API によって管理されます。

分散トランザクション機能の使用法については、『Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients』の「Working With Distributed Transactions」を参照してください。

メッセージキュー 4.2 には、Tuxedo トランザクションマネージャーに基づくプログラミング例が用意されています。これらのサンプルプログラムの使用法については、『Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients』の「Distributed Transaction Sample Programs」を参照してください。

分散トランザクション機能は、Solaris、Linux、および Windows プラットフォームでサポートされますが、現時点で保証されているのは Solaris プラットフォームのみです。

インストーラでの Sun Connection 登録のサポート

Message Queue インストーラが、メッセージキュー を Sun Connection に登録できるように拡張されました。Sun Connection は、Sun のハードウェアとソフトウェアの追跡、構成、および維持を支援するために Sun が提供するサービスです。

メッセージキュー のインストール中に、メッセージキュー を Sun Connection に登録するかどうかを選択できます。インストールした Message Queue に関する情報、たとえば、リリースバージョン、ホスト名、オペレーティングシステム、インストール日などの基本情報は、Sun Connection のデータベースに安全に転送されます。Sun Connection のインベントリサービスは、Sun のハードウェアとソフトウェアの構成 に役立ちます。また、更新サービスでは、最新のセキュリティー修正、推奨される更新、および機能拡張に関する情報を得ることができます。

Sun Connection への メッセージキュー の登録については、『Sun GlassFish Message Queue 4.4 Installation Guide 』を参照してください。

MySQL データベースのサポート

メッセージキュー 4.2 では、JDBC ベースのデータストアとして MySQL データベースのサポートが導入されました。スタンドアロンブローカ用の JDBC データベースとして、MySQL Cluster Edition を使用できます。MySQL Cluster Edition は、拡張ブローカクラスタに必要な高可用性共有データストアとして使用することもできます。MySQL を使用するための メッセージキュー の設定については、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Configuring a JDBC-Based Data Store」および『Sun GlassFish Message Queue 4.4 Administration Guide』の「Enhanced Broker Cluster Properties」を参照してください。

その他の拡張機能

先に述べた機能に加え、メッセージキュー 4.2 では次の拡張機能が導入されました。

• リモートで生成されたメッセージのメトリック

  メッセージキュー 4.2 には、ブローカクラスタでの送信先の監視に役立つ新しい送信先メトリックが含まれています。ブローカクラスタで、クラスタ内の特定のブローカ上の特定の送信先に格納されるメッセージには、クラスタ内のリモートブローカからその送信先に送信されるメッセージだけでなく、直接その送信先に対して生成されたメッセージもあります。ブローカクラスタでのメッセージのルーティングと配信を分析する際に、送信先のメッセージのうち、ローカルで生成されたメッセージの数と、リモートで生成されたメッセージの数を調べると訳に立つことがあります。

  メッセージキュー 4.2 では、2 つの新しい物理送信先メトリック量として Num messages remote と Total Message bytes remote が導入されました。新しいメトリック量は、imqcmd list dst コマンドと imqcmd query dst コマンド (『Sun GlassFish Message Queue 4.4 Administration Guide』の「Viewing Physical Destination Information」を参照)、および JMX 属性 (『Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients』の「Destination Monitor」を参照) を通して使用できます。

• ワイルドカードプロデューサとワイルドカードコンシューマの情報

  送信先名でのワイルドカード文字の使用をサポートするための情報 (「パブリッシャーまたはサブスクライバの複数の送信先」を参照) が、新しい監視データを通して提供されます。たとえば、送信先に関連付けられたワイルドカードプロデューサまたはワイルドカードコンシューマの数は、imqcmd query dst コマンド (『Sun GlassFish Message Queue 4.4 Administration Guide』の「Viewing Physical Destination Information」を参照) と、新しい JMX 属性 (『Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients』の「Destination Monitor」を参照) を通して使用できます。また、ワイルドカード情報は、コンシューママネージャーの監視 MBean およびプロデューサマネージャーの監視 MBean を通しても使用できます。

• Support for DN Username Format for Client Authentication

  メッセージキュー 4.2 では、LDAP ユーザーリポジトリによるクライアント接続認証で DN ユーザー名形式のサポートが導入されました。そのため、次の新しいブローカプロパティー (および値) が追加されています。

  imq.user_repository.ldap.usrformat=dn

  このプロパティーにより、ブローカは、次のプロパティーで指定された属性の値を DN ユーザー名形式から抽出することにより、LDAP ユーザーリポジトリのエントリと照合してクライアントユーザーを認証します。

  imq.user_repository.ldap.uidattr

  ブローカは、アクセス制御操作で、前述の属性の値をユーザー名として使用します。

  たとえば、imq.user_repository.ldap.uidattr=udi と指定したときに、クライアント認証ユーザー名の形式が udi=mquser,ou=People,dc=red,dc=sun,dc=com の場合、アクセス制御の実行時に「mquser」が抽出されます。

• JAAS Authentication Enhancement

  メッセージキュー 4.2 の JAAS 認証では、ユーザー名による認証に加えて、IP アドレスによる認証のサポートも導入されました。

メッセージキュー 4.1 の新機能

メッセージキュー 4.1 は、いくつかの新機能、機能拡張、およびバグ修正を実装したマイナーリリースです。ここでは 4.1 リリースの新機能について説明するとともに、詳細な情報の参照先を示します。

• 「高可用性ブローカクラスタ」

• 「JAAS サポート」

• 「持続データストアの形式の変更」

• 「ブローカの環境設定」

• 「Java ES Monitoring Framework のサポート」

• 「拡張されたトランザクション管理」

• 「C クライアント接続の固定ポート」

Message Queue 4.0 で導入された機能については、「メッセージキュー 4.0 の新機能」を参照してください。

高可用性ブローカクラスタ

メッセージキュー 4.1 では、新しい拡張ブローカクラスタが導入されました。従来のブローカクラスタでは、ブローカで障害が発生した場合に別のブローカがメッセージングサービスを提供する「メッセージングサービス」の可用性のみが提供されていました。拡張ブローカクラスタでは、ブローカで障害が発生した場合に持続メッセージと状態データを使用して別のブローカがメッセージ配信を継承できる、「データ」の可用性も提供されます。

メッセージキュー 4.1 で導入された高可用性の実装は、JDBC ベースの共有データストアを使用します。つまり、ブローカクラスタの各ブローカに固有の持続データストアを用意する代わりに、クラスタ内のすべてのブローカで同じ JDBC 準拠のデータベースを使用します。特定のブローカで障害が発生すると、そのブローカのメッセージ配信はメッセージクラスタ内の別のブローカによって継承されます。そのときに、継承ブローカは、共有データストアのデータおよび状態情報を使用します。障害が発生したブローカのメッセージングクライアントは継承ブローカに再接続するため、メッセージングサービスは中断されません。

メッセージキュー 4.1 の高可用性実装に使用される JDBC ベースの共有ストアは、それ自体も高可用性ストアでなければなりません。高可用性データベースを持っていない場合、またはメッセージ配信が中断されないことを重要視しない場合は、データの可用性がなくサービスの可用性のみを提供する従来のクラスタを引き続き使用できます。

メッセージキュー 4.1 の拡張ブローカクラスタを設定するには、クラスタ内のブローカごとに、次のブローカプロパティーを指定します。

• クラスタメンバーシッププロパティー。ブローカが拡張ブローカクラスタ内にあることと、クラスタの ID およびクラスタ内のブローカの ID を指定します。

• 高可用性データベースプロパティー。持続データモデル (JDBC)、データベースベンダーの名前、およびベンダー固有の設定プロパティーを指定します。

• 障害検出および継承プロパティー。ブローカ障害の検出および継承ブローカによる処理の方法を指定します。

拡張ブローカクラスタ実装を使用するには、次の操作を実行します。

1. 高可用性データベースをインストールします。

2. JDBC ドライバの .jar ファイルをインストールします。

3. 高可用性持続データストア用のデータベーススキーマを作成します。

4. クラスタ内のブローカごとに、高可用性プロパティーを設定します。

5. クラスタ内の各ブローカを起動します。

拡張ブローカクラスタの概念に関する説明、および従来のクラスタとの比較については、『Sun GlassFish Message Queue 4.4 Technical Overview』の第 4 章「Broker Clusters」を参照してください。拡張ブローカクラスタの手続きおよび参照に関する情報については、『Sun GlassFish Message Queue 4.4 Administration Guide』の第 10 章「Configuring and Managing Broker Clusters」および『Sun GlassFish Message Queue 4.4 Administration Guide』の「Cluster Configuration Properties」を参照してください。

メッセージキュー 4.0 で高可用性データベースを使用していた場合、拡張ブローカクラスタに切り替えるには、データベースマネージャーユーティリティー (imqdbmgr) を使用して共有持続データストアに変換します。「ブローカクラスタ」で、既知の問題および制限事項についても参照してください。

JAAS サポート

メッセージキュー 4.1 では、ファイルベースおよび LDAP ベースの組み込み認証機構に加えて、JAAS (Java Authentication and Authorization Service) サポートも導入されています。JAAS を使用すると、外部の認証機構をブローカに接続して Message Queue クライアントを認証できます。

ブローカによって JAAS 準拠の認証サービスで利用可能になる情報についての説明、およびそれらのサービスを使用するようにブローカを設定する方法については、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Using JAAS-Based Authentication」を参照してください。

持続データストアの形式の変更

メッセージキュー 4.1 は、JDBC ベースのデータストアが拡張ブローカクラスタをサポートするように変更されました。このため、JDBC ベースのデータストアの形式がバージョン 410 に更新されました。バージョン 350、370、および 400 の形式は、バージョン 410 に自動的に移行されます。

ファイルベースの持続データストアの形式は、何も変更されていないので、Version 370 のままです。

ブローカの環境設定

メッセージキュー 4.1 の環境設定ファイル imqenv.conf に、プロパティー IMQ_DEFAULT_EXT_JARS が追加されました。このプロパティーを設定して、ブローカが起動するときに CLASSPATH に含まれる外部 .jar ファイルのパス名を指定できます。このプロパティーを使用して外部 .jar ファイルの場所を指定した場合は、これらのファイルを lib/ext ディレクトリにコピーする必要はなくなります。外部 .jar ファイルは、JDBC ドライバまたは JAAS ログインモジュールを参照できます。次のサンプルプロパティーは、JDBC ドライバの場所を指定します。

IMQ_DEFAULT_EXT_JARS=/opt/SUNWhadb4/lib/hadbjdbc4.jar:/opt/SUNWjavadb/derby.jar

Java ES Monitoring Framework のサポート

メッセージキュー 4.1 では、Sun Java Enterprise System (Java ES) Monitoring Framework のサポートが導入されました。Monitoring Framework は、一般的なグラフィカルインタフェースを使用して Java ES コンポーネントを監視できるようにします。このインタフェースは、Sun Java System Monitoring Console と呼ばれる Web ベースのコンソールによって実装されます。管理者はこのコンソールを使用して、パフォーマンス統計の表示、自動監視のためのルールの作成、アラームの確認などを行えます。ほかの Java ES コンポーネントと一緒に Message Queue を実行している場合は、1 つのインタフェースを使用してすべてのコンポーネントを管理するほうが便利なことがあります。

Java ES Monitoring Framework による Message Queue の監視については、XREF を参照してください。

拡張されたトランザクション管理

以前は、管理上、PREPARED 状態のトランザクションだけをロールバックすることができました。つまり、分散トランザクションの一部であるセッションが正常に終了しなかった場合、そのトランザクションは、管理者がクリーンアップできない状態のままになりました。メッセージキュー 4.1 では、コマンドユーティリティー (imqcmd) を使用して、STARTED、FAILED、INCOMPLETE、COMPLETE、および PREPARED の状態のトランザクションをクリーンアップ (ロールバック) することができます。

特定のトランザクションをロールバックできるかどうかを判断できるように (特に、PREPARED 以外の状態の場合)、コマンドユーティリティーは imqcmd query txn の出力の一部として追加データを表示します。このデータには、トランザクションを開始した接続の接続 ID と、トランザクションが作成された時刻が示されます。管理者は、この情報を使用して、トランザクションをロールバックする必要があるかどうかを決定できます。一般に、管理者は早計にトランザクションをロールバックすることを避けるとよいでしょう。

C クライアント接続の固定ポート

メッセージキュー 4.1 では、C クライアントは、Java クライアントと同様に、ブローカのポートマッパーサービスで動的に割り当てられるポートではなく、固定ブローカポートに接続できるようになりました。固定ポート接続は、ファイアウォールを経由する場合、または他の何らかの理由でポートマッパーサービスをバイパスする必要がある場合に役立ちます。

固定ポート接続を設定するには、ブローカと C クライアントランタイムの両方 (接続の両端) を設定する必要があります。たとえば、ssljms を介してクライアントをポート 1756 に接続する場合は、次のように操作します。

• クライアント側で、次のプロパティーを設定します。

  MQ_SERVICE_PORT_PROPERTY=1756

  MQ_CONNECTION_TYPE_PROPERTY=SSL

• ブローカ側で、imq.serviceName.protocolType.port プロパティーを次のように設定します。

  imq.ssljms.tls.port=1756

MQ_SERVICE_PORT_PROPERTY 接続プロパティーは、Message Queue 3.7 Update 2 にバックポートされています。

メッセージキュー 4.0 の新機能

メッセージキュー 4.0 は、Application Server 9 PE のサポートに限定されたマイナーリリースです。このリリースでは、いくつかの新機能、機能拡張、およびバグ修正が実装されています。この節では、このリリースの新機能について説明します。

• 「JMX 管理 API のサポート」

• 「クライアントランタイムログ」

• 「接続イベント通知 API」

• 「ブローカ管理の拡張機能」

• 「JDBC ベースのデータストアに関する情報の表示」

• 「JDBC プロバイダのサポート」

• 「持続データストアの形式の変更」

• 「追加のメッセージプロパティー」

• 「SSL サポート」

version 4.0 には、軽度とはいえ、状況によって十分な対応が必要になる変更が導入されました。その 1 つとして、パスワードを指定するコマンド行オプションが使用されなくなったことが挙げられます。今後は、「使用されなくなったパスワードオプション」で説明するように、すべてのパスワードをファイルに保存するか、または要求されたときに入力します。

JMX 管理 API のサポート

Message Queue 4.0 には、Java Management Extensions (JMX) 仕様に準拠して、メッセージキュー ブローカを設定および監視するための新しい API が追加されました。この API を使用すると、Java アプリケーション内部からプログラムによってブローカ関数を設定および監視することができます。以前のバージョンの メッセージキュー では、これらの関数にはコマンド行管理ユーティリティーまたは管理コンソールからしかアクセスできませんでした。

詳細は、『Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients 』を参照してください。

クライアントランタイムログ

メッセージキュー 4.0 では、接続およびセッション関連のイベントに関するクライアントランタイムログのサポートが導入されました。

クライアントランタイムログおよびその設定方法については、『Java Dev Guide』の 137 ページを参照してください。

接続イベント通知 API

メッセージキュー 4.0 にはイベント通知 API が導入され、クライアントランタイムが接続状態の変更をアプリケーションに通知できるようになりました。接続イベント通知を使用すると、Message Queue クライアントは接続のクローズおよび再接続イベントを待機して、通知タイプと接続状態に基づいて適切なアクションを起こすことができます。たとえば、フェイルオーバーが発生してクライアントが別のブローカに再接続された場合、アプリケーションはそのトランザクションの状態をクリーンアップしてから新しいトランザクションに進む必要があるかもしれません。

接続イベント、およびイベントリスナの作成方法については、『Java Dev Guide』の 96 ページを参照してください。

ブローカ管理の拡張機能

メッセージキュー 4.0 では、コマンドユーティリティー (imqcmd) に、サブコマンドといくつかのコマンドオプションが追加されました。管理者はこれらを使用して、ブローカを休止したり、指定した間隔の後でブローカをシャットダウンしたり、接続を破棄したり、Java システムプロパティー (たとえば、コネクション関連のプロパティー) を設定したりできます。

• ブローカを休止すると休止状態になり、ブローカをシャットダウンまたは再起動する前に、メッセージを排出してしまうことができます。休止状態にあるブローカに新しく接続が作成されることはありません。ブローカを休止するには、次のようなコマンドを入力します。

  imqcmd quiesce bkr -b Wolfgang:1756

• 指定した間隔の後でブローカをシャットダウンするには、次のようなコマンドを入力します。(時間間隔は、ブローカをシャットダウンするまでの待機を秒数で指定します。)

  imqcmd shutdown bkr -b Hastings:1066 -time 90

  時間間隔を指定した場合、ブローカはシャットダウンが発生するタイミングを示すメッセージを記録します。次に例を示します。

  Shutting down the broker in 29 seconds (29996 milliseconds)

  ブローカがシャットダウンを待っている間、ブローカの動作は次のような影響を受けます。

  • 管理 JMS 接続は引き続き受け付けられます。

  • 新しい JMS 接続は受け付けられません。

  • 既存の JMS 接続は引き続き機能します。

  • ブローカが拡張ブローカクラスタ内のほかのブローカを継承することはできません。

  • imqcmd ユーティリティーはブロックはせず、シャットダウンの要求をブローカに送信してすぐに返します。

• 接続を破棄するには、次のようなコマンドを入力します。

  imqcmd destroy cxn -n 2691475382197166336

  コマンド imqcmd list cxn または imqcmd query cxn を使用してコネクション ID を取得します。

• imqcmd を使用してシステムプロパティーを設定するには、新しい –D オプションを使用します。これは、JMS コネクションファクトリのプロパティー、またはコネクション関連の Java システムのプロパティーの設定または上書きに便利です。次に例を示します。

  imqcmd list svc -secure -DimqSSLIsHostTrusted=true
  imqcmd list svc -secure -Djavax.net.ssl.trustStore=/tmp/mytruststore 
              -Djavax.net.ssl.trustStorePassword=mytrustword

imqcmd コマンドの構文については、『Sun GlassFish Message Queue 4.4 Administration Guide』の第 16 章「Command Line Reference」を参照してください。

JDBC ベースのデータストアに関する情報の表示

メッセージキュー 4.0 では、データベースマネージャーユーティリティー imqdbmgr に、新しい query サブコマンドが追加されました。このサブコマンドは、JDBC ベースのデータストアに関する情報 (データベースバージョン、データベースユーザー、データベーステーブルが作成されたかどうかなど) を表示するために使用します。

次に、このコマンドによって表示される情報の例を示します。

imqdbmgr query

[04/Oct/2005:15:30:20 PDT] Using plugged-in persistent store:
        version=400
        brokerid=Mozart1756
        database connection url=jdbc:oracle:thin:@Xhome:1521:mqdb
        database user=scott
Running in standalone mode.
Database tables have already been created.

JDBC プロバイダのサポート

メッセージキュー 4.0 では、Apache Derby Version 10.1.1 が、JDBC ベースのデータストアプロバイダとしてサポートされるようになりました。

持続データストアの形式の変更

メッセージキュー 4.0 では、最適化のため、および今後の拡張機能をサポートするために、JDBC ベースのデータストアに変更が加えられました。このため、JDBC ベースのデータストアの形式はバージョン 400 に更新されました。Message Queue 4.0 では、ファイルベースのデータストアのバージョンは、何も変更されていないので 370 のままです。

追加のメッセージプロパティー

メッセージキュー 4.0 では、デッドメッセージキューに配置されたすべてのメッセージで設定される 2 つの新しいプロパティーが追加されました。

• JMS_SUN_DMQ_PRODUCING_BROKER は、メッセージが生成されたブローカを指定します。

• JMS_SUN_DMQ_DEAD_BROKER は、メッセージをデッドとして指定したブローカを指定します。

SSL サポート

メッセージキュー 4.0 から、クライアントコネクションファクトリのプロパティー imqSSLIsHostTrusted のデフォルト値が false になりました。使用しているアプリケーションが以前のデフォルト値の true に依存している場合は、再設定を行い、プロパティーを明示的に true に設定する必要があります。

ブローカが自己署名付き証明書を使用するように設定されているときは、ホストを信頼することもできます。この場合、接続で SSL ベースの接続サービスを使用するように指定する (imqConnectionType プロパティーを使用する) ことに加えて、imqSSLIsHostTrusted プロパティーを true に設定することをお勧めします。

たとえば、ブローカが自己署名付き証明書を使用するときに安全にクライアントアプリケーションを実行するには、次のようなコマンドを使用します。

java -DimqConnectionType=TLS 
      -DimqSSLIsHostTrusted=true ClientAppName

ブローカが自己署名付き証明書を使用するときにコマンドユーティリティー (imqcmd) を安全に使用するには、次のようなコマンドを使用します (コネクタサービスのリストを表示する場合)。

imqcmd list svc -secure -DimqSSLIsHostTrusted=true

今後のリリースで使用されなくなる機能

次の機能は、今後のリリースで使用されなくなります。

• メッセージベースの監視

  メッセージベースの監視では、ブローカの設定可能なメトリックスメッセージプロデューサを利用して、メトリックデータを JMS メッセージに書き込みます。この JMS メッセージは、メッセージに含まれているメトリック情報の種類に応じてメトリックトピック送信先に送信されます。このメトリック情報にアクセスするには、適切なメトリックトピック送信先へのサブスクライブ、そのメッセージの消費、および必要に応じたデータ処理を行うクライアントアプリケーションを記述します。

  メッセージベースの監視機能の代わりに、MQ 4.0 で導入された JMX 管理 API が使用されるようになっています (「JMX 管理 API のサポート」を参照)。この JMX API は、より包括的 (トピック送信先に書き込まれるよりも多くのメトリックデータが含まれる) であり、JMX 業界標準に基づいています。

  メッセージキュー で JMX API がサポートされている現在、あえてメッセージベースの監視を使用する理由はありません。メッセージベースの監視機能に関する情報は、この機能が正式に使用されなくなるまで メッセージキュー ドキュメントに残されます。

• テキストベースのインストーラ

  メッセージキュー インストーラのテキストモード (installer -t) は、すべてのオペレーティングシステムプラットフォームで使用できなくなります。テキストモードでは、端末ウィンドウにグラフィカルユーザーインタフェース (GUI) モードの表示をシミュレートするプレーンテキストが表示されます。GUI モードおよびサイレントモードのサポートは継続されます。

• プラットフォームサポート

  今後のリリースでは、Windows 2000 と Red Hat Linux 3 はサポートされなくなります。

• JMSRA リソースアダプタ

  メッセージキュー のリソースアダプタ imqjmsra.rar (JMSRA) は、今後の メッセージキュー のリリースで新しいリソースアダプタに置き換えられます。JMSRA は、メッセージキュー と Sun Java System Application Server を統合するために使用されます。

  新しいリソースアダプタは、JMSRA の既存の機能とほかの Sun JMS リソースアダプタの機能を組み合わせて、Java EE 5 Application Server 環境で メッセージキュー やほかのプロバイダに特別なサポートを提供します。したがって、メッセージキュー を Sun GlassFish Enterprise Server および Sun Java Composite Application Platform Suite (Java CAPS) に統合するために使用される予定です。

メッセージキュー 4.4 で修正されたバグおよび最近のリリース

メッセージキュー 4.4 には、新しいバグの修正と、メッセージキュー 4.x ファミリのこれまでのリリースで解決されたバグの修正が含まれます。

次の各節では、それぞれのリリースで修正されたバグの一覧を示します。

• 「メッセージキュー 4.4 で修正されたバグ」

• 「メッセージキュー 4.3 で修正されたバグ」

• 「メッセージキュー 4.2 で修正されたバグ」

• 「メッセージキュー 4.1 で修正されたバグ」

• 「メッセージキュー 4.0 で修正されたバグ」

メッセージキュー 4.4 で修正されたバグ

次の表に、メッセージキュー 4.4 で修正されたバグを示します。

メッセージキュー 4.3 で修正されたバグ

次の表に、メッセージキュー 4.3 で修正されたバグを示します。

メッセージキュー 4.2 で修正されたバグ

次の表に、メッセージキュー 4.2 で修正されたバグを示します。

メッセージキュー 4.1 で修正されたバグ

次の表に、メッセージキュー 4.1 で修正されたバグを示します。

メッセージキュー 4.0 で修正されたバグ

次の表に、メッセージキュー 4.0 で修正されたバグを示します。

メッセージキュー 4.4 のドキュメントの更新

この節では、メッセージキュー 4.4 のドキュメントの更新について説明します。

• 「互換性の問題」

• 「メッセージキュー 4.4 ドキュメントセットの変更点」

互換性の問題

この節では、メッセージキュー 4.4 に関する互換性の問題を説明しています。

インタフェースの安定性

Sun GlassFish メッセージキュー で使用される多くのインタフェースは、時間の経過につれて変更される可能性があります。『Sun GlassFish Message Queue 4.4 Administration Guide』の付録 B「Stability of Message Queue Interfaces」では、インタフェースを安定性に従って分類しています。安定性に優れるインタフェースほど、製品の後継バージョンで変更される可能性は低くなります。

メッセージキュー の次回のメジャーリリースに関係する問題

メッセージキュー の次回のメジャーリリースでは、現在の メッセージキュー クライアントアプリケーションがそのリリースと互換性がなくなるような変更が導入される可能性があります。この情報は、完全な情報開示の目的で提供しています。

• Sun GlassFish メッセージキュー の一部としてインストールされる各ファイルの場所が変更される可能性があります。これによって、特定の メッセージキュー ファイルの現在の場所に依存する既存のアプリケーションの動作が中断する可能性があります。

• メッセージキュー 3.5 以前のブローカは、これより新しいブローカのクラスタ内では動作できなくなる可能性があります。

• 今後のリリースでは、メッセージキュー クライアントは 1.5 より前のバージョンの JDK を使用できなくなる可能性があります。

• 今後のリリースでは、メッセージキュー クライアントは 1.6 より前のバージョンの JDK を使用できなくなる可能性があります。

メッセージキュー 4.4 ドキュメントセットの変更点

メッセージキュー 4.4 ドキュメントセットは、次に説明するように、Message Queue 4.3 ドキュメントセットから更新されています。

『技術の概要』

『Sun GlassFish Message Queue 4.4 Technical Overview 』は、メッセージキュー 4.4 の新しい機能を反映するように更新されました。

インストールとアップグレードに関する情報

『Sun GlassFish Message Queue 4.4 Installation Guide 』には、AIX プラットフォームでの メッセージキュー のインストールに関する内容が追加されました。

管理ガイド

『Sun GlassFish Message Queue 4.4 Administration Guide 』には、重要性の低いバグ修正、AIX プラットフォームのサポート、およびブローカクラスタを管理する手順と従来のクラスタを拡張クラスタに変換する手順が追加されています。

『Developer's Guide for Java Clients』

『Sun GlassFish Message Queue 4.4 Developer’s Guide for Java Clients 』は、新しいバージョン番号を反映するように更新されました。それ以外の変更はありません。

『Developer’s Guide for C Clients』

『Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients 』には、AIX プラットフォームで C クライアントアプリケーションをビルドする際の情報が追加されています。

『Developer's Guide for JMX Clients』

『Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients 』には、JMX API の拡張機能が追加されています。

既知の問題点と制限事項

この節には、メッセージキュー 4.4 の既知の問題についてのリストが含まれています。次の内容について説明します。

• 「インストールに関する情報」

• 「使用されなくなったパスワードオプション」

• 「管理および設定上の問題」

• 「ブローカの問題」

• 「ブローカクラスタ」

• 「JMX の問題」

• 「SOAP サポート」

現時点のバグ、その状態、および回避策の一覧については、Java Developer Connection™ メンバーは、Java Developer Connection Web サイトの「Bug Parade」ページを参照してください。新しいバグを報告する前に、このページをチェックしてください。すべての メッセージキュー バグがリストされているわけではありませんが、このページはある問題が報告済みかどうかを知りたい場合に活用できます。

http://bugs.sun.com/bugdatabase/index.jsp

Java Developer Connection のメンバーになるのは無料ですが、登録が必要です。Java Developer Connection のメンバーになる方法についての詳細は、Sun の「For Developers」Web ページを参照してください。

新しいバグの報告や機能に関する要求を行うには、imq-feedback@sun.com 宛てにメールを送信してください。

インストールに関する情報

この節では、Message Queue version 4.4 のインストールに関連した問題について説明します。

製品レジストリと Java ES

メッセージキュー 4.4 は、メッセージキュー 4.2 および 4.1 と同様に、新しいインストーラでインストールされます。このインストーラでは、JDK、NSS、JavaHelp など、Message Queue に必要な Java Enterprise System (Java ES) 共有コンポーネントもインストールされます。

新しい Message Queue インストーラと、以前のバージョンの Message Queue で使用されていた古い Java ES インストーラは、同じ製品レジストリを共有しません。Java ES でインストールされた Message Queue を削除したあと、Message Queue インストーラで メッセージキュー 4.4 をインストールすると、Java ES 製品レジストリが矛盾した状態になる場合があります。その結果、Java ES アンインストーラを実行すると、Java ES でインストールしなかったとしても、メッセージキュー 4.4 とそれが依存する共有コンポーネントが意図せずに削除されることがあります。

Java ES インストーラでインストールした Message Queue ソフトウェアをアップグレードする最善の方法は、次のとおりです。

1. Java ES アンインストーラを使用して、メッセージキュー とその共有コンポーネントを削除します。

2. Message Queue インストーラを使用して、メッセージキュー 4.4 をインストールします。

すべてのプラットフォームでのインストール

次に示す問題は、すべてのプラットフォームでのインストールに影響します。

• 「インストールの準備完了」画面で、製品名が「Sun Java System Message Queue 4.3」ではなく「mq」と表示されます。(バグ 6650841)

• インストーラが Message Queue 4.3 のインストールを処理中で、「進行状況」画面が表示されているときは、「取消し」ボタンがアクティブになります。ここで「取消し」ボタンを選択すると、インストールが完了しないか、破棄されます。 (バグ 6595578)

• インストーラの「概要」画面には、クリックするとログまたは概要ページビューアが開くリンクがいくつか含まれています。「閉じる」というラベルの付いたボタンの代わりに、ウィンドウの閉じるボタン「X」を使用してこのビューアウィンドウを閉じた場合、このビューアウィンドウを再度表示することができません。(バグ 6587138)

  回避方法: 「閉じる」というラベルの付いたボタンを使用してウィンドウを閉じます。

• コンピュータシステムに古いバージョンの Message Queue および NSS/NSPR があると、インストーラの「アップグレード」画面で、アップグレードが必要なものとして Message Queue だけが表示され、NSS と NSPR のアップグレードも必要であることは触れられません。実際には、関連ソフトウェアもすべてアップグレードされ、「インストールの準備完了」画面では正しい情報が示されます。(バグ 6580696)

• 「JDK の選択」画面の JDK のリストが、「JDK を選択」オプションが選択されていない場合でもアクティブになります。(バグ 6650874)

• Message Queue アンインストーラを使用する場合、「削除」の代わりに「取消し」をクリックすると、一部のインストーラファイルが削除され、以後のアンインストールが失敗します。(バグ 6760416)

• 登録が省略されるサイレントインストールを実行したあとに、インストーラを登録のみのモード (installer -r) で実行すると、「ファイルの途中終了」エラーにより登録が失敗します。(バグ 6767988)

• Open Message Queue がインストールされているコンピュータで Message Queue 4.3 インストーラを実行すると、「Error reading previous session data from Config-State.」という警告メッセージが表示される場合があります。(バグ 6764305)

  回避方法: メッセージは良性で、インストールが完了すると再度発生することはありません。または、/var/install/config/mq/InstallDirectory.xcu ファイルを削除すると、メッセージを回避することができます。

• JDK がインストールされていないコンピュータで Message Queue の ZIP ベースのインストーラを実行すると、「Invalid root in registry key HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion」というエラーメッセージが表示されます。(バグ 6764358)

  回避方法: インストーラを実行する前に、JDK をインストールします。

• 「インストールの準備完了」画面の「インストール」ボタンをクリックする前に、Message Queue インストーラによって mqInstallHome ディレクトリが作成されます。(Bug 6595590)

• Message Queue をインストールせずに、Message Queue をテキストモード (installer -t -r) で登録しようとすると、NullPtr 例外がスローされます。(バグ 6760991)

  回避方法: Message Queue をインストールしてからインストールの登録を行います。

Windows でのインストール

Message Queue を Windows にインストールするときは、次の制限事項に注意してください。

• Windows プラットフォームにインストールされた Message Queue 4.3 のディレクトリ構造は、これまでのリリースのディレクトリ構造と異なります。『Sun GlassFish Message Queue 4.4 Installation Guide』の「Installed Directory Structure」を参照してください。

• インストーラは、Message Queue 用のエントリを「スタート」>「すべてのプログラム」メニューに追加しません。(バグ 6567258)

  回避方法: 管理コンソールを起動するには、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Starting the Administration Console」で説明されているようにコマンド行を使用します。

• インストーラは、IMQ_HOME\mq\bin ディレクトリを PATH 環境変数に追加しません。(バグ 6567197)

  回避方法: ユーザーは Message Queue ユーティリティー (IMQ_HOME\mq\bin\command) を起動するときに、このエントリを PATH 環境変数に追加するか、フルパス名を指定する必要があります。

• インストーラは、Message Queue がインストールされたことを示すために Windows レジストリにエントリを追加しません。(バグ 6586389)

• インストーラは、メッセージキュー ブローカを Windows サービスとして追加しません。

  回避方法: imqsvcadm コマンドを使用して、メッセージキュー ブローカを Windows サービスとして手動で追加します。

• JDK がインストールされていない場合、インストーラが「Invalid root in registry key HKLM\\SOFTWARE\\JavaSoft\\Java Runtime Environment\\CurrentVersion」というエラーをスローします。(バグ 6764358)

  回避方法: このエラーが表示された場合は、JDK をインストールしてから操作を続行します。

• 回答ファイルを使用してサイレントモードで実行すると、インストーラはすぐに返されます。インストールは行われますが、ユーザーにはサイレントインストールがいつ実際に実行されたかを知る方法がありません。(バグ 6586560)

• Windows で、インストーラをテキストモード (installer –t ) で実行しようとすると、エラーメッセージが表示されます。このメッセージは、インストーラが英語以外で実行されていても、英語で表示されます。テキストモードは Windows ではサポートされていません。(バグ 6594142)

• オペレーティングシステムが別のドライブにインストールされている場合でも、インストーラは Message Queue を C:\ にインストールします。(バグ 6673511)

• Windows でのインストールおよびアンインストールでは、ユーザーが実行できる bat ファイルはありません。また、ユーザーが Windows コントロールパネルの「プログラムの追加と削除」を使用してアンインストールすることもできません。(バグ 6673417)

• Windows Vista では、コマンドプロンプトから管理者としてインストールを実行しなければ、Message Queue を C:\Program Files にインストールできません。(バグ 6701661)

  回避方法: 管理者としてコマンドプロンプトからインストールするには、次の手順に従います。

  1. 「スタート」 -> 「すべてのプログラム」 -> 「アクセサリ」の順にクリックし、「コマンド プロンプト」をポイントします。

  2. 「コマンド プロンプト」を右クリックします。

  3. 「管理者として実行」をクリックします。

  4. ディレクトリを Message Queue 4.2 のインストールイメージに変更します。

  5. installer.vbs を実行します。

• アンインストーラを予行モード (uninstaller -n) で実行すると、アンインストールが誤って実行されます。(バグ 6719051)

  回避方法: 次のコマンドを使用して、サイレントインストールを実行します。

  uninstaller -s

• インストーラのホームページで「Install Home」の文字列がローカライズされません。(バグ 6592491)

• Message Queue の ZIP ベースのアンインストーラが、Windows 2003 でハングアップします。(バグ 6764370)

  回避方法: mqInstallHome ディレクトリを手動で削除します。

Solaris でのインストール

• インストーラを予行モード (installer –n ) で実行すると、「概要」画面にいくつかのエラーメッセージが表示され、「未完了」のインストール状態も表示されます。これは誤りで、誤解を招きます。予行モードでは、何もシステムにインストールされません。後でサイレントインストールの実行に使用できる回答ファイルが作成されるだけです。(バグ 6594351)

• 回答ファイルを使用してサイレントモード (installer -a filename -s) でインストーラを実行すると、Sun Connection への登録が実行されません。(バグ 6710268)

• テキストモードでインストーラを実行している場合、Sun Connect 登録用のユーザー名またはパスワードを入力したり、オンラインアカウントを作成したりするときに、ユーザー名やパスワードの訂正にバックスペースキーを使用できません。(バグ 6673460)

  回避方法: バックスペースキーの代わりに Control-H キーを使用するか、または dtterm や xterm のような別の端末エミュレータを使用します。

• インストーラの「アップグレード」画面に、インストールされている既存の メッセージキュー またはインストーラエンジンのバージョンが正しく表示されない場合があります。(バグ 6679765)

• テキストモードでインストーラを実行しているときに、無効なユーザー名とパスワードで Sun Connection に登録しようとすると、登録できないことを示すメッセージが表示され、Null ポインタ例外がスローされて、インストーラが終了します。(バグ 6666365)

Linux でのインストール

次に示す問題は、Linux プラットフォームでのインストールに影響します。

• Redhat Linux 5 では、C クライアントアプリケーションの実行に必要な compat-libstdc++ ライブラリが、メッセージキュー の配布に含まれていません。したがって、メッセージキュー インストーラではこのライブラリをインストールできません。C クライアントを開発および実行している場合は、このライブラリを手動でインストールする必要があります。

  通常、compat-libstdc++ RPM は使用している Linux のバージョンのインストールメディアにあります。次のコマンドを使用してインストールできます。

  rpm -ivh compat-libstdc++-x-x.x.x.x..rpm

  x はバージョン番号を表します。

  ライブラリが正常にインストールされたかどうかを確認するには、次のコマンドを使用します。

  rpm -qa | grep compat-libstdc++

• 「JDK 選択」パネルで、スクロールリストに項目が 1 つしか表示されません。このため、リスト内のほかの JDK を選択することが難しくなります。(バグ 6584735)

• JDK が現在のもので、ユーザーが「JDK 選択」画面で「Java(TM) SDK のデフォルトバージョンをインストールして使用します。」を選択した場合、インストーラはその JDK をインストールしようとし、パッケージをインストールできないというレポートを返します。この問題があっても、インストールは正常に完了します。(バグ 6581310)

• 現在インストールされている JDK が JDK 1.5.0_15 (メッセージキュー インストーラによって標準でインストールされるバージョン) より新しいバージョンの場合、メッセージキュー アンインストーラはデフォルトの IMQ_JAVAHOME ディレクトリを見つけることができず、エラーを返します。(バグ 6673415)

  回避方法: メッセージキュー アンインストーラを実行する前に、次のコマンドを使用して JDK 1.5 を手動でインストールします。

  # cd installImage/Product/UNIX/LINUX/X86/2.4/Packages

  # rpm -i --force jdk-1.5.0_15–linux- arch.rpm

  arch は i586 か amd64 のいずれかです。

• インストーラを予行モード (installer –n ) で実行すると、「概要」画面にいくつかのエラーメッセージが表示され、「未完了」のインストール状態も表示されます。これは誤りで、誤解を招きます。予行モードでは、何もシステムにインストールされません。後でサイレントインストールの実行に使用できる回答ファイルが作成されるだけです。(バグ 6594351)

• 64 ビット Linux では、Message Queue インストーラのテキストモードは動作しません。(バグ 6771303)

  回避方法: 端末ウィンドウからリモートでインストールしている場合は、リモートディスプレイソフトウェアを使用して、GUI モードでインストーラを実行する必要があります。

インストーラのバージョン表示の問題

インストーラには、メッセージキュー のバージョン情報が不明瞭な形式で表示されます。(バグ 6586507)

Solaris プラットフォーム

Solaris プラットフォームの場合は、次の表を参照して、インストーラに表示される メッセージキュー のバージョンを判別してください。

3.6 SP4 のパッチリリースの場合 (たとえば、3.6 SP4 Patch 1)、インストーラで表示されるリリース文字列は同じままです。厳密なバージョンを判別するには、コマンド imqbrokerd -version を実行する必要があります。

Linux プラットフォーム

Linux のプラットフォームの場合、インストーラで表示されるバージョン番号は次の形式になります。

majorReleaseNumber.minorReleaseNumber-someNumber

たとえば、3.7–22 のようになります。これにより、3.7 リリースの 1 つであることだけはわかりますが、どの特定のバージョンかはわかりません。インストールされている メッセージキュー のバージョンを判別するには、次のコマンドを実行します。

imqbrokerd -version.

ローカリゼーションの問題

次に示す問題は、ローカリゼーションの問題に関係しています。

• インストーラを英語以外のロケールでテキストモード (installer –t) で実行すると、マルチバイト文字が文字化けします。 (バグ 6586923)

• インストーラの「進行状況」画面で、進行状況のバーに見慣れない文字が表示されます。ツールヒントは、英語以外のロケールではハードコードされています。(バグ 6591632)

• テキストモード (installer –t) は Windows ではサポートされていません。Windows でテキストモードでインストーラを実行すると、エラーメッセージが表示されます。このメッセージは、インストーラが英語以外のロケールで実行されていても、ローカライズされません。(バグ 6594142)

• インストーラの「ライセンス」画面には、インストーラが実行されるロケールに関係なく、英語のライセンステキストが表示されます。(バグ 6592399)

  回避方法: ローカライズされたライセンスファイルにアクセスするには、LICENSE_MULTILANGUAGE.pdf ファイルを検索してください。

• インストーラの使用方法に関するヘルプテキストがローカライズされていません。(バグ 6592493)

• インストーラの概要 HTML ページに表示される文字列「None」は、英語でハードコードされています。(バグ 6593089)

• インストーラをドイツ語のロケールで実行すると、ほかのロケールでは表示される開始画面のテキストが正しく表示されません。(バグ 6592666)

• インストーラの「Install Home」画面に表示される文字列「Install Home」がローカライズされていません。その文字列は、英語以外のロケールでインストーラを実行しても、英語で表示されます。(バグ 6592491)

• テキストモード (installer –t) でインストーラを実行すると、どのロケールでインストーラを実行するかに関係なく、英語の応答選択肢「Yes」および「No」が使用されます。(バグ 6593230)

• インストーラの「JDK 選択」画面の参照ボタンのツールヒントは、英語でハードコードされています。(バグ 6593085)

使用されなくなったパスワードオプション

以前のバージョンの メッセージキュー では、—p または —password オプションを使用して、imqcmd、imqbrokerd、および imdbmgr コマンドのパスワードを対話形式で指定することができました。version 4.0 から、これらのオプションは使用できなくなりました。

代わりに、関連するパスワードを指定したパスワードファイルを作成し、-passfile コマンドオプションを使用してそのパスワードファイルを参照できます。または、コマンドで要求されたときにパスワードを入力することもできます。

パスワードファイルには、次に示すパスワードを 1 つ以上格納することができます。

• SSL キーストアを開くために使用するキーストアパスワード。このパスワードを指定するには imq.keystore.password プロパティーを使用します。

• 接続が匿名でない場合に LDAP ディレクトリとの接続のセキュリティーを確保するために使用する LDAP リポジトリパスワード。このパスワードを指定するには imq.user_repository.ldap.password プロパティーを使用します。

• JDBC 準拠のデータベースとの接続に使用する JDBC データベースパスワード。このパスワードを指定するには imq.persist.jdbc.vendorName.password プロパティーを使用します。プロパティー名の vendorName コンポーネントは、データベースベンダーを指定する変数です。hadb、derby、pointbase、oracle、mysql から選択できます。

• imqcmd コマンド (ブローカ管理タスクを実行する) に対するパスワード。このパスワードを指定するには imq.imqcmd.password プロパティーを使用します。

次の例では、JDBC データベースに対するパスワード abracadabra をパスワードファイルに設定しています。

imq.persist.jdbc.mysql.password=abracadabra

バスワードファイルは、次のいずれかの方法で使用できます。

• ブローカがパスワードファイルを使用するように、ブローカの config.properties ファイルに次のプロパティーを設定する。

  imq.passfile.enabled=trueimq.passfile.dirpath= passwordFileDirectoryimq.passfile.name=passwordFileName

• 関連するコマンドの -passfile オプションを使用する。次に例を示します。

  imqbrokerd -passfile passwordFileName

管理および設定上の問題

次に示す問題は メッセージキュー の管理および設定に関係するものです。

• Windows プラットフォームでは、imqsvcadm コマンドを使用して、メッセージキュー ブローカを Windows サービスとして手動で追加する必要があります。インストーラはこの処理を実行しません。

• Windows プラットフォームの場合、デフォルトで有効になっている組み込みの Windows ファイアウォールで、ブローカがクライアントから受信接続を受け付けるようにするためのファイアウォール規則を手動で設定する必要があります。(バグ 6675595)

  1. コントロールパネルの「Windows ファイアウォール」をダブルクリックします。

     Windows ファイアウォールの設定ダイアログを開くには、「ユーザー アカウント制御」ダイアログで「続行」をクリックします。

  2. Windows ファイアウォールの設定ダイアログで、「例外」タブをクリックします。

  3. 「プログラムの追加」をクリックします。

  4. 「プログラムの追加」ダイアログで、「java.exe」を選択し、「参照」をクリックします。

     Windows はブローカプロセスを Java Platform SE バイナリとして識別します。従って、ブローカが使用する java.exe (通常は jdk1.5.0_15\jre\bin\java.exe) を探します。

  5. 「スコープの変更」をクリックします。

  6. 「スコープの変更」ダイアログで、「任意のコンピュータ (インターネット上のコンピュータを含む)」を選択します。

  7. 「了解」をクリックします。

  8. 「プログラムの追加」ダイアログで「OK」をクリックします。

  9. Windows ファイアウォールの設定ダイアログで「OK」をクリックします。

• Windows プラットフォームの場合、CLASSPATH に二重引用符が含まれていると、imqadmin および imqobjmgr コマンドの実行時にエラーがスローされます。(バグ 5060769)

  回避方法: コマンドプロンプトウィンドウを開き、次のように入力して CLASSPATH を設定解除します。

  set classpath=

  その後、同じコマンドプロンプトウィンドウで、必要なコマンドを実行します。次に例を示します。

  mqInstallHome\mq\bin\imqadmin

• すべての Solaris および Windows スクリプトで、-javahome オプションの値に空白文字が含まれると動作しません。(バグ 4683029)

  javahome オプションは メッセージキュー コマンドおよびユーティリティーで使用し、使用する代替の Java 2 互換のランタイムを指定します。ただし、代替の Java 2 互換のランタイムへのパスには、空白文字を含めることはできません。空白文字を含むパスの例は次のとおりです。

  Windows: C:\jdk 1.4

  Solaris: /work/java 1.4

  回避方法: Java ランタイムを、空白文字を含まない場所またはパスにインストールします。

• imqQueueBrowserMaxMessagesPerRetrieve 属性は、クライアントランタイムがキューの内容を検索するときに一度に取得することのできるメッセージの最大数を指定します。この属性は、キューに入れられたメッセージがバッチ処理され、クライアントランタイムに配信される方法には影響しますが、参照されるメッセージの総数には影響しません。この属性は参照機構のみに影響し、キューのメッセージの配信には影響しません。(バグ 6387631)

ブローカの問題

次に示す問題は メッセージキュー ブローカに影響します。

• 持続データストアがあまりにも多くの送信先を開く場合、ブローカがアクセス不可能になります。(バグ 4953354)

  回避方法: この状態はブローカがシステムのオープンファイル記述子の制限に達したことが原因です。Solaris や Linux では、ulimit コマンドを使って、ファイル記述子の制限を増やします。

• 送信先が破棄された場合、コンシューマが孤立します。(バグ 5060787)

  送信先が破棄された場合、アクティブコンシューマが孤立します。いったんコンシューマが孤立すると、送信先が再作成された場合でもメッセージを受信しなくなります。

• HTTP 接続サービスを使用している JMS クライアントが、Ctrl-C の使用などにより突然終了した場合、ブローカがクライアント接続や関連するすべてのリソースを解放するまでに、およそ 1 分かかります。

  この 1 分の間にクライアントのほかのインスタンスが起動し、同じ ClientID、永続サブスクリプション、またはキューを使おうとした場合、そのインスタンスは「クライアント ID はすでに使用されています」の例外を受け取ります。このことは実際の問題ではなく、上記の終了処理の結果にすぎません。およそ 1 分経過後にクライアントが起動すると、すべて問題なく動作します。

• データストアに MySQL データベースを使用している場合、1M バイトを超えるメッセージを格納すると、「クエリーのパケットが大きすぎます...」という SQLException がスローされます。(バグ 6682815)

  回避方法:--max_allowed_packet オプションでデフォルトの 1M バイトより大きい値を設定して MySQL サーバーを起動します。たとえば、次の値を使用します。

  --max_allowed_packet=60M

• 高可用性共有データストアに MySQL データベースを使用している場合、MySQL ストレージエンジンを NDBCLUSTER として設定する機構が必要です。(バグ 6691394)

  回避方法: ブローカの config.properties ファイルに、次のプロパティー値を追加します (『Sun GlassFish Message Queue 4.4 Administration Guide』の「Enhanced Clusters: JDBC Configuration Properties 」を参照)。

  imq.persist.jdbc.mysql.tableoption=EMGINE=NDBCLUSTER

• Oracle の 9i (JDBC 9.2.0.x) ドライバを使用する場合、ブローカが「Failed to persist property...」という例外をスローします。(バグ 6626825)

  回避方法: Oracle の 10g (JDBC 10.2.0.x) ドライバを使用します。ブローカはこのドライバに対して最適化されます。

  imq.persist.jdbc.derby.table.MYCONSTATE41.index.IDX2=CREATE INDEX &(index) ON $(name) (MESSAAGE_ID)

• データストアに Java DB データベースを使用している場合、メッセージを格納すると、「要求された時間内に例外を取得できませんでした」という SQLException がスローされます。(バグ 6691394)

  回避方法: ブローカの config.properties ファイルに次のプロパティー値を設定します。

  imq.persist.jdbc.derby.table.MYCONSTATE41.index.IDX2=CREATE INDEX &(index) ON $(name) (MESSAAGE_ID)

ブローカクラスタ

次に示す問題は、ブローカクラスタに影響します。

• このリリースでは、フル接続のブローカクラスタのみサポートされています。つまり、クラスタ内のすべてのブローカは、そのクラスタ内のほかのブローカと相互に直接やり取りする必要があります。imqbrokerd -cluster コマンド行引数を使用してブローカを従来のクラスタに接続する場合は、そのクラスタ内のすべてのブローカが含まれていることを確認してください。

• クライアントが拡張ブローカクラスタ内のブローカに接続されている場合、クライアントランタイムは、imqAddressListIterations 接続ファクトリ属性の値を無視して、成功するまで再接続を試みます。

• クライアントが検索できるのは、ホームブローカにあるキューの内容のみです。この場合でも、クライアントは、クラスタ内の任意のブローカに対してキューにメッセージを送信したりキューからのメッセージを消費したりできます。制約を受けるのはキューの検索のみです。

• Version 4.3 のブローカが含まれる従来のクラスタでは、すべてのクラスタが Version 3.5 以降でなければなりません。

• デフォルトでは、メッセージキュー 4.3、4.2、および 4.1 のブローカを メッセージキュー 3.7 または 3.6 のブローカと同時に使用できません。これは、これらのバージョン間で imq.autocreate.queue.maxNumActiveConsumers のデフォルト値が変更されているためです。(バグ 6716400)

  回避方法: すべてのブローカで imq.autocreate.queue.maxNumActiveConsumers の値を同じにします。通常は、メッセージキュー 4.3、4.2、および 4.1 の設定を変更して、3.7 または 3.6 のブローカで使用されている設定に一致させます (デフォルトでは、-1 の値を以前のバージョンのデフォルト値の 1 に変更します)。

• Message Queue 4.3 (または 4.x) ブローカを Message Queue 3.x ブローカクラスタに追加するには、マスターブローカが動作している必要があります。(バグ 6763796)

• 従来のクラスタから拡張クラスタに変換するときに、メッセージキュー データベースマネージャーユーティリティー (imqdbmgr ) を使用して、既存のスタンドアロン JDBC ベースのデータストアから共有 JDBC データストアに変換できます。方法については、『Sun GlassFish Message Queue 4.4 Administration Guide』の「Cluster Conversion: JDBC-Based Data Store」を参照してください。

• HADB を使用するブローカは、10M バイトより大きなメッセージを処理できません。(バグ 6531734)

• コマンド imqdbmgr upgrade hastore を使用した HADB ストアへの変換は、ストアに 10,000 を超えるメッセージが保持されている場合、「設定されているロックの数が多すぎます」というメッセージが表示されて失敗することがあります。(バグ 6588856)

  回避方法: 次のコマンドを使用して、ロックの数を増やします。

  hadbm set NumberOfLocks=<desiredNumber>

  詳細は、『Sun Java System Application Server 9.1 Enterprise Edition トラブルシューティングガイド』の「HADB の問題」を参照してください。

• 1 つのトランザクションに 500 を超えるリモートメッセージがコミットされている場合、ブローカは「HADB-E-12815: Table memory space exhausted」というエラーを返します。(バグ 6550483)

  詳細は、『Sun Java System Application Server 9.1 Enterprise Edition トラブルシューティングガイド』の「HADB の問題」を参照してください。

• ブローカクラスタで、ブローカが開かれていないリモート接続へのメッセージをキューに入れます。(バグ 4951010)

  回避方法: いったんその接続が開かれると、メッセージはコンシューマによって受信されます。コンシューマの接続が閉じたままの場合、メッセージは別のコンシューマへ再配信されます。

• 1 つのトランザクションでリモートブローカから複数のメッセージを消費しているときは、次のエラーメッセージがブローカに記録される可能性があります。このメッセージは無視しても問題ありません。

  [26/Jul/2007:13:18:27 PDT] WARNING [B2117]: 
  Message acknowledgement failed from 
  mq://129.145.130.95:7677/?instName=a&brokerSessionUID=3209681167602264320:
      ackStatus = NOT_FOUND(404)\
      Reason = Update remote transaction state to COMMITED(6): 
  transaction 3534784765719091968 not found, the transaction
  may have already been committed.
      AckType = MSG_CONSUMED
      MessageBrokerSession = 3209681167602264320
      TransactionID = 3534784765719091968
          SysMessageID = 8-129.145.130.95(95:fd:93:91:ec:a0)-33220-1185481094690
          ConsumerUID = 3534784765719133952\par
  
  [26/Jul/2007:13:18:27 PDT] WARNING Notify commit transaction 
  [8-129.145.130.95(95:fd:93:91:ec:a0)-33220-1185481094690, 
  [consumer:3534784765719133952, type=NONE]]
  TUID=3534784765719091968 got response: 
  com.sun.messaging.jmq.jmsserver.util.BrokerException:
   Update remote transaction state to COMMITED(6): 
    transaction 3534784765719091968 not found, the transaction may have already 
    been committed.:
  com.sun.messaging.jmq.jmsserver.util.BrokerException: Update remote transaction 
  state to COMMITED(6): transaction 3534784765719091968 not found, the transaction
   may have already been committed.r

  このメッセージは、imq.txn.reapLimit プロパティーが 1 つのトランザクション内のリモートメッセージの数と比較して少ない場合に、トランザクション内の後のメッセージのためにコミットをメッセージホームブローカに通知するときに記録されます。(バグ 6585449)

  回避方法: このメッセージを回避するには、imq.txn.reapLimit プロパティーの値を増やします。

JMX の問題

Windows プラットフォームでは、トランザクションマネージャーの監視 MBean の getTransactionInfo メソッドが不正なトランザクションの作成時間を含むトランザクション情報を返します。(バグ 6393359)

回避方法: 代わりに、トランザクションマネージャーの監視 MBean の getTransactionInfoByID メソッドを使用します。

SOAP サポート

SOAP サポートに関連した 2 つの問題に注意する必要があります。

• Message Queue の version 4.0 のリリースから、SOAP 管理によるオブジェクトのサポートは中止されています。

• SOAP 開発は、SUNWjaf、SUNWjmail、SUNWxsrt、および SUNWjaxp ファイルに依存します。Message Queue の version 4.1 では、これらのファイルを利用できるのは JDK version 1.6.0 以降で Message Queue を実行している場合のみです。

• 以前は、SAAJ 1.2 実装 .jar が mail.jar を直接参照していました。SAAJ 1.3 では、この参照が削除されたため、Message Queue クライアントが mail.jar を明示的に CLASSPATH 内に配置する必要があります。

再配布可能なファイル

Sun GlassFish メッセージキュー 4.4 には、バイナリ形式で使用でき自由に配布可能な次のファイルのセットが含まれています。

さらに、LICENSE ファイルおよび COPYRIGHT ファイルも再配布できます。

障害を持つユーザー向けのアクセシビリティー機能

このメディアの出版後にリリースされたアクセシビリティーを入手する場合は、請求に応じて Sun から提供される 508 条に関する製品評価資料を参照し、使いやすいソリューションの配備にもっとも適したバージョンを調べてください。アプリケーションの最新バージョンは、http://sun.com/software/javaenterprisesystem/get.html で入手できます。

アクセシビリティー機能に対する Sun のコミットメントについては、http://sun.com/access を参照してください。

問題の報告とフィードバックの方法

Sun GlassFish メッセージキュー に問題が発生した場合は、次のいずれかの方法で Sun のカスタマサポートにお問い合わせください。

• Sun ソフトウェアサポートサービスオンライン (http://www.sun.com/service/sunone/software)。

  このサイトには、ナレッジベース、オンラインサポートセンター、ProductTracker へのリンクと保守プログラムおよびサポートの連絡先電話番号へのリンクがあります。

• 保守契約を結んでいるお客様の場合は、専用ダイヤルをご利用ください。

最善の問題解決のため、サポートに連絡する際には次の情報をご用意ください。

• 問題が発生した箇所や動作への影響など、問題の具体的な説明

• マシンのタイプ、OS のバージョン、および製品のバージョン (問題に関連している可能性のあるパッチやその他のソフトウェアを含む)

• 問題を再現するために用いた詳細な手順。

• すべてのエラーログまたはコアダンプ。

Sun GlassFish Software Forum

次のサイトでは、Sun GlassFish メッセージキュー フォーラムが利用できます。

http://swforum.sun.com/jive/forum.jspa?forumID=24

ご参加を歓迎いたします。

Java Technology Forum

Java Technology Forums には、関連する JMS のフォーラムがあります。

http://forum.java.sun.com

このドキュメントに関するコメント

弊社では、ドキュメントの改善に努めており、お客様からのコメントおよびご忠告をお受けしております。

http://docs.sun.com にアクセスして「コメントの送信」をクリックしてください。このオンラインフォームでは、ドキュメントのタイトルと Part No. もご記入ください。Part No. は、7 桁か 9 桁の番号で、ドキュメントのタイトルページまたは最初のページに記載されています。このドキュメントのタイトルは『リリースノート』で、Part No. は 821-0892-05 です。

その他の情報

次のインターネットのサイトで、Sun GlassFish の情報を参照できます。

• ドキュメント

  http://docs.sun.com/prod/java.sys

• プロフェッショナルサービス

  http://www.sun.com/service/sunps/sunone

• ソフトウェア製品およびサービス

  http://www.sun.com/software

• ソフトウェアサポートサービス

  http://www.sun.com/service/sunone/software

• サポートおよびナレッジベース

  http://www.sun.com/service/support/software

• Sun サポートおよびトレーニングサービス

  http://training.sun.com

• コンサルティングおよびプロフェッショナルサービス

  http://www.sun.com/service/sunps/sunone

• 開発者向けの情報

  http://developers.sun.com

• Sun 開発者サポートサービス

  http://www.sun.com/developers/support

• ソフトウェアトレーニング

  http://www.sun.com/software/training