實作 Web 伺服器外掛程式

這個主題說明如何實作 Web 伺服器外掛程式。 本產品會利用 Web 伺服器來遞送 Web 應用程式發出的動態內容要求，如 Servlet。 將瀏覽器的資料流量導向執行於應用程式伺服器的應用程式時，需要 Web 伺服器。 Web 伺服器外掛程式會利用 XML 配置檔，來判斷要求是否針對應用程式伺服器而提出。

關於這項作業

已安裝適當的外掛程式檔。 此外，還會建立 http 設定檔 (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http)。 http 設定檔可用來協助建立 Web 伺服器定義。 請參閱有關選取 Web 伺服器拓蹼圖及導覽圖的主題，以取得如何配置 IBM HTTP Server for IBM i 以與應用程式伺服器通訊的指示。

以下是外掛程式安裝程序所執行的步驟。 請參閱外掛程式安裝導覽圖，以取得其他資訊。

1. 建立 Web 伺服器定義。

   您也可以使用管理主控台或 ConfigurewebServerDefinition.jacl Script 來建立 Web 伺服器定義。

2. 應用程式或模組會對映至 Web 伺服器。 如果要與這部 Web 伺服器搭配使用的應用程式已安裝，則該應用程式會自動對映至 Web 伺服器。 如果未安裝應用程式，請在應用程式安裝程序的 將模組對映至伺服器 步驟期間選取此 Web 伺服器。
3. 會更新和儲存主要儲存庫。

當您配置外掛程式時，會自動建立這個外掛程式的配置檔。 您可以變更或調整這個配置檔中的內容預設值。 只要您變更任何設定，就必須重新產生這個檔案，變更才會生效。

產生或重新產生配置檔可能需要一會兒才能完成。 完成之後，管理 Cell 中的所有物件都會使用 Web 伺服器能夠存取的最新設定。 如果應用程式伺服器是在 Web 伺服器的相同實體工作站中，通常需要 30 至 60 秒才能重新產生完成。 如果應用程式伺服器和 Web 伺服器在不同的工作站上，重新產生需要更長的時間。

下列程序說明更新外掛程式配置檔的步驟，其中包括 SSL 和 Web 伺服器的調整配置。

1. 請利用管理主控台，來變更外掛程式配置檔中的設定。
   在設定 Web 伺服器外掛程式時，您必須決定是否要自動產生配置，來回應配置變更。 當啟用 Web 伺服器外掛程式配置服務，且出現下列任何情況時，就會自動產生外掛程式配置檔：

   • 建立或儲存 Web 伺服器時
   • 安裝應用程式時
   • 解除安裝應用程式時
   • 更新虛擬主機定義時

   避免麻煩: 當第一次產生外掛程式配置檔時，它不會在虛擬主機清單中包含 admin_host。 有關容許 Web 伺服器存取管理主控台的資訊，會說明如何將它新增至清單。

   您可以使用管理主控台，或發出 GenPluginCfg 指令來重新產生您的 plugin-cfg.xml 檔。

   請利用管理主控台，完成下列步驟來重新產生您的 plugin-cfg.xml 檔：

   1. 選取 伺服器 > 伺服器類型 > Web 伺服器 > web_server_name > 外掛程式 內容。
   2. 選取 自動產生外掛程式配置檔，或按下列一或多個主題來手動配置 plugin-cfg.xml 檔:
      避免麻煩: 請勿手動更新 plugin-cfg.xml 檔。 每當重新產生 Web 伺服器的 plugin-cfg.xml 檔時，都會置換這個 Web 伺服器的任何手動更新。
   3. 按一下 確定。
   4. 延伸外掛程式配置。
      如果要從管理主控台傳播外掛程式配置，請按一下 伺服器 > 伺服器類型 > Web 伺服器web_server_name延伸外掛程式。

      另一個配置傳播外掛程式的方法是執行 GenPluginCfg 指令。 如需相關資訊，請參閱 GenPluginCfg 指令說明文件。

      如果 Web 伺服器位於產品相關聯獨立式版本的相同機器上，就不需要傳播外掛程式配置。 如果傳送外掛程式配置失敗且原因不明，您必須用手動方式將 plugin-cfg.xml 檔複製到遠端 Web 伺服器的安裝位置。

      避免麻煩: 如果您使用 FTP 功能來執行複製，且配置重新載入失敗，請檢查 plugin-cfg.xml 檔的檔案權限，並確定使用者 QTMHHTTP、QNOTES 及 QEJBSVR 具有 RWX 權限。 如果權限不正確，Web 伺服器就無法存取新版本的檔案，而導致重新載入配置失敗。 若要檢查權限，請執行下列 IBM i 指令:

      wrklnk 'plug_in_folder_location/plugin-cfg.xml' 

      然後選取選項 9，檢視指派給使用者（QTMHHTTP、QNOTES 和 QEJBSVR）的權限。

      如果權限不正確，請發出下列 IBM i 指令，將檔案權限變更為適當的設定:

      CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('plug_in_folder_location/plugin-cfg.xml') DTAAUT(*RWX)

      plug_in_folder_location 是您傳送 plugin-cfg.xml 檔時所指定的位置。
   5. 您可能必須停止應用程式伺服器，然後啟動應用程式伺服器， Web 伺服器才能找到 plugin-cfg.xml 檔。
2. 調整 Web 伺服器。
   如需相關資訊，請參閱有關調整 Web 伺服器的頁面。
3. 延伸外掛程式配置。
   如果啟用 Web 伺服器外掛程式配置服務，且出現下列狀況之一，就會自動將外掛程式配置檔 plugin-cfg.xml 傳播至 Web 伺服器：

   • Web 伺服器是本端 Web 伺服器，也就是說，Web 伺服器和應用程式伺服器位於相同的工作站。
   • Web 伺服器是遠端 IBM HTTP Server 第 7 版，具有執行中 IBM HTTP Server 管理伺服器。

   如果兩個條件都不符合，您必須將 plugin-cfg.xml 檔手動複製到遠端 Web 伺服器的安裝位置。 將 <app_server_root>/profiles/<profilename>/config/cells/../../nodes/../servers/<webservername> 中的 plugin-cfg.xml 檔複製到 Web 伺服器主機位置，即 <PluginInstallRoot>/config/<webservername>/。

   重要事項: 如果您使用 FTP 功能來複製檔案，且配置重新載入失敗，請檢查 plugin-cfg.xml 檔案的檔案許可權，並確定它們已設為 rw-r--r--。 如果檔案許可權不正確，Web 伺服器就無法存取新版的檔案，而造成配置重新載入失敗。

   如果檔案許可權不正確，請發出下列指令，將檔案許可權變更為適當的設定：

   chmod 644 plugin-cfg.xml

   AIX® FTP 功能不會保留檔案屬性。 因此，如果您需要從 AIX 作業系統手動複製 plugin-cfg.xml ，您可能想要使用 AIX RCP 功能而非 FTP 功能來複製檔案。

4. 將金鑰儲存庫檔複製到 Web 伺服器的金鑰儲存庫目錄。
   避免麻煩: Web 伺服器必須執行此步驟，才能正常運作。

   如需有關複製金鑰儲存庫檔的詳細指示，請閱讀有關配置 Web 伺服器外掛程式使用 Secure Sockets Layer 的主題。