# Web Application Server Network Deployment 的 Web 伺服器外掛程式安裝導覽圖

開始使用
外掛程式安裝導覽圖：

1. 獨立式應用程式伺服器的 Web 伺服器外掛程式安裝作業
2. 分散式環境的 Web 伺服器外掛程式安裝作業

## 獨立式應用程式伺服器的 Web 伺服器外掛程式安裝作業

| 遠端安裝實務 | 本端安裝實務
## 典型環境 | # 正式作業（建議） | # 開發
## 安裝與配置 |
安裝應用程式伺服器：
（A 機器）
1. | 安裝 IBM Installation Manager。
2. | 使用 Installation Manager 安裝 WebSphere Application Server Network Deployment 產品。
3. | 建立獨立式應用程式伺服器。
安裝 Web 伺服器和 Web 伺服器外掛程式：
（B 機器）
4. | 安裝 IBM Installation Manager。
5. | 使用 Installation Manager 安裝 IBM HTTP Server，或安裝另一部支援的 Web 伺服器。
6. | 使用 Installation Manager 安裝 WebSphere Application Server Web 伺服器外掛程式。
配置 Web 伺服器外掛程式：
（B 機器）
7. | 使用 Installation Manager 安裝 WebSphere 自訂工具。
8. | 開啟「WebSphere 自訂工具」，並啟動「Web 伺服器外掛程式配置工具」， 來配置 Web 伺服器外掛程式。 用來建立和配置 Web 伺服器的 Script 建立於 plugins_root`/bin` 目錄中。
9. | 複製 Web_server_name 配置 Script，並貼到 A 機器 上。 若為下列情況，請參閱這份文件的「跨平台考量」一節， 取得執行配置 Script 的相關資訊： 有一部機器執行 Windows，其他機器執行 Linux 或 UNIX。 有一部機器執行不同的檔案編碼。
建立 Web 伺服器定義：
（A 機器）
10. | 將 `configureWeb_server_name` Script 從 B 機器貼到 A 機器上的 app_server_root`/bin` 目錄
11. | 在 A 機器上啟動應用程式伺服器。
12. | 在 A 機器上執行 Script。
驗證：
（A 機器）
13. | 驗證應用程式伺服器正在執行。
（B 機器）
14. | 啟動 IBM HTTP Server，或啟動另一部支援的 Web 伺服器。
15. | 執行「探查」Servlet。
| 如果要利用您自己的應用程式來驗證， 請在配置（安裝）應用程式之後，重新產生和延伸 `plugin-cfg.xml` 檔。
安裝應用程式伺服器：
（A 機器）
1. | 安裝 IBM Installation Manager。
2. | 使用 Installation Manager 安裝 WebSphere Application Server Network Deployment 產品。
3. | 建立獨立式應用程式伺服器。
安裝 Web 伺服器和 Web 伺服器外掛程式：
（A 機器）
4. | 使用 Installation Manager 安裝 IBM HTTP Server，或安裝另一部支援的 Web 伺服器。
5. | 使用 Installation Manager 安裝 WebSphere Application Server Web 伺服器外掛程式。
配置 Web 伺服器外掛程式，並建立 Web 伺服器定義：
（A 機器）
6. | 使用 Installation Manager 安裝 WebSphere 自訂工具。
7. | 開啟「WebSphere 自訂工具」，並啟動「Web 伺服器外掛程式配置工具」， 來配置 Web 伺服器外掛程式，並建立 Web 伺服器定義。
8. | 啟動應用程式伺服器。
驗證：
（A 機器）
9. | 驗證應用程式伺服器正在執行。
10. | 啟動 IBM HTTP Server，或啟動另一部支援的 Web 伺服器。
11. | 執行「探查」Servlet。
## 重新產生 `plugin-cfg.xml` 檔 | 在配置期間，會將 `plugin-cfg.xml` 暫存檔安裝在 B 機器的 plugins_root`/config/Web_server_name` 目錄中。 Web 伺服器外掛程式的配置服務會自動重新產生 `plugin-cfg.xml` 檔。 如果要使用應用程式伺服器中的實際 `plugin-cfg.xml` 檔，請按照下一節的說明， 來延伸 `plugin-cfg.xml` 檔。 | Web 伺服器外掛程式的配置服務會自動重新產生 `plugin-cfg.xml` 檔。 在您建立 Web 伺服器定義時，會在 profile_root `/config/cells/cell_name/nodes/node_name/servers/Web_server_name` 目錄位置中產生 `plugin-cfg.xml` 檔。
## 延伸 `plugin-cfg.xml` 檔 | Web 伺服器外掛程式配置服務只會針對 IBM HTTP Server，自動延伸 `plugin-cfg.xml` 檔。如果要啟用自動延伸， 請執行單次設定。 對於其他的 Web 伺服器， 若要延伸外掛程式配置檔，請手動將 `plugin-cfg.xml` 檔從 A 機器上的 profile_root `/config/cells/cell_name/nodes/node_name/servers/ web_server_name` 目錄，複製到 B 機器上的 `plugins_root/config/web_server_name` 目錄。 | 使用延伸選項，將 `plugin-cfg.xml` 檔從 profile_root/config/cells/cell_name /nodes/node_name/servers/Web_server_name 目錄移至 plugins_root/config/web_server_name 目錄。

### 遠端拓蹼 | ### 本端拓蹼

# 分散式環境 (Cell) 的 Web 伺服器外掛程式安裝作業
| 遠端分散式安裝實務 | 本端分散式安裝實務
## 典型環境 | # 正式作業（建議） | # 開發
## 安裝與配置 |
安裝部署管理程式：
（A 機器）
1. | 安裝 IBM Installation Manager。
2. | 使用 Installation Manager 安裝 WebSphere Application Server Network Deployment 產品。
3. | 建立部署管理程式設定檔。
4. | 驗證部署管理程式正在執行，以便讓節點與已變更的配置檔取得同步。
安裝應用程式伺服器：
（B 機器）
5. | 安裝 IBM Installation Manager。
6. | 使用 Installation Manager 安裝 WebSphere Application Server Network Deployment 產品。
7. | 建立獨立式應用程式伺服器。
8. | 將節點新增至部署管理程式 Cell，以啟動節點代理程式程序。在現有的受管理節點上啟動節點代理程式。部署管理程式和節點代理程式必須正在執行， 以便讓節點與已變更的配置檔取得同步。
安裝 Web 伺服器和 Web 伺服器外掛程式：
（C 機器）
9. | 安裝 IBM Installation Manager。
10. | 使用 Installation Manager 安裝 IBM HTTP Server，或安裝另一部支援的 Web 伺服器。
11. | 使用 Installation Manager 安裝 WebSphere Application Server Web 伺服器外掛程式。
配置 Web 伺服器外掛程式：
（C 機器）
12. | 使用 Installation Manager 安裝 WebSphere 自訂工具。
13. | 開啟「WebSphere 自訂工具」，並啟動「Web 伺服器外掛程式配置工具」， 來配置 Web 伺服器外掛程式。 用來建立和配置 Web 伺服器的 Script 建立於 plugins_root`/bin` 目錄中。
14. | 複製 Web_server_name 配置 Script，並貼到 A 機器 上。 若為下列情況，請參閱這份文件的「跨平台考量」一節， 取得執行配置 Script 的相關資訊： 有一部機器執行 Windows，其他機器執行 Linux 或 UNIX。 有一部機器執行不同的檔案編碼。
建立 Web 伺服器定義：
（A 機器）
15. | 從 C 機器貼上 Web_server_name 配置 Script 到 A 機器上的 app_server_root `/bin` 目錄。
16. | 從指令行執行 Script。 這個步驟需要部署管理程式和節點代理程式正在執行。 如果您已啟用安全或變更預設 JMX 連接器類型， 請編輯 Script，並包含適當的參數。
驗證：
（A 和 B 機器）
17. | 在 A 機器上使用部署管理程式的管理主控台， 啟動 B 機器上的應用程式伺服器。
（C 機器）
18. | 啟動 IBM HTTP Server，或啟動另一部支援的 Web 伺服器。
19. | 執行「探查」Servlet。
附註：下列程序說明在兩部機器上安裝外掛程式。不過， 您可以在單一機器上執行這項程序。
安裝部署管理程式：
（A 機器）
1. | 安裝 IBM Installation Manager。
2. | 使用 Installation Manager 安裝 WebSphere Application Server Network Deployment 產品。
3. | 建立部署管理程式設定檔。
4. | 驗證部署管理程式正在執行，以便讓節點與已變更的配置檔取得同步。
安裝應用程式伺服器：
（B 機器）
5. | 安裝 IBM Installation Manager。
6. | 使用 Installation Manager 安裝 WebSphere Application Server Network Deployment 產品。
7. | 建立獨立式應用程式伺服器。
8. | 將節點新增至部署管理程式 Cell，以啟動節點代理程式程序。在現有的受管理節點上啟動節點代理程式。部署管理程式和節點代理程式必須正在執行， 以便讓節點與已變更的配置檔取得同步。
安裝 Web 伺服器和 Web 伺服器外掛程式：
（B 機器）
9. | 使用 Installation Manager 安裝 IBM HTTP Server，或安裝另一部支援的 Web 伺服器。
10. | 使用 Installation Manager 安裝 WebSphere Application Server Web 伺服器外掛程式。
配置 Web 伺服器外掛程式：
（B 機器）
11. | 使用 Installation Manager 安裝 WebSphere 自訂工具。
12. | 開啟「WebSphere 自訂工具」，並啟動「Web 伺服器外掛程式配置工具」， 來配置 Web 伺服器外掛程式，並建立 Web 伺服器定義。 用來建立和配置 Web 伺服器的 Script 建立於 plugins_root`/bin` 目錄中。
13. | 複製 Web_server_name 配置 Script，並貼到 A 機器 上。 若為下列情況，請參閱這份文件的「跨平台考量」一節， 取得執行配置 Script 的相關資訊： 有一部機器執行 Windows，其他機器執行 Linux 或 UNIX。 有一部機器執行不同的檔案編碼。
建立 Web 伺服器定義：
（A 機器）
14. | 從 B 機器貼上 Web_server_name 配置 Script 到 A 機器上的 app_server_root `/bin` 目錄。
15. | 從指令行執行 Script。 這個步驟需要部署管理程式和節點代理程式正在執行。 如果您已啟用安全或變更預設 JMX 連接器類型， 請編輯 Script，並包含適當的參數。
驗證：
（A 和 B 機器）
16. | 在 A 機器上使用部署管理程式的管理主控台， 啟動 B 機器上的應用程式伺服器。
17. | 啟動 IBM HTTP Server，或啟動另一部支援的 Web 伺服器。 在 Linux 或 UNIX 系統上啟動 Domino Web 伺服器之前， 請提供 plug-ins_root`/setupPluginCfg.sh` Script。
18. | 執行「探查」Servlet。
## 重新產生 `plugin-cfg.xml` 檔 | 在配置期間，會將 `plugin-cfg.xml` 暫存檔安裝在 C 機器的 plugins_root`/config/Web_server_name` 目錄中。 Web 伺服器外掛程式的配置服務會自動重新產生 `plugin-cfg.xml` 檔。 如果要使用應用程式伺服器中的實際 `plugin-cfg.xml` 檔，請按照下一節的說明， 來延伸 `plugin-cfg.xml` 檔。 | 在您建立 Web 伺服器定義時，會在 profile_root `/config/cells/cell_name/nodes/node_name/servers/Web_server_name` 目錄中產生 `plugin-cfg.xml` 檔。 每當配置變更時， 就會在應用程式伺服器的 Web 伺服器定義中重新產生 `plugin-cfg.xml` 檔。只要重新產生檔案， Web 伺服器立即具備檔案的存取權。 當在 A 機器上啟用 Web 伺服器外掛程式配置服務（一種管理服務）時， 會自動針對所有 Web 伺服器產生 `plugin-cfg.xml` 檔。
## 延伸 `plugin-cfg.xml` 檔 | Web 伺服器外掛程式配置服務只會針對 IBM HTTP Server，自動延伸 `plugin-cfg.xml` 檔。如果要啟用自動延伸， 請執行本導覽圖最後一個區段所說明的單次設定。 對於其他的 Web 伺服器， 若要延伸外掛程式配置檔，請手動將 `plugin-cfg.xml` 檔從 A 機器上的 profile_root `/config/cells/cell_name/nodes/node_name/servers/ Web_server_name` 目錄，複製到 C 機器上的 plugins_root`/config/Web_server_name` 目錄。 | 使用延伸選項， 將 `plugin-cfg.xml` 檔從 profile_root/config/cells/cell_name/nodes/node_name/servers/Web_server_name 目錄移至 plugins_root/config/web_server_name 目錄。

### 遠端拓蹼 | ### 本端拓蹼

# 自動延伸的設定與疑難排解程序 Web 伺服器外掛程式配置服務只會針對 IBM HTTP Server，自動延伸 `plugin-cfg.xml` 檔。如果要啟用自動延伸， 請執行下列的單次設定： 在 IHS_root `/conf/admin.passwd` 檔中建立使用者 adminUser 和密碼 adminPassword。例如：c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword 在管理主控台中，按一下伺服器 > Web 伺服器 > webserver1 > 遠端 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 管理伺服器。 使用 htpasswd 指令，驗證指定於 WebSphere Application Server 管理主控台中以進行遠端管理的使用者 ID 和密碼， 已建立在 `admin.passwd` 檔中。 如果您嘗試進行安全連線， 請驗證已將 IBM HTTP Server 管理伺服器的 keydb 個人憑證，匯出至 WebSphere Application Server 金鑰資料庫， 作為簽章者憑證。這個金鑰資料庫是利用 `com.ibm.ssl.trustStore` 指引，指定於執行管理主控台之設定檔的 `sas.client.props` 檔中。這項考量主要是針對自簽憑證。 如果仍有問題， 請查看 IBM HTTP Server `admin_error.log` 檔及 WebSphere Application Server 日誌（`trace.log` 檔）， 判斷發生問題的原因。

- # 執行配置 Script 時的跨平台考量 在配置遠端 Web 伺服器時， 作業系統和機器平台中可能出現若干差異： 有一部機器執行 Windows，其他機器執行 Linux 或 UNIX。 有一部機器執行的預設編碼有別於其他機器。 有一部機器執行 Windows，其他機器執行 Linux 或 UNIX 如果有一部機器是在 Linux 或 UNIX 下執行， 其他機器是在 Windows 下執行，請使用建立在 `plugins_root /bin/crossPlatformScripts` 目錄中的 Script。 有一部機器執行的預設編碼有別於其他機器 若有兩部機器的預設檔案編碼不同， `configureWeb_server_name.bat` Script 或 `configure Web_server_name.sh` Script 的內容可能毀損。如果某部機器的編碼設為雙位元組字集 (DBCS) 語言環境， 但另一部機器不是時，就會發生這種情況。 請判斷每一部機器的檔案編碼， 並使用下列其中一項程序作為暫行解決方法。如果要判斷預設檔案編碼，請執行適當指令： Windows 系統：
      CHCP
- Linux 與 UNIX 系統：
      locale
使用每一部機器上的指令結果，在下列其中一項程序中作為 web_server_machine_encoding 變數和 application_server_machine_encoding 變數的值。 編碼差異更正程序 假設 Web 伺服器是在 Linux 機器上執行， 而 Network Deployment 是在 Windows 機器上執行。 在 Linux 機器上執行的 Web 伺服器 在 Linux 或 UNIX 系統上執行下列指令， 對配置了 Web 伺服器定義的 Script 檔進行編碼， 然後利用 FTP 以二進位模式將檔案傳送到 Windows 機器：
    iconv -f web_server_machine_encoding \
          -t application_server_machine_encoding \
             configureWeb_server_name.bat
如果您輸入單行指令，請省略 Linux 與 UNIX 接續字元 (\)。 重要事項：Script 檔名中會使用 Web 伺服器名稱 （暱稱）。如果您打算將 IBM HTTP Server 設定為自動延伸，名稱不可包含雙位元組字集 (DBCS) 字元。 現在， 假設 Web 伺服器是在 Windows 機器上執行，而 Network Deployment 是在 Linux 或 UNIX 機器上執行。 在 Windows 機器上執行的 Web 伺服器 在您利用 FTP 以二進位模式傳送檔案之後， 在 Linux 或 UNIX 系統上執行下列指令， 對配置了 Web 伺服器定義的 Script 檔進行編碼：
    iconv -f web_server_machine_encoding \
          -t application_server_machine_encoding \
             configureWeb_server_name.sh
如果您輸入單行指令，請省略 Linux 與 UNIX 接續字元 (\)。 如果您系統上的 iconv 指令不支援轉換對映， 請將 Web 伺服器配置 Script 的內容複製到剪貼簿， 再將內容貼到應用程式伺服器執行所在的機器中。