>WebSphere® Application
Server 提供 Web 伺服器外掛程式,可讓您配置成與特定品牌的 Web 伺服器通訊。您將瞭解如何將 Web 伺服器、其 WebSphere Application Server 的 Web 伺服器外掛程式,以及應用程式伺服器,安裝在相同機器上。
開始之前
若有多份設定檔存在時,您可以選取「Web 伺服器外掛程式配置工具」配置的設定檔。有關決定如何選取所要配置之設定檔的邏輯流程的說明,請參閱外掛程式配置。
若有多份設定檔存在時,您可以選取「Web 伺服器外掛程式配置工具」配置的設定檔。有關決定如何選取所要配置之設定檔的邏輯流程的說明,請參閱外掛程式配置。
如果 WebSphere Application Server 系列產品支援特定品牌的 Web 伺服器(如:IBM® HTTP Server 或 Microsoft Internet Information Services
(IIS)),則 WebSphere Application
Server 產品會提供您必須安裝之 Web 伺服器的二進位外掛程式。
如果 WebSphere Application Server 系列產品未提供特定品牌之 Web 伺服器的二進位外掛程式,該 Web 伺服器即不受支援。二進位外掛程式的用途是提供 Web 伺服器和應用程式伺服器之間的通訊協定。
假設您建立了新的設定檔,同時假設您要使用 Web 伺服器。您必須安裝新的 Web 伺服器以用於該新的設定檔、安裝「Web 伺服器外掛程式」,並使用「Web 伺服器外掛程式配置工具」來配置 Web 伺服器和應用程式伺服器。
如果尚未安裝 Web 伺服器,您仍然可以安裝「Web 伺服器外掛程式」供未來使用。
這個程序會配置機器上作為預設設定檔的應用程式伺服器設定檔。Web 伺服器和應用程式伺服器之間存在一對一的關係。
不過,獨立式應用程式伺服器設定檔和受管理設定檔都可以定義多部 Web 伺服器,且每一部 Web 伺服器定義在個別的 Web 伺服器定義中。
這篇文章說明如何建立下列拓蹼:
註: 如果要支援由非 root 使用者安裝外掛程式元件,應用程式伺服器也必須是由同一非 root 使用者安裝。否則,在應用程式伺服器安裝架構中,將無法執行 Web 伺服器配置 Script。
關於這項作業
註: 這個主題參照一或多個應用程式伺服器日誌檔。
此外,在分散式和 IBM i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.log、SystemErr.log, trace.log 及 activity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
「Web 伺服器外掛程式配置工具」會編輯 Web 伺服器的一或多個配置檔,亦即,它會建立指引,來指向二進位外掛程式模組和外掛程式配置檔的位置。
二進位外掛程式模組的名稱會因 Web 伺服器類型而異。外掛程式配置檔一律是 plugin-cfg.xml 檔。
除非已存在 Web 伺服器定義,否則,「Web 伺服器外掛程式配置工具」會在應用程式伺服器配置中建立一項。
您可以使用管理主控台,來管理 Web 伺服器配置。舉例來說,當您將應用程式安裝在應用程式伺服器時,也可以選擇將它安裝在 Web 伺服器定義中。若是如此,已更新的 plugin-cfg.xml 檔會顯示新的應用程式可供使用。在 Web 伺服器讀取已更新的外掛程式配置檔時,Web 伺服器就會察覺新的應用程式,並可提供給 Web 用戶端。
如果您選擇不將新應用程式安裝在 Web 伺服器定義中,就不會將應用程式新增至外掛程式配置檔。Web 伺服器不會察覺應用程式,且無法將它提供給 Web 用戶端。
支援的配置: 只有在 AIX®、Linux 和 Windows 上,才支援此工具。除了使用「Web 伺服器外掛程式配置工具」,您也可以改用 pct 指令行工具與回應檔來配置 Web 伺服器。
如需相關資訊,請參閱
使用 pct 工具來配置 Web 伺服器外掛程式。
sptcfg
利用這項程序,來安裝 Web 伺服器外掛程式、配置 Web 伺服器,並在預設應用程式伺服器設定檔中建立 Web 伺服器定義。
程序
- 配置獨立式應用程式伺服器。
- 登入作業系統。
如果您要以非 root 或非管理使用者的身分進行安裝,則有某些限制。
![[AIX]](../images/aixlogo.gif)
![[Linux]](../images/linux.gif)
此外,選取 Umask 讓擁有者能夠讀寫檔案,並讓其他人可以根據通行系統原則來存取它們。若為 root 使用者,建議使用 022 的 Umask。如果是非 root 使用者,可以使用 002 或
022 的 Umask,視該使用者是否共用群組而定。如果要驗證 Umask 設定,請發出下列指令:
umask
如果要將 Umask 設定設定為 022,請發出下列指令:
umask 022
![[Windows]](../images/windows.gif)
在 Windows 作業系統上以管理使用者的身分進行安裝時,會自動建立 Windows 服務以自動啟動應用程式伺服器。安裝者的使用者帳戶必須具有下列的進階使用者權限:
比方說,在某些 Windows 作業系統中,按一下
控制台 > 系統管理工具 > 本機安全性原則 > 本機原則
> 使用者權限指派來設定進階選項。
如需相關資訊,請參閱 Windows 作業系統文件。
如果您打算將應用程式伺服器當作 Windows 服務執行,請勿從包含空格的使用者 ID 進行安裝。系統無法驗證含有空格的使用者 ID。
這類使用者 ID 不允許繼續進行安裝作業。要暫行解決這項限制,請以不含空格的使用者 ID 進行安裝。
- 安裝 Installation Manager。
- 使用 Installation Manager 來安裝下列各項:
- WebSphere Application Server Network Deployment
- WebSphere Application Server 的 Web 伺服器外掛程式
- Websphere Customization Toolbox
- 使用 Installation Manager 安裝 IBM HTTP
Server,或是安裝另一部支援的 Web 伺服器。
- 開啟 WebSphere Customization Toolbox,並啟動「Web 伺服器外掛程式配置工具」。
- 選取「Web 伺服器外掛程式」執行時期位置。
如果您想使用先前的 Web 伺服器外掛程式安裝位置,但卻不在清單中,請執行下列動作,將該位置新增至工作集:
- 按一下新增。
- 輸入 Web 伺服器外掛程式位置的名稱。
- 請執行下列其中一個動作:
- 輸入位置。
- 按一下瀏覽,尋找位置,然後按一下確定。
- 按一下建立。
- 選取您要配置的 Web 伺服器類型,然後按下一步。
- 選取已安裝之目標 Web 伺服器的架構(64 位元或 32 位元),並按下一步(如果要求您這麼做的話)。
- 按一下瀏覽以選取 Web 伺服器的配置檔,確認 Web 伺服器埠是正確的,完成時按下一步。
請選取檔案,而不是只選取檔案的目錄。某些 Web 伺服器有兩個配置檔,因此需要您瀏覽每一個檔案。
下列清單顯示受支援之 Web 伺服器的配置檔:
- Apache HTTP Server
- apache_root/config/httpd.conf
- Domino® Web 伺服器
- names.nsf 和 Notes.jar
精靈會提示您使用 notes.jar 檔,但實際的名稱是 Notes.jar。
「Web 伺服器外掛程式配置工具」會確認檔案存在,但此工具並不會驗證任一個檔案。
- IBM HTTP Server
IHS_root/conf/httpd.conf
IHS_profile_root/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- 「Web 伺服器外掛程式配置工具」可判斷出正確的檔案,以用來進行編輯。
- Sun Java™ System Web Server(早期為 Sun ONE Web Server 和 iPlanet Web Server)6.0 版以及更新版本
- obj.conf 和 magnus.conf
- 如果您正在配置 IBM HTTP Web 伺服器外掛程式,請執行下列動作。
- (選用)設定管理伺服器配置,以管理 Web 伺服器。
小心: 當您使用「Web 伺服器外掛程式配置工具」來配置
IBM HTTP Server 管理伺服器時,必須以具備管理者/root 專用權的「本端」帳戶,來執行 WebSphere Customization Toolbox。
- 選取設定 IBM HTTP
Server 管理伺服器。
- 指定 IBM HTTP 管理伺服器所用的通訊埠號。
- (選用)選取建立 IBM Server 管理伺服器鑑別用的使用者 ID,並輸入從管理主控台接受 IBM HTTP Server 管理伺服器鑑別時所用的使用者 ID 與密碼。
- 按下一步。
![[AIX]](../images/aixlogo.gif)
指定對 IBM HTTP
Server、IBM HTTP Server
管理伺服器和 Web 伺服器外掛程式配置檔具備寫入權的系統使用者 ID 和群組。必要的話,請選取使用認證來建立新的唯一系統使用者 ID 和群組。
限制: 如果您指定的新使用者 ID 或群組名稱超過平台限制
(通常是 8 個字元,有時可以配置),配置可能失敗。
(選用)將 IBM HTTP Server 管理伺服器設為以 Windows 服務形式執行。
- 選取以 Windows 服務形式,來執行 IBM HTTP Server 管理伺服器。
- 請執行下列其中一個動作:
- 選取以本端系統帳戶登入。
- 選取以指定的使用者帳戶登入,並輸入該帳戶的使用者 ID 與密碼。
- 選擇您的啟動類型是自動還是手動。
- 按下一步。
- 指定 Web 伺服器定義的唯一名稱,並按下一步。
- 選取配置實務。
- 選擇本端實務。
- 請執行下列其中一個動作:
- 輸入 WebSphere Application Server 的安裝位置 (app_server_root)。
- 按一下瀏覽,尋找 WebSphere Application Server 的安裝位置
(app_server_root),並按一下確定。
- 按下一步。
- 選取要配置成使用現行 Web 伺服器外掛程式的設定檔,並按下一步。
- 檢閱摘要資訊,並按一下配置,開始配置 Web 伺服器、Web 伺服器外掛程式和應用程式伺服器設定檔。
- 在摘要畫面中,驗證安裝成功,並按一下完成。
如果發生問題且安裝未順利完成,請檢查 plugins_root/logs 目錄中的日誌。
請更正任何問題,並重新配置。
- 僅限 Domino Web 伺服器:設定 WAS_PLUGIN_CONFIG_FILE 環境變數。
在像是 AIX 或 Linux 的平台中,尋找母項 Shell 的 Script 來源可讓子程序繼承匯出的變數。
在 Windows 系統中,請依照您執行任何其他指令的方式來執行 Script。在 Windows 系統中,尋找來源會自動執行。
- 開啟指令視窗。
- 將目錄切換至外掛程式安裝根目錄。
- 對 plugins_root/bin/setupPluginCfg.sh Script 發出適當的指令:
. plugins_root/bin/setupPluginCfg.sh(請注意句點和安裝根目錄之間的空格。)
source plugins_root/bin/setupPluginCfg.sh
該 Script 也位於像是 AIX 或 Linux 作業系統的 lotus_root/notesdata 目錄中。
請先對該 Script 發出適當的指令,再啟動 Domino Web 伺服器。
- 啟動 Snoop Servlet 來驗證 Web 伺服器從應用程式伺服器擷取應用程式的功能。
啟動應用程式伺服器、Web 伺服器,並使用含 IP 位址的 Snoop Servlet 來測試環境。
- 啟動應用程式伺服器。 在「網路部署」環境中,只有當您在將應用程式伺服器加入 Cell 中時有包含 DefaultApplication,才可在 Cell 中使用 Snoop Servlet。addNode 指令的 -includeapps 選項會將 DefaultApplication 移轉到 Cell。
如果應用程式不存在,請跳過這個步驟。
切換至
profile_root/bin 目錄,然後執行
startServer 指令:
![[AIX]](../images/aixlogo.gif)
./startServer.sh server1
startServer server1
startServer server1
- 啟動 IBM HTTP
Server 或您所使用的 Web 伺服器。
使用 2001 頁面或使用 STRTCPSVR
SERVER(*HTTP) HTTPSVR(instance_name ) 指令來啟動 IBM HTTP Server。
請利用指令視窗,來切換至 IBM HTTP Server 安裝映像檔或 Web 伺服器安裝映像檔的目錄。請發出適當的指令來啟動 Web 伺服器,例如下列 IBM HTTP Server 的指令:
如果要從指令行啟動 IBM HTTP Server,請執行下列動作:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
存取
IBMHttpServer/bin 目錄中的
apache 和
apachectl 指令。
- 將瀏覽器指向 http://localhost:9080/snoop,測試應用程式伺服器提供的內部 HTTP 傳輸。
將瀏覽器指向 http://Host_name_of_Web_server_machine/snoop,以測試 Web 伺服器外掛程式。
依預設,HTTP 傳輸埠是 9080,且對每一個設定檔而言都必須是唯一的。這個埠和名稱為 default_host 的虛擬主機相關聯,配置成控管已安裝的 DefaultApplication。
Snoop Servlet 是 DefaultApplication 的一部分。請變更這個埠,以符合實際的 HTTP 傳輸埠。
- 驗證 Snoop 在執行中。
任一個網址都應該會顯示「Snoop Servlet - 要求/用戶端資訊」頁面。
提示: 萬一驗證失敗,而出現 HTTP 錯誤碼 500,請移至 IIS 管理員 > 預設網站 > sePlugins。按一下滑鼠右鍵,然後選擇編輯許可權。按一下共用標籤,並選擇與每一個人共用(許可權層次:讀取/寫入)。
- 僅限遠端 IBM HTTP
Server:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
利用以下步驟,驗證自動傳播功能可以在遠端 IBM HTTP Server 上運作。
這個程序對本端 Web 伺服器並不需要。
- 在 IHS_root /conf/admin.passwd 檔中,建立 user=adminUser,password=adminPassword。
例如:c:\ws\ihs80\bin\htpasswd -cb c:\ws\ihs80\conf\admin.passwd
adminUser adminPassword
- 利用部署管理程式或應用程式伺服器的管理主控台,輸入您為 IBM HTTP Server 的管理使用者所建立的使用者 ID 和密碼資訊。移至伺服器 > Web 伺服器 > web_server_definition > 遠端 Web 伺服器管理。
設定下列值:管理埠=8008,使用者 ID=adminUser,密碼=adminPassword。
- 設定 httpd.conf 以及 plugin-cfg.xml 兩個檔案的正確讀寫權。
請參閱 IHS_root /logs/admin_ERROR.
LOG 檔,以取得相關資訊。
如果要自動傳播外掛程式配置檔,IBM HTTP 管理伺服器必須已經啟動且在執行中。如果您是使用 WebSphere Application Server 管理主控台來管理 IBM HTTP Server,可能會顯示下列錯誤訊息:
「無法連接至 IHS 管理伺服器錯誤」
請執行下列程序,更正錯誤:
- 驗證 IBM HTTP
Server 管理伺服器在執行中。
- 驗證 WebSphere Application Server 管理主控台中定義的 Web 伺服器主機名稱和埠號,符合 IBM HTTP Server 管理主機名稱和埠號。
- 確認防火牆不會讓您無法從 WebSphere Application
Server 管理主控台存取 IBM HTTP Server 管理伺服器。
- 確認已在 admin.passwd 檔中,使用 htpasswd 指令建立了
WebSphere Application Server 管理主控台中所指定的、受遠端管理的使用者 ID 和密碼。
- 如果希望進行安全連線,請確認已將 IBM HTTP Server 管理伺服器的 keydb 個人憑證,匯出至 WebSphere Application Server 金鑰資料庫,作為簽章者憑證。這個金鑰資料庫是在管理主控台執行所在的設定檔之 sas.client.props 檔中,以 com.ibm.ssl.trustStore 指引指定。這項考量主要是針對自簽憑證。
- 如果仍然有問題,請查看 IBM HTTP Server admin_ERROR.LOG
檔和 WebSphere Application Server 日誌(trace.log 檔),來判斷發生問題的原因。
- 配置要聯合至部署管理程式 Cell 的應用程式伺服器。
註: 下列程序說明將外掛程式安裝在兩部機器上。不過,您可以在單一機器上執行這項程序。
下列拓蹼被視為本端分散式拓蹼,因為它涉及 Cell:

程序的這個部分會假設您已在兩部機器上安裝 Installation Manager 和 Network Deployment 產品。此外,會假設您已在機器 A 上配置部署管理程式設定檔,在機器 B 上配置應用程式伺服器設定檔。
如果您打算將應用程式伺服器節點加入部署管理程式 Cell 中,但尚未完成,請先啟動部署管理程式並聯合節點,再配置外掛程式。您不能將含有 Web 伺服器定義的應用程式伺服器加入部署管理程式 Cell 中。
聯合應用程式伺服器上的 Web 伺服器定義,會安裝在該應用程式伺服器相同的受管理節點上。存在一個節點,但它有兩項伺服器程序,分別是應用程式伺服器和 Web 伺服器定義。
如果您正在安裝外掛程式,以便與聯合應用程式伺服器搭配使用,請啟動部署管理程式。請驗證受管理節點上的節點代理程式程序也在執行中。部署管理程式和節點代理程式都必須正在執行,才能順利配置受管理節點。
- 使用 Installation Manager,將下列項目安裝在機器 B 上。
- WebSphere Application Server 的 Web 伺服器外掛程式
- Websphere Customization Toolbox
- 在機器 B 上,使用 Installation Manager 來安裝 IBM HTTP Server 或另一部受支援的 Web 伺服器。
- 在機器 B 上,開啟 WebSphere Customization
Toolbox,並且啟動「Web 伺服器外掛程式配置工具」。
- 選取 Web 伺服器外掛程式執行時期的位置。
如果您想使用先前的 Web 伺服器外掛程式安裝位置,但卻不在清單中,請執行下列動作,將該位置新增至工作集:
- 按一下新增。
- 輸入 Web 伺服器外掛程式位置的名稱。
- 請執行下列其中一個動作:
- 輸入位置。
- 按一下瀏覽,尋找位置,然後按一下確定。
- 按一下建立。
- 選取您要配置的 Web 伺服器類型,然後按下一步。
- 選取已安裝之目標 Web 伺服器的架構(64 位元或 32 位元),並按下一步。
- 按一下瀏覽以選取 Web 伺服器的配置檔,確認 Web 伺服器埠是正確的,完成時按下一步。
請選取檔案,而不是只選取檔案的目錄。某些 Web 伺服器有兩個配置檔,因此需要您瀏覽每一個檔案。
下列清單顯示受支援之 Web 伺服器的配置檔:
- Apache HTTP Server
- apache_root/config/httpd.conf
- Domino Web 伺服器
- names.nsf 和 Notes.jar
精靈會提示您使用 notes.jar 檔,但實際的名稱是 Notes.jar。
「Web 伺服器外掛程式配置工具」會確認檔案存在,但此工具並不會驗證任一個檔案。
- IBM HTTP Server
IHS_root/conf/httpd.conf
IHS_profile_root/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- 「Web 伺服器外掛程式配置工具」可判斷出正確的檔案,以用來進行編輯。
註: 最佳作法是在 IIS 7 上使用 32 位元外掛程式。
- Sun Java System Web Server(早期為 Sun ONE Web Server 和 iPlanet Web Server)6.0 版以及更新版本
- obj.conf 和 magnus.conf
- 指定 Web 伺服器定義的唯一名稱,並按下一步。
- 選取配置實務。
- 選擇本端實務。
- 請執行下列其中一個動作:
- 輸入 WebSphere Application Server 的安裝位置 (app_server_root)。
- 按一下瀏覽,尋找 WebSphere Application Server 的安裝位置
(app_server_root),並按一下確定。
- 按下一步。
- 選取要配置成使用現行 Web 伺服器外掛程式的設定檔,並按下一步。
- 檢閱摘要資訊,並按一下配置,開始配置 Web 伺服器、Web 伺服器外掛程式和應用程式伺服器設定檔。
- 在摘要畫面中,驗證安裝成功,並按一下完成。
如果發生問題且安裝未順利完成,請檢查 plugins_root/logs 目錄中的日誌。
請更正任何問題,並重新配置。
- 複製 configureweb_server_name Script,並貼到機器 A 上。
- 在機器 A 上,建立 Web 伺服器定義。
您可以使用部署管理程式的管理主控台,在聯合節點上建立 Web 伺服器定義;或者,您可以執行「Web 伺服器外掛程式配置工具」所建立的配置 Script。
該 Script 已包含在使用管理主控台選項時,您必須收集的所有資訊。
- 從部署管理程式的管理主控台中,按一下系統管理 > 儲存主儲存庫的變更 > 與節點同步變更 > 儲存。
- 僅限 Domino Web 伺服器:設定 WAS_PLUGIN_CONFIG_FILE 環境變數。
在像是 AIX 或 Linux 的平台中,尋找母項 Shell 的 Script 來源可讓子程序繼承匯出的變數。
在 Windows 系統中,請依照您執行任何其他指令的方式來執行 Script。在 Windows 系統中,尋找來源會自動執行。
- 啟動 Snoop Servlet。
如需完整程序,請參閱獨立式應用程式伺服器的 Snoop 程序。
結果
安裝 Web 伺服器外掛程式會建立
Plugins 目錄和一些子目錄。比方說,以下是在 Linux 系統上建立的一些目錄:
- plugins_root/bin/32bits 或 plugins_root/bin/64bits 包含所有受支援之 Web 伺服器的二進位外掛程式
- plugins_root/logs 含有日誌檔
- plugins_root/properties 含有版本資訊
除非 Web 伺服器定義已存在,否則「Web 伺服器外掛程式配置工具」會在應用程式伺服器設定檔內建立一項。
「Web 伺服器外掛程式配置工具」會將 Web 伺服器配置成使用
profile_root/plugin-cfg.xml 檔。
只要發生的事件會影響 Web 伺服器外掛程式配置檔
plugin-cfg.xml,應用程式伺服器就會重新產生該檔案。這類事件包括新增或移除應用程式、伺服器或虛擬主機。獨立式應用程式伺服器會在下列位置中重新產生檔案:
profile_root
/config/cells/cell_name/nodes/
web_server_name_node/servers/
web_server_name/plugin-cfg.xml
在聯合節點中,如果建立或移除叢集和叢集成員,也會重新產生檔案。部署管理程式會在下列位置中,為聯合應用程式伺服器重新產生檔案:
profile_root
/config/cells/cell_name/nodes/
node_name_of_AppServer/servers/
web_server_name/plugin-cfg.xml
下一步
在配置本端 Web 伺服器的外掛程式之後,即可立即啟動獨立式應用程式伺服器和 Web 伺服器。在您啟動伺服器之後,請開啟應用程式伺服器的管理主控台,並儲存已變更的配置。
在配置本端 Web 伺服器的外掛程式之後,您可以在執行用來完成配置的 Script 之後,啟動聯合應用程式伺服器和 Web 伺服器。開啟部署管理程式的管理主控台。等待將節點同步化。儲存已變更的配置
(其中含有新的 Web 伺服器定義)。
請參閱選取 Web 伺服器拓蹼圖和導覽圖,以取得安裝程序的概觀。
如需外掛程式配置檔位置的相關資訊,請參閱外掛程式配置。
如需配置 Web 伺服器時所涉及之檔案的相關資訊,請參閱 Web 伺服器配置。
如需「Web 伺服器外掛程式配置工具」如何配置支援的 Web 伺服器的相關資訊,請參閱編輯 Web 伺服器配置檔。
如需安裝 Web 伺服器外掛程式的其他安裝實務相關資訊,請參閱配置 Web 伺服器外掛程式。