變更歷程:
GA:2004 年 7 月 23 日
修正套件 5:2005 年 2 月 9 日
這個檔案包含的資訊說明了在 Microsoft(R) Windows(R) 2000 以及 Windows XP 上安裝 IBM WebSphere Business Integration Message Brokers Toolkit for WebSphere Studio 5.1 版的方式,以及進行後置安裝配置的步驟。
這些資訊僅適用於 Message Brokers Toolkit 5.1 版的安裝程序,並與 WebSphere Business Integration Message Broker 和 WebSphere Business Integration Event Broker 5.0 版搭配使用。若要取得有關所有 其他元件的資訊,請參閱 5.0 版 Readme 以及安裝指示。
警告!
除非您已安裝 WebSphere Studio Application Developer Integration Edition 5.1 版,才需要安裝 Message Brokers Toolkit 5.1 版。如果您有較舊層次的 WebSphere Studio Application Developer Integration Edition,請勿安裝 5.1 版;
這樣的情況下,您必須使用由 WebSphere Business Integration Message Broker
和 WebSphere Business Integration Event Broker 5.0 版所提供的 Message Brokers Toolkit 5.0 版。
移轉
如果您要進行移轉作業,請閱讀安裝須知。
在群組環境中安裝 Message Brokers Toolkit 5.1 版
WebSphere Studio Application Developer Integration Edition 5.1 版並非
安裝 Message Brokers Toolkit 5.1 版的必備項目。但若其中一項 Message Broker Toolkit 安裝作業整合了
WebSphere Studio Application Developer Integration Edition 5.1 版,則所有安裝的 Message Broker Toolkit
版本都必須是 5.1 版,以確保資料的分享及完整性。
如果您並未在任何系統上使用 WebSphere Studio Application Developer Integration Edition 5.1 版, 或您使用的是 WebSphere Studio Application Developer Integration Edition 5.0 版, 請務必安裝 Message Brokers Toolkit 5.0 版。
說明文件
請檢視最新版的線上安裝指示,以確定您的安裝指示為最新版本。
您可以在以下網址找到最新版本(僅提供英文版):
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
這些指示的翻譯版也會在稍後提供在以下網址中:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
Message Brokers Toolkit 5.1 版隨附的資訊中心不包括翻譯版本。 資訊中心中的其他語言部分會保持空白,且所有的資訊都以英文顯示。 如果您要用美國英文以外的支援語言顯示資訊中心,請在安裝修正套件後,下載適當的 Eclipse 功能。 您可在修正套件發佈當時或稍後取得翻譯的版本。README 檔則提供如何下載這些更新的指示。
您可以下載 WebSphere Business Integration Message Broker 和 WebSphere Business Integration
Event Broker 的獨立式資訊中心。您可以從以下網址下載壓縮檔:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/wbimb_help.zip
請參閱包含在 wbimb_help.zip 檔中的 installing_and_managing.htm 檔。
目錄
有關 Message Brokers Toolkit 5.1 版所支援特定版本作業系統的最新狀態,
請造訪以下 WebSphere MQ Family Supported Software 網頁:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
(WebSphere Business Integration Message Broker) 或
http://www.ibm.com/software/integration/wbieventbroker/requirements/
(WebSphere Business Integration Event Broker)
以下環境支援 Message Brokers Toolkit 5.1 版:
Windows 2003 不支援本產品。
安裝 Message Brokers Toolkit 5.1 版之前,你可能需要先完成部分動作:
5.0 版的安裝指示也放在主產品光碟的 \installdocs\<locale>\install.html 目錄中。
5.0 版修正套件 5 的獨立資訊中心包括 5.1 及 5.0 版工具箱的相關資訊。
如果您要在系統上安裝 Message Brokers Toolkit 5.1 版,且系統上並沒有安裝其他 Message Brokers 元件, 則不需在安裝前進行任何動作。
在裝載了 CD 後,「安裝精靈」會自動啟動。您也可以在「Windows 檔案總管」裡按兩下 setup.exe,或在指令行中呼叫它,來執行安裝程式。
這些安裝指示說明了安裝 Message Brokers Toolkit 5.1 版必須執行的步驟。
如果您從指令行裡執行安裝程式,您可以指定選項,以指示安裝作業執行的方式。 您可在安裝指令行選項中找到選項的說明。
指令的格式顯示於下:
setup.exe [-options-...]
如果您未併入任何選項,則會啟動「安裝精靈」。
如果 CD 在遠端系統上,您可以對映 CD 的網路磁碟機。您無法使用 UNC 路徑 (\\server\drive) 來存取安裝程式;請務必對映磁碟機,否則 JavaTM 程序會逾時。如果您無法對映磁碟機,或不想對映磁碟機, 請將 CD 內容複製至本端磁碟機,並從該磁碟機進行安裝。
以下指示說明了如何進行 Message Brokers Toolkit 5.1 版的安裝設定。 您可以用三種不同的模式來執行「安裝精靈」:
在開始前,請確定您具有「管理者」專用權。
GUI 介面是「安裝精靈」的預設模式,也就是沒有指令行選項。
如果您在安裝進度畫面出現之前按一下取消,就會結束安裝程序,系統會返回原始狀態。
不過,如果您在「安裝進度」列出現之後取消「安裝精靈」,系統不會還原至其前一個狀態。
請參閱解除安裝指示來移除 Message Brokers Toolkit。
在使用精靈時,在按下一步 > 按鈕後,可能需要等待數秒鐘,才會進入下一個畫面。
如果您按兩次下一步>,您可能會跳過整個畫面。如果要確定安裝已開始執行,您可以監視 CPU 使用率,因為 CPU 使用率在進行安裝時會大幅提高。
「主控台」模式安裝在主控台視窗中有一個文字型的介面。 您可以從指令行中輸入以下指令來啟動它:
path setup.exe -console -is:javaconsole其中 path 是目前安裝程式的位置。 例如:
E:\setup.exe -console -is:javaconsole在現行主控台視窗中,啟動 Windows 安裝程式(位於 E 磁碟機的根目錄中)。
請使用以下提示以瀏覽安裝:
1 以移至下一個畫面
2 以回到上一個畫面
3 以取消並結束安裝程式
4 以重新顯示現行畫面
預設選項一律顯示在方括弧中,例如 [1]。
如果這是正確的選項,請按 Enter 鍵繼續。
您可使用回應檔或安裝程式的預設值,來管理無聲模式。
「安裝精靈」的預設值會遵循上述交談模式中的可用選項,產生以下動作:
如果要使用預設值,請在指令行中輸入以下指令:
path setup.exe -silent其中 path 是目前安裝程式的位置。 例如:
E:\setup.exe -silent啟動 Windows 安裝程式(位於 E 磁碟機的根目錄中)。
回應檔在進行無聲自動安裝時給予您某些控制權。 您有兩個方法可以產生回應檔:
path setup.exe -options-record responsefile
其中 responsefile 是您選擇的回應檔的完整路徑和名稱。建議您在產品安裝目錄以外的其他目錄中建立回應檔。
path setup.exe -options -template responsefile
其中 responsefile 是您選擇的回應檔的完整路徑和名稱。範本回應檔包含如何輸入特定選項的完整指示。
警告
如果您要將工具箱鏈結到 WebSphere Studio Application
Developer Integration Edition 工作台,請務必對範本或新產生的回應檔進行以下更正動作。
於「無聲自動安裝」模式下,如果要整合工具箱與 WebSphere Studio Application Developer Integration Edition,您必須使用回應檔。請參閱 WebSphere Studio Application Developer Integration Edition 以取得進一步資訊。
安裝引數可讓安裝程式以 4 種不同模式執行:GUI 模式、主控台模式、協助工具模式及無聲模式。 安裝引數還可讓您記錄並使用回應檔。
GUI 模式是預設的安裝模式,無須輸入安裝引數,又稱為抽象視窗工具箱 (Abstract Window Toolkit, AWT) 模式。 請在指令行中輸入以下指令:
setup.exe [-awt]其中 awt 是選用的,只有在預設安裝模式不是 GUI 時才需要用到。
主控台模式通常是在 GUI 模式無法使用時才會用到,但您也可以視需要隨時使用。 請在指令行中輸入以下指令:
setup.exe -console -is:javaconsole協助工具模式另外提供視障使用者聽覺資訊,可用來作為執行主控台模式的替代指令行。 請在指令行中輸入以下指令:
setup.exe -accessibility在無聲安裝模式下不需要使用者輸入指令,除非使用了回應檔。 如要在許多相同的系統上安裝程式時,建議採用無聲自動安裝。請在指令行中輸入以下指令:
setup.exe -silent回應檔是用來紀錄在互動式 GUI 或主控台安裝中輸入的選項,並在在執行無聲自動安裝時自動輸入選項。 若要記錄主控台安裝的回應,請在指令行中輸入以下指令:
setup.exe -options-record responsefile -console -is:javaconsole其中 responsefile 是回應檔的完整路徑和檔案名稱。
若要記錄 GUI 安裝的回應,請在指令行中輸入以下指令:
setup.exe -options-record responsefile其中 responsefile 是回應檔的完整路徑和檔案名稱。
在 CD 影像起始目錄的 sample-scripts 目錄中,提供了範例回應檔。
您必須在使用回應檔前,先更正其錯誤。如需詳細資訊,請參閱安裝指示中,無聲安裝模式下的警告。
若要讓安裝期間記錄的選項在無聲自動安裝時自動輸入,請在指令行中輸入以下指令:
setup.exe -options responsefile -silent其中 responsefile 是回應檔的完整路徑和檔案名稱。
回應檔範本中並不包含預設的安裝選項,而是讓您能加以編輯,方便稍後使用。 要產生回應檔並不一定要執行完整安裝。若要產生回應檔,請在指令行中輸入以下指令:
setup.exe -options-template responsefile其中 responsefile 是回應檔的完整路徑和檔案名稱。
解決方案:Message Brokers Toolkit 的組件需要授權,才能註冊。 授權通常會自動註冊,不過,在這個狀況中,您必須手動執行 enroll.exe。 請利用以下指令之一來執行這個動作。 您也必須確定您的系統日期正確。
解決方案:每次完成無聲自動安裝時,請務必檢查安裝日誌 (mqsi5.log) 來找出是否有錯誤,以確保順利完成而沒有發生任何錯誤。
mqsi5.log 是安裝日誌檔。預設位置通常為 C:\Documents 和 Settings\user_login_name。
警告!
如果您要擴充 WebSphere Studio Application Developer Integration Edition 工作台以使用此產品, 您必須安裝 WebSphere Studio Application Developer Integration Edition 5.1 GA 版;不支援舊版本。
如果您沒有安裝支援的 GA 版 WebSphere Studio Application Developer Integration Edition,或不確定您的產品版本, 請聯絡您的 IBM 客戶服務代表以取得進一步資訊。
您同時必須將 WebSphere Studio Application Developer Integration Edition 升級至適當的支援層次; 您必須套用「臨時修正程式 002 - 一般修正程式 2.0.0」及「WebSphere Business Integration Message Broker 5.1.5 版臨時修正程式 001 - 必備修正程式 1.0.0.1」。
當您準備好套用 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 支援下載網站,網址為: http://www.ibm.com/software/awdtools/studiointegration/support/
此處的資訊假設您在安裝 Message Brokers Toolkit 5.1 版前,已經安裝了 WebSphere Studio Application Developer Integration Edition。如果您在 Message Brokers Toolkit 之後才安裝 WebSphere Studio Application Developer Integration Edition,請參閱線上資訊中心以取得指示。您必須使用位於 install_location\_uninst\studio\uninstaller.exe 的「解除安裝精靈」以移除 Message Brokers Toolkit 5.1 版。
警告:在執行「解除安裝精靈」前,您必須停止所有的處理程序。
以下指示說明了如何解除安裝 Message Brokers Toolkit 5.1 版。就像「安裝精靈」一樣,您可以用三種不同的模式來呼叫「解除安裝精靈」:
GUI 介面是「解除安裝精靈」的預設模式,也就是沒有指令行選項。
如果您在解除安裝進度畫面出現之前按一下取消,就會結束「解除安裝精靈」,系統會返回原始狀態。
您也可以從新增/移除程式來啟動 Windows 解除安裝程式。例如,開始 > 設定 > 控制台 > 新增/移除程式。
「主控台」模式是在主控台視窗中的文字型介面。若要啟動主控台模式,請在指令行中輸入以下指令:
path uninstaller -console -is:javaconsole其中 path 指的是解除安裝程式的現行位置,且 uninstaller 是解除安裝程式的名稱。例如:
install_location\_uninst\studio\uninstaller.exe -console -is:javaconsole解除安裝的無聲模式使用「解除安裝精靈」的預設值。 這些設定值會依上述交談模式中的可用選項來解除所有可選功能。
請在指令行中輸入以下指令:
path uninstaller -silent其中 path 指的是解除安裝程式的現行位置,且 uninstaller 是解除安裝程式的名稱。例如:
install_location\_uninst\studio\uninstaller.exe -silent
您可以從網站下載維護更新軟體,它採用「暫時修正程式 (PTF)」的形式,也稱為修正套件。修正套件是累積的,例如,在安裝 Fix Pack 2 前,不需要安裝 Fix Pack 1。 但您必須先安裝 GA 程式碼來啟動版權需求。 您可以在網際網路上找到可用修正程式的最新資訊: http://www.ibm.com/software/integration/mqfamily/support/summary
WebSphere Business Integration Message Brokers Toolkit 的修正套件使用 與 GA 版本相同的技術安裝。這表示產品檔的歷程一致,且已適當更新。
您無法只移除個別修正套件,卻不解除安裝整個產品。 強烈建議您保留及備妥備份的 GA 影像和先前的修正套件,以預防安裝服務後發生問題。 如果您要將系統還原至先前的服務層次,您必須解除安裝整個產品、重新安裝本產品的 GA 層次,再安裝所需要的修正套件層次。
如果現有的安裝架構套用了任何臨時修正程式,請洽詢 IBM 客戶服務代表,以取得指示及您在安裝的修正套件層次可能更新過的臨時修正程式。
附註: 如果您在安裝了 Message Brokers Toolkit 5.1 版後,再安裝
5.0 版執行時期元件的修正套件,請選擇自訂安裝,並清除 Message Brokers Toolkit 元件
的勾選框。
5.0 版修正套件所提供的工具開發修正程式與 5.1 版工具箱不相容;如果您未清除
勾選框,安裝程式會報告錯誤(因為安裝程式無法將 5.0 版修正程式安裝至 5.1 版
元件)。無法成功為所有其他元件安裝修正程式。
(如果您使用主控台或無聲自動安裝,請確定您選取了比較選項。)
您可以從以下網址下載最新修正套件:
http://www.ibm.com/software/integration/mqfamily/support/summary/wbib.html
請在 WebSphere Business Integration Brokers Support 網頁上向下捲動至 Message Brokers Toolkit 5.1 版。
您必須閱讀備忘錄。如果要存取備忘錄,請按一下檢視備忘錄直欄中的詳細資料鏈結。
如果要開始下載程序,請前往下載 PTF/修正套件直欄,然後按一下該鍵結(名稱的格式為 Fix Pack XX Unnnnnn, 其中 XX 是修正套件的號碼,Unnnnnn 是修正套件檔案名稱)。
請遵循 IBM 下載網站的指示,依序執行「配置」、「登錄」和「下載」的三階段程序。 選取適當的目的地作為下載目標。
請確定您用來登入的 ID 是本端安全領域中的 Windows Administrators 群組成員。 建議您使用與用來安裝 WebSphere Business Integration Message Brokers Toolkit 相同的 ID。
請確定所有 WebSphere Business Intergration Event Broker 或 WebSphere Business Integration Message Broker 程序都已停止。 您必須執行以下作業:
其中 FixPackLauncher 指的是修正套件可執行檔的完整路徑,例如 U200208.exe。
-s 是選用的,代表修正套件啟動程式以無聲方式來解壓縮。
如果您略過這一項,就會顯示解壓縮畫面的進度。
-a 表示會讀取後面所接的安裝引數
installation_arguments 是決定安裝程式如何執行的引數。
請參閱安裝指令行選項。
順利解壓縮之後,安裝程式會根據所選引數來自動執行。 請遵循安裝畫面中的指示。 如果需要安裝畫面的詳細說明,請參閱安裝指示。
安裝好之後,請檢視 readme 目錄所提供的多平台備忘錄,再完成任何必要的手動後置安裝作業。
本資訊是針對 IBM 在美國所提供之產品與服務開發出來的。
IBM 不見得有提供本資訊中所提的各項產品、服務或功能。 請洽詢當地的 IBM 業務代表,以取得當地目前提供的產品和服務之相關資訊。這份文件在提及 IBM 的產品、程式或服務時,不表示或暗示只能使用 IBM 的產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,任何非 IBM 的產品、程式或服務,使用者必須自行負責作業的評估和驗證責任。
本資訊所說明的主題內容,IBM 可能擁有其專利或專利申請案。 提供本資訊不代表提供這些專利的授權。您可以書面提出授權查詢,來函請寄到:
如果是有關雙位元組 (DBCS) 資訊的授權查詢,請洽詢所在國的 IBM 智慧財產部門,或書面提出授權查詢,來函請寄到:
以下段落若與該國之法律條抵觸時,即視為不適用:
IBM 公司只依「現況」提供本出版品,不提供任何明示或默示之保證, 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。 有些地區在特定交易上,不允許排除明示或暗示的保證,因此,這項聲明不一定適合您。
這項資訊中可能會有技術上或排版印刷上的訛誤。 因此,IBM 會定期修訂;並將修訂後的內容納入新版的資訊中。IBM 隨時會改進及/或變更本資訊所提及的產品及/或程式,不另行通知。
這份資訊中所提及的任何非 IBM 網站只供參考,IBM 不為這些網站提供保證。 這些網站所提供的素材不是 IBM 本產品的素材內容,如果要使用這些網站的素材,您必須自行承擔風險。
IBM 得以各種適當的方式使用或散布由您提供的任何資訊,無需對您負責。
如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式(包括本程式)之間交換資訊, 以及 (ii) 相互使用所交換的資訊,因而需要相關的資訊,請洽詢:
這些資訊可依適當條款而取得,在某些情況下必須付費方得使用。
IBM 基於雙方之 IBM 國際程式設計授權合約(或任何同等合約)條款, 提供本資訊所提及的授權程式與其所有適用的授權資料。
本書所提及之非 IBM 產品資訊,取自產品的供應商,或其發佈的聲明或其他 公開管道。IBM 並未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、 相容性或任何對產品的其他主張是否完全無誤。有關非 IBM 產品的性能問題應直接洽詢該產品供應商。
這份資訊含有日常商業運作所用的資料和報告範例。 為了要使它們儘可能完整,範例包括個人、公司、品牌和產品的名稱。 所有這些名稱都是虛構的,如有任何類似實際企業所用的名稱及地址之處,純屬巧合。
著作權:
這份資訊含有原始語言的範例應用程式,用以說明各作業平台中的程式設計技術。 您可以基於研發、使用、銷售或散布符合作業平台(撰寫範例程式的作業平台)之應用程式介面的應用程式等目的,以任何形式複製、修改及散布這些範例程式,而不必向 IBM 付費。 此些範例並未在所有情況下完整測試。因此,IBM 不保證或暗示這些程式的可靠性、有用性或功能。 您可以免費為了開發、使用、銷售或散布應用程式,利用任何形式來複製、修改和散布這些程式範例,不過,這些應用程式必須符合 IBM 的應用程式設計介面。
以下詞彙是 IBM 公司在美國及/或其他國家或地區的商標:
IBM、WebSphere
Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。
Microsoft、Windows 是 Microsoft 公司在美國及/或其他國家或地區的商標。
其他公司、產品或服務名稱,可能是第三者的商標或服務標記。