您可以搭配使用安裝在本端環境的 Eclipse 型資訊中心和 WebSphere ESB 文件外掛程式,
以離線使用 WebSphere ESB 資訊(不需存取網際網路)。或者,
您可以透過 Adobe Acrobat Reader 使用 WebSphere ESB PDF 文件。
開始之前
WebSphere ESB 文件外掛程式和 PDF 文件皆可從網路取得。因此,
若要下載這些檔案,您必須暫時能夠存取網際網路。在下載您要的檔案後,
您可以使用文件,而不需維持和網際網路存取間的連線。
執行這項作業的原因和時機
如果您想離線使用
WebSphere ESB 資訊(不需存取網路),
請下載可在本端資訊中心中使用的
WebSphere ESB 文件外掛程式,
或下載可搭配 Adobe Acrobat Reader 本端副本使用的
WebSphere ESB PDF 文件。
這個主題說明如何使用 WebSphere ESB 提供的「IBM Eclipse 說明系統」。或者,您可以在另一個 Eclipse 型資訊中心中使用 WebSphere ESB 文件外掛程式,
以便整合您現有資訊中心中的資訊。
如果您想使用
WebSphere ESB PDF
文件,請參閱WebSphere ESB PDF 文件。
這項作業的步驟
- 安裝「IBM Eclipse 說明系統」。
如需安裝「IBM Eclipse 說明系統」的相關資訊,
請參閱安裝套件在 CD2 的 IEHS 目錄中所提供的 Readme 檔。
若要安裝「IBM Eclipse 說明系統」,
請完成下列的子步驟:
- 將 CD2 插入光碟機中。
- 將安裝套件的內容解壓縮到您的系統中,
並維持其目錄結構。 以 Windows 為例,請使用下列指令,將說明系統解壓縮到
C:\ibm_help 目錄:
unzip IBM-Help-Win32.zip -d C:\
iehs_install\ibm_help 目錄含有「IBM Eclipse 說明系統」和其內嵌的 JRE;
其中 iehs_install 是指解壓縮後之說明系統安裝套件內容的所在目錄。
- 下載產品文件外掛程式。
WebSphere ESB 文件外掛程式會以 Zip 檔提供於網頁 (http://www.ibm.com/software/integration/wsesb/library/infocenter/) 中。
- 將文件 Zip 檔下載至適當位置。 視您的連線速度而定,下載檔案的時間可能超過 20 分鐘。
- 將 Zip 檔內容解壓縮到 iehs_install\ibm_help\eclipse\plugins 目錄,
並維持目錄結構。
在 iehs_install\ibm_help\eclipse\plugins 目錄中,
您應可看到產品文件的一些外掛程式目錄,
包括:- com.ibm.websphere.wesb.doc_6.0.1
- 主要的 WebSphere ESB 文件外掛程式。這個外掛程式應會使得 WebSphere ESB 項目出現在說明系統導覽中。
- com.ibm.websphere.nd.doc_6.0.2
- 建置到 WebSphere ESB 中之 IBM WebSphere Application Server Network Deployment 的文件外掛程式。
- com.ibm.websphere.wscc.doc
- IBM Web Services Client for C++ 的文件外掛程式。
- com.ibm.websphere.xms.doc
- IBM Message Service Client for C/C++ 和 Message Service Client for .NET
如果您沒有看到這些目錄,請檢查 Zip 檔內容是否解壓縮正確。
- 啟動「IBM Eclipse 說明系統」
您可以執行
iehs_install\ibm_help 目錄中的 Script 檔,
來啟動「IBM Eclipse 說明系統」。
隨說明系統提供的 Script 檔會使用內嵌 JRE 來啟動說明系統。如果您不想使用內嵌 JRE,
則必須安裝 JRE 1.4.2 版(或以上),修改啟動和停止 Script,
以使用該 JRE。
您可以在下列兩種模式之一下,啟動「IBM Eclipse 說明系統」:
- 獨立模式
- 當採用獨立模式時,「IBM Eclipse 說明系統」會自動啟動 Web 瀏覽器以顯示說明內容。當在獨立模式下執行時,
只有該系統上的使用者才能取得說明內容。說明內容和功能表會以系統的語言環境來顯示。
- 資訊中心模式
- 當採用資訊中心模式時,「IBM Eclipse 說明系統」會在使用者定義之埠(預設埠號為 8888)上啟動 Web 應用程式,
而凡是和該系統進行網路連線的 Web 瀏覽器皆能取得說明內容。說明網頁和功能表會以使用者之 Web 瀏覽器的語言環境來顯示。
所提供的範例 Script 可在每一種模式下啟動和停止說明系統。在啟動「IBM Eclipse 說明系統」後,
即使在所有作用中的 Web 瀏覽器皆已關閉後,它仍會繼續執行。您必須使用適當的停止 Script,
明確停止「IBM Eclipse 說明系統」。
您可以使用符合您特定需求的選項,
來裁剪 Script 檔。如需可用選項的相關資訊,請參閱說明系統 Readme 檔。
選項 |
敘述 |
獨立模式 |
從 iehs_install\ibm_help,
執行 IC_start.bat 或 IC_start.sh 檔。此時會出現說明系統的指令行視窗。 若要檢視說明內容,
請開啟一個 Web 瀏覽器,並輸入 URL http://servername:port/help;
其中 servername 是「IBM Eclipse 說明系統」安裝所在之系統的主機名稱或 IP 位址。
|
資訊中心模式 |
- 從 iehs_install\ibm_help,
執行 help_start.bat 或 help_start.sh 檔。此時會出現說明系統的指令行視窗。
- 如果作業系統已設定預設瀏覽器,則說明系統會自動開啟一個內含說明內容的 Web 瀏覽器。
|
- 驗證所顯示的產品文件一如預期。
如果您正確擷取文件 Zip 檔,
但說明系統仍沒有以您預期的國家語言顯示,或者沒有顯示正確的說明主題,
可進行下列檢查。例如,新增 osgi.checkConfiguration=true 到
iehs_install\ibm_help\configuration\config.ini
配置檔中。這項設定會讓系統尋找並配置新的國家語言套件。
有關疑難排解「IBM Eclipse 說明系統」問題的詳細說明,
請參閱安裝套件所附的 Readme 檔。
下一步
您可以從 IBM 或協力廠商下載其他的文件外掛程式,
並在同一說明系統中使用它們,以建置更綜合性的資訊中心。