test

Sun Java System Application Server Enterprise Edition 8.2 高可用性管理指南

第 5 章 配置 HTTP 負載平衡

本小節說明 HTTP 負載平衡外掛程式。其中包含以下主題︰

如需有關其他類型負載平衡的資訊，請參閱第 10 章, Java 訊息服務的負載平衡和容錯移轉和第 11 章, RMI-IIOP 負載平衡和容錯移轉。

本節討論 Application Server 內隨附之 HTTP 負載平衡外掛程式的使用方式。另一個 HTTP 負載平衡選項會搭配 Application Server 使用 Sun Secure Application Switch，做為以硬體為基礎的負載平衡解決方案。如需有關配置此解決方案的指導文件，請參閱文章 Clustering and Securing Web Applications: A Tutorial。

HTTP 負載平衡器的工作方式

負載平衡器嘗試在多個應用程式伺服器實例 (獨立或叢集) 之間平均分布工作負荷量，從而增加了系統的總流量。

使用負載平衡器還可以滿足從一個伺服器實例防故障備用到另一個伺服器實例的請求。如果要使 HTTP 階段作業資訊持續運作，您必須使用 Enterprise Edition、安裝並設定 HADB，同時配置 HTTP 階段作業的持續性。如需更多資訊，請參閱第 9 章, 配置高可用性階段作業持續性和容錯移轉。

備註 –

負載平衡器不處理大於 8K 的 URI/URL。

使用 asadmin 公用程式而非 Admin Console 來配置 HTTP 負載平衡。

本節包含下列主題：

指定的請求與未指定的請求

首次從 HTTP 用戶端傳入負載平衡器的請求為新階段作業的請求。新階段作業的請求稱為未指定的請求。負載平衡器會根據循環演算法將此請求路由到叢集中的應用程式伺服器實例。

在某個應用程式伺服器實例中建立階段作業後，負載平衡器會將此階段作業的所有後續請求都路由到該特定實例而且僅路由到該實例。現有階段作業的請求稱為指定的或居留式請求。

HTTP 負載平衡演算法

Sun Java System Application Server 負載平衡器使用居留式循環演算法對內送 HTTP 和 HTTPS 請求進行負載平衡。給定階段作業的所有請求都將會傳送到同一個應用程式伺服器實例。使用居留式負載平衡器，階段作業資料將快取在單一應用程式伺服器上，而不會分布到叢集中的所有實例。

因此，居留式循環方案能夠帶來顯著的效能優勢，這種優勢通常超過了使用純循環方案所獲得的使負載更加平均分佈的優勢。

新 HTTP 請求傳送到負載平衡外掛程式後，系統將基於簡單的循環方案將該請求轉寄至某個 Application Server 實例。隨後，透過使用 Cookie 或明確的 URL 重新寫入將該請求「居留」在此特定的 Application Server 實例上。負載平衡器會自動決定居留方法。

負載平衡器外掛程式使用以下方法來確定階段作業居留性：

從居留式資訊中，負載平衡器外掛程式將首先確定請求先前轉寄到的實例。如果發現該實例正常工作，負載平衡器外掛程式會將請求轉寄至該特定應用程式伺服器實例。因此，給定階段作業的所有請求都將會傳送到同一個應用程式伺服器實例。

應用程式範例

以下目錄包含用於演示負載平衡和容錯移轉的範例應用程式：

install-dir/samples/ee-samples/highavailabilityinstall-dir/samples/ee-samples/failover

ee-samples 目錄還包含有關設定環境以執行範例的資訊。

設定 HTTP 負載平衡

本節說明如何設定負載平衡外掛程式，其中包含以下小節︰

設定負載平衡的先決條件

配置負載平衡器之前，您必須︰

HTTP 負載平衡器部署

您可以使用不同的方式配置負載平衡器 (視目標和環境而定)，如以下小節中所述︰

使用叢集伺服器實例

部署負載平衡器的最常用方法是使用伺服器實例的一個或多個叢集。依預設，叢集中所有實例具有相同的配置，並且部署了相同的應用程式。負載平衡器可在伺服器實例之間分散工作負荷量，並可發出從異常實例向正常實例執行容錯移轉的請求。如果您已配置了 HTTP 階段作業持續性，則在對請求執行容錯移轉時，階段作業資訊會持續。

如果您有多個叢集，則請求僅會在單一叢集的實例之間進行負載平衡和容錯移轉。在負載平衡器中使用多個叢集可簡化應用程式的滾動升級。如需更多資訊，請參閱在不遺失可用性的情況下升級應用程式。

將單一獨立的實例與用做反向代理外掛程式的負載平衡器配合使用

您也可以將負載平衡器配置為使用獨立伺服器實例，而非叢集。此配置可讓負載平衡外掛程式做為反向代理外掛程式 (有時稱為傳遞式外掛程式) 運作。當 Web Server 接收到在負載平衡器中啟用的應用程式之請求時，會將請求直接轉寄至 Application Server。

為通道外掛程式配置負載平衡器的程序與為伺服器實例的叢集配置負載平衡器的程序相同。

使用多個獨立實例

也可將負載平衡器配置為使用多個獨立的實例，並在這些實例之間對請求進行負載平衡和容錯移轉。但是，在此配置中，您必須手動確定獨立實例具有同質環境，並且這些實例已部署了相同的應用程式。由於叢集會自動維護同質環境，因此大多數情況下，使用叢集會更加簡便有效。

設定負載平衡的程序

使用 asadmin 工具可在您的環境中配置負載平衡。如需有關在這些步驟中所使用的 asadmin 指令的更多資訊，請參閱配置負載平衡器。

Procedure設定負載平衡

  1. 使用 asadmin 指令 create-http-lb-config 建立負載平衡器配置。

  2. 使用 asadmin create-http-lb-ref 為要管理的負載平衡器增加對叢集或獨立伺服器實例的參照。

    如果您建立了具有目標的負載平衡器配置，並且該目標是負載平衡器參考的唯一叢集或獨立伺服器實例，請跳過此步驟。

  3. 使用 asadmin enable-http-lb-server 啟用負載平衡器所參照的叢集或獨立伺服器實例。

  4. 使用 asadmin enable-http-lb-application 啟用要用於負載平衡的應用程式。

    這些應用程式必須已在負載平衡器所參考的叢集或獨立實例上部署並可以使用。啟用應用程式以用於負載平衡，與啟用應用程式以加以使用，是兩個獨立的步驟。

  5. 使用 asadmin create-health-checker 建立運作狀態檢查程式。

    運作狀態檢查程式監視工作異常的伺服器實例，以便在這些伺服器實例重新正常工作時，負載平衡器可以向它們傳送新的請求。

  6. 使用 asadmin export-http-lb-config 產生負載平衡器配置檔案。

    此指令可產生要與 Sun Java System Application Server 隨附之負載平衡外掛程式配合使用的配置檔案。

  7. 將負載平衡器配置檔案複製到 Web 伺服器的 config 目錄，該目錄中儲存了負載平衡外掛程式配置檔案。

配置負載平衡器

負載平衡器的配置為 domain.xml 檔案內的配置。負載平衡器配置非常靈活：

本小節說明如何建立、修改和使用負載平衡器配置，其中包含以下主題︰

建立 HTTP 負載平衡器配置

使用 asadmin 指令 create-http-lb-config 建立負載平衡器配置。表 5–1 說明參數。如需更多資訊，請參閱有關 create-http-lb-config、delete-http-lb-config 以及 list-http-lb-configs 的文件。

表 5–1 負載平衡器配置參數

參數 

說明 

response timeout 

伺服器實例需傳回回應的時限 (以秒為單位)。如果在該時間段內未收到任何回應，則認為伺服器處於異常狀態。預設值為 60。

HTTPS routing 

對負載平衡器的 HTTPS 請求是否產生對伺服器實例的 HTTPS 或 HTTP 請求。如需更多資訊，請參閱配置 HTTPS 路由。

reload interval 

檢查負載平衡器配置檔案 loadbalancer.xml 是否有變更的時間間隔。當檢查偵測到變更時，系統將重新載入配置檔案。值為 0 時會停用重新載入。如需更多資訊，請參閱啟用動態重新配置。

monitor 

是否為負載平衡器啟用監視功能。 

routecookie 

負載平衡外掛程式用於記錄路由資訊的 Cookie 之名稱。HTTP 用戶端必須支援 Cookie。如果您的瀏覽器設定為在儲存 Cookie 前詢問，則 Cookie 的名稱為 JROUTE。

target 

負載平衡器配置的目標。如果指定目標，則相當於增加對該目標的參考。目標可為叢集或獨立實例。

建立 HTTP 負載平衡器參考

當您在負載平衡器中建立對獨立伺服器或叢集的參照時，會將該伺服器或叢集增加至負載平衡器所控制的目標伺服器和叢集的清單中。您仍必須先啟用所參照的伺服器或叢集 (使用 enable-http-lb-server)，才能對向該伺服器或叢集發出的請求執行負載平衡。如果建立了帶有目標的負載平衡器配置，則系統已增加了作為參考的該目標。

使用 create-http-lb-ref 建立參照。您必須提供負載平衡器配置名稱和目標伺服器實例或叢集。

若要刪除參照，請使用 delete-http-lb-ref。必須先使用 disable-http-lb-server 停用已參照的伺服器或叢集，才能刪除此參照。

如需更多資訊，請參閱有關 create-http-lb-ref 和 delete-http-lb-ref 的文件。

啟用用於負載平衡的伺服器實例

建立對伺服器實例或叢集的參照後，請使用 enable-http-lb-server 啟用伺服器實例或叢集。如果在建立負載平衡器配置時使用某伺服器實例或叢集作為目標，則必須啟用該伺服器實例或叢集。

如需更多資訊，請參閱有關 enable-http-lb-server 的文件。

啟用用於負載平衡的應用程式

負載平衡器管理的所有伺服器均必須具有同質配置，包括部署到這些伺服器的相同應用程式集。部署某個應用程式並啟用 (在部署期間或之後) 此應用程式以進行存取後，您必須啟用該應用程式以進行負載平衡。如果沒有為負載平衡啟用應用程式，則將無法對該應用程式的請求執行負載平衡和防故障備用，即使已對該應用程式部署到的伺服器的請求執行了負載平衡和防故障備用。

啟用應用程式時，請指定應用程式名稱和目標。如果負載平衡器管理了多個目標 (例如，兩個叢集)，請在所有目標上啟用該應用程式。

如需更多資訊，請參閱有關 enable-http-lb-application 的線上說明。

如果部署了新的應用程式，您也必須啟用該應用程式以進行負載平衡並再次匯出負載平衡器配置。

建立 HTTP 運作狀態檢查程式

負載平衡器的運作狀態檢查程式會定期檢查所有標記為異常的已配置 Application Server 實例。運作狀態檢查程式不是必需的，但如果沒有運作狀態檢查程式，或者停用了運作狀態檢查程式，異常實例的定期運行狀況檢查就不會執行。負載平衡器無法判斷運作不正常的實例在何時開始正常運作。

負載平衡器的運作狀態檢查機制使用 HTTP 與 Application Server 實例進行通訊。運作狀態檢查程式將 HTTP 請求傳送給指定的 URL 並等待回應。HTTP 回應標頭中的狀態碼在 100 到 500 之間時表示實例處於正常狀態。

建立運作狀態檢查程式

若要建立運作狀態檢查程式，請使用 asadmin create-http-health-checker 指令。指定下列參數。

表 5–2 運作狀態檢查程式參數

參數 

說明 

預設 

url 

指定負載平衡器檢查的偵聽程式之 URL 以確定其運作狀態。 

“/” 

interval 

指定實例的運作狀態檢查發生的間隔 (以秒為單位)。指定為 0 將停用運作狀態檢查程式。 

30 秒 

timeout 

指定逾時間隔 (以秒為單位)，必須在該時間間隔內獲得回應才能認為偵聽程式運作正常。 

10 秒 

如果應用程式伺服器實例標示為異常，運作狀態檢查程式將輪詢異常實例以確定實例的狀態是否已變為正常。運作狀態檢查程式使用指定的 URL 來檢查所有異常的應用程式伺服器實例，以確定這些異常的應用程式伺服器實例是否已返回到正常狀態。

如果運作狀態檢查程式發現某個異常實例已變為正常，該實例將被增加到正常實例的清單中。

如需更多資訊，請參閱有關 create-http-health-checker 和 delete-http-health-checker 的文件。

運作正常實例的其他運作狀態檢查特性

由 create-http-health-checker 建立的運作狀態檢查程式僅檢查異常實例。若要定期檢查運作正常實例，請在匯出的 loadbalancer.xml 檔案中設定某些其他特性。

備註 –

僅在您已將 loadbalancer.xml 匯出之後，才可透過手動對其進行編輯，來設定這些特性。沒有等效的 asadmin 指令可以使用。

若要檢查運作正常實例，請設定以下特性。

表 5–3 運作狀態檢查程式手動特性

特性 

定義 

active-healthcheck-enabled

True/False 標幟，用於表示是否要 Ping 正常伺服器實例以確定這些實例是否正常。若要 Ping 伺服器實例，請將標幟設定為 True。 

number-healthcheck-retries

指定在將未回應的伺服器實例標記為異常之前，負載平衡器的運作狀態檢查程式對該伺服器實例執行 Ping 指令的次數。有效範圍在 1 到 1000 之間。設定的預設值為 3。 

透過編輯 loadbalancer.xml 檔案來設定特性。例如︰

<property name="active-healthcheck-enabled" value="true"/>
<property name="number-healthcheck-retries" value="3"/>

若您增加這些特性，然後進行編輯並再次匯出 loadbalancer.xml 檔案，新匯出的配置不會包含這些特性。您必須對新匯出的配置再次增加這些特性。

匯出負載平衡器配置檔案

Sun Java System Application Server 隨附的負載平衡外掛程式使用名為 loadbalancer.xml 的配置檔案。使用 asadmin 公用程式可以在 domain.xml 檔案中建立負載平衡器配置。配置好負載平衡環境之後，請將其自 domain.xml 匯出至 loadbalancer.xml 檔案。

Procedure匯出負載平衡器配置

  1. 使用 asadmin 指令 export-http-lb-config 匯出 loadbalancer.xml 檔案。

    匯出用於特定負載平衡器配置的 loadbalancer.xml 檔案。您可以指定路徑和其他檔案名稱。若您未指定檔名，則該檔案會命名為 loadbalancer.xml. load-balancer-config-name。若您未指定路徑，則會在 domain-dir/generated 目錄中建立檔案。

    若要在 Windows 上指定路徑，請將路徑加上引號。例如，"C:\Sun\AppServer\loadbalancer.xml"。

  2. 將已匯出的負載平衡器配置檔案複製到 Web Server 的配置目錄。

    例如，對於 Sun Java System Web Server，該位置通常為 web-server-root/config。

    Web Server 配置目錄中的負載平衡器配置檔案必須命名為 loadbalancer.xml。如果您的檔案使用其他名稱，例如 loadbalancer.xml. load-balancer-config-name，則必須重新命名該檔案。

變更負載平衡器配置

如果您因為建立或刪除對伺服器的參照、部署新的應用程式、啟用或停用伺服器或應用程式而變更了負載平衡器配置，則請重新匯出負載平衡器配置檔案並將其複製到 Web 伺服器的 config 目錄。如需更多資訊，請參閱匯出負載平衡器配置檔案。

負載平衡器外掛程式將基於在負載平衡器配置中指定的重新載入間隔定期檢查已更新的配置。在指定的時間值後，如果負載平衡器發現新的配置檔案，則它將開始使用新配置。

啟用動態重新配置

透過動態重新配置，負載平衡外掛程式會定期檢查已更新的配置。

若要啟用動態重新配置，請執行以下步驟：

備註 –

如果負載平衡器在嘗試重新配置時遇到硬碟讀取錯誤，它將使用記憶體中目前的配置。負載平衡器還確定了在覆寫現有配置之前，已修改的配置資料與 DTD 相容。

如果遇到磁碟讀取錯誤，相關的警告訊息會記錄至 Web Server 的錯誤記錄檔中。

Sun Java System Web Server 的錯誤記錄位於以下位置：web-server-install-dir/web-server-instance /logs/。

停用 (靜止) 伺服器實例或叢集

基於任何原因而停止應用程式伺服器之前，實例應先完成處理請求。正常停用伺服器實例或叢集的程序被稱為靜止。

負載平衡器使用以下策略來靜止應用程式伺服器實例：

Procedure停用某個伺服器實例或叢集

  1. 執行 asadmin disable-http-lb-server，設定逾時 (以分鐘為單位)。

  2. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

  3. 將匯出的配置複製到 Web Server 的 config 目錄中。

  4. 停止該伺服器實例或叢集。

停用 (靜止) 應用程式

在取消部署 Web 應用程式之前，應讓應用程式完成處理請求。正常停用應用程式的程序稱為靜止。靜止應用程式時，您可指定逾時時間。依據逾時時間，負載平衡器會使用以下策略靜止應用程式︰

Procedure停用應用程式

  1. 使用 asadmin disable-http-lb-application，並指定以下內容︰

    • 逾時 (以分鐘為單位)。

    • 要停用的應用程式之名稱。

    • 要在其上停用應用程式的目標叢集或實例。

  2. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

  3. 將匯出的配置複製到 Web Server 的 config 目錄中。

配置 HTTP 和 HTTPS 容錯移轉

如果 HTTP/HTTPS 階段作業所連線的原始應用程式伺服器實例變為不可用，負載平衡器外掛程式會將這些階段作業防故障備用到其他應用程式伺服器實例上。本小節介紹如何配置負載平衡器外掛程式以啟用 HTTP/HTTPS 路由和階段作業容錯移轉。

HTTPS 路由

負載平衡外掛程式將所有內送的 HTTP 或 HTTPS 請求路由至應用程式伺服器實例。然而，如果啟用了 HTTPS 路由，則負載平衡外掛程式會將 HTTPS 請求僅轉寄給使用 HTTPS 連接埠的應用程式伺服器。HTTPS 路由是針對新請求和居留式請求而執行的。

如果收到了 HTTPS 請求且沒有正在進行的階段作業，負載平衡器外掛程式將選取使用已配置的 HTTPS 連接埠的可用應用程式伺服器實例，並將請求轉寄到該實例。

在正在進行的 HTTP 階段作業中，如果收到對同一個階段作業的新 HTTPS 請求，則使用在 HTTP 階段作業期間儲存的階段作業和居留式資訊來路由 HTTPS 請求。新的 HTTPS 請求將路由到在此 HTTPS 連接埠上處理上一個 HTTP 請求的同一伺服器。

配置 HTTPS 路由

create-http-lb-config 指令的 httpsrouting 選項用於控制為正在參與負載平衡的所有應用程式伺服器開啟或關閉 HTTPS 路由。如果此選項設定為 false，所有 HTTP 和 HTTPS 請求都將作為 HTTP 請求進行轉寄。如果設定為 true，HTTPS 將做為 HTTPS 請求進行轉寄。建立新的負載平衡器配置時，請設定 HTTPS 路由，或者以後使用 asadmin set 指令加以變更。

備註 –

已知問題

負載平衡器對 HTTP/HTTPS 請求處理具有以下限制。

透過負載平衡器使用重新導向

使用重新導向將請求從一個 URL 重新導向另一個 URL。例如，使用重新導向將使用者傳送至不同的網站 (例如從舊版應用程式重導向至較新版本)，或是從 HTTP 重新導向至 HTTPS，或是從 HTTPS 重新導向至 HTTP。您可以在應用程式中以多種方式啟用重新導向 (例如，以 Servlet 為基礎的重新導向，web.xml 重新導向)。然而，如果要從負載平衡器傳送重新導向 URL，可能需要對 Application Server 或負載平衡器進行其他配置。請注意，重新導向和使用 HTTPS 路由轉寄的請求不同。使用重新導向時，請將 httpsrouting 設定為 false。如果將 HTTPS 請求配置成需轉寄至 HTTP，請使用HTTPS 路由。

下列特性會影響重新導向：HTTP 服務或 HTTP 偵聽程式的 authPassthroughEnabled 和 proxyHandler 特性，以及 loadbalancer.xml 檔案中的 rewrite-location 特性。

authPassthroughEnabled 特性

當 Application Server authPassthroughEnabled 特性設定為 true 時，會以自訂的請求標頭將有關原始用戶端請求的資訊 (例如用戶端 IP 位址、SSL 金鑰大小、以及認證的用戶端憑證鏈) 傳送至 HTTP 偵聽程式。如果您安裝了硬體加速器，authPassThroughEnabled 特性會讓您利用硬體加速器加快 SSL 認證的進行。在負載平衡器上配置硬體加速器，比在每個叢集的 Application Server 實例上進行配置更為容易。

注意 – 注意 –

只有在 Application Server 受防火牆保護後，才能將 authPassthroughEnabled 設定為 true。

使用 asadmin set 指令來設定 HTTP 服務或個別 HTTP 偵聽程式上的 authPassthroughEnabled 特性。個別 HTTP 偵聽程式的設定優先於 HTTP 服務的設定。

如果要在所有的 HTTP/HTTPS 偵聽程式上設定 authPassthroughEnabled 特性，請使用下列指令：

asadmin set cluster-name-config.http-service.property.authPassthroughEnabled=true

如果要在個別的偵聽程式上進行設定，請使用下列指令：

asadmin set cluster-name-config.http-service.http-listener.listener-name.property. authPassthroughEnabled=true

proxyHandler 特性

Application Server 的代理伺服器處理程式負責擷取遭代理伺服器 (在此例中指的是負載平衡器) 攔截、並轉寄至應用程式伺服器之原始用戶端請求的相關資訊，同時負責將此資訊提供給做為用戶端請求之目標的 Web 應用程式 (部署於應用程式伺服器上)。如果代理伺服器的截取遭 SSL 終止，代理伺服器處理程式會擷取並提供有關原始請求的其他資訊，例如原始請求是否為 HTTPS 請求，以及 SSL 用戶端認證是否啟用。只有當 authPassThroughEnabled 設定為 true 時，才使用 proxyHandler 屬性。

代理伺服器處理程式會檢視內送請求中的自訂請求標頭，而代理伺服器就是藉由該自訂請求標頭傳送和原始用戶端請求相關的資訊，並使用標準的 ServletRequest API 向應用程式伺服器上的 Web 應用程式提供這項資訊。

代理伺服器處理程式實作可透過 proxyHandler 特性，在 HTTP 服務層級上進行全域配置，或是針對個別的 HTTP 偵聽程式進行配置，而該特性的值會指定 com.sun.appserv.ProxyHandler 抽象類別之實作的完全合格類別名稱。可進行配置的代理伺服器處理程式實作允許應用程式伺服器搭配任何代理伺服器，只要代理伺服器處理程式實作知道 HTTP 請求的標頭名稱，並了解其值的格式，而代理伺服器就是以此方式傳送與原始用戶端請求相關的資訊。

Application Server 的代理伺服器處理程式會從請求標頭讀取並剖析 SSL 憑證鏈。此舉讓後端應用程式伺服器實例得以擷取原始用戶端請求 (遭到終止 SSL 的代理伺服器所攔截；該代理伺服器在此指的是負載平衡器) 的相關資訊。您可以使用預設的代理伺服器處理程式設定，或是使用 HTTP 服務或 HTTP/HTTPS 偵聽程式的 proxyHandler 特性自行加以配置。proxyHandler 特性會針對該偵聽程式或所有偵聽程式所使用的 com.sun.appserv.ProxyHandler 抽象類別之自訂實作，指定完全合格類別名稱。

此抽象類別的實作會檢視自訂請求標頭的特定請求，而代理伺服器就是透過該自訂請求標頭，將原始用戶端請求的相關資訊傳送至應用程式伺服器實例，並將該資訊傳回至其呼叫者。預設實作會從名為 Proxy-ip 的 HTTP 請求標頭讀取用戶端 IP 位址、從名為 Proxy-keysize 的 HTTP 請求標頭讀取 SSL 金鑰大小，並從名為 Proxy-auth-cert 的 HTTP 請求標頭讀取 SSL 用戶端憑證鏈。Proxy-auth-cert 值必須包含 BASE-64 編碼的用戶端憑證鏈且無 BEGIN CERTIFICATE 和 END CERTIFICATE 邊界，並以 % d% a 取代 \n。

只有當 authPassThroughEnabled 設定為 true 時，才能使用這項特性。如果您在個別的 HTTP 或 HTTPS 偵聽程式上設定 proxyHandler 特性，該特性會覆寫所有偵聽程式的預設設定。

使用 asadmin set 指令來設定 HTTP 服務或個別 HTTP 偵聽程式上的 proxyHandler 特性。

如果要在所有的 HTTP/HTTPS 偵聽程式上設定 proxyHandler 特性，請使用下列指令：

asadmin set cluster-name-config.http-service.property.proxyHandler=classname

如果要在個別的偵聽程式上進行設定，請使用下列指令：

asadmin set cluster-name-config.http-service.http-listener.listener-name.property.proxyHandler=classname

rewrite-location 特性

如果設定為 true，rewrite-location 特性就會重寫原始的請求資訊，並納入通訊協定 (HTTP 或 HTTPS)、主機和連接埠資訊。依預設，rewrite-location 特性會設定為 true，以維持與先前 Application Server 發行版本的向下相容性。

rewrite-location 特性無法經由 asasmin create-http-lb-config 或 asadmin set 指令取得。如果要使用這項特性，請在匯出負載平衡器配置後，將該特性手動增加至 loadbalancer.xml 檔案。例如，將下列特性增加至所匯出的 loadbalancer.xml 檔案：

<property name="rewrite-location" value="false"/>

設定 rewrite-location 特性時，請記住下列要點：

配置等冪 URL

等冪請求是一種在重試時不會在應用程式中造成任何變更或不一致的請求。在 HTTP 中，某些方法 (例如 GET) 是等冪的，而其他方法 (例如 POST) 則不是。重試等冪 URL 不會導致伺服器上或資料庫中的值發生變更。唯一的差異在於使用者收到的回應會有所不同。

等冪請求的範例包括搜尋引擎查詢和資料庫查詢。基礎原則是重試不會導致資料的更新或修改。

若要增強已部署應用程式的可用性，請在負載平衡器所服務的所有應用程式伺服器實例上，將環境配置為重試失敗的等冪 HTTP 請求。此選項用於唯讀請求 (例如，重試搜尋請求)。

請在 sun-web.xml 檔案中配置等冪 URL。匯出負載平衡器配置時，等冪 URL 資訊會自動增加至 loadbalancer.xml 檔案中。

如需有關配置等冪 URL 的更多資訊，請參閱「Sun Java System Application Server Enterprise Edition 8.2 Developer’s Guide」中的「Configuring Idempotent URL Requests」。

配置多個 Web 伺服器實例

Sun Java System Application Server 安裝程式不允許在單一機器上安裝多個負載平衡外掛程式。若要在單一叢集或多個叢集中的單一機器上安裝多個帶有負載平衡器外掛程式的 Web 伺服器，需要手動執行一些步驟來配置負載平衡器外掛程式。

Procedure配置多個 Web Server 實例

  1. 配置新的 Web Server 實例以使用負載平衡外掛程式。

    請依循第 4 章, 配置 Web Server 以用於負載平衡中的步驟。

  2. 複製 DTD 檔案。

    從現有 Web 伺服器實例的 config 目錄中，將 sun-loadbalancer_1_1.dtd 複製到新實例的 config 目錄中。

  3. 設定負載平衡器配置檔案。或者︰

    • 複製現有負載平衡器配置。

      使用現有負載平衡器配置，從現有 Web Server 實例的 config 目錄中，將 loadbalancer.xml 檔案複製到新實例的 config 目錄中。

    • 建立新的負載平衡器配置︰

      1. 使用 asadmin create-http-lb-config 建立新的負載平衡器配置。

      2. 使用 asadmin export http-lb-config 將新配置匯出至 loadbalancer.xml 檔案。

      3. 將該 loadbalancer.xml 檔案複製至新 Web 伺服器的 config 目錄中。

        如需有關建立負載平衡器配置並將其匯出至 loadbalancer.xml 檔案的資訊，請參閱建立 HTTP 負載平衡器配置。

在不遺失可用性的情況下升級應用程式

將應用程式升級至新版本而不影響使用者對應用程式的使用情形，即稱為滾動升級。在升級過程中，小心管理這兩個版本的應用程式，不但可以確保應用程式的目前使用者在無中斷的情況下完成作業，同時可讓新使用者不需設定即可取得新的應用程式版本。使用滾動升級時，使用者不會察覺正在進行升級。

應用程式相容性

依據兩個應用程式版本之間的變更大小，滾動升級會造成不同程度的困難。

如果變更很小 (例如對靜態文字和影像的變更)，則此應用程式的兩個版本可以相容，並可在相同叢集中同時執行。

相容的應用程式必須︰

您可以在單一叢集或多個叢集中執行相容應用程式的滾動升級。如需更多資訊，請參閱在單一叢集中升級。

如果應用程式的兩個版本不滿足上述所有條件，則應用程式會被視為不相容。在某個叢集中執行不相容的應用程式版本會毀壞應用程式資料，並導致階段作業容錯移轉無法正常執行。該問題取決於不相容性的類型和程度。好的做法是透過建立要向其部署新版本應用程式的「隱式叢集」，來升級不相容的應用程式，然後緩慢靜止舊叢集和應用程式。如需更多資訊，請參閱升級不相容的應用程式。

應用程式開發者和管理員是確定應用程式版本是否相容的最佳人選。如有疑問，請假設版本不相容，因為這是最安全的方法。

在單一叢集中升級

如果未與任何其他叢集共用叢集配置，則可以對部署至單一叢集的應用程式執行滾動升級。

Procedure在單一叢集中升級應用程式

  1. 儲存舊版本的應用程式或備份網域。

    若要備份網域，請使用 asadmin backup-domain 指令。

  2. 關閉叢集的動態重新配置 (如果已啟用)。

    若要使用 Admin Console 執行此作業，請︰

    1. 展開 [配置] 節點。

    2. 按一下叢集配置的名稱。

    3. 在 [配置系統特性] 頁面中，取消核取 [已啟用動態重新配置] 方塊。

    4. 按一下 [儲存]。

    或者，使用以下指令︰

    asadmin set --user user --passwordfile password-file cluster-name-config.dynamic-reconfiguration-enabled=false

  3. 將已升級的應用程式重新部署至目標 domain 中。

    如果使用管理主控台進行重新部署，網域將自動成為目標。如果使用 asadmin，請指定目標 domain。由於已停用動態重新配置，因此舊應用程式將繼續在叢集上執行。

  4. 使用 asadmin enable-http-lb-application 為實例啟用已重新部署的應用程式。

  5. 從負載平衡器靜止叢集中的某個伺服器實例。

    請依照下列步驟執行：

    1. 使用 asadmin disable-http-lb-server 停用伺服器實例。

    2. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

    3. 將已匯出的配置檔案複製到 Web Server 實例的配置目錄。

      例如，對於 Sun Java System Web Server，位置為 web-server-install-dir/https-host-name /config/loadbalancer.xml。若要確保負載平衡器載入新的配置檔案，請務必確定已透過在負載平衡器配置中設定 reloadinterval 啟用了動態重新配置。

    4. 請等待，直至逾時值到期。

      監視負載平衡器的記錄檔以確定實例已離線。如果使用者看到重試 URL，請略過靜止期間，並立即重新啟動伺服器。

  6. 在叢集中的其他實例仍處於執行狀態的情況下，重新啟動已停用的伺服器實例。

    重新啟動可讓伺服器與網域同步，並可更新應用程式。

  7. 測試重新啟動的伺服器上的應用程式，以確定應用程式執行正常。

  8. 在負載平衡器中重新啟用伺服器實例。

    請依照下列步驟執行：

    1. 使用 asadmin enable-http-lb-server 啟用伺服器實例。

    2. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

    3. 將配置檔案複製到 Web Server 的配置目錄。

  9. 對叢集中的每個實例重複步驟 5 至 8。

  10. 當所有伺服器實例具有新的應用程式並且這些伺服器實例正在執行時，您可以再次為叢集啟用動態重新配置。

在多個叢集中升級

Procedure若要在兩個或更多叢集中升級相容的應用程式，請執行以下步驟︰

  1. 儲存舊版本的應用程式或備份網域。

    若要備份網域，請使用 asadmin backup-domain 指令。

  2. 關閉所有叢集的動態重新配置 (如果已啟用)。

    若要使用 Admin Console 執行此作業，請︰

    1. 展開 [配置] 節點。

    2. 按一下某個叢集配置的名稱。

    3. 在 [配置系統特性] 頁面中，取消核取 [已啟用動態重新配置] 方塊。

    4. 按一下 [儲存]。

    5. 對其他叢集重複此程序。

    或者，使用以下指令︰

    asadmin set --user user --passwordfile password-file cluster-name-config.dynamic-reconfiguration-enabled=false

  3. 將已升級的應用程式重新部署至目標 domain 中。

    如果使用管理主控台進行重新部署，網域將自動成為目標。如果使用 asadmin，請指定目標 domain。由於已停用動態重新配置，因此舊應用程式將繼續在叢集上執行。

  4. 使用 asadmin enable-http-lb-application 為叢集啟用已重新部署的應用程式。

  5. 靜止負載平衡器中的某個叢集。

    1. 使用 asadmin disable-http-lb-server 停用叢集。

    2. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

    3. 將已匯出的配置檔案複製到 Web Server 實例的配置目錄。

      例如，對於 Sun Java System Web Server，位置為 web-server-install-dir/https-host-name /config/loadbalancer.xml。必須為負載平衡器啟用動態重新配置 (透過在負載平衡器配置中設定 reloadinterval)，以便能夠自動載入新的負載平衡器配置檔案。

    4. 請等待，直至逾時值到期。

      監視負載平衡器的記錄檔以確定實例已離線。如果使用者看到重試 URL，請略過靜止期間，並立即重新啟動伺服器。

  6. 在其他叢集仍處於執行狀態的情況下，重新啟動已停用的叢集。

    重新啟動可讓叢集與網域同步，並可更新應用程式。

  7. 測試重新啟動的叢集上的應用程式，以確定應用程式執行正常。

  8. 在負載平衡器中啟用叢集︰

    1. 使用 asadmin enable-http-lb-server 啟用叢集。

    2. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

    3. 將配置檔案複製到 Web Server 的配置目錄。

  9. 對其他叢集重複步驟 5 至 8。

  10. 當所有伺服器實例都具有新的應用程式並且這些伺服器實例正在執行時，您可以為所有叢集再次啟用動態重新配置。

升級不相容的應用程式

如果新版應用程式與舊版不相容，請使用下列程序。有關應用程式相容要素的相關資訊，請參閱應用程式相容性。此外，您必須在兩個或更多叢集中升級不相容的應用程式。如果您僅有一個叢集，請為升級建立「隱式叢集」，如下所述。

升級不相容的應用程式時，請︰

Procedure透過建立第二個叢集來升級不相容的應用程式

  1. 儲存舊版本的應用程式或備份網域。

    若要備份網域，請使用 asadmin backup-domain 指令。

  2. 在相同或不同的一組機器上建立「隱式叢集」，將其做為現有叢集。如果您已經有第二個叢集，請跳過這個步驟。

    1. 使用 Admin Console 建立新叢集並參照現有叢集的已命名配置。

      在每個機器上為新實例自訂連接埠，以避免與現有使用中連接埠衝突。

    2. 對於與叢集相關聯的所有資源，使用 asadmin create-resource-ref 將資源參照增加至新建的叢集中。

    3. 使用 asadmin create-application-ref，從新建的叢集中，建立對部署至該叢集的所有其他應用程式 (目前重新部署的應用程式除外) 的參照。

    4. 使用 asadmin configure-ha-cluster 將叢集配置為具有高可用性。

    5. 使用 asadmin create-http-lb-ref 在負載平衡器配置檔案中建立對新建叢集的參照。

  3. 為應用程式的新版本指定與舊版本不同的名稱。

  4. 透過將新叢集做為目標來部署新應用程式。使用不同的一個或多個環境根目錄。

  5. 使用 asadmin enable-http-lb-application 為叢集啟用已部署的新應用程式。

  6. 在其他叢集仍處於執行狀態的情況下，啟動新的叢集。

    啟動可使叢集與網域同步，並與新應用程式一同更新。

  7. 測試新叢集上的應用程式，以確定其是否正常執行。

  8. 使用 asadmin disable-http-lb-server 從負載平衡器中停用舊叢集。

  9. 為延遲階段作業存在的時間設定逾時。

  10. 使用 asadmin enable-http-lb-server 從負載平衡器中啟用新叢集。

  11. 使用 asadmin export-http-lb-config 匯出負載平衡器配置檔案。

  12. 將已匯出的配置檔案複製到 Web Server 實例的配置目錄。

    例如，對於 Sun Java System Web Server，位置為 web-server-install-dir/https-host-name /config/loadbalancer.xml。必須為負載平衡器啟用動態重新配置 (透過在負載平衡器配置中設定 reloadinterval)，以便能夠自動載入新的負載平衡器配置檔案。

  13. 在逾時時間過期後，或舊應用程式的所有使用者結束後，停止舊叢集並刪除舊應用程式。

監視 HTTP 負載平衡器外掛程式

配置記錄訊息

負載平衡外掛程式使用 Web 伺服器的記錄機制寫入記錄訊息。Application Server 上的預設記錄層級設定為 Sun Java System Web Server (INFO)、Apache Web Server (WARN) 和 Microsoft IIS (INFO) 上的預設記錄層級。應用程式伺服器記錄層級 (FINE、FINER 和 FINEST) 對映到 Web 伺服器上的 DEBUG 層級。

這些記錄訊息將寫入 Web 伺服器記錄檔，並且以可使用程序檔進行剖析或匯入試算表以計算所需公制的原始資料形式進行。

記錄訊息類型

負載平衡外掛程式會產生以下類型的記錄訊息：

負載平衡器配置器記錄訊息

使用等冪 URL 和錯誤頁面設定時，將記錄這些訊息。

等冪 URL 式樣配置的輸出包含以下資訊：

請求派送和執行階段記錄訊息

這些記錄訊息在負載平衡和派送請求時產生。

配置器錯誤訊息

如果存在配置問題 (例如，缺少參考的自訂錯誤頁面)，將顯示這些錯誤。

啟用負載平衡器記錄

負載平衡器外掛程式記錄以下資訊：

備註 –

啟用負載平衡外掛程式後，如果將 Web Server 記錄層級設定為 DEBUG 或設定為輸出詳細訊息，則負載平衡器會將 HTTP 階段作業 ID 寫入 Web Server 記錄檔中。因此，如果託管負載平衡外掛程式的 Web Server 位於 DMZ 中，請勿在生產環境中使用 DEBUG 或類似的記錄層級。

如果必須使用 DEBUG 記錄層級，請透過在 loadbalancer.xml 中將 require-monitor-data 特性設定為 false，以關閉負載平衡器記錄。

Procedure開啟負載平衡器記錄

  1. 設定 Web 伺服器中的記錄選項。該程序取決於 Web Server︰

    • 對於 Sun Java System Web Server

      在伺服器的 Admin console 中，請至 [Magnus Editor] 標籤，然後將 [Log Verbose] 選項設定為 [On]。

    • 對於 Apache Web Server，請將記錄層級設定為 DEBUG。

    • 對於 Microsoft IIS，請在 sun-passthrough.properties 檔案中，將記錄層級設定為 FINE。

  2. 將負載平衡器配置的 monitor 選項設定為 true。

    在最初建立負載平衡器配置時，使用 asadmin create-http-lb-config 指令將監視功能設定為 true，或稍後使用 asadmin set 指令將其設定為 true。依預設，停用監視。

瞭解監視訊息

負載平衡器外掛程式記錄訊息的格式如下所示：