IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit 5.1 版 README

變更歷程：
GA：2004 年 7 月 23 日
Updated: 20 August 2004

(C) Copyright IBM Corporation 2004. All rights reserved.

歡迎使用 IBM WebSphere Business Integration Message Brokers Toolkit 5.1 版。本 README 檔含有線上資訊中心尚未包含的最新資訊。 其中的資訊僅適用於在 Microsoft^(R) Windows^(R) 上安裝 Message Brokers Toolkit 5.1 版，並與 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版搭配使用。

警告！
只有在安裝了 WebSphere Application Development Integration Edition (WSADIE) 5.1 版的情況下，才能安裝 Message Brokers Toolkit 5.1 版。 如果您有較舊層次的 WSADIE，請勿安裝 5.1 版； 這樣的情況下，您必須使用由 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版所提供的 Message Brokers Toolkit 5.0 版。Message Brokers Toolkit 5.1 版 與 Message Brokers Toolkit 5.0.3 版（修正套件 3）的功能相同。

若要取得有關 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版所有其他元件的資訊，請參閱 5.0 版 README。

Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation of the Message Brokers Toolkit Version 5.1. However, if at least one of your Message Broker Toolkit installations integrates with WSADIE Version 5.1, all your Message Broker Toolkit installations must be at Version 5.1 to ensure data sharing and integrity.

If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.0.

所有使用者都需要瞭解的重要資訊
建議您務必查看最新版本的 README。您可以在下列網址中找到這個 README 的最新版本（僅提供英文版）：
http://www.ibm.com/software/integration/mqfamily/support/readme/

若要完成安裝，請參閱 install.html 檔。

您可以從以下網址找到 README 檔以及 install.html 檔的翻譯版本： ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

進行移轉時需要的重要資訊

If you are migrating, refer to the install.html file for details of the actions that you must take before you install.

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first; the two versions cannot coexist.

The information center provides further information about migration; to view this before you install, download a stand-alone version of the information center (see the "Documentation" section for instructions).

請您注意以下幾個有關移轉和部署的事項：

• 在 5.1 版工具箱中建立或修改訊息流程、訊息集以及訊息對映後， 您無法再存取 5.0 版工具箱中的資源。 請確定在團隊環境中共用專案的所有使用者都注意到此限制，且在需要時製作備份。
• 您必須要從供應商取得所有使用者定義的節點外掛程式的移轉版本， 才能成功地部署包含這些節點外掛程式的訊息流程。

在不同系統中，您可以共用不同版本的資源：

• 您可以部署任何在 5.0 版中所開發的專案，不需作任何變更。
• 您可以將此版本所建立的分配管理程式保存檔匯入 5.0 版工作區，並成功部署。

文件
您可以下載已更新的 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版的獨立式資訊中心，內容 中已包含 Message Brokers Toolkit 5.1 版所需的變更。從以下網址可以下載 zip 保存檔：ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip

請參閱包含在 wbimb_help.zip 檔中的 installing_and_managing.htm 檔。

支援
在這份 Readme 文件中提供了問題號碼的參照。這些號碼是代表內部的 IBM 問題號碼；在與您的 IBM 客戶服務代表討論問題時，這些號碼可能會有所幫助。
如需已知問題以及可用修正程式的最新資訊，請查看
http://www.ibm.com/software/integration/wbimessagebroker/support/
WebSphere Business Integration Message Broker，以及
http://www.ibm.com/software/integration/wbieventbroker/support/
WebSphere Business Integration Event Broker。

功能更新
您應該定期檢查有沒有功能的更新（包括文件更新）。

請遵循下列步驟：

1. 從工具箱中，選取說明 > 軟體更新 > 新的更新項目。之後，Eclipse 會搜尋可用的更新項目。
2. 這時 Eclipse 會顯示可用的更新項目。選取您要安裝的更新項目。
3. 當您選取要安裝的更新項目時，您會收到一則功能尚未以數位簽章的警告。您可以忽略這個警告。
4. 安裝好功能之後，Eclipse 會提示您重新啟動工作台。
5. 在您重新啟動工作台後，新的功能已安裝，且可以開始使用。

目錄

限制

• WebSphere Studio Application Developer Integration Edition
• 共存性
• 安裝
• 安裝之後

注意事項和商標

有用的網頁

限制

本節依元件概述 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 的限制。  

WebSphere Studio Application Developer Integration Edition

若要擴充 WebSphere Studio Application Developer Integration Edition (WSADIE) 工作台以使用此產品，您必須將 WSADIE 升級至適當的支援層次。 可以擴充的 WSADIE 工作台版本為 WSADIE 5.1 GA 版（並套用「臨時修正程式 002 - 一般修正程式 2.0.0」）。

在安裝了 WebSphere Business Integration Message Broker 或 WebSphere Business Integration Event Broker 之後，您還必須套用修正程式「WebSphere Business Integration Message Broker v5.1.0 臨時修正程式 001 - 必備修正程式 1.0.0.1」。

若要取得詳細指示，請參閱 install.html 檔。

共存性

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first. The two versions cannot coexist, however you can share resources between versions on different systems:

• 您可以部署任何在 5.0 版中所開發的專案，不需作任何變更。
• 您可以將此版本所建立的分配管理程式保存檔匯入 5.0 版 工作區，並成功部署。

有關如何移轉資源和使用者資料至 5.1 版的資訊，請參照線上資訊中心的「移轉」一節。

安裝

1. 在安裝期間，如果您選擇「不」接受「授權合約」，就會出現一個包含「是」和「否」按鈕的蹦現畫面。 不論你選取哪一個按鈕，您都會返回「授權合約」頁面。 如果按一下「是」，會使安裝取消，並且關閉「啟動程式」。

   另外，在安裝期間，如果您在「授權合約」 頁面中按「上一步」，會出現幾個 Java^TM 虛擬機器 (JVM) 錯誤訊息，且「啟動程式」會當掉。

   解決方案：如果您要順利安裝產品，請接受「授權合約」。

安裝之後

1. 如果您已安裝了 Message Brokers Toolkit 5.1 版，並取代了 5.0 版：
   1. 問題報告 34555
      您必須重新建置在您工作區中所定義的所有專案。
   2. 問題報告 34930
      如果 INSTALL_PATH\eclipse\workspace\.metadata 存在，您可能會發現，在開啟 Message Brokers Toolkit 時， 「更新管理程式」會正確啟動，但是對外掛程式的任何更新都會失敗。因此，Message Brokers Toolkit 無法開啟正確的外掛程式層次，可能導致工具箱失敗。
      
      比方說，當您在「分配管理系統應用程式開發視景」中，您可能會發現檔案 > 新建功能表所產生的清單遺漏了訊息定義檔功能表項目。 這表示您的安裝架構中不含「訊息分配管理系統工具箱」外掛程式的正確層次或版本。
      
      您可以按一下 Message Brokers Toolkit for WebSphere Studio 視窗中的說明 > 關於 Message Brokers Toolkit for WebSphere Studio - Message Broker， 來檢查所使用的外掛程式層次是否正確。在 "Message Brokers Toolkit for WebSphere Studio" 標題之下，會顯示版本號碼。 如果在安裝 5.1 版後使用了正確版本的外掛程式，則顯示的版本會是 5.1.0。如果顯示的版本為舊的，請執行以下步驟：
      1. 刪除 .metadata 目錄。
      2. 重新開啟「訊息分配管理系統工具箱」。
      3. 針對每個專案執行下列動作，以將現有專案重新匯入工作區中：
         1. 按一下檔案 > 匯入。
         2. 當「匯入」精靈出現時，請選取現有專案至工作區，然後按一下下一步。
         3. 按一下瀏覽並定義工作區中的專案位置。
         4. 按一下完成。
2. 問題報告 32898
   如果本端主機存取作業的 LAN 設定配置不正確，可能會因為自動組態 Script 中的設定而發生下列狀況之一：
   • 您的說明瀏覽器開啟空白的頁面。
   • 您的說明瀏覽器顯示 HTTP 錯誤，而不是說明頁面。
   • 在載入資訊中心時有長時間的延遲。
   
   解決方案：系統管理者可以執行下列動作來配置 LAN 設定，以便從本端說明伺服器順利存取說明文件：
   1. 在控制台中，開啟「網際網路選項」，選取「連線」標籤，選擇 LAN 設定。
   2. 如果您的主機配置成使用 DHCP 來指派 IP，請確定已清除自動偵測設定勾選框。
   3. 如果您使用 Proxy 伺服器，請確定已選取本端網址略過 Proxy 伺服器。
   4. 在 Proxy 的進階設定中，如果 '127.0.0.1;localhost' 沒有列在「例外」中，請將它加進去。
   5. 如果您使用 Proxy 設定的自動組態 Script，且不確定這個 Script 是否正確，請清除使用自動組態 Script 勾選框。
   
   如果上述步驟無法修正您的問題，請嘗試變更 org.eclipse.tomcat\preferences.ini 中的 port 和 host 內容。 設定 host=localhost 或 host=127.0.0.1 應該會有效。 如果您在執行防火牆，您也可能需要設定 port=80（或其他防火牆方便使用的值）。
3. Defect T32243
   The mxsd file extension is not associated correctly with the Message Definition Editor. To ensure that mxsd files are opened in the Message Definition Editor as the default action, select Window > Preferences > Workbench > File Associations. Scroll down the list of file types and select *.mxsd. Then select Message Definition Editor in the list of Associated editors. Click Default then OK.
4. Defect 36422
   In the topic "Distributing a user-defined node" in the online information center, the instructions about extracting the zip file are incorrect. Step 2 of the instructions tells you to unzip the file to the install_dir\eclipse\plugins directory. Instead, the correct location to unzip the file to is the WBIMB_install_dir\evtoolkit\eclipse\plugins directory.
   In the topic "Installing a user-defined extension on a broker domain" in the online information center, the install location for Windows is ambiguous. For C user-defined nodes, the topic tells you to use the location install_dir\bin. This should be WBIMB_install_dir\bin. For Java user-defined nodes, the topic tells you to use the location install_dir\jplugin. This should be WBIMB_install_dir\jplugin.
5. Defect 36589
   If you use any of the predefined ESQL constants, such as MQMO_NONE, in ESQL code, the code is flagged as Message Brokers Toolkit Version 5.0 compatible. This means that you cannot deploy message flows referencing this ESQL code to a Version 2.1 broker, regardless of the compatibility level set in the preferences. This limitation will be lifted in the next fix pack for Message Brokers Toolkit Version 5.1.
6. Defect 36605
   The description of the property Namespace in topics "Wildcard attribute logical properties" (ad11870_) and "Wildcard element logical properties" (ad11890_) is incorrect. In the current implementation, there is no enumerated list of options and the field is initially blank. You can specify a namespace in this field; this causes a Task List warning to be displayed which explains that the broker will not use this information and will allow an element from any namespace to be used as the wildcard.
7. Defect 36638
   The Message Set Editor Preferences topic (ad15810_) describes only the options available in the Version 5.0 toolkit. The Version 5.0 options are not available for Version 5.1. In the Version 5.1 toolkit, the options are:
   • Message set editor settings, Outline view settings. These options are displayed but are not operational:
     • Group by namespace and then by collections
     • Group by collections and then by namespace
   • Message definition editor settings:
     • Show base complex types
       If you have defined one or more complex types based on other complex types, select this option if you want the content of those base complex types to be displayed in the message definition editor overview and outline views (this is selected by default).
       If you do not want them displayed, clear the check box.
8. TDS properties
   The grouping and order of TDS properties of global attribute, global element, local attribute, and local element shown in the workbench differ from the grouping and order shown in the topics that describe them. Their meaning and use is unchanged.
9. Defect 36655
   If you uninstall the toolkit by invoking uninstaller.exe with the -silent option, the uninstall program returns control immediately and runs as a background task. If you do not want the uninstall program to return until it has completed, you must invoke the uninstaller within java using this command:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   where <install_dir> is the directory in which you installed the product.
   If you do not have a jvm configured (Version 1.3.1 or above), you can use the jvm within the installed product in directory <install_dir>\_sjvm\bin\. If you do this, you might have to delete this directory manually when uninstallation is complete.