IBM WebSphere Message Broker および IBM WebSphere Event Broker をお買い上げいただき、ありがとうございます。この文書はフィックスパック 2 の README ファイルです。このファイルの内容は、バージョン 6.0.0.2 の Tooling コンポーネントおよび Runtime コンポーネントに関連しています。
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 ファイルを使用してください。最新版の 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 用)
翻訳版のインフォメーション・センターは、一般出荷の開始後に Update Manager を通して入手可能になります。
WebSphere Message Broker および WebSphere Event Broker のスタンドアロン・インフォメーション・センターは、WebSphere Documentation CD に収録されています。また、 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 バージョン)
installing_and_managing.htm ファイルをお読みください。このファイルは wmb_help_lin.zip および wmb_help_win.zip ファイルに収められています。
印刷用にフォーマットされた情報トピック、および Rules and Formatter に関する全資料は以下のアドレスにあります。
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/
障害: この README 文書では、全体に渡って障害番号の参照が記されています。これらの障害番号は IBM 社内問題番号を参照しており、 問題について IBM 技術員と相談するときにこの問題番号が役立ちます。
技術情報: 現在の時点で既知の問題と使用可能なフィックスについては、次の URL をご覧ください。
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 has encountered a problem and needs to close
このエラーの原因として、Windows コンポーネント「Microsoft ネットワーク用ファイルとプリンタ共有」がアンインストールされていることが考えられます。セキュリティー・プログラムは、このコンポーネントによって提供される API に依存しており、このコンポーネントがインストールされていない場合、正常に完了できません。 このコンポーネントが必要ない場合、無効にしてください。
インストール・プログラムが正常に完了するように実行するには、以下に示す手順を実行してください。
UNIX プラットフォームで、構成マネージャー・コンポーネントのインストール時に Broker コンポーネントをインストールせず、その後同じディレクトリーに Broker コンポーネントをインストールすると、Broker の 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 (フィックスパック 2 へのアップグレード後、以下を行う必要があります。
サイレント・インストールに応答ファイルを使用する際に、応答ファイルのフラグの設定が誤っていることがあります。 その結果、(製品全体ではなく) インストールする 1 つ以上の特定のコンポーネントを選択した場合に、この選択内容が無視され、製品全体がインストールされます。この問題に対処するには、応答ファイルを編集し、該当するフラグを以下のように変更する必要があります。
-W setupTypes.selectedSetupTypeId=custom
上記の行を以下のように変更します。
-W setupTypes.selectedSetupTypeId=
つまり、何も設定しません。これにより、デフォルトの標準インストールまたはカスタム・インストール (すべてのコンポーネントのインストール) が実行されなくなります。
Message Broker Toolkit および Event Broker Toolkit と Rational Application Developer (RAD) または Rational Software Architect (RSA) 製品のインストールに関する、いくつかの重要な問題に関する技術情報を入手できます。Message Brokers Toolkit をインストールするときには、これらの技術情報を参照することを強くお勧めします。これらの技術情報の参照方法については、この README ファイルの『サポート』セクションで説明します。
WebSphere MQ Real-time Transport with Multicast PGM support を使用するメッセージ・フローを開発する場合、該当するブローカー・システムごとに WebSphere MQ バージョン 6.0 以上をインストールする必要があります。さらに、APAR IC47032 と USERMOD ANPGM01 を適用する必要があります。
Message Broker はグローバル・ゾーンまたは完全ルートの非グローバル・ゾーンでサポートされており、それぞれにインストールする必要があります。
WebSphere Message Broker の 1 つ以上のコンポーネントが既にコンピューター上にインストール済みの場合に、さらに別のコンポーネントをインストールしようとすると、その追加のコンポーネントのインストールだけでなく、製品全体のインストールに十分なディスク・スペースがあるかどうかが InstallShield によって確認されます。その結果、追加のコンポーネントに対して十分なスペースがコンピューター上にあっても、その追加コンポーネントをインストールできないことがあります。 製品全体をインストールするのに十分なスペースがある場合、選択したコンポーネントを正常にインストールすることができます。 しかし、十分なスペースがない場合は、前にインストールしたコンポーネントをアンインストールしてから、開始し直す必要があります。
現時点では、「コマンド・アシスタント・ウィザード」では構成マネージャー・コンポーネントを管理できません。 この状況を修正するフィックスが入手可能になる予定です。
WebSphere Message Brokers Toolkit で使用する WebSphere MQ V6 Explorer プラグインをインストールするには、Eclipse Update Manager を使用できます。ただし、最初に WebSphere MQ V6 の V6.0.1 リフレッシュ・パックをインストールする必要があります。
Eclipse ツールバーから、「ヘルプ」>「ソフトウェア更新」>「検索とインストール」を選択します。「新規フィーチャー」オプションを選択します。 新規のローカル・ソースとして <WebSphere MQ installation directory>/eclipse を追加します。すると、インストール可能なものとして Explorer フィーチャーが表示されます。
V6.0.1 更新が入手可能になる前の対処法として、WebSphere MQ Explorer の各種フィーチャーとプラグインの入ったディレクトリーを、WebSphere Message Brokers Toolkit ディレクトリーに手動でコピーすることができます。WebSphere Message Brokers Toolkit を再始動した後で、WebSphere MQ Explorer を新規のパースペクティブとしてオープンすることができます。
-options-record フラグを使用して、サイレント・アンインストールに使用する応答ファイルを作成する場合、応答ファイルには無効な設定のフラグが含められます。その結果、(製品全体ではなく) 1 つ以上の特定のコンポーネントのアンインストールを選択した場合に、この選択内容が無視され、製品全体がアンインストールされます。
この問題に対処するには、応答ファイルを編集し、個別のコンポーネントをアンインストールするかしないかを指定する各行を変更する必要があります。 つまり、以下のストリングすべてのインスタンスの変更が必要です。
-P feature.active=trueこれは、以下のように変更します。
-P feature.activeForUninstall=trueここで、feature はアンインストールするコンポーネントの名前です。
また、以下のストリングすべてのインスタンスの変更も必要です。
-P feature.active=falseこれは、以下のように変更します。
-P feature.activeForUninstall=falseここで、feature はアンインストールしないコンポーネントの名前です。
各コンポーネントごとに、これらのステートメントのいずれか (activeForUninstall=true または activeForUninstall=false) が存在することを確認してください。
ただし、生成された応答ファイルには、インストールされていないコンポーネントに関する activeForUninstall ステートメントが含まれている場合があります。このようなステートメントが存在する場合、これらの各コンポーネントについての activeForUninstall オプションは true に設定してください。これらのコンポーネントについて activeForUninstall オプションが false に設定されていると、アンインストール・プログラムが失敗します。
以下の Dublin Adapter ソリューションを使用している場合は、Dublin Adapters Support (dubadsup@ie.ibm.com) に連絡し、Message Broker バージョン 6 でテスト済みのソリューションのバージョンについて確認してください。単にバージョン 5 ソリューションをマイグレーションしないでください。このマイグレーションを実行すると、バージョン 5 の動作が多少変化します。
ソリューションをバージョン 6 にマイグレーションする前に、以下の Dublin Adapter ソリューションを使用している場合は、Dublin Adapters Support (dubadsup@ie.ibm.com) に連絡し、Message Broker バージョン 6 でテスト済みのバージョンが入手可能であるかどうか、およびその他に問題があるかどうかを確認してください。
メッセージ・セットを WebSphere MQ Integrator バージョン 2.1 からマイグレーションする際に、メッセージ・セットに SWIFT などの業界標準 TDS 物理フォーマットが含まれている場合や、メッセージ・セットをバージョン 2.1 ブローカー (またはサービス・レベルがフィックスパック 3 より前のバージョン 5 ブローカー) にデプロイする予定である場合は、mqsimigratemsgsets コマンドの使用後に以下のステップを実行する必要があります。
この更新を行わないと、メッセージ・セットをバー・ファイルに追加する際に、以下のメッセージが表示されます (このメッセージ中の CSD3 はフィックスパック 3 を指します)。
BIP0202W このディクショナリーにはバージョン 5 CSD3 以上のブローカーが必要です。TDS 形式 "SWIFT" は「厳密な数値チェック」を使用します。このオプションは、バージョン 5 CSD 3 より前のブローカーではサポートされていません。
このエラーを訂正しないと、バー・ファイルを正常にデプロイできるようになりません。
パブリッシュ/サブスクライブ・アプリケーションで Real-timeInput ノードを使用すると、すべての分散プラットフォームの DataFlowEngine プロセスでメモリー・リークが発生する可能性があります。プラットフォームとパブリッシュ/サブスクライブ・クライアントの数によっては、DataFlowEngine プロセスにより使用されるメモリーのサイズが継続的に拡大します。
DataFlowEngine プロセスでメモリー不足が発生すると、このプロセスは停止します。Windows では、「errors」フォルダーに ABEND ファイルとダンプが生成されます。他のシステムでは、ABEND ファイルとコア・ファイルが生成されます。その後、DataFlowEngine プロセスが再開します。
例えば、1 つの実行グループを持つ 1 つのブローカーで単一メッセージ・フロー (その他のインスタンスなし) を使用し、Windows を実行する 4 way 4GB コンピューターで 80 のパブリッシュ/サブスクライブ・クライアントを使用すると、約 1.5 時間後に DataFlowEngine プロセスは停止します。
システム・イベント・ログに以下のようなエラーが記録されます。
Java 仮想マシン OutOfMemoryError が発生しました。 JVM は OutofMemoryError 状態を報告しました。
ABEND ファイルには、以下のようなエラーが記録されます。
ファイル: F:¥build¥S000_P¥src¥DataFlowEngine¥JavaNodeLibrary¥ImbJmsIpJNIJmsIpNode.cpp 行: 417 関数: Java_com_ibm_broker_server_JmsIpNode_logFatalError AbendAction: 3
この問題を解決するには、ブローカーを停止してから再始動し、Java 仮想マシン・ヒープ・サイズを大きくする必要があります。Real-timeInput ノードの代わりに Real-timeOptimizedFlow ノードを使用すると、一部のメモリーの問題を解消できます。
z/OS プラットフォーム: 宛先プロパティーが「ユーザー・トレース」に設定されている Trace ノードを高スループット・メッセージ・フローに組み込むと、所有実行グループが停止することがあります (異常終了 S2C1)。Trace ノードは常にアクティブであるため、通常は実動フローに組み込まないでください。Trace ノードは常にアクティブであり、I/O オーバーヘッドが高いため、この問題を防ぐには、接続 Trace ノードが高スループット・フローに組み込まれていないことを確認してください。
フロー・デバッガーを使用する場合は、コンピューターのロケールに関係なく、ブローカーと実行グループの名前を英字で指定する必要があります。
AIX では、/usr/lib から Oracle 提供の 32 ビット・クライアント・ライブラリー「libclntsh.a」へのリンクがない場合は、XA 対応 WebSphere MQ キュー・マネージャー (WebSphere MQ バージョン 5 上) をクリーンな状態で開始できません。
この問題を解決するには、(root として) 以下のコマンドを実行します。
ln -s $ORACLE_HOME/lib32/libclntsh.a /usr/lib/libclntsh.a
これにより、キュー・マネージャーをクリーンな状態で開始できます。
これは WebSphere MQ バージョン 6 には適用されないことに注意してください。
Oracle9i または Oracle10g と DB2v8 を同一 HP-UX システムにインストールしている場合は、Oracle ブローカー・データベースとブローカーを使用すると問題が発生することがあります。
ブローカーを開始できず、ABEND ファイルが作成されます。このファイルに、DB2 ライブラリーで解決された Oracle ライブラリーのシンボルが原因で、セグメンテーション違反が発生していることが記録されています。
ブローカーで Oracle を使用する際に、同じ (HP-UX) コンピューターに DB2 がインストールされている場合は、<install_dir>/lib/imbdfdb2.lil ファイルを使用不可にします。最も簡単にこれを実行する方法は、imbdfdb2.lil の名前を何らかの名前に変更する方法です。これにより、HP-UX オペレーティング・システムが Oracle シンボルの解決に使用する DB2 ライブラリーをブローカーが取得しなくなります。
Oracle XA は、AIX、Solaris、および HP-UX 上の 64 ビット EG をサポートしません。
データベース内の Unicode データの操作はサポートされていません。
インフォメーション・センターの「サポートされるデータベース」のトピックで説明されている制限に加えて、32 ビットの Informix Dynamic Server と 32 ビットのクライアント SDK だけがサポートされることに注意してください。64 ビットの Informix サーバーまたはクライアントはサポートされていません。
Informix クライアントの必要なバージョンは SDK V2.90 (UC4X8 フィックスパックを適用) 以上です。このフィックスパックを要求するには、Informix に連絡してください。
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 は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、 改良または変更を行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、 便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものでは ありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部では ありません。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、 自ら適切と信ずる方法で、使用もしくは配布することができるものとします。
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムと その他のプログラム (本プログラムを含む) との間での情報交換、 および (ii) 交換された情報の相互利用を可能にすることを目的として、 本プログラムに関する情報を必要とする方は、下記に連絡してください。
本プログラムに関する上記の情報は、適切な使用条件の下で使用すること ができますが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他の ライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、 IBM より提供されます。
IBM 以外の製品に関する情報は、その製品の供給者、出版物、 もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、 他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、 あるいは製品などの名前が含まれている場合があります。 これらの名称はすべて架空のものであり、 名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。
著作権使用許諾:
本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。お客様は、サンプル・プログラムが書かれているオペレーティング・ プラットフォームのアプリケーション・プログラミング・インターフェースに 準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、 いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、 配布することができます。 このサンプル・プログラムは、あらゆる条件下における完全なテストを経ていません。 従って IBM は、これらのサンプル・プログラムについて信頼性、利便性もしくは機能性が あることをほのめかしたり、保証することはできません。 お客様は、IBM のアプリケーション・プログラミング・インターフェースに準拠した アプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、 IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。
以下は、IBM Corporation の商標です。
AIX、DB2、Everyplace、IBM、Universal Database、WebSphere、z/OS、zSeries。
Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Microsoft および Windows は、Microsoft Corporation の米国およびその他の国における商標です。
UNIX は、The Open Group の米国およびその他の国における登録商標です。
Linux は、Linus Torvalds の米国およびその他の国における商標です。
他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。
DB2 フィックスパック
DB2 フィックスパック は CD-ROM から入手するか、または Web からダウンロードして入手します。ただし、フィックスパックはサイズが大きいことがあるので、CD-ROM 版を請求すると、長時間かけてダウンロードする必要がありません。
現行のサポート契約をお持ちの場合は、DB2 サポートに電話して DB2 フィックスパックの CD-ROM 版を注文することができます。
連絡先の詳細については、次の URL に説明されています (英語)。
http://www.ibm.com/software/data/db2/udb/support.html
この同じ Web サイトからダウンロードすることもできます。
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.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 Services Description Language (WSDL) の仕様 (英語)
http://www.w3.org/TR/wsdl
WebSphere Message Broker Basics (Redbook) (英語)
http://www.redbooks.ibm.com/abstracts/sg247137.html
Migration to WebSphere Message Broker V6 (Redbook) (英語)
http://www.redbooks.ibm.com/abstracts/sg247198.html