- 至少需要 1.5 GB 的磁碟空間來安裝 WebSphere Application Server - Express，開發資源另需額外磁碟空間。
- 如果您下載電子映像檔來安裝 WebSphere Application Server - Express，您還需要額外 1.5 GB。
-
至少需要 800 x 600 顯示畫面（建議使用 1024 x 768）
-
至少需要 1024 x 768 顯示畫面
第 1 章 IBM WebSphere Application Server - Express 的安裝需求
第 2 章 在 Windows 中安裝 WebSphere Application Server - Express
第 3 章 在 Linux 中安裝 WebSphere Application Server - Express
第 4 章 在 AIX 中安裝 WebSphere Application Server - Express
第 5 章 在 Solaris 中安裝 WebSphere Application Server - Express
第 6 章 在 HP-UX 中安裝 WebSphere Application Server - Express
第 9 章 設定 WebSphere Application Server - Express 在團隊環境中工作
這份安裝手冊第 6 版（2003 年 11 月）含有 WebSphere Application Server - Express 5.1 版的下列資訊：
請參考產品支援網站 (www.ibm.com/software/webservers/appserv/express/support.html) 來取得下列修正程式和支援資訊：
比方說，從 5.0 或 5.0.1 或 5.0.2 升級至 5.1。
請注意 WebSphere Application Server - Express 5.1 版的下列相關事項：
這份手冊有 HTML 和 Acrobat PDF 版，在安裝 CD 的根目錄和產品安裝目錄中。 這兩個版本包含相同的資訊。 您可以在任何 Web 瀏覽器中開啟 install.html。 如果要開啟 install.pdf，您必須已安裝 Acrobat Reader 軟體，您可以從 www.adobe.com/products/acrobat/readstep2.html 下載這個軟體。
您必須先安裝下列硬體，才能安裝 WebSphere Application Server - Express：
至少需要 800 x 600 顯示畫面（建議使用 1024 x 768）
至少需要 1024 x 768 顯示畫面
通訊配接器支援
TCP/IP 和配接器的支援。
您必須先安裝下列軟體，才能安裝 WebSphere Application Server - Express：
下列作業系統的其中一個：
Windows(R) 2000 Server 或 Advanced Server，含 Service Pack 4 或更新的版本，只適用於遠端伺服器元件
只適用於 Windows(R) 2003 Server 標準版遠端伺服器元件
Windows(R) 2000 Professional（含 Service Pack 4 或更新的版本），用於 WebSphere Studio 工具和伺服器元件
Windows XP SP1a Professional，用於 WebSphere Studio 工具和伺服器元件
Red Hat 7.2 版，用於 WebSphere Studio 工具元件（只包括單元測試環境）
Red Hat 8.0 版，用於 WebSphere Studio 工具元件（只包括單元測試環境）
Red Hat AS（或 EL）2.1 版，只適用於遠端伺服器元件
SuSE 7.2 版 WebSphere Studio 工具元件（只包括單元測試環境）
SuSE 8.1 版 Studio 工具元件（只包括單元測試環境）
只有 United Linux 1.0 版 ( Suse SLES 8) 遠端伺服器元件
只有 AIX 5.2（5200-01 維護層次）遠端伺服器元件，含從任何支援的 Studio 工具平台進行的遠端部署
只有 Solaris 9（含 2003 年 4 月的建議修補程式叢集）遠端伺服器元件
只有 HP 11iv1（修正層次 2002 年 12 月）遠端伺服器元件
表 1. Red Hat 和 SuSE 作業系統所支援的國家語言。
|
| 只有英文 | 英文加上國家語言 | 單位元組字集 (SBCS) | 雙位元組字集 (DBCS)（請參閱附註 1） |
|---|---|---|---|---|
| Red Hat 7.2 | 是 |
|
|
|
| Red Hat 8.0 |
| 是 | 是 | 是 (1) |
| SuSE 7.2 | 是 |
|
|
|
| SuSE 8.1 |
| 是 | 是 |
|
(1) 如果您要在 Red Hat 8.0 中使用雙位元組字集，您必須將 GTK 2.0 升級至 GTK 2.2 或更新的版本。 請參閱（選用）升級至 GTK 2.2.2 或更新的版本。
警告：
如果您已安裝 WebSphere Application Server - Express ，且安裝了任何協力廠商外掛程式，您必須取得 5.1.1 版的對應外掛程式，再重新安裝它們。
這個套裝軟體有兩組 CD：
安裝使用實務
重要事項：您只能在專供示範、測試和開發應用程式的機器中使用 DB2 Universal Database Express Edition。 您不能在正式作業伺服器中安裝其中任何一個程式。 請參閱含括的授權，以取得詳細資料。
這一節包含在 Windows 中安裝 WebSphere Application Server - Express 的相關資訊。 WebSphere Application Server - Express 的主要元件是應用程式伺服器、Remote Agent Controller 和 WebSphere Studio Site Developer (WSSD)。 您可以選擇安裝這些元件全部或其中任何一個。 如果您要能夠利用 WSSD 來管理應用程式伺服器，您必須同時安裝 Remote Agent Controller 和應用程式伺服器。 您可以從 CD-ROM 或下載的電子映像檔來安裝 WebSphere Application Server - Express。
安裝注意事項：
安裝程式可以在交談式主控台模式下執行，而不需使用 GUI 精靈畫面。主控台模式可能較適合有協助工具需求的人員。"-accessibility" 模式提供了其他聽得見的資訊，供視覺障礙的一般使用者使用。如果要在主控台模式下，從 WebSphere Application Server - Express 安裝 CD 的安裝目錄執行這個指令，請執行下列動作：
請遵循提示來完成安裝。附註："-is:javaconsole" 選項是選用的。 如果您未指定這個選項， 安裝程式會當掉。"-log @NONE" 會關閉記載功能，以消除出現在主控台上的日誌資訊。如果您在安裝期間遇到任何問題， 您可能要拿掉這個選項，以收集日誌資訊。
重要事項：請勿將這個版本安裝在舊版上。 您可以安裝在不同的目錄中，以便共存，也可以先解除安裝舊版本，再安裝到相同目錄中。 如果安裝程式偵測到舊版的應用程式伺服器，它會提供將伺服器配置移轉至 5.1 伺服器的選項。 請參閱移轉手冊，以取得詳細資料。
重要事項：如果您試圖從 5.1.1 版 Studio Site Developer IDE 開啟 4.0.x 版工作區，工作區會轉換成 5.1.1 版工作區。 專案名稱、專案程式檔以及專案 Java 建置路徑（類別路徑）會保留下來。 不過，使用者介面設定、除錯設定和大部分喜好設定都會遺失。 請參閱移轉手冊，以取得將現有專案安全移轉至 5.1.1 版的指示。
為了預防，建議您在移轉至 5.1.1 版之前，先建立 5.x 版工作區的備份。
安裝產品之前，請先檢查下列事項：
如果要從第一片產品安裝 CD 安裝 WebSphere Application Server - Express，請遵循下列步驟：
要訣：
重要事項：請勿安裝在名稱含有雙位元組字元或錢幣符號之類特殊字元的目錄中。 如此做可能會造成不合需求的結果，例如，在 WebSphere 測試環境中的類別路徑問題。
WebSphere Application Server - Express 有多個可下載的部分。 每個部分都是自行解壓縮的保存檔，所有部分都是必要的。
安裝產品之前，請先檢查下列事項：
如果要安裝 WebSphere Application Server - Express 的電子映像檔，請遵循下列步驟：
安裝 WebSphere Application Server - Express 之後，您在安裝期間所選取的 <Expressinstallpath> 下應該會有下列目錄結構：
如果這些目錄中任何一個目錄實際包含的檔案數目不同，您應該懷疑安裝期間發生問題。 請查看 <Expressinstallpath>\logs 目錄中的 expressInstallLog.txt 檔來診斷問題。
如果安裝順利完成，請利用開始 > 程式集 > IBM WebSphere Application Server - Express 5.1 > Studio Site Developer 功能表項目來啟動 Site Developer。在啟動 Site Developer 之後，請遵循「歡迎使用」頁面中的鏈結來載入和執行 Express 範例。
IBM Agent Controller 一律會安裝成 Windows 服務，且會自動啟動。IBM Agent Controller 提供 Site Developer 和應用程式伺服器之間的通訊通道。 請選取「控制台 > 管理工具 > 服務」來查看有沒有列出 IBM Agent Controller 以及有沒有在執行中。 如果您懷疑有問題，請查看 <Expressinstallpath>\RAC\config 目錄中的 servicelog.log 檔。
如果未順利完成安裝作業，請查看 <Expressinstallpath>\logs 目錄中的 racInstallLog.txt。 如果 racInstallLog.txt 檔不存在，可能表示系統中已有另一 IBM Agent Controller 版本存在。 請解除安裝其他版本，再重試安裝作業。
您可以從「首要步驟」應用程式執行「驗證伺服器安裝」來驗證應用程式伺服器安裝架構的基本作業。 「首要步驟」是在安裝結束時啟動的，您也可以從「開始 > 程式集 > IBM WebSphere Application Server - Express 5.1 > 首要步驟」啟動它。
另外，您也可以執行 <Expressinstallpath>\Express\bin\testServer.bat 檔來驗證應用程式伺服器的作業。 這個批次檔會利用預設配置來逐步啟動和停止應用程式伺服器。請注意，這個批次檔只供測試伺服器安裝架構之用。
執行 setupwin32.exe 會啟動 Java 安裝程式，再將控制權還給命令提示模式。 實際上，安裝程序會繼續在背景中執行。 以下是驗證無聲自動安裝已順利完成的若干簡單方式：
執行安裝程式的另一個替代方法是發出指令來直接執行 Java 安裝程式。 安裝程式必須收到若干指令行參數，才能正確運作。 在第一片 CD 的 util 目錄中，有一個稱為 syncInstall.bat 的範例批次檔，可用來同步執行安裝程序，也就是說，在安裝順利完成之前，控制權不會還給命令提示模式。 您可以將 setupwin32.exe 的相同參數傳給 syncInstall.bat 指令。 對無聲自動安裝實務而言，這個批次指令尤其有用。
如果您要將產品和您自己的程式連結起來，您可以無聲執行 WebSphere Application Server - Express 安裝程式。 如果要無聲自動安裝 WebSphere Application Server - Express，請使用 -silent 指令行選項。 於無聲自動安裝期間，您將不會在呼叫安裝指令之後，看到精靈畫面。
如果要用所有預設值來執行無聲自動安裝，請使用類似下列中的指令：
setupwin32.exe -silent
如果您要變更預設 Express 安裝位置 (IBM/WebSphere/Express)，請利用：
setupwin32.exe -silent -P waseBean.installLocation=c:\<yourdirectory>
您也可以利用回應檔來設定無聲自動安裝的其他選項。 請參閱安裝 CD 中的範例回應檔來取得範本。 如果要利用回應檔來執行無聲自動安裝，請利用如下指令：
setupwin32.exe -silent -options <fully qualified path>\responsefile
附註：當您選取 WebSphere Studio Site Developer 特性時，WebSphere Application Server - Express 不支援從 CD 無聲自動安裝。 原因是這項特性需要第二片 CD，當無聲執行時，安裝程式不會提示您插入第二片 CD。 如果要無聲自動安裝 WebSphere Studio Site Developer 特性，您可以將第二片 CD 複製至硬碟中，或將 CD 裝載在第二部光碟機中，再利用 '-media 2=<path to second CD>' 選項告訴安裝程式要去哪裡找第二片 CD 的映像檔。
Express 檢附了一個範例回應檔：\util\responsefile.txt。 您可以利用這個檔案來作為模型回應檔。
如果要解除安裝 WebSphere Application Server - Express，請執行下列動作：
如果要完全移除 WebSphere Application Server - Express，請手動刪除其餘目錄。
當執行 WebSphere Application Server - Express 的解除安裝時，所顯示的特性畫面會出現安裝期間所沒有顯示的若干其他特性。 這些其他特性會顯示為 Studio Site Developer 特性的子特性。 如果您要選取或取消選取 Studio Site Developer 特性，請確定您已選取或取消選取所有子特性。
IBM Agent Controller 提供 Studio Site Developer 和 Application Server 之間的通訊機制。Agent Controller 安裝成一項 Windows 服務，配置成利用本端系統帳戶來執行。 如果您想要的話，您可以利用 Windows 服務管理程式畫面來改變這個配置，使 IBM Agent Controller 利用另一個使用者帳戶來執行。 由於 Agent Controller 用來啟動 Application Server，因此，用來執行 Agent Controller 的帳戶也是用來執行 Application Server 的帳戶。
在 Studio Site Developer 和 Agent Controller 之間的鏈結有若干安全維護選項。 安裝程序會配置鏈結，讓任何 Studio Site Developer 使用者都能夠連接 Agent Controller。 當在正式作業伺服器環境中使用 Agent Controller 時，您會想變更這個安全預設值。
您可以利用 <Expressinstallpath>\RAC\bin\RACSecurityOn.bat 和 RACSecurityOff.bat 檔來啟用和停用基本登入安全。 當啟用安全時，Studio Site Developer 使用者必須提供有效的使用者名稱和密碼組合，也就是在連接至 Agent Controller 時的作業系統使用者名稱和密碼。Agent Controller 會將使用者名稱和密碼轉遞給作業系統進行鑑別。 在 Windows 中，不會鑑別領域名稱密碼。您必須提供本端使用者名稱和密碼配對。
如果要執行 IBM Agent Controller 的 SetConfig 公用程式，Java 必須在執行路徑中。
如果您將 WebSphere Application Server - Express 5.1 安裝在已有一份 WebSphere Application Server - Express 5.0 的機器中，IBM Agent Controller 會更新為 5.1.1 版，且會配置成指向 5.1 Express 伺服器。如果您後來又要移除 WebSphere Application Server - Express 5.1 並還原 5.0 環境，您必須重新安裝 5.0 Application Server 或 Studio Site Developer 元件，才能還原 5.0 版的 IBM Agent Controller。 這兩項 5.0 特性也都會安裝 5.0 的 IBM Agent Controller。
本節說明在 Windows 中安裝和解除安裝 WebSphere Application Server - Express 時，已知的問題和限制。請參閱 Readme 檔，以取得會影響產品之實際用法的問題和限制的相關資訊。
如果您對映至網路磁碟機，但沒有指定裝置名稱（如 \\computername\sharename），當您試圖安裝 WebSphere Application Server - Express 時，可能會出現下列訊息： 發生下列錯誤，精靈無法繼續作業：無法載入 /wizard.inf (104) 中指定的精靈。 暫行解決方法是指定裝置名稱（如 x:\sharename），在本端環境中對映至網路磁碟機。
不要安裝至 Novell NetWare 磁碟機。 在 Novell NetWare 磁碟機中，安裝會失敗。
在開始 WebSphere Application Server - Express 的安裝作業之前，您應該以管理者的身分登入。
安裝失敗有時會造成 _uninst 目錄中的解除安裝檔案不完整。 這種問題的症狀是，當您執行解除安裝時，會出現找不到適當 JVM 的訊息。 您應該依照下列方式來手動執行解除安裝：
如果安裝作業失敗，您必須移除所有已安裝的 WebSphere Application Server - Express 檔案。如果您打算安裝 WebSphere Application Server - Express 的目錄是空的，就表示安裝程序已移除所有已安裝的檔案，您可以依需要刪除這個空目錄。
如果安裝失敗，請執行下列步驟：
這一節含有在 Linux 中安裝 WebSphere Application Server - Express 的相關資訊。 WebSphere Application Server - Express 的主要元件是應用程式伺服器、Remote Agent Controller 和 WebSphere Studio Site Developer (WSSD)。 您可以選擇安裝這些元件全部或其中任何一個。 如果您要能夠利用 WSSD 來管理應用程式伺服器，您必須同時安裝 Remote Agent Controller 和應用程式伺服器。
您可以從 CD-ROM 或下載的電子映像檔來安裝 WebSphere Application Server - Express。
安裝注意事項：
安裝程式可以在交談式主控台模式下執行，而不需使用 GUI 精靈畫面。主控台模式可能較適合有協助工具需求的人員。"-accessibility" 模式提供了其他聽得見的資訊，供視覺障礙的一般使用者使用。如果要在主控台模式下，從 WebSphere Application Server - Express 安裝 CD 的安裝目錄執行這個指令，請執行下列動作：
請遵循提示來完成安裝。附註："-is:javaconsole" 選項是選用的。 如果您未指定這個選項， 安裝程式會當掉。"-log @NONE" 會關閉記載功能，以消除出現在主控台上的日誌資訊。如果您在安裝期間遇到任何問題， 您可能要拿掉這個選項，以收集日誌資訊。
請勿將這個版本安裝在舊版上。 您可以安裝在不同的目錄中，以便共存，也可以先解除安裝舊版本，再安裝到相同目錄中。 如果安裝程式偵測到舊版的應用程式伺服器，它會提供將伺服器配置移轉至 5.1 伺服器的選項。 請參閱移轉手冊，以取得詳細資料。
如果需要將現有專案從舊版 Studio Site Developer 安全移轉至 5.1.1 版的指示，請參閱移轉手冊。
為了預防，建議您在移轉至 5.1.1 版之前，先建立 4.0.x 版和 5.0 版工作區的備份。
如果要從產品 CD 安裝 WebSphere Application Server - Express，請遵循下列步驟：
從指令視窗執行 'setupLinux'： 如果指令視窗的現行工作目錄是 /mnt/cdrom，且您是從 CD 安裝，當安裝程序要求您提供第二片安裝 CD 時，您會無法從光碟機中退出第一片 CD。 這是因為指令視窗工作目錄指向 CD，因此，光碟機會顯示為在使用中。 如果要避免這個情況，請確定您沒有將指令視窗的工作目錄設為 /mnt/cdrom。 也就是說，不要用 ./setupLinux 指令來啟動安裝程序，而要用指向 CD 的完整路徑： /mnt/cdrom/setupLinux。
從指令視窗執行 '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary'：
可能會出現「找不到 mqver」和「找不到 wempsservice」的錯誤報告。您可以忽略這些錯誤訊息。
在 Linux 中執行 Cloudscape
如果要在 Linux 中使用 Cloudscape，請使用 /opt/IBM/WebSphere/Express51/Express/bin 目錄中的 Shell Script EXPcview.sh。
安裝產品之前，請先檢查下列事項：
WebSphere Application Server - Express 的 Linux CD 映像檔分割成若干部分，以縮減下載大小。 每個部分都是一個磁帶保存檔 (tar)，所有部分都是必要的。
如果要安裝 WebSphere Application Server - Express 的電子映像檔，請遵循下列步驟：
安裝 WebSphere Application Server - Express 之後，在 /opt/IBM/WebSphere/Express51 目錄下應該會有下列目錄結構：
如果這些目錄中任何一個目錄實際包含的檔案數目不同，您應該懷疑安裝期間發生問題。 請查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 檔來診斷問題。
首先查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 檔。移至檔案底端並檢查安裝完成狀態。 如果安裝順利完成，請執行 wasexpress51 或 /opt/IBM/WebSphere/Express51/SiteDeveloper/wasexpress51 來啟動 Site Developer。Site Developer 啟動之後，請遵循「歡迎使用」頁面中的鏈結來載入和執行 Express 範例之一。
如果未順利完成安裝，請仔細查看 expressInstallLog.txt 檔來判斷原因。
如果安裝已順利完成，請執行 /opt/IBMRAC/bin/RAStart.sh 來啟動 IBM Agent Controller。 如果您懷疑有問題，請查看 /opt/IBMRAC/config/servicelog.log 檔。
如果未順利完成安裝，請仔細查看 racInstallLog.txt 來判斷原因。
您可以從「首要步驟」應用程式執行「驗證伺服器安裝」來驗證應用程式伺服器安裝架構的基本作業。 「首要步驟」是在安裝結束時啟動的，您也可以從「開始」功能表啟動它。
另外，您也可以執行 /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh Script 來驗證應用程式伺服器的作業。 這個 Script 會利用預設配置來逐步啟動和停止應用程式伺服器。請注意，這個 Script 只供測試伺服器安裝架構之用。
如果您要將產品和您自己的程式連結起來，您可以無聲執行 WebSphere Application Server - Express 安裝程式。 如果要無聲自動安裝 WebSphere Application Server - Express，請使用 -silent 指令行選項。 於無聲自動安裝期間，您將不會在呼叫安裝指令之後，看到精靈畫面。
如果要用所有預設值來執行無聲自動安裝，請使用類似下列中的指令：
./setupLinux -silent
您也可以利用回應檔來設定無聲自動安裝的其他選項。 請參閱安裝 CD 中的範例回應檔來取得範本。 如果要利用回應檔來執行無聲自動安裝，請利用如下指令：
./setupLinux -silent -options <fully qualified path>/responsefile
附註：當您選取 WebSphere Studio Site Developer 特性時，WebSphere Application Server - Express 不支援從 CD 無聲自動安裝。 原因是這項特性需要第二片 CD，當無聲執行時，安裝程式不會提示您插入第二片 CD。 如果要無聲自動安裝 WebSphere Studio Site Developer 特性，您可以將第二片 CD 複製至硬碟中，或將 CD 裝載在第二部光碟機中，再利用 "-media 2=<path to second CD>" 選項告訴安裝程式要去哪裡找第二片 CD 的映像檔。
Express 檢附了一個範例回應檔：/util/responsefile.txt。 您可以利用這個檔案來作為模型回應檔。
IBM Agent Controller 提供 Studio Site Developer 和 Application Server 之間的通訊機制。
在 Studio Site Developer 和 Agent Controller 之間的鏈結有若干安全維護選項。 安裝程序會配置鏈結，讓任何 Studio Site Developer 使用者都能夠連接 Agent Controller。 當在正式作業伺服器環境中使用 Agent Controller 時，您會想變更這個安全預設值。
您可以利用 /opt/IBMRAC/bin/RACSecurityOn.sh and RACSecurityOff.sh 和 RACSecurityOff.sh Script 來啟用和停用基本登入安全。 當啟用安全時，Studio Site Developer 使用者必須提供有效的使用者名稱和密碼組合，也就是在連接至 Agent Controller 時的作業系統使用者名稱和密碼。Agent Controller 會將使用者名稱和密碼轉遞給作業系統進行鑑別。
如果您將 WebSphere Application Server - Express 5.1 安裝在已有一份 WebSphere Application Server - Express 5.0 的機器中，IBM Agent Controller 會更新為 5.1.1 版，且會配置成指向 5.1 Express 伺服器。如果您後來又要移除 WebSphere Application Server - Express 5.1 並還原 5.0 環境，您必須重新安裝 5.0 Application Server 或 Studio Site Developer 元件，才能還原 5.0 版的 IBM Agent Controller。 這兩項 5.0 特性也都會安裝 5.0 的 IBM Agent Controller。
警告：
如果您要在 Red Hat 8.0 中使用雙位元組字集 (DBCS)，您必須執行下列步驟，將 GTK 升級至 2.2.2 或更新的版本。 以下是 GTK 2.2.2 的指示。
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
rpm -q libtiff-devel
如果還沒有安裝，請從 Red Hat 安裝 CD 中安裝它。
/usr/local/lib
./configure make make install /sbin/ldconfig
依預設，會使用 GTK 2.0.6 安裝。 如果要確定應用程式是使用 GTK 2.2.2，您每次都必須在啟動應用程式之前，從指令行中執行下列範例指令。
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export PATH=/usr/local/bin/:$PATH /opt/IBM/WebSphereExpress/SiteDeveloper/wasexpress51
如果需要使用 GTK 的詳細資訊，請造訪下列網站： developer.gnome.org/doc/API/2.2/gtk/gtk-building.html。
如果要在 Linux 中解除安裝 WebSphere Application Server - Express，請遵循下列步驟：
./uninstaller
如果要完全移除 WebSphere Application Server - Express，請手動刪除其餘目錄。
本節涵蓋安裝和解除安裝 WebSphere Application Server - Express for Linux 時，已知的問題和限制。請參閱 Readme 檔，以取得會影響產品之實際用法的問題和限制的相關資訊。
如果安裝失敗，請執行下列動作：
安裝失敗有時會造成 _uninst 目錄中的解除安裝檔案不完整。 這種問題的症狀是，當您執行解除安裝時，會出現找不到適當 JVM 的訊息。 您應該依照下列方式來手動執行解除安裝：
這一節含有在 AIX 中安裝 WebSphere Application Server - Express 的相關資訊。 可安裝在 AIX 中的 WebSphere Application Server - Express 主要元件有應用程式伺服器和 Remote Agent Controller。 您可以選擇安裝這兩個元件或其中任何一個。 如果您要能夠利用 Windows 或 Linux 中的 Studio Site Developer 來管理 AIX 中的應用程式伺服器，您必須同時安裝 Remote Agent Controller 和應用程式伺服器。您也可以利用瀏覽器型管理主控台來管理應用程式伺服器。
您可以從 CD-ROM 或下載的電子映像檔來安裝 WebSphere Application Server - Express。
如果您的系統有舊版的 WebSphere Application Server - Express，在繼續進行之前，您應該先將它解除安裝。
用來安裝的產品 CD 只有一片。如果要從產品 CD 安裝 WebSphere Application Server - Express，請遵循下列步驟：
安裝產品之前，請先檢查下列事項：
WebSphere Application Server - Express 的 AIX CD 映像檔分割成若干部分，以縮減下載大小。
每個部分都是一個磁帶保存檔 (tar)，所有部分都是必要的。 如果要安裝 WebSphere Application Server - Express 的電子映像檔，請遵循下列步驟：
安裝 WebSphere Application Server - Express 之後，在 /opt/IBM/WebSphere/Express51 目錄下應該會有下列目錄結構：
如果這些目錄中任何一個目錄實際包含的檔案數目不同，您應該懷疑安裝期間發生問題。 請查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 檔。
首先查看 /opt/IBM/WebSphere/Express51/logs/expressracInstallLog.txt 檔。 移至檔案底端並檢查安裝完成狀態。 如果安裝已順利完成，請執行 /opt/IBMRAC/bin/RAStart.sh 來啟動 IBM Agent Controller。 如果您懷疑有問題，請查看 /opt/IBMRAC/config/servicelog.log 檔。
如果未順利完成安裝，請仔細查看 racInstallLog.txt 來判斷原因。
您可以從「首要步驟」應用程式執行「驗證伺服器安裝」來驗證應用程式伺服器安裝架構的基本作業。 「首要步驟」是在安裝結束時啟動的，您也可以執行 /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh Script 來啟動它。
另外，您也可以執行 /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh Script 來驗證應用程式伺服器的作業。 這個 Script 會利用預設配置來逐步啟動和停止應用程式伺服器。請注意，這個 Script 只供測試伺服器安裝架構之用。
如果您要將產品和您自己的程式連結起來，您可以無聲執行 WebSphere Application Server Express 安裝程式。 如果要無聲自動安裝 WebSphere Application Serve - Express，請使用 -silent 指令行選項。 於無聲自動安裝期間，您將不會在呼叫安裝指令之後，看到精靈畫面。
如果要用所有預設值來執行無聲自動安裝，請使用如下指令：
./aix/setupAIX -silent
您也可以利用回應檔來設定無聲自動安裝的其他選項。 請參閱安裝 CD 中的範例回應檔來取得範本。 如果要利用回應檔來執行無聲自動安裝，請使用如下指令：
./aix/setupAIX -silent -options <fully qualified path>/responsefile
Express 檢附了一個範例回應檔：/util/responsefile.text。 您可以利用這個檔案來作為模型回應檔。
IBM Agent Controller 提供 Studio Site Developer 和 Application Server 之間的通訊機制。
在 Studio Site Developer 和 Agent Controller 之間的鏈結有若干安全維護選項。 安裝程序會配置鏈結，讓任何 Studio Site Developer 使用者都能夠連接 Agent Controller。 當在正式作業伺服器環境中使用 Agent Controller 時，您會想變更這個安全預設值。
您可以利用 /opt/IBMRAC/bin/RACSecurityOn.sh and RACSecurityOff.sh 和 RACSecurityOff.sh Script 來啟用和停用基本登入安全。 當啟用安全時，Studio Site Developer 使用者必須提供有效的使用者名稱和密碼組合，也就是在連接至 Agent Controller 時的作業系統使用者名稱和密碼。Agent Controller 會將使用者名稱和密碼轉遞給作業系統進行鑑別。
如果要在 AIX 中解除安裝 WebSphere Application Server - Express，請遵循下列步驟：
./uninstaller
這一節討論 WebSphere Application Server - Express for AIX 在安裝和解除安裝方面的已知問題和限制。 請參閱 Readme 檔，以取得會影響產品之實際用法的問題和限制的相關資訊。
如果安裝失敗，請執行下列動作：
安裝失敗有時會造成 _uninst 目錄中的解除安裝檔案不完整。 這種問題的症狀是，當您執行解除安裝時，會出現找不到適當 JVM 的訊息。 您應該依照下列方式來手動執行解除安裝：
如果您的系統有舊版的 WebSphere Application Server - Express，在繼續進行之前，您應該先將它解除安裝。
如果要從產品 CD 安裝 WebSphere Application Server - Express，請遵循下列步驟：
安裝注意事項：
如果您從指令視窗執行下列指令： '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary'，可能會出現「找不到 mqver」和「找不到 wempsservice」的錯誤報告。 您可以忽略這些錯誤訊息。
安裝產品之前，請先檢查下列事項：
WebSphere Application Server - Express 的 Solaris CD 映像檔分割成若干部分，以縮減下載大小。 每個部分都是一個磁帶保存檔 (tar)，所有部分都是必要的。
如果要安裝 WebSphere Application Server - Express 的電子映像檔，請遵循下列步驟：
安裝 WebSphere Application Server - Express 之後，在 /opt/IBM/WebSphere/Express51 目錄下應該會有下列目錄結構：
如果這些目錄中任何一個目錄實際包含的檔案數目不同，您應該懷疑安裝期間發生問題。 請查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 檔。
如果您要將產品和您自己的程式連結起來，您可以無聲執行 WebSphere Application Server - Express 安裝程式。 如果要無聲自動安裝 WebSphere Application Server - Express，請使用 -silent 指令行選項。 於無聲自動安裝期間，您將不會在呼叫安裝指令之後，看到精靈畫面。
如果要用所有預設值來執行無聲自動安裝，請使用類似下列中的指令：
./solaris/setupSolaris -silent
您也可以利用回應檔來設定無聲自動安裝的其他選項。 請參閱安裝 CD 中的範例回應檔來取得範本。 如果要利用回應檔來執行無聲自動安裝，請利用如下指令：
./solaris/setupSolaris -silent -options <fully qualified path>/responsefile
如果要在 Solaris 中解除安裝 WebSphere Application Server - Express，請遵循下列步驟：
./uninstaller
這一節討論 WebSphere Application Server - Express for Solaris 在安裝和解除安裝方面的已知問題和限制。 請參閱 Readme 檔，以取得會影響產品之實際用法的問題和限制的相關資訊。
如果安裝失敗，請執行下列動作：
安裝失敗有時會造成 _uninst 目錄中的解除安裝檔案不完整。 這種問題的症狀是，當您執行解除安裝時，會出現找不到適當 JVM 的訊息。 您應該依照下列方式來手動執行解除安裝：
這一節含有在 HP-UX 中安裝 WebSphere Application Server - Express 的相關資訊。 在 HP-UX 中，只能安裝 WebSphere Application Server - Express 的應用程式伺服器元件。 請利用瀏覽器型管理主控台來管理 HP-UX 中的應用程式伺服器。
您可以從 CD-ROM 或下載的電子映像檔來安裝 WebSphere Application Server - Express。
如果您的系統有舊版的 WebSphere Application Server - Express，在繼續進行之前，您應該先將它解除安裝。
如果要從產品 CD 安裝 WebSphere Application Server - Express，請遵循下列步驟：
安裝注意事項：
如果您從指令視窗執行下列指令： '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary'，可能會出現「找不到 mqver」和「找不到 wempsservice」的錯誤報告。 您可以忽略這些錯誤訊息。
安裝產品之前，請先檢查下列事項：
WebSphere Application Server - Express 的 HP/UX CD 映像檔分割成若干部分，以縮減下載大小。 每個部分都是一個磁帶保存檔 (tar)，所有部分都是必要的。
如果要安裝 WebSphere Application Server - Express 的電子映像檔，請遵循下列步驟：
安裝 WebSphere Application Server - Express 之後，在 /opt/IBM/WebSphere/Express51 目錄下應該會有下列目錄結構：
如果這些目錄中任何一個目錄實際包含的檔案數目不同，您應該懷疑安裝期間發生問題。 請查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 檔。
您可以從「首要步驟」應用程式執行「驗證伺服器安裝」來驗證應用程式伺服器安裝架構的基本作業。 「首要步驟」是在安裝結束時啟動的，您也可以執行 /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh Script 來啟動它。
另外，您也可以執行 /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh Script 來驗證應用程式伺服器的作業。 這個 Script 會利用預設配置來逐步啟動和停止應用程式伺服器。請注意，這個 Script 只供測試伺服器安裝架構之用。
如果您要將產品和您自己的程式連結起來，您可以無聲執行 WebSphere Application Server - Express 安裝程式。 如果要無聲自動安裝 WebSphere Application Server - Express，請使用 -silent 指令行選項。 於無聲自動安裝期間，您將不會在呼叫安裝指令之後，看到精靈畫面。
如果要用所有預設值來執行無聲自動安裝，請使用類似下列中的指令：
./hpux/setupHPUX -silent
您也可以利用回應檔來設定無聲自動安裝的其他選項。 請參閱安裝 CD 中的範例回應檔來取得範本。 如果要利用回應檔來執行無聲自動安裝，請利用如下指令：
./hpux/setupHPUX -silent -options <fully qualified path/responsefile
如果要在 HP-UX 中解除安裝 WebSphere Application Server - Express，請遵循下列步驟：
./uninstaller
這一節討論 WebSphere Application Server - Express for HP-UX 在安裝和解除安裝方面的已知問題和限制。 請參閱 Readme 檔，以取得會影響產品之實際用法的問題和限制的相關資訊。
如果安裝失敗，請執行下列動作：
安裝失敗有時會造成 _uninst 目錄中的解除安裝檔案不完整。 這種問題的症狀是，當您執行解除安裝時，會出現找不到適當 JVM 的訊息。 您應該依照下列方式來手動執行解除安裝：
歡迎使用 WebSphere Application Server - Express 的 Web 伺服器外掛程式特性。
使用者可以利用 Web 伺服器外掛程式來區分 Web 伺服器機器和 Express Application Server 機器，以提升安全和效能。 這個區分也可讓您在架構一般網站時更具彈性。
這些外掛程式是利用 HTTP(S) 來與 WebSphere Application Server - Express 通訊。
Web 伺服器外掛程式安裝架構包括在支援下列 Web 伺服器的平台中自動配置這些 Web 伺服器時所需要的所有元件。
| Apache Web Server |
|
| IBM HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
附註 1
|
附註：
| Apache Web Server |
|
| IBM HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
請參閱下面的附註 1。
|
附註：
這是 Web 伺服器外掛程式檔案和程式庫的安裝位置。 如果 WebSphere Application Server - Express 安裝在機器中，預設位置就是 <ExpressInstallDir>/Plugins。
附註：安裝目錄是授權檔、產品檔、JVM 和解除安裝程式的安裝位置。 執行時期所需要的 Web 伺服器外掛程式檔案安裝在 <InstallDir>/../AppServer 中。
範例目錄結構：
C:\
- Program Files
-IBM
-WebSphere
- Plugins
- AppServer
在 Web 伺服器和 Express Application Server 安裝在相同機器的單層環境中，Web 伺服器外掛程式在 WebSphere Application Server - Express 目錄中：<ExpressInstallDir>/AppServer。 這可以提供 Web 伺服器外掛程式和 Express Application Server 的無縫整合。 結果重新產生的 plugin-cfg.xml 的預設目錄會在 Web 伺服器配置要用的相同位置。 因此，在重新產生 plugin-cfg.xml 檔之後，您不需要手動複製或移動它。
這是執行 WebSphere Application Server - Express 的機器的主機名稱。 收集這個資訊之後，會將適當值插入外掛程式配置檔 (plugin-cfg.xml) 中。 預設值是本端主機的主機名稱。 如果 WebSphere Application Server - Express 是在不同機器中執行，請輸入遠端伺服器的主機名稱。
對於您選擇要安裝的每個 Web 伺服器外掛程式，系統會提示您輸入它的配置檔位置。 這個檔案必須存在，才能繼續安裝。
請參閱 4.0 節「我的 Web 伺服器配置進行哪些變更」，以取得詳細資料。
請參閱 4.0 節「我的 Web 伺服器配置進行哪些變更」，以取得詳細資料。
這一節說明在安裝期間 Web 伺服器配置檔的修改，它們是可以手動完成的作業。 這些步驟是安裝程序自動執行的，列在這裡作為參考。
這些修正包括加入指向 Web 伺服器外掛程式庫的參照，以及指向 Web 伺服器外掛程式配置檔 (plugin-cfg.xml) 位置的參照。
這項作業的步驟
請利用下列項目作為檔案的配置模型。 附註：<pluginsInstallRoot> 是 WebSphere Application Server - Express 外掛程式的安裝起始目錄。
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_ibm_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
附註：安裝起始目錄可能會隨著作業系統平台而不同。比方說，第 5 版的 AIX 安裝起始目錄是 /opt/IBM/WebSphere/Express51/Plugins/。
LoadModule ibm_app_server_http_module <pluginsInstallRoot>\bin\mod_ibm_app_server_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
請利用下列項目作為模型來配置您的檔案。
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/config/cells/plugin-cfg.xml
附註：安裝起始目錄可能會隨著作業系統平台而不同。比方說，第 5 版的 AIX 安裝起始目錄是 /opt/IBM/WebSphere/Express51/Plugins/。
LoadModule was_ap20_module <pluginsInstallRoot>\bin\mod_was_ap20_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
附註：如果 IBM HTTP Server 2.0 httpd.conf 檔中有 IBM HTTP Server 1.3.26 指引 LoadModule ibm_app_server_http_module，IBM HTTP Server 就無法啟用。您必須將這個指引註解或刪除，才能啟動第 2 版伺服器。
請利用下列項目作為模型來配置您的檔案。
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
大部分 Apache Web Server 的編譯都沒有延伸 API (EAPI) 支援。 如果利用 mod_app_server_http.so 外掛程式模組來啟動 Web 伺服器時，出現類似下列中的訊息，請使用模組的 EAPI 版本。
[Tue Jul 2 13:20:14 2002] [警告] 已載入 DSO /opt/IBM/WebSphere/AppServer/bin/mod_app_server_http.so 使用一般 Apache 1.3 API，在 EAPI 之下，這個模組可能會當掉！ （請設定 -D EAPI 來重新編譯它）
如果要使用 EAPI 模組，請配置 httpd.conf 檔來指向 mod_app_server_http_eapi.so，而不是指向 mod_app_server_http.so：
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_app_server_http_eapi.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/ config/cells/plugin-cfg.xml
附註：安裝起始目錄可能會隨著作業系統平台而不同。比方說，第 5 版的 AIX 安裝起始目錄是 /opt/IBM/WebSphere/Express51/Plugins/。
LoadModule app_server_http_module <pluginsInstallRoot> \bin\mod_app_server_http.dll WebSpherePluginConfig <pluginsInstallRoot> \config\cells\plugin-cfg.xml
大部分 Apache Web Server 的編譯都沒有延伸 API (EAPI) 支援。 如果利用 mod_app_server_http.dll 外掛程式模組來啟動 Web 伺服器時，出現類似下列中的訊息，請使用模組的 EAPI 版本。
[Tue Jul 2 13:20:14 2002] [警告] 已載入 DSO C:\WebSphere\AppServer\bin\ mod_app_server_http.so 使用一般 Apache 1.3 API，在 EAPI 之下，這個模組可能會當掉！ （請設定 -D EAPI 來重新編譯它）
如果要使用 EAPI 模組，請配置 httpd.conf 檔來指向 mod_app_server_http_eapi.dll，而不是指向 mod_app_server_http.dll：
LoadModule app_server_http_module <pluginsInstallRoot>\bin\mod_app_server_http_eapi.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
請遵循下列程序，使 HTTP 傳輸外掛程式能夠與 Domino 5.05 或 5.06 版共同運作。 安裝精靈不會執行這項修改作業。 請執行這個手動程序。
附註：如果已指定 Domino Web Server 應用程式設計介面 (DSAPI) 過濾器檔案，請利用空格來分隔 WebSphere Application Server 外掛程式檔。
設定 WAS_HOME 環境變數來指向 WebSphere Application Server 安裝起始目錄。
將 Plugin Config 變數加入 HKEY_LOCAL_MACHINE > SOFTWARE > IBM > WebSphere Application Server > 5.1.0.0 路徑下的登錄中。 請將這個變數的值設為 plugin-cfg.xml 檔的位置，也就是 <pluginsInstallRoot>\config\cells\plugin-cfg.xml。
其中 <pluginsInstallRoot> 是 WebSphere Application Server - Express 外掛程式的安裝起始目錄。
02/12/2001 03:05:09 PM JVM: 已起始設定 Java 虛擬機器 已載入 WebSphere Application Server DSAPI 過濾器 02/12/2001 03:05:10 PM 已啟動 HTTP Web 伺服器
請利用下列項目作為模型來配置您的檔案。
請將這些指引併入 obj.conf 檔中：
Init fn=『load-modules』 funcs=『as_init,as_handler,as_term』 shlib=『/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so』 Init fn=『as_init』 bootstrap.properties=『 /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml』 Service fn=『as_handler』
附註：安裝起始目錄可能會隨著作業系統平台而不同。比方說，第 5 版的 AIX 安裝起始目錄是 /opt/IBM/WebSphere/Express51/Plugins/。
請在 obj.conf 檔中加入一個指引，在 『<Object name=default>』 之後：
Service fn=『as_handler』
請在 magnus.conf 檔尾端加入兩個指引：
Init fn=『load-modules』 funcs=『as_init,as_handler,as_term』 shlib=『/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so』 Init fn=『as_init』 bootstrap.properties=『 /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml』
附註：安裝起始目錄可能會隨著作業系統平台而不同。比方說，第 5 版的 AIX 安裝起始目錄是 /opt/IBM/WebSphere/Express51/Plugins/。
請將這些指引併入 obj.conf 檔中：
Init fn=『load-modules』 funcs=『as_init,as_handler,as_term』 shlib=『 <pluginsInstallRoot>\bin\libns41_http.dll』 Init fn=『as_init』 bootstrap.properties=『 <pluginsInstallRoot>\config\cells\plugin-cfg.xml』 Service fn=『as_handler』
請在 obj.conf 檔中加入一個指引，在 『<Object name=default>』 之後：
Service fn=『as_handler』
請在 magnus.conf 檔尾端加入兩個指引：
Init fn=『load-modules』 funcs=『as_init,as_handler,as_term』 shlib=『 <pluginsInstallRoot>\bin\libns41_http.dll』 Init fn=『as_init』 bootstrap.properties=『 <pluginsInstallRoot>:\config\cells\plugin-cfg.xml』
請遵循下列程序，以手動方式重現安裝精靈配置網際網路服務管理員 (IIS) Web 伺服器的方式：
其中 <pluginsInstallRoot> 是 WebSphere Application Server - Express 外掛程式的安裝起始目錄。
將應用程式部署在 WebSphere Application Server - Express 之後，必須重新產生 Web 伺服器外掛程式配置檔 plugin-cfg.xml。
當使用 WebSphere Application Server - Express 5.1.0 版時，請利用 genPluginCfg Script，根據 WebSphere Express Application Server 現行配置來重新產生 plugin-cfg.xml 檔。
其中 <ExpressInstallDir> 是 WebSphere Application Server - Express 的安裝起始目錄
其中 <PluginInstallRoot> 是 WebSphere Application Server - Express 外掛程式的安裝起始目錄。
下列情況需要手動編輯 plugin-cfg.xml 檔：
<?xml version=『1.0』 encoding=『ISO-8859-1』 ?> <Config> <Log LogLevel=『Error』 Name=『C:\Program Files\IBM\WebSphere\Express51\Plugins \logs\http_plugin.log』 /> <VirtualHostGroup Name=『default_host』> <VirtualHost Name=『*:7080』 /> <VirtualHost Name=『*:80』 /> <VirtualHost Name=『*:7443』 /> </VirtualHostGroup> <ServerCluster Name=『server1_DefaultNode_Cluster』> <Server Name=『DefaultNode_server1』> <Transport Hostname=『myHostname.raleigh.ibm.com』 Port=『7080』 Protocol=『http』 /> <Transport Hostname=『myHostname.raleigh.ibm.com』 Port=『7443』 Protocol=『https』> <Property name=『keyring』 value=『 C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb』 /> <Property name=『stashfile』 value=『 C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth』 /> </Transport> </Server> <PrimaryServers> <Server Name=『DefaultNode_server1』 /> </PrimaryServers> </ServerCluster> <UriGroup Name=『default_host_server1_DefaultNode_Cluster_URIs』> <Uri AffinityCookie=『JSESSIONID』 AffinityURLIdentifier=『jsessionid』 Name=『/UTC/*』 /> <Uri AffinityCookie=『JSESSIONID』 AffinityURLIdentifier=『jsessionid』 Name=『/CustomHomePageExample/*』 /> <Uri AffinityCookie=『JSESSIONID』 AffinityURLIdentifier=『jsessionid』 Name=『/YourCoExpressExample/*』 /> <Uri AffinityCookie=『JSESSIONID』 AffinityURLIdentifier=『jsessionid』 Name=『/CustomerServiceExample/*』 /> <Uri AffinityCookie=『JSESSIONID』 AffinityURLIdentifier=『jsessionid』 Name=『/DocumentMgmtExample/*』 /> <Uri AffinityCookie=『JSESSIONID』 AffinityURLIdentifier=『jsessionid』 Name=『/SurveyExample/*』 /> </UriGroup> <Route ServerCluster=『server1_DefaultNode_Cluster』 UriGroup=『default_host_server1_DefaultNode_Cluster_URIs』 VirtualHostGroup=『default_host』 /> </Config>
當您的 Web 伺服器是安裝在不同於 WebSphere Application Server - Express 的機器時，您必須將產生的 plugin-cfg.xml 檔移至在 Web 伺服器機器的 <PluginsInstallRoot>/config/cells 目錄中。 因此，您可能需要手動編輯 plugin-cfg.xml 檔上所參照的路徑。 後來使用 genPluginCfg Script 時，會將更新合併起來，且會保留手動更新的路徑項目。
範例：export SHLIB_PATH=/usr/lib:/lib
產品 CD-ROM 採用含 Rockridge 延伸的 ISO-9660 格式。 您可能需要手動裝載 CD-ROM。 您必須有 root 專用權，才能裝載或卸載 CD_ROM。
請遵循下列指示來裝載 HP-UX 中的 CD_ROM：
/usr/sbin/pfs_mountd &
/usr/sbin/pfsd &
<device_file> <mount_point> <filesystem_type> <translation_method>
範例： /dev/dsk/c0t0d0 /cdrom pfs-rrip ro,suid 0 0
/usr/sbin/pfs_mount /cdrom
/usr/sbin/pfs_umount /cdrom
範例： export WAS_HOME=/opt/IBM/WebSphere/Express51/Plugins
WebSphere Application Server - Express 5.1 版預先安裝了一個稱為 Snoop 的應用程式，您可以利用它來驗證 Web 伺服器外掛程式的安裝和配置正不正確。 安裝 Web 伺服器外掛程式期間所安裝的 Web 伺服器外掛程式配置檔 plugin-cfg.xml 預先配置成會測試 Snoop 應用程式。 不過，您也可以依照這份文件的說明來重新產生 Web 伺服器外掛程式。
要訣：重新產生外掛程式配置檔之後，請記得重新啟動 Web 伺服器。
Web 伺服器外掛程式的測試程序
http://yourHostName:7080
要訣：如果 Web 伺服器無法啟動，請參閱這份文件的「疑難排解要訣」一節，以瞭解如何解決問題。
附註：請勿指定 WebSphere Express Application Server 的內部傳輸 7080。Web 伺服器外掛程式會利用內部傳輸 7080 來作為伺服器的 Proxy。 下列 URL 假設 Web 伺服器是用預設 HTTP 埠 80 來接聽。
http://yourHostName
如果 Web 伺服器外掛程式的安裝和配置正確，瀏覽器會顯示 WebSphere Application Server 預設應用程式網頁。
請先嘗試這個：在配置 Web 伺服器外掛程式之後，Web 伺服器啟動失敗最常見的原因是 plugin-cfg.xml 檔含有無效或不正確的資訊，Web 伺服器無法剖析它。 問題往往是下列情況造成的：
如果 HTTP 外掛程式元件（將要求從 IBM HTTP Server、Apache 或 IIS 之類的 HTTP 伺服器傳給 Websphere Application Server - Express 的元件）有問題，請嘗試下列步驟：
如果這些檔案無法揭露問題的原因，請遵循下列額外步驟。
外掛程式問題判斷步驟
外掛程式提供了很好讀取的追蹤，可以協助您找出問題。您可以將 config/plugin-cfg.xml 檔中的 LogLevel 屬性設為 Trace 來遵循要求處理程序查看發生什麼問題。 在高層次上：
您可以讀取單一要求的追蹤，將這個看得非常清楚：
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: --------------------System Information-------------------- [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Webserver: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ---------------------------------------------------------------
ws_common: websphereGetStream: 無法連接至應用程式伺服器，OS err=%d
其中 %d 是關於 connect() 呼叫為什麼失敗的 OS 特定錯誤碼。這個情況的可能原因有許多。
您可以利用瀏覽器型的管理主控台，或利用在 <ExpressInstallDir>/AppServer/bin 中的 GenPluginCfg Script，來重新產生 plugin-cfg.xml 檔。
用法：GenPluginCfg [[-option.name optionValue]...]
有效選項：
-config.root configroot_dir
（預設值是 CONFIG_ROOT 環境變數）
-cell.name cell
（預設值是 WAS_CELL 環境變數）
-node.name node
（預設值是 WAS_NODE 環境變數）
-server.name server
（產生單一伺服器外掛程式需要這個選項）
-output.file.name file_name
（預設值是 configroot_dir/plugin-cfg.xml）
-destination.root root
（將在其中使用配置的安裝起始目錄）
-destination.operating.system windows/unix
（將在其中使用配置的作業系統）
-debug yes/no
（預設值是無）
範例：
IBM HTTP Server
技術文章和範例程式碼
文件更新
如果需要線上說明系統未併入的 WebSphere Application Server - Express 最新資訊，請造訪下列網站：
這一節說明如何設定 WebSphere Application Server - Express 的 Web 伺服器安全外掛程式特性。 您應該從 WebSphere Application Server - Express 5.1.1 版所檢附的 Web 伺服器外掛程式 CD 中安裝 Web 伺服器安全外掛程式特性。
使用者可以利用 Web 伺服器安全外掛程式來分開 Web 伺服器機器和 Express Application Server 機器，以提升安全和效能。 您可以利用這個區分來更靈活架構一般網站。
這些安全外掛程式是利用 HTTP(S) 來與 WebSphere Application Server - Express 通訊。
Web 伺服器外掛程式安裝架構包括在支援下列 Web 伺服器的平台中自動配置它們時所需要的所有元件。
Web 伺服器安全外掛程式必須安裝在 HTTP Web 伺服器的同一部機器上。 因此，在安裝 HTTP Web 伺服器外掛程式之前，請先確定 HTTP Web 伺服器已安裝在機器中。
請參閱在 Web 伺服器外掛程式 CD 中的 README 檔，以取得這些主題的詳細資訊：
如果要從 CD 安裝 HTTP Web 伺服器安全外掛程式，請遵循下列步驟：
這是 Web 伺服器外掛程式檔案和程式庫的安裝位置。 如果 WebSphere Application Server - Express 安裝在機器中，預設位置就是 <ExpressInstallDir>/Plugins。
附註：安裝目錄是授權檔、產品檔、JVM 和解除安裝程式的安裝位置。 執行時期所需要的 Web 伺服器外掛程式檔案安裝在 <InstallDir>/../AppServer 中。
範例目錄結構：
C:\ Program File\IBM\WebSphere\Plugins
C:\ Program File\IBM\WebSphere\Appserver
在 Web 伺服器和 Express Application Server 安裝在相同機器的單層環境中，Web 伺服器外掛程式在 WebSphere Application Server - Express 目錄中：<ExpressInstallDir>/AppServer。 這可以提供 Web 伺服器外掛程式和 Express Application Server 的無縫整合。 結果重新產生的 plugin-cfg.xml 的預設目錄會在 Web 伺服器配置要用的相同位置。 因此，在重新產生 plugin-cfg.xml 檔之後，您不需要手動複製或移動它。
這是執行 WebSphere Application Server - Express 的機器的主機名稱。 這個資訊收集之後，會將適當值插入外掛程式配置檔 (plugin-cfg.xml) 中。 預設值是本端主機的主機名稱。 如果 WebSphere Application Server - Express 是在不同機器中執行，請輸入這個遠端伺服器的主機名稱。
對於您選擇要安裝的每個 Web 伺服器外掛程式，系統會提示您輸入它的配置檔位置。 這個檔案必須存在，才能繼續安裝。
如果您要將產品和您自己的程式連結起來，您可以無聲執行 WebSphere Application Server - Express 外掛程式的安裝程式。 如果要無聲自動安裝 WebSphere Application Server - Express 的外掛程式，請使用 -silent 指令行選項。 於無聲自動安裝期間，您將不會在呼叫安裝指令之後，看到精靈畫面。
您應該利用回應檔來設定無聲自動安裝的適當選項。 請參閱安裝 CD 中的範例回應檔來取得範本。 如果要利用回應檔來執行無聲自動安裝，請利用如下指令：
Windows：
install.exe -silent -options <fully qualified path>/responsefile
Linux 和 UNIX：
linux/setupLinux -silent -options <fully qualified path>/responsefile
UNIX 平台範例：
WebSphere Application Server - Express 5.1 版預先安裝了一個稱為 Snoop 的應用程式，您可以利用它來驗證 Web 伺服器外掛程式的安裝和配置正不正確。 安裝 Web 伺服器外掛程式期間所安裝的 Web 伺服器外掛程式配置檔 plugin-cfg.xml 預先配置成會測試 Snoop 應用程式。 不過，您也可以依照這份文件的說明來重新產生 Web 伺服器外掛程式。
要訣：重新產生外掛程式配置檔之後，請記得重新啟動 Web 伺服器。
Web 伺服器外掛程式的測試程序
http://yourHostName:7080
要訣：如果 Web 伺服器無法啟動，請參閱這份文件的「疑難排解要訣」一節，以瞭解如何解決問題。
附註：請勿指定 WebSphere Express Application Server 的內部傳輸 7080。Web 伺服器外掛程式會利用內部傳輸 7080 來作為伺服器的 Proxy。 下列 URL 假設 Web 伺服器是用預設 HTTP 埠 80 來接聽。
http:// yourHostName
如果 Web 伺服器外掛程式的安裝和配置正確，瀏覽器會顯示 WebSphere Application Server 預設應用程式網頁。
如果要解除安裝 WebSphere Application Server - Express 的 HTTP Web 伺服器安全外掛程式，請遵循下列步驟：
如果要在 Linux 和 UNIX 平台中解除安裝 WebSphere Application Server - Express 的 HTTP Web 伺服器外掛程式，請遵循下列步驟：
./uninstaller
依預設，WebSphere Application Server - Express 會自動安裝並行版本系統 (CVS) 外掛程式。 您可以從下列網站取得 CVS 伺服器最新的版本：www.cvshome.org。您不需要安裝 CVS 從屬站來使用 CVS，只要安裝 CVS 伺服器就行了。 如果需要安裝和使用 CVS 的詳細資訊，請參閱團隊線上說明。 另外，www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html 的 WebSphere Application Server - Express 中也有一篇關於 CVS 團隊支援的文章。
您也可以利用 Rational(R) ClearCase(R) 作為軟體配置管理 (SCM) 系統來替代 CVS。 如果需要 Rational ClearCase 的詳細資訊，請參閱 www.ibm.com/software/awdtools/clearcase/
CVS 伺服器和 Rational ClearCase 用戶端或伺服器都不會自動安裝。 您必須在 WebSphere Studio 之外，個別安裝它們。
有一些其他的 SCM 儲存庫可以透過 SCM 團隊配接器（在 Eclipse 中稱為團隊提供者），和 WebSphere Application Server - Express 整合在一起。如果要取得 IBM 事業夥伴所提供的 SCM 產品和配接器清單，請移至 www-3.ibm.com/software/awdtools/studioappdev/about/，從 Further reading 區段中選取 SCM Adaptor Vendors。 從這份清單中，您可以進入 SCM 產品供應商的網站，以下載您選取的 SCM 配接器。IBM 不為這些配接器提供任何保證或背書。 如果需要支援或進一步的資訊，請直接洽詢 SCM 產品供應商。
Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
本資訊是針對 IBM 在美國所提供的產品與服務所開發，IBM 在其他國家不見得提供本文所提及的各項產品、服務或功能。 有關當地目前所提供的產品與服務，請洽詢當地的 IBM 業務代表。 本文件在提及 IBM 產品、程式或服務時，不表示或暗示您只能使用 IBM 產品、程式或服務。 只要未侵犯 IBM 的任何智慧財產權， 您可以採用任何功能相當的產品、程式或服務。 不過，任何非 IBM 產品、程式或服務，使用者必須自行負責作業的評估和驗證。
本文件可能含有 IBM 所擁有的專利或專利申請案。 提供本文件不代表提供這些專利的授權。 您可以書面提出授權查詢，來函請寄到：
IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.
如果是有關雙位元組 (DBCS) 資訊的授權查詢，請洽詢所在國的 IBM 智慧財產部門，或書面提出授權查詢，來函請寄到：
IBM World Trade Asia CorporationLicensing 2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan
當您傳送資訊給 IBM 時，即授與 IBM 非獨占的資訊使用或公佈權利， IBM 不需對您負任何責任。
下列段落不適用於英國或本條款與當地法律有抵觸的其他國家：INTERNATIONAL BUSINESS MACHINES CORPORATION 只依「現況」提供本出版品，不提供任何明示或默示之保證， 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。 有些地區在特定交易上，不允許排除明示或暗示的保證，因此，這項聲明不一定適合您。
本資訊可能會有技術上或排版印刷上的訛誤。 因此 IBM 會定期修訂；並將修訂後的內容納入新版中。IBM 隨時會改進和/或變更本出版品所提及的產品和/或程式，不另行通知。
如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式（包括本程式）之間交換資訊， 以及 (ii) 相互使用所交換的資訊，因而需要相關的資訊，請洽詢：
Lab DirectorIBM Canada Ltd. Laboratory8200 Warden AvenueMarkham, Ontario, Canada L6G 1C7
這些資訊可依適當條款而取得，在某些情況下，可能需要付費。
IBM 基於雙方之 IBM 客戶合約、IBM 國際程式授權合約或任何同等合約之條款， 提供本文件中所述之授權程式及其所有適用的授權資料。
本書所提及之非 IBM 產品資訊，取自產品的供應商，或其發佈的聲明或其他公開管道。 IBM 並未測試過這些產品，也無法確認這些非 IBM 產品的執行效能、 相容性或任何對產品的其他主張是否完全無誤。 有關非 IBM 產品的性能問題應直接洽詢該產品供應商。
本資訊所提及的任何非 IBM 網站僅供參考之用，IBM 不為這些網站背書。 這些網站之資料並非本 IBM 產品資料的一部分， 使用者必須承擔使用這些網站的風險。
這份資訊含有日常商業運作所用的資料和報告範例。 為了要使它們儘可能完整，範例可能包括個人、公司、品牌和產品的名稱。 所有這些名稱全屬虛構，如果與真實公司企業的名稱和地址雷同，純屬巧合。
著作權：
本資訊包含程式碼語言的範例應用程式，用以說明各種作業平台上的程式設計技術。 您可以基於開發、使用、銷售或散布應用程式的目的， 免費利用任何形式來複製、修改和散布這些程式範例， 不過，這些應用程式必須符合程式範例所針對的作業平台之應用程式設計介面。 這些範例並未在所有情況下完整測試。 因此，IBM 不保證或暗示這些程式的可靠性、有用性或功能。 您可以基於開發、使用、銷售或散布應用程式的目的， 免費利用任何形式來複製、修改和散布這些程式範例， 不過，這些應用程式必須符合 IBM 的應用程式設計介面。
這些範例程式或任何衍生成果的每份副本或任何部分，都必須依照下列方式併入著作權聲明：
(C)（您的公司名稱）（年份）。本程式的若干部分係衍生自 IBM 公司的範例程式。 (C) Copyright IBM Corp. 2000, 2003. All rights reserved.
程式設計介面資訊之目的，是要協助您利用這個程式來建立應用軟體。
通用程式設計介面可讓您撰寫取得本程式工具各項服務的應用軟體。
不過，本資訊也可能包含診斷、修正和調整資訊。 提供診斷、修正和調整資訊，是要協助您進行應用軟體的除錯。
警告：請勿將這份診斷、修正和調整資訊當作程式設計介面使用，因為它隨時會改變。
下列詞彙是 International Business Machines Corporation 在美國和/或其他國家的商標或註冊商標：
Java 及所有以 Java 為基礎的商標與標誌，是 Sun Microsystems, Inc. 在美國和其他國家的商標或註冊商標。
ActiveX、Microsoft、Windows、Windows NT 和 Windows 標誌是 Microsoft Corporation 在美國和/其他國家的商標或註冊商標。
UNIX 是 The Open Group 的註冊商標。