變更歷程:
GA:2004 年 7 月 23 日
(C) Copyright IBM Corporation 2004. All rights reserved.
這個檔案包含了在 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 (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 版。
Migrating
If you are migrating, read Before you start.
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.
您必須在線上檢視這些安裝指示的最新版本。
您可以在以下網址找到最新版本(僅提供英文版):
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
這些指示的翻譯版也會依照進程提供在下列網址中:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/
您可以下載 WebSphere Business Integration Message Broker 和 WebSphere Business Integration
Event Broker 的獨立式資訊中心。從以下網址可以下載 zip 保存檔:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip
請參閱包含在 wbimb_help.zip 檔中的 installing_and_managing.htm 檔。
目錄
有關 Message Brokers Toolkit 5.1 版所支援特定版本作業系統的最新狀態,
請造訪以下 WebSphere MQ Family Supported Software 網頁:
http://www-3.ibm.com/software/integration/wbimessagebroker/requirements/ (WebSphere Business Integration Message Broker) 或
http://www-3.ibm.com/software/integration/wbieventbroker/requirements/ (WebSphere Business Integration Event Broker)
以下環境支援 Message Brokers Toolkit 5.1 版:
Windows 2003 不支援本產品。
You might have to complete some actions before you install Message Brokers Toolkit Version 5.1:
The Version 5.0 installation instructions are also on the main product CD in \installdocs\<locale>\install.html.
After you have installed, refer to the online information center for further information about migration.
在裝載了 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 是您選擇的回應檔的完整路徑和名稱。範本回應檔包含如何輸入特定選項的完整指示。
WARNING
You must make the following correction in the template response file to
indicate whether the toolkit is to link to WSADIE.
於「無聲自動安裝」模式下,如果要整合工具箱與 WSADIE,您必須使用回應檔。請參閱 WebSphere Studio Application Developer Integration Edition 以取得進一步資訊。
安裝引數可讓您以四個不同的模式來執行安裝:GUI 模式、主控台模式、協助工具模式,以及無聲模式。 安裝引數也可讓您記錄和使用回應檔。
GUI 模式也稱為 AWT(抽象視窗化工具箱)模式,是預設安裝模式,不含安裝引數。 請在指令行中,輸入下列指令:
setup.exe [-awt]
其中 awt 是選用的,只有在 GUI 模式不是預設安裝模式時,才是必要的。
通常是在無法使用 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 目錄中,提供了範例回應檔。
You must correct an error in the response file before you use it. For details, see the Warning under Silent mode in the Install instructions.
如果要將安裝期間所記錄的選項提供給無聲安裝,請在指令行中輸入下列指令:
setup.exe -options responsefile -silent
其中 responsefile 是回應檔的完整路徑和檔案名稱。
回應檔範本不包含預先設定的安裝選項,產生之後,您可以加以編輯,供稍後使用。 您不需要執行完整的安裝,就可以產生這個檔案。 如果要這麼做,請在指令行中輸入下列指令:
setup.exe -options-template responsefile
其中 responsefile 是回應檔的完整路徑和檔案名稱。
實務:在啟動或使用「訊息分配管理系統工具箱」時,會出現下列訊息。 「找不到授權合約或授權合約已過期。將會停用不具有效授權合約的功能。」
解決方案:「訊息分配管理系統工具箱」的組件需要授權,才能註冊。 授權通常會自動註冊,不過,在這個狀況中,您必須手動執行 enroll.exe。 請利用下列指令之一來執行這個動作。 您也必須確定您的系統日期正確。
解決方案:您每次完成無聲安裝時,都必須檢查安裝日誌 (mqsi5.log) 來找出錯誤,以確定已順利完成,沒有發生任何錯誤。
mqsi5.log 是安裝日誌檔。預設位置通常為 C:\Documents 和 Settings\user_login_name。
WARNING!
You can integrate Message Brokers Toolkit Version 5.1 only with the supported GA
of WSADIE Version 5.1.
If you do not have the supported GA version of WSADIE installed, or you are unsure which version you have, contact your IBM Service representative for further information.
When you are ready to apply WSADIE fixes, you must complete these tasks in the order shown below.
若要擴充 WebSphere Studio Application Developer Integration Edition (WSADIE) 工作台以使用此產品,您必須將 WSADIE 升級至適當的支援層次。 可以擴充的 WSADIE 工作台版本為 WSADIE 5.1 版 GA(並套用「臨時修正程式 002 - 一般修正程式 2.0.0」)。 您必須也套用修正程式「WebSphere Business Integration Message Broker v5.1.0 臨時修正程式 001 - 必備修正程式 1.0.0.1」。
在安裝 WebSphere Business Integration Message Broker 或 WebSphere Business Integration Event Broker 後,您必須套用這些修正程式,然後選取安裝選項以啟用至 WSADIE(請參閱安裝指引)的鏈結。
若要取得詳細資訊,請參閱 WSADIE 支援下載網站,網址為: http://www.ibm.com/software/awdtools/studiointegration/support/
此處的資訊假設您在安裝 Message Brokers Toolkit 5.1 版前,已經安裝了 WSADIE。如果您在 Message Brokers Toolkit 之後才安裝 WSADIE,請參閱線上資訊中心以取得指示。您必須使用位於 install_location\_uninst\studio\uninstaller.exe 的「解除安裝精靈」以移除 Message Brokers Toolkit 5.1 版。
警告:在執行「解除安裝精靈」前,您必須停止所有的處理程序。
以下指示說明了如何解除安裝 Message Brokers Toolkit 5.1 版。如同「安裝精靈」一樣,您也可以用三種不同的模式來執行「解除安裝精靈」:
GUI 介面是「解除安裝精靈」的預設模式,也就是沒有指令行選項。
如果您在解除安裝進度畫面出現之前按一下取消,就會結束「解除安裝精靈」,系統會返回原始狀態。
您也可以從新增/移除程式來啟動 Windows 解除安裝程式。例如,開始 > 設定 > 控制台 > 新增/移除程式。
選取 IBM Message Brokers Toolkit for WebSphere Studio 5.1 版。
按一下變更/移除。
選取用來執行「解除安裝精靈」的語言。按一下確定。
「主控台」模式是在主控台視窗中的文字型介面。您可以從指令行中輸入下列指令來啟動主控台模式:
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 程序都已停止。 您必須執行下列作業:
切換至您下載修正套件檔案 (Unnnnnn.exe) 的目錄。請在 Windows 檔案總管中,用滑鼠右鍵按一下檔案名稱,再選取開啟。 另外,您也可以在命令提示模式中,輸入下列指令:
FixPackLauncher [-s] -a install_arguments
其中 FixPackLauncher 指的是修正套件可執行檔的完整路徑,例如 U200208.exe。
-s 是選用的,表示修正套件啟動程式以無聲方式來解壓縮。
如果您略過這一項,就會顯示解壓縮畫面的進度。
-a 表示「讀取下列安裝引數」
install_arguments 是決定安裝程式如何執行的引數。
請參閱安裝指令行選項。
本資訊是針對 IBM 在美國所提供之產品與服務開發出來的。
IBM 不見得有提供本資訊中所提的各項產品、服務或功能。請洽詢當地的 IBM 業務代表,以取得當地目前提供的產品和服務之相關資訊。 這份文件在提及 IBM 的產品、程式或服務時,不表示或暗示只能使用 IBM 的產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,任何非 IBM 的產品、程式或服務,使用者必須自行負責作業的評估和驗證責任。
此資訊所說明的主題內容,IBM 可能擁有其專利或專利申請案。提供此資訊不代表提供這些專利的授權。您可以書面提出授權查詢,來函請寄到:
如果是有關雙位元組 (DBCS) 資訊的授權查詢,請洽詢所在國的 IBM 智慧財產部門,或書面提出授權查詢,來函請寄到:
下列段落若與該國之法律條抵觸時,即視為不適用:
International Business Machines Corporation 只依「現況」提供本出版品,不提供任何明示或默示之保證, 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。有些地區在特定交易上,不允許排除明示或暗示的保證,因此,這項聲明不一定適合您。
這項資訊中可能會有技術上或排版印刷上的訛誤。 因此,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 公司在美國及/或其他國家或地區的商標。
其他公司、產品或服務名稱,可能是第三者的商標或服務標記。