這項程序說明如何在預設設定檔是一個自訂設定檔的機器上,安裝 Web 伺服器和其外掛程式。
開始之前
若有多份設定檔存在時,您可以選取「Web 伺服器外掛程式配置工具」配置的設定檔。有關決定如何選取所要配置之設定檔的邏輯流程的說明,請參閱外掛程式配置。
若有多份設定檔存在時,您可以選取「Web 伺服器外掛程式配置工具」配置的設定檔。有關決定如何選取所要配置之設定檔的邏輯流程的說明,請參閱外掛程式配置。
這項程序是在機器 B 上配置自訂設定檔。
這項程序會假設您已在機器 A 上安裝部署管理程式。
機器 B 上的 WebSphere® Application Server 節點是您在這項程序中建立的自訂節點。這項程序會先啟動部署管理程式,並聯合自訂節點,然後再安裝「Web 伺服器外掛程式」。
啟動部署管理程式。部署管理程式必須正在執行,才能順利聯合和配置自訂節點。
關於這項作業
註: 這個主題參照一或多個應用程式伺服器日誌檔。
此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.log、SystemErr.log, trace.log 及 activity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
請利用這項程序,來安裝 Web 伺服器外掛程式、配置 Web 伺服器,以及在自訂設定檔(自訂節點)中建立 Web 伺服器定義。
支援的配置: 只有在 AIX®、Linux 和 Windows 上,才支援此工具。除了使用「Web 伺服器外掛程式配置工具」,您也可以改用 pct 指令行工具與回應檔來配置 Web 伺服器。
如需相關資訊,請參閱
使用 pct 工具來配置 Web 伺服器外掛程式。
sptcfg
程序
- 登入作業系統。
如果您要以非 root 或非管理使用者的身分進行安裝,則有某些限制。
![[Windows]](../images/windows.gif)
在 Windows 作業系統上以管理使用者的身分進行安裝時,會自動建立 Windows 服務以自動啟動應用程式伺服器。安裝者的使用者帳戶必須具有下列的進階使用者權限:
比方說,在某些 Windows 作業系統中,按一下
控制台 > 系統管理工具 > 本機安全性原則 > 本機原則
> 使用者權限指派來設定進階選項。
如需相關資訊,請參閱 Windows 作業系統文件。
如果您打算將應用程式伺服器當作 Windows 服務執行,請勿從包含空格的使用者 ID 進行安裝。系統無法驗證含有空格的使用者 ID。
這類使用者 ID 不允許繼續進行安裝作業。要暫行解決這項限制,請以不含空格的使用者 ID 進行安裝。
- 使用 Installation Manager,將下列項目安裝在機器 B 上。
- WebSphere Application Server Network Deployment
- WebSphere Application Server 的 Web 伺服器外掛程式
- Websphere Customization Toolbox
- 在機器 B 上,使用 Installation Manager 來安裝 IBM HTTP Server 或另一部受支援的 Web 伺服器。
- 建立自訂設定檔,作為機器 B 上的第一個設定檔,並在您建立設定檔時聯合節點。
- 選擇性的: 使用部署管理程式的管理主控台,在自訂節點上建立應用程式伺服器。
按一下伺服器
> 應用程式伺服器 > 新建,並遵循指示來建立伺服器。安裝外掛程式時,並不需要伺服器,但它可讓您驗證 Web 伺服器的功能。
- 選擇性的: 在部署管理程式的管理主控台中,將 DefaultApplication 安裝在新的伺服器上。
DefaultApplication 含有 Snoop Servlet。驗證步驟會使用 Snoop Servlet。
- 在機器 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 伺服器外掛程式配置工具」可判斷出正確的檔案,以用來進行編輯。
- 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 目錄中的日誌。
請更正任何問題,並重新配置。
- 在機器 A 上,建立 Web 伺服器定義。
您可以使用部署管理程式的管理主控台,在聯合節點上建立 Web 伺服器定義;或者,您可以執行「Web 伺服器外掛程式配置工具」所建立的配置 Script。
該 Script 已包含在使用管理主控台選項時,您必須收集的所有資訊。
僅限 Domino Web 伺服器:設定 WAS_PLUGIN_CONFIG_FILE 環境變數。 在像是 AIX 或 Linux 的平台中,尋找母項 Shell 的 Script 來源可讓子程序繼承匯出的變數。
在 Windows 系統中,請依照您執行任何其他指令的方式來執行 Script。在 Windows 系統中,尋找來源會自動執行。
- 開啟指令視窗。
- 將目錄切換至外掛程式安裝根目錄。
- 對 plugins_root/bin/setupPluginCfg.sh Script 發出適當的指令:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
. 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 來測試環境。
- 啟動應用程式伺服器。 在 Network Deployment 環境中,只有當您在將應用程式伺服器加入 Cell 中時有包含 DefaultApplication,才可在 Cell 中使用 Snoop Servlet。addNode 指令的 -includeapps 選項會將 DefaultApplication 移轉到 Cell。
如果應用程式不存在,請跳過這個步驟。
- 啟動 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 - 要求/用戶端資訊」頁面。
- 僅限遠端 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\ihs85\bin\htpasswd -cb c:\ws\ihs85\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 檔),來判斷發生問題的原因。
- 如果部署管理程式沒有安裝 DefaultApplication,您可以使用自己的應用程式,來測試 Web 伺服器和自訂節點的功能。
- 從部署管理程式的管理主控台中,按一下系統管理 > 儲存主儲存庫的變更 > 與節點同步變更 > 儲存。
- 如果要為受管理節點建立多項 Web 伺服器定義,請使用「Web 伺服器外掛程式配置工具」來配置每一部 Web 伺服器。
每次都要識別相同的受管理節點。提供不同的暱稱給每一部 Web 伺服器。
結果
執行這項程序之後,您已將 WebSphere Application Server 的 Web 伺服器外掛程式安裝在 Web 伺服器機器上。「Web 伺服器外掛程式配置工具」會將
Web 伺服器定義建立在受管理節點內。
「Web 伺服器外掛程式配置工具」會將 Web 伺服器配置成使用位於受管理自訂節點內的
plugin-cfg.xml 檔。
只要發生的事件會影響 Web 伺服器外掛程式配置檔 plugin-cfg.xml,部署管理程式就會重新產生該檔案。這類事件包括新增或移除應用程式、伺服器或虛擬主機。
如果建立或移除叢集和叢集成員,也會重新產生檔案。在每次重新產生之後,會藉由節點同步化來自動傳播,以便將檔案複製到自訂節點機器上的下列位置:
profile_root
/config/cells/cell_name/nodes/
node_name_of_custom_profile/servers/
web_server_name/plugin-cfg.xml
安裝 Web 伺服器外掛程式會建立
Plugins 目錄和一些子目錄。比方說,以下是在 Linux 系統上建立的一些目錄:
- plugins_root/bin/32bits 或 plugins_root/bin/64bits 包含所有受支援之 Web 伺服器的二進位外掛程式
- plugins_root/logs 含有日誌檔
- plugins_root/properties 含有版本資訊
下一步
如需外掛程式配置檔位置的相關資訊,請參閱外掛程式配置。
如需配置 Web 伺服器時所涉及檔案的相關資訊,請參閱Web 伺服器配置。
如需「Web 伺服器外掛程式配置工具」如何配置支援的 Web 伺服器的相關資訊,請參閱編輯 Web 伺服器配置檔。
如需安裝 Web 伺服器外掛程式的其他安裝實務相關資訊,請參閱配置 Web 伺服器外掛程式。