安裝和配置 WebSphere MQ

WebSphere MQ 是在 InterChange Server 和配接器之間啟用通訊的傳訊軟體。 InterChange Server 以 MQI Java 用戶端或 JMS 的身份 存取 WebSphere MQ 伺服器。

請在與 InterChange Server 相同的網路上安裝 WebSphere MQ。 若要安裝 WebSphere MQ,您必須是 ICS 管理者。

WebSphere MQ 亦可配置為 JMS 提供程式。 如需此選項的特定配置指示,請參閱"配置 JMS 的 WebSphere MQ"
HA

若為高可用性,請在叢集中的每一部機器上安裝 WebSphere MQ。 如需詳細資訊,請參閱 WebSphere MQ 文件。

安裝 WebSphere MQ

下列各節說明如何安裝 WebSphere MQ:

"升級 WebSphere MQ"

安裝 WebSphere MQ 軟體

升級 WebSphere MQ

如果您要升級 WebSphere MQ,而其目前作為 Windows 服務在執行,您必須先停止該服務, 才能升級至較新的版本或將修補程式套用到安裝。若服務未停止,當重新啟動 InterChange Server 時,可能會產生一連串的 WebSphere MQ 錯誤。 若要停止 WebSphere MQ 服務,請執行下列動作:

  1. 按一下「開始」>「設定」>「控制台」,然後按兩下「系統管理工具」。
  2. 按兩下「服務」。畫面上會出現「服務」對話框。
  3. 用滑鼠右鍵按一下 IBM WebSphere MQ,然後按一下「停止」。
註:
若要驗證目前環境中的 WebSphere MQ 版本,請在命令提示模式中輸入 mqver

如需在升級期間如何將現有資料保留於佇列中的特定資訊,請參閱 WebSphere MQ 文件。

安裝 WebSphere MQ 軟體

IBM 將 WebSphere MQ 軟體的 5.3.0.2 版放在另一片 CD 上。

  1. 插入 WebSphere MQ 5.3.0.2 CD。(可從以下網址下載 CSD:https://www6.software.ibm.com/dl/wsmqcsd/wsmqcsd-p )
  2. 遵循「WebSphere MQ 安裝啟動程式」中的指示。如需相關資訊,請參閱
    http://www.ibm.com/software/ts/mqseries/messaging/v53/。
  3. 在「啟動程式」處理程序的尾端,按一下「啟動 WebSphere MQ 安裝程式」。
  4. 在出現「歡迎使用」和「授權合約」畫面後,按一下「安裝類型」畫面中的「自訂」, 然後按「下一步」。
  5. 接受「程式」、「資料檔」及「日誌檔」的預設資料夾位置。
  6. 在「功能選項」畫面中,選取「Java 傳訊」,然後按「下一步」。 此功能將會安裝「MQ Java 用戶端程式庫」。
    註:
    若您正計劃「遠端代理程式」安裝,但並非安裝伺服器,您必須選取「Windows 用戶端」功能以提供必要的用戶端檔案。
  7. 在「準備安裝 WebSphere MQ」畫面中,按一下「安裝」。
  8. 當「安裝精靈順利完成」畫面出現時,按一下「完成」。
  9. 當「歡迎使用準備 WebSphere MQ 精靈」畫面出現時,按一下「取消」。
  10. 當系統要求確認結束時,按一下「確定」。
    註:
    在第一次完成 WebSphere MQ 安裝程序之後,MQ 會自動啟動。 在安裝 CSD 5 修正程式之前,必須先在工作列中的 WebSphere MQ 圖示上按一下滑鼠右鍵, 然後按一下「停止 WebSphere MQ」,將 MQ 停止。如果 MQ 沒有停止,CSD 安裝程式將會失敗。
  11. 安裝 CSD 5 修正程式。
  12. 重新啟動您的機器。
    重要事項:
    繼續進行安裝 InterChange Server、系統監視器及相關的軟體。 完成 InterChange Server 安裝和配置之後,將會引導您回到本章以配置 WebSphere MQ。

配置 WebSphere MQ 訊息佇列

WebSphere MQ 佇列會將連接器訊息送至 InterChange Server。 InterChange Server 需要每一個作用中連接器 的訊息佇列。configure_mq.bat 檔會建立佇列管理程式,並且建立指定於 crossworlds_mq.tst 檔中的所有佇列。這些檔案位於 \IBM\WebSphereICS\mqseries

您可能需要變更 WebSphere MQ 訊息佇列的預設配置,以便處理大型物件或大量訊息。 此可能需要變更 WebSphere MQ 訊息佇列的日誌檔大小、訊息佇列內容,或兩者。

變更日誌檔大小

若要變更 WebSphere MQ 訊息佇列的日誌檔大小,請修改 configure_mq.bat 檔。

  1. 建立 ProductDir\mqseries\configure_mq.bat 檔 的複本。重新命名複本,例如 ibm_mq_orig.bat
  2. 開啟複製的 configure_mq.bat 檔。使用 WebSphere MQ crtmqm 指令,以下列的格式來設定內容的值:
    crtmqm -lp integer -ls integer -lf integer -q 『%QUEUE%』
     

    參數如下所示:

    -lp
    指定主要日誌檔的數量。預設值為 3,最小值為 2,最大值為 62。

    -ls
    指定要配置的次要日誌檔數量。 預設值為 2,最小值為 1,最大值為 61。

    -lf
    以 4 KB 為單位,指定日誌檔的大小。預設值為 1024,即為提供 4 MB 的預設日誌大小。

    -q
    指定此佇列管理程式可以作為預設佇列管理程式。新的佇列管理程式會取代任何現有的預設佇列管理程式。

    例如,您可變更現有的 crtmqm -q "%QUEUE%" 陳述式,如下所示:

    crtmqm -lp 20 -ls 10 -lf 2048 -q "%QUEUE%"
     

變更訊息佇列內容

若要變更所容許的最大訊息佇列長度,請依照下列程序的說明,設定 crossworlds_mq.tst 檔中 MAXDEPTH、MAXMSGL、AND MAXUMSGS 內容的值:

  1. 導覽至 ProductDir\mqseries\crossworlds_mq.tst,並建立 crossworlds_mq.tst 檔的複本。重新命名複本,例如 ibm_mq_orig.tst
  2. 開啟複製的 crossworlds_mq.tst 檔。按照下列變更 MAXDEPTH 值變更 MAXMSGL 值這兩節的說明, 使用 WebSphere MQ ALTER 指令設定 MAXDEPTH 或 MAXMSGL 內容的值。
  3. 儲存檔案,然後重新啟動機器。
  4. 按一下「開始」>「程式集」> IBM WebSphere InterChange Server > IBM WebSphere MQ >「配置佇列管理程式」 ,以重新配置「MQ 管理程式」。
  5. 繼續進行第一次啟動 InterChange Server

變更 MAXDEPTH 值

依預設,WebSphere MQ 訊息佇列設為最多保留 5000 則訊息。在高資料流量或在起始的 WebSphere Business Integration 系統期間,可能會超過此預設值,造成錯誤並使連接器無法將訊息公佈到 ICS。為了幫助避免這種狀況,您可以增加 在佇列中容許的訊息最大數量,以及在所有佇列中容許的未確定訊息最大數量。偏好值可依特定的情況而變更。例如,若您正執行起始 WebSphere Business Integration 系統轉換,建議將佇列深度最大值設定為至少 20,000 則訊息。

若要變更 MAXDEPTH 設定,請在每一個佇列定義之後,新增下列:

ALTER QLOCAL (QUEUENAME) MAXDEPTH (DEPTH DESIRED)
 

例如:

DEFINE QLOCAL(AP/EMailConnector/Server_Name)
  
 ALTER QLOCAL(AP/EMailConnector/Server_Name) MAXDEPTH(20000)
 

您也可以變更佇列管理程式,使所有的佇列中可容許更多的標準未確定訊息。可容許的未確定訊息數量應是每一個佇列的最大訊息深度 (MAXDEPTH) 的總和。InterChange Server 使用的記憶體應該不會增加,除非未確定訊息的數量增加。

若要變更 MAXUMSGS 設定,請新增下列一行:

ALTER QMGR MAXUMSGS (NUMBER)
 

例如:

ALTER QMGR MAXUMSGS (400000)
 

變更 MAXMSGL 值

僅在您瞭解您有大於 4 MB 預設 MAXMSG 值的商業物件時,才修改此值。若要變更 MAXMSGL 值,請在每個佇列定義之後新增下列指令:

ALTER QLOCAL (QUEUENAME) MAXMSGL (一個訊息可容許的最大位元組數)
 

繼續進行步驟 3

定義佇列 (僅限 JMS)

ICS 需要您利用下面所列出的內容來配置佇列。於連接器的配置檔中,指定每一個佇列的名稱作為標準內容。

配置配接器的佇列

您可使用下列任何方法來為配接器配置必要的 WebSphere MQ 佇列:

要訣

若要輕易地識別與佇列相關的配接器,請使用配接器名稱作為佇列名稱的字首。 例如,將 Clarify 事件遞送佇列的配接器命名為:ClarifyConnector/deliveryqueue

使用批次檔配置 WebSphere MQ 佇列

WebSphere Business Integration Adapters 提供批次檔,供您配置部署配接器 所需的 WebSphere MQ 佇列。

下列檔案位於 ProductDir\mqseries

configure_mq.bat
執行此批次檔,以配置 crossworlds_mq.tst 中所指定的 WebSphere MQ 佇列。

crossworlds_mq.tst
編輯此檔案以指定 ICS 系統中的 WebSphere MQ 佇列。 configure_mq.bat 會讀取這個檔案當做輸入。

crossworlds_mq.tst 檔案的內容如下所示。您必須以手動方式編輯此檔案。 檔案的頂端部分包含原生的 MQ 資訊,而底端部份包含特定的 JMS 資訊。 您可使用此檔案來定義每一個配置的配接器所需要的佇列。請依下列方式編輯檔案:

  1. 在檔案的原生 WebSphere MQ 部份,刪除下列陳述式:
        DEFINE QLOCAL(IC/SERVER_NAME/DestinationAdapter)
         DEFINE QLOCAL(AP/DestinationAdapter/SERVER_NAME)
     

    這些僅適用於使用 WebSphere InterChange Server 的商業整合系統。

  2. 對於您所部署的每一個配接器,請使用 DEFINE QLOCAL(AdapterName/AdminInQueue) 開頭的陳述式作為範本,在檔案的 JMS 部份中建立個別的佇列定義陳述式組。

***************************************************************/
 *                                                                 */
 *   定義所有伺服器/配接器對組的本端佇列。                          */
 *   對於 MQ 佇列,必須有下列定義:                                 */
 *       Application = DEFINE QLOCAL (AP/AdapterName/ServerName)    */
 *                                                                  */
 *   範例:                                                         */
 *   DEFINE QLOCAL(AP/ClarifyConnector/CrossWorlds)                 */
 *                                                                  */
 *   DEFINE QLOCAL(AP/SAPConnector/CrossWorlds)                     */
 *                                                                  */
 *   如果您的伺服器名稱不同於 'CrossWorlds',                       */
 *   請務必變更項目以符合這項要求。                                 */
 ********************************************************************/
     DEFINE QLOCAL(IC/SERVER_NAME/DestinationAdapter)
     DEFINE QLOCAL(AP/DestinationAdapter/SERVER_NAME)
 ********************************************************************/
 *   對於每一個 JMS 佇列 (遞送傳輸是 JMS),
 *   預設值遵循下列慣例:
 *           AdapterName/QueueName
 ********************************************************************/
     DEFINE QLOCAL(AdapterName/AdminInQueue)
     DEFINE QLOCAL(AdapterName/AdminOutQueue)
     DEFINE QLOCAL(AdapterName/DeliveryQueue)
     DEFINE QLOCAL(AdapterName/RequestQueue)
     DEFINE QLOCAL(AdapterName/ResponseQueue)
     DEFINE QLOCAL(AdapterName/FaultQueue)
     DEFINE QLOCAL(AdapterName/SynchronousRequestQueue)
     DEFINE QLOCAL(AdapterName/SynchronousResponseQueue)
 ********************************************************************/
 *   定義預設的 CrossWorlds 通道類型                                */
 ********************************************************************/
     DEFINE CHANNEL(CHANNEL1) CHLTYPE(SVRCONN) TRPTYPE(TCP)
 ********************************************************************/
 *   CrossWorlds MQSeries 物件定義結束                              */
 ********************************************************************/
 

使用 WebSphere MQ Explorer 配置 WebSphere MQ 佇列

如需使用 WebSphere MQ Explorer 配置佇列的相關資訊,請開啟 WebSphere MQ Explorer 並參照其線上說明。

使用 WebSphere MQ 指令配置 WebSphere MQ 佇列

如需使用 WebSphere MQ 指令配置佇列的相關資訊,請參閱 WebSphere MQ:System Administration GuideWebSphere MQ:Script (MQSC) Command Reference

註:
若您不需要修訂 WebSphere MQ 訊息佇列的預設配置,請繼續進行 配置 JMS 的 WebSphere MQ第一次啟動 InterChange Server。 定義佇列之後,請勿在 ICS 和佇列管理程式執行時,重新執行 configure_mq.bat 檔。這樣會導致現有的佇列發生問題。

配置 WebSphere MQ

您必須配置 WebSphere MQ 佇列管理程式和 WebSphere MQ 接聽器。

配置 WebSphere MQ 佇列管理程式

第一次配置 InterChange Server 系統時,您必須建立佇列管理程式。 按一下「開始」>「程式集」> IBM WebSphere InterChange Server > IBM WebSphere MQ >「配置佇列管理程式」。

此時會建立預設的佇列管理程式並將您在安裝期間定義的名稱提供給它。

將接聽器新增到 WebSphere MQ 服務

建立佇列管理程式之後,您必須將 WebSphere MQ 接聽器新增為 Windows 服務, 並將它配置為自動啟動:

  1. 按一下「開始」>「程式集」> IBM WebSphere MQ > WebSphere MQ Explorer,以啟動 WebSphere MQ Explorer。
  2. 在 WebSphere MQ Explorer 的左窗格中,選取具有該佇列管理程式名稱的佇列管理程式資料夾。 右窗格中的「佇列管理程式狀態」應該會顯示佇列管理程式狀態為「執行中」。若沒有顯示,請以滑鼠右鍵按一下佇列管理程式名稱, 然後從下拉清單中選取「啟動」。「佇列管理程式狀態」應該變更為「執行中」。
  3. 在右窗格中,以滑鼠右鍵按一下佇列管理程式名稱,然後從下拉清單中選取「所有作業」 >「服務」,以開啟 WebSphere MQ Services。
  4. 在 MQServices 視窗的「主控台根目錄」樹狀結構中,展開 WebSphere MQ Services, 然後選取佇列管理程式。

    在右窗格中,應列示特定佇列的三個項目:「佇列管理程式」、「指令伺服器」,以及「通道起始器」。 (若您看不到「通道起始器」,它將會在您重新啟動系統之後出現。)

  5. 針對右窗格中的三個項目 (「佇列管理程式」、「指令伺服器」、「通道起始程式」), 用滑鼠右鍵按一下每一個項目,然後選取「所有作業」>「自動」,將「啟動」模式配置為「自動」。
  6. 用滑鼠右鍵按一下「主控台根目錄」樹狀結構中的佇列管理程式名稱,然後從下拉清單中 選取「新建」>「接聽器」,以新增接聽器項目。
  7. 在「建立接聽服務」對話框的「參數」標籤中,選取 TCP 作為通訊協定並 選取 1414 作為埠號,然後按一下「確定」。

    您必須為每一個接聽器使用唯一埠號。請指定預設值 1414 以外的號碼作為埠號, 然後按一下「確定」。

  8. 以滑鼠右鍵按一下接聽器,然後選取「所有作業」>「自動」,將接聽器配置為自動啟動。
  9. 關閉 IBM WebSphere MQ Explorer。當提示您儲存變更時,按一下「是」。
  10. 重新啟動您的機器。
  11. 執行下列步驟,驗證「通道起始程式」是否已啟動:
    1. 「開始」>「程式集」> IBM WebSphere MQ > WebSphere MQ Services。(另外,您可在工作列上以滑鼠右鍵按一下 WebSphere MQ 圖示,然後選取 MQ Services。)
    2. 在「MQ 服務」視窗中,驗證「通道起始程式」是否執行中且是否設為「自動」。
    3. 關閉「MQ 服務」視窗。

配置 JMS 的 WebSphere MQ

對於每一個要搭配 WebSphere MQ for JMS 傳輸使用而配置的每一個連接器, 請使用「連接器配置程式」工具,以編輯本端連接器的配置檔。

WebSphere MQ 應該使用 JMS 傳輸,因為原生的 WebSphere MQ 需要 CORBA 來進行管理及使用其他元件。不過,若當作 JMS 提供程式來使用,就不再需要 CORBA。此外,原生的 MQ 僅會保存進入伺服器的事件。

指定佇列管理程式並配置表 5 列出的內容值。 在此範例中,JmsConnector 是配置的連接器

表 5. JMS 傳輸的內容值
內容
AdminInQueue JMSCONNECTOR\ADMININQUEUE
AdminOutQueue JMSCONNECTOR\ADMINOUTQUEUE
DeliveryQueue JMSCONNECTOR\DELIVERYQUEUE
FaultQueue JMSCONNECTOR\FAULTQUEUE
RequestQueue JMSCONNECTOR\REQUESTQUEUE
ResponseQueue JMSCONNECTOR\RESPONSEQUEUE
SynchronousRequestQueue JMSCONNECTOR\SYNCHRONOUS
REQUESTQUEUE
SynchronousResponseQueue JMSCONNECTOR\SYNCHRONOUS
RESPONSEQUEUE

您可以將 UserNamePassword 保留空白,除非您使用用戶端模式存取佇列管理程式。

重要事項:
若您在國際性環境上配置 JMS 的 WebSphere MQ, 您必須安裝 JMS 的 WebSphere MQ 類別之國際版本。

在下列位置中,指定已針對特定連接器更新的本端配置檔:

  1. 導覽至「開始」>「程式集」> IBM WebSphere Integration Adapters >「配接器」>「連接器」> 「連接器名稱」
  2. 用滑鼠右鍵按一下連接器名稱並選取「內容」。
  3. 在「目標」欄位的路徑尾端插入 -c filename 指令。

    其中 filename 是擁有該連接器項目之本端配置檔的完整路徑。

在進行這些變更之後,請重新載入儲存庫並重新啟動 InterChange Server 與連接器。 繼續進行第一次啟動 InterChange Server

Copyright IBM Corp. 1997, 2004