このセクションでは、アダプターをインストールして実行する前に、WebSphere Commerce およびその他のソフトウェアに対して実行しなければならないインストール作業と構成作業について説明します。
実行しなければならない作業は、以下のとおりです。
WebSphere Commerce バージョン 5.4 (Fix Pack 6 以上を適用) をインストールするか、WebSphere Commerce バージョン 5.5 (Fix Pack 4 以上を適用) をインストールします。インストール手順とインストール後の構成については、製品に付属の資料を参照してください。 WebSphere Commerce メッセージング・システムは、メッセージを処理してバックエンド・システムとやり取りするために装備されています。
CMDREG テーブルを更新する必要があります。これは、XML メッセージ・フォーマットを使用するための、WebSphere Commerce データベース内のコマンド・レジストリー・テーブルです。
Commerce 拡張パックをインストールするには、URL
http://www.ibm.com/software/commerce/epacks か ら
Commerce 拡張パック・ドライバーをダウンロードし、readme.txt
ファイルの指示に従います。
このアダプターは、WebSphere Commerce の既存のパブリッシュ済みストアと併用することができます。また、新しいストアを作成することもできます。
アダプターの使用に必要な WebSphere MQ キューの構成は、WebSphere Commerce と IBM WebSphere InterChange Server Express をインストールする場合の接続形態により、ある程度異なります。サポートされている接続形態は、以下のとおりです。
WebSphere Commerce と IBM WebSphere InterChange Server Express とアダプターがすべて、同じマシンにインストールされています。
WebSphere Commerce が 1 台のマシンにインストールされ、IBM WebSphere InterChange Server Express とコネクターがもう 1 台のマシンにインストールされています。マシンごとに別々のキュー・マネージャーが使用されています。
WebSphere Commerce が 1 台のマシンにインストールされ、IBM WebSphere InterChange Server Express とコネクターがもう 1 台のマシンにインストールされています。同じキュー・マネージャーを使用して、両方のマシンのキューを管理しています。
この接続形態では、WebSphere Commerce と InterChange Server Express と Adapter for WebSphere Commerce がすべて、1 台のマシンにインストールされています。単一のキュー・マネージャーが、ソリューションで使用するすべての WebSphere MQ キューを処理します。InterChange Server Express をインストールしたときにセットアップしたキュー・マネージャーを使用することをお勧めします。
この接続形態では、以下の役割を行うキューが必要です。
これは、WebSphere Commerce が必要とするキューです。ただし、アダプターは、このソリューションではこのキューを利用しません。
これは、WebSphere Commerce が必要とするキューです。ただし、アダプターは、このソリューションではこのキューを利用しません。
InterChange Server Express から WebSphere Commerce に送信されるメッセージの受信用。
WebSphere Commerce から InterChange Server Express へのメッセージの送信用。
WebSphere Commerce から InterChange Server Express に送信される有効なメッセージのオリジナル・バージョンは、アダプターが処理を完了するまでここに保管されます。処理が完了すると、オリジナルのメッセージはローカルのアーカイブ・キューに移されます。
メッセージがアダプターにより完全に処理されて、WebSphere Commerce から InterChange Server Express に送信されると、メッセージのオリジナル・バージョンはここに保管されます。
メッセージが正常に解析されたが、アダプターでサポートされるビジネス・オブジェクトに対応していないと、ここに保管されます。
メッセージは、ビジネス・オブジェクトに正常に変換されずに InterChange Server Express に送信されると、ここに保管されます。
WebSphere Commerce で正常に処理できないメッセージが保管されます。
同期データ交換用にセットアップされた構成でのみ使用されます。
マシンが 1 台の接続形態では、上記のキューはすべてローカルです。キューを手動で作成する場合は、そのキューに割り当てる名前を選択します。このソリューションでバッチ・ファイルを使用する場合 (以下を参照) は、バッチ・ファイルが、事前に割り当て済みの名前を使ってキューを作成します。
Windows 環境でアダプターを使用している場合は、バッチ・ファイルを使用して、マシンが 1 台の接続形態に適したキューを生成することができます。このファイルは、製品パッケージと一緒に、IBM InterChange Server Express のインストールで使用したルート・ディレクトリー内の ¥Connector¥WebSphereCommerce¥Utilities サブディレクトリーにインストールされます。このバッチ・ファイルを使用してキューを作成するには、以下のように、ファイル ConfigureWebSphereCommerceAdapter.bat を実行します。
コマンド・プロンプトに、以下のように入力します。
ConfigureWebSphereCommerceAdapter <InterChangeServerName>.queue.manager
ここで、<InterChangeServerName> は WebSphere InterChange Server Express の名前です。
これで、InterChange ServerName.queue.manager という名前のキュー・マネージャーが作成され、必要な WebSphere MQ キューが作成されます。バッチ・ファイルによって作成される、作成済みキューの名前は、以下のとおりです。
WC_MQCONN.IN_PROGRESS: アダプター用の InProgress Queue。
WC_MQCONN.ERROR: アダプター用の InterChange Server Express Error Queue。
WC_MQCONN.ARCHIVE: アダプター用の Archive Queue。
WC_MQCONN.REPLY: アダプター用の Reply-To_Queue。
WC_MQCONN.UNSUBSCRIBED: アダプター用の UnSubscribed Queue。
WCS_Serial_Inbound: WebSphere Commerce 用の Serial Inbound Queue。WebSphere Application Server の JMS 設定の構成 (WAS 4.x の場合)に示すように、WebSphere Commerce に対して定義されている JMS キュー名と一致しなければなりません。
WCS_Outbound: WebSphere Commerce 用の Outbound Queue。WebSphere Application Server の JMS 設定の構成 (WAS 4.x の場合)に示すように、WebSphere Commerce に対して定義されている JMS キュー名と一致しなければなりません。
WCS_Parallel_Inbound: WebSphere Commerce 用の Parallel Inbound Queue。WebSphere Application Server の JMS 設定の構成 (WAS 4.x の場合)に示すように、WebSphere Commerce に対して定義されている JMS キュー名と一致しなければなりません。
WCS_Error: WebSphere Commerce 用の Error Queue。WebSphere Application Server の JMS 設定の構成 (WAS 4.x の場合)に示すように、WebSphere Commerce に対して定義されている JMS キュー名と一致しなければなりません。
WCS_Inbound: WebSphere Commerce 用の Inbound Queue。WebSphere Application Server の JMS 設定の構成 (WAS 4.x の場合)に示すように、WebSphere Commerce に対して定義されている JMS キュー名と一致しなければなりません。
OS/400 環境でアダプターを使用する場合は、キューを作成する必要があります。
ご使用のシステムに応じて、次の 2 通りの方法でキューを作成できます。
WebSphere Business Integration Server Express Console を使用してキューを作成する
WebSphere Business Integration Server Express Console を使用する場合は、以下の手順でキューを作成します。
ユーザー・プロファイルは、Server Express コンポーネントのインストール時に作成された WebSphere MQ キュー QWBIDFT.QUEUE.MANAGER に対するアクセス権を持っている必要があります。
メモ帳でファイル mq_temp.tst が開いて、このファイルを編集できるようになります。
DEFINE QL (WC_MQCONN.IN_PROGRESS)
DESCR (WBI Adapter In Progress Queue)
DEFINE QL (WC_MQCONN.ERROR)
DESCR (WBI Adapter Error Queue)
DEFINE QL (WC_MQCONN.ARCHIVE)
DESCR (WBI Adapter Archive Queue)
DEFINE QL (WC_MQCONN.REPLY)
DESCR (WBI Adapter Reply-To Queue)
DEFINE QL (WC_MQCONN.UNSUBSCRIBED)
DESCR (WBI Adapter UnSubscribed Queue)
DEFINE QL (WCS_Serial_Inbound)
DESCR (WebSphere Commerce MQ Adapter JMS Serial Inbound Queue)
DEFINE QL (WCS_Outbound)
DESCR (WebSphere Commerce MQ Adapter JMS Outbound Queue)
DEFINE QL (WCS_Parallel_Inbound)
DESCR (WebSphere Commerce MQ Adapter JMS Parallel Inbound Queue)
DEFINE QL (WCS_Error)
DESCR (WebSphere Commerce MQ Adapter JMS Error Queue)
DEFINE QL (WCS_Inbound)
DESCR (WebSphere Commerce MQ Adapter JMS Inbound Queue)
コンソールにより、OS/400 上のキューが作成されます。
コマンド行を使用してキューを作成する
CL コマンドを使用してキューを作成する場合は、コマンド・プロンプトで以下のように入力します。
ここで、serverName は InterChange Server Express インスタンスです (OS/400 の場合、デフォルトは QWBIDFT)。
この接続形態では、WebSphere Commerce が 1 台のマシンにインストールされ、IBM WebSphere InterChange Server Express と Adapter for WebSphere Commerce がもう 1 台のマシンにインストールされています。
WebSphere MQ は、マシンごとにインストールしなければならないので、インストールごとに別々のキュー・マネージャーを使用します。以下に、各マシンで作成するキューを示します。
WebSphere Commerce マシン上のキュー
|
InterChange Server Express マシン上のキュー
|
---|---|
WCS_Outbound Queue WebSphere Commerce から InterChange Server Express
へのメッセージの送信用。このキューは、リモート・キューとして InterChange
Server Express マシン上の ICS_Inbound
を指す、リモート・キュー定義として作成されます。
|
ICS_Inbound queue WebSphere Commerce から InterChange Server Express
に送信されるメッセージの受信用。
|
WCS_Serial Inbound queue InterChange Server Express から WebSphere Commerce
に送信されるメッセージの受信用。
|
ICS_Outbound queue InterChange Server Express から WebSphere Commerce
へのメッセージの送信用。このキューは、リモート・キューとして WebSphere
Commerce マシン上の WCS_Serial Inbound
を指す、リモート・キュー定義として作成されます。
|
InterChange Server Express へ WebSphere Commerce システムから InterChange Server Express への送信キュー。
|
WebSphere Commerce へ InterChange Server Express から WebSphere Commerce システムへの送信キュー。
|
WCS_Error_queue WebSphere Commerce で正常に処理できないメッセージが保管されます。
|
ICS_Error_queue メッセージは、ビジネス・オブジェクトに正常に変換されないと、ここに保管されます。
|
WCS_Parallel Inbound
|
アダプターは、並列インバウンド・キューを利用しません。
|
|
ICS_InProgress queue WebSphere Commerce から InterChange Server Express
に送信される有効なメッセージのオリジナル・バージョンは、アダプターが処理を完了するまでここに保管されます。処理が完了すると、オリジナルのメッセージはローカルのアーカイブ・キューに移されます。
|
|
ICS_Archive_queue メッセージがアダプターにより完全に処理されて、WebSphere Commerce から
InterChange Server Express
に送信されると、メッセージのオリジナル・バージョンはここに保管されます。
|
|
ICS_Unsubscribed_queue メッセージがビジネス・オブジェクトに正常に変換されたが、アダプターでサポートされるビジネス・オブジェクトに対応していないと、ここに保管されます。
|
2 つのシステム間の通信を確立するには、チャネルと送信キューを使用します。
この接続形態では、各マシンごとに以下の役割を実行するチャネルを作成しなければなりません。
WebSphere Commerceマシン上のチャネル | InterChange Server Express マシン上のチャネル |
---|---|
Sender_WCS
|
Sender_ICS
|
Receiver_ICS
|
Receiver_WCS
|
以下の手順では、別々のマシンとキューに対応付けるように、特定のサーバーとキュー・マネージャーの名前を指定しています。チャネルは、正しいキューが参照し合っていることを確認するためのものです。キューの「ローカル」バージョンは、実際の情報を保持するためのものです。
WebSphere Commerce マシンで、以下の構成作業を行います。
これで、WebSphere Commerce マシンの構成作業は終わりです。
InterChange Server Express マシンで、以下の構成作業を行います。
WebSphere Commerce マシンと InterChange Server Express マシンの両方で WebSphere MQ キューとチャンネルの構成が終了したら、受信側チャネル、送信側チャネルの順に始動します。
この接続形態では、WebSphere Commerce が 1 台のマシンにインストールされ、InterChange Server Express と Adapter for WebSphere Commerce がもう 1 台のマシンにインストールされています。WebSphere MQ のインスタンスは 1 つしか実行されていないので、両方のマシンで使用するキューは単一のキュー・マネージャーで管理されます。このシナリオでは、ローカル・キューしか使用しません。
この接続形態では、以下の役割を行うキューが必要です。
これは、WebSphere Commerce が必要とするキューです。ただし、アダプターは、このソリューションではこのキューを利用しません。
InterChange Server Express から WebSphere Commerce へのメッセージの送信用。
WebSphere Commerce から InterChange Server Express に送信されるメッセージの受信用。
WebSphere Commerce から InterChange Server Express に送信される有効なメッセージのオリジナル・バージョンは、アダプターが処理を完了するまでここに保管されます。処理が完了すると、オリジナルのメッセージはローカルのアーカイブ・キューに移されます。
メッセージがアダプターにより完全に処理されて、WebSphere Commerce から InterChange Server Express に送信されると、メッセージのオリジナル・バージョンはここに保管されます。
メッセージが正常に解析されたが、アダプターでサポートされるビジネス・オブジェクトに対応していないと、ここに保管されます。
メッセージは、ビジネス・オブジェクトに正常に変換されずに InterChange Server Express に送信されると、ここに保管されます。
WebSphere Commerce で正常に処理できないメッセージが保管されます。
同期データ交換用にセットアップされた構成でのみ使用されます。
Java Messaging Service Connection Factory と JMS キューを作成して WebSphere MQ で使用できるように、WebSphere Application Server (WAS) を構成する必要があります。以下の手順を実行します。
set classpath= %classpath%; MQ_install_path¥java¥lib¥com.ibm.mqjms.jar; MQ_install_path¥java¥lib¥com.ibm.mq.jar; MQ_install_path¥java¥lib¥com.ibm.mq.iopp.jar; MQ_install_path¥java¥lib¥com.ibm.ibmorb.jar;WAS_install_path¥lib¥ns.jar
set MQ_JAVA_INSTALL_PATH=MQ_install_path¥java
set PATH = WAS_Intall_Path¥Java¥bin;%PATH%
INITIAL_CONTEXT_FACTORY=com.ibm.ejs.ns.jndi.CNInitialContextFactory PROVIDER_URL=iiop://localhost:900
上記の値は、WebSphere Commerce と WebSphere MQ が同じマシンにインストールされていることを前提とします。
SECURITY_AUTHENTICATION=none
コマンド・プロンプト:> JMSAdmin -cfg JMSAdmin.config -t -v
このコマンドを実行すると、WebSphere Application Server が提供する JNDI (Java Naming and Directory Interface) サービスを検索できるようになります。InitCtx> プロンプトが表示されるので、これを使用して JMS 管理コマンドを実行することができます。
ここで、JMS_QueueConnection_Factory は、MQQueueConnectionFactory JMS オブジェクトの名前です。
上記の一連のコマンドを実行すると、このキュー・コネクション・ファクトリーの項目が WebSphere Application Server データベースの BINDINGBEANTBL テーブル下に作成されます。これらのオブジェクトは、WebSphere Application Server データベースに登録されます。
JMS キューを定義する構文は、以下のとおりです。
define q(JMS_Outbound_Queue)qmanager (Your_Queue_Manager_Name) queue(Your_Outbound_QueueName)
define q(JMS_Inbound_Queue)qmanager (Your_Queue_Manager_Name) queue(Your_Inbound_QueueName)
define q(JMS_Parallel_Inbound_Queue)qmanager (Your_Queue_Manager_Name)queue (Your_Parallel_Inbound_Queue_Name)
define q(JMS_Serial_Inbound_Queue)qmanager (Your_Queue_Manager_Name)queue (Your_Serial_Inbound_Queue_Name)
define q(JMS_Error_Queue)qmanager (Your_Queue_Manager_Name) queue (Your_Error_Queue_Name)
Your_Outbound_QueueName
|
アウトバウンド・キューに対して作成する WebSphere MQ
キュー。デフォルトでは、これは、アダプターが WebSphere Commerce から
InterChange Server Express
に渡すメッセージを選ぶときにポーリングするキューです。バッチ・ファイルで作成されるデフォルトの WebSphere MQ キュー設定では、この値は
WCS_Outbound になります。
|
Your_Serial_Inbound_Queue
|
逐次インバウンド・キューに対して作成する MQ キュー。これは、WebSphere
Commerce の MQ アダプターが、InterChange Server Express から Websphere
Commerce に送信するメッセージを入れるキューです。バッチ・ファイルで作成されるデフォルトの WebSphere MQ キュー設定では、この値は
WCS_Serial_Inbound になります。
|
Your_Parallel_Inbound_Queue_Name
|
これは、並列インバウンド・キューに対して作成する WebSphere MQ キューです。
|
Your_Error_Queue_Name
|
エラー・キューに対して作成する WebSphere MQ キュー。メッセージでエラーが発生すると、WebSphere Commerce MQ Adapter はここにメッセージを送信します。バッチ・ファイルで作成されるデフォルトの WebSphere MQ キュー設定では、この値は WCS_Error になります。 |
Your_Queue_Manager_Name
|
WebSphere Commerce システムのユーザー設定で、WebSphere MQ
キューを処理するキュー・マネージャーの名前。バッチ・ファイル
ConfigureAdapterQueues.bat (WebSphere Commerce のインストールと構成を参照) で作成されるセットアップなど、マシンが 1
台の一般的なセットアップでは、InterChange Server Express
に対して設定したキュー・マネージャーを使用して、WebSphere Commerce
システムのキューも管理します。 このようなセットアップでは、デフォルトは
<InterchangeServerName>.queue.manager
になります。
|
キューを作成し終えたら、JMSAdmin コンソールを使用して、アウトバウンド・キューとエラー・キューの以下のプロパティーを設定します。ここでは、JMS が固有の WebSphere MQ アプリケーションを扱うことを指定します。
JMSAdmin ツールを終了するために、end と入力します。これで、WebSphere Application Server で WebSphere Commerce が実行されるように Java Messaging Service を構成する作業は終わりです。
WebSphereCommerce 5.5 の導入により、Commerce インスタンスが WAS 5.x の WebSphere Application Server として作成されるようになりました。 5.x バージョンの WebSphere Application Server 用に JMS を作成するときは、JMS 設定は、WAS 4.x バージョンに関して記載されている JMSAdministrator ツールを使用するのではなく、WAS 管理者ユーザー・インターフェースを介して構成する必要があります。WAS 管理者インターフェースにログオンしたら (管理者インターフェースへの接続方法については WAS の資料を参照)、以下の一般手順を使用して JMS を構成します。
WAS 5.x の WebSphere Application Server 用に JMS を構成するには、以下の手順を実行します。
GRTMQMAUT OBJ(*ALL) OBJTYPE(*ALL) USER(<WAS_SubSystem_Name>) AUT(*ALL) MQMNAME(<ICSName>.QUEUE.MANAGER)
例えば: GRTMQMAUT OBJ(*ALL) OBJTYPE(*ALL) USER(QEJBSVR) AUT(*ALL) MQMNAME(QWBIDFT.QUEUE.MANAGER)
WebSphere Commerce 管理コンソールを始動します。サイト管理者としてログインし、「構成」セクションに移動して、「トランスポート (Transport)」オプションを選択します。トランスポートとして WebSphere MQ を選択し、状況をアクティブに変更します。管理コンソールからログアウトします。
WebSphere Commerce ソリューションでは、「WebSphere Commerce インストール・ガイド」に記載されているように、「ストア」の作成と使用が必要です。同資料の『サンプル・ストアのパブリッシュ (Publishing a Sample Store)』のセクションに従ってストアのパブリッシュを完了したら、今度はストア管理者として管理コンソールにログオンし、使用しているストアを選択します。「構成」セクションで、ストアに MQ Transport を追加します。これに対する項目は、STORETRANS テーブルに作成されます。
メッセージング・システムのトランスポート・アダプターを使用可能にするには、WebSphere Commerce Configuration Manager を立ち上げて、以下のことを実行します。
以下のように、このインスタンスで connectionSpec に使用している値を使って、JMSQueue の名前と JMS Connection Factory を構成します。
終わったら、Configuration Manager を終了します。
インスタンスに合わせて WebSphere Application Server クラスパスを更新し、その他の jar ファイル項目を追加する必要があります。このためには、WebSphere Application Server Advanced Administrative Console を開き、以下のことを実行します。
name= ws.ext.dirs value=MQ_INSTALL_PATH/java/lib
ここで、MQ_INSTALL_PATH は WebSphere WebSphere MQ のインストール・パスです。
WebSphere Commerce で、管理コンソール下の構成オプションを使用して、WebSphere Commerce と IBM WebSphere InterChange Server Express のインプリメンテーションで使用しているアウトバウンドとインバウンドのメッセージング用の WebSphere MQ キューと通信するように WebSphere Commerce を構成します。必要に応じて、「WebSphere Commerce オンライン・ヘルプ」ガイドを参照してください。