移轉 5.1 版 Web 服務閘道配置
在 WebSphere® Application Server 5.1 版中,Web 服務閘道是可分開的元件,有它自己的使用者介面。在產品的較新版本中,閘道整合在具有服務整合匯流排功能的 Web 服務中,且重新實作為用來延伸及鏈結入埠和出埠服務的機制。 您可以使用 wsadmin 指令 Script,將現有的閘道配置從 5.1 版應用程式伺服器,移轉到更新版本的應用程式伺服器或叢集。
開始之前
考慮您是否必須移轉現有的閘道:
- WebSphere Application Server 5.0 版已不再受到支援,因此,您應該將在 5.0 版應用程式伺服器中執行的任何現有閘道,移轉成在產品現行版本上的應用程式伺服器中執行。
- 在 WebSphere Application Server 5.1 版上執行的 Web 服務閘道,於某些特定的限制下,可以與在 7.0 版或更新版本應用程式伺服器上執行的閘道實例同時存在.
- 7.0 版或更新版本 Cell 可以包含 5.1 版、第 6 版和 7.0 版或更新版本 應用程式伺服器.
您可以在不停止閘道的情況下移轉正式用途的 5.1 版閘道;然後,要求端應用程式就可以切換為使用新的閘道配置,而現有的 5.1 版閘道會繼續運作。
關於這項作業
移轉處理程序會採用已將配置匯出到 XML 檔的 5.1 版閘道應用程式,然後使用匯出的 XML 檔,在更新版本的單一應用程式伺服器或叢集上配置相同的閘道功能。 在作法上,您需要匯出 5.1 版閘道配置,然後執行 Script,將已匯出的配置移轉到更新版本的現有應用程式伺服器或叢集中的新閘道實例。
5.1 版配置的移轉如下所示:
- 移轉過程中會自動建立閘道實例。
- 直接移轉閘道服務、目標服務和 UDDI 參照。
- 也會移轉 JAX-RPC 處理程式的閘道內的定義及處理程式清單。您必須確保基礎處理程式類別在執行時期可用。
- 原本將閘道服務指派給特定的通道,改成指派給特定的入埠連接埠和端點接聽器配對(因為在更新版本中,端點接聽器和入埠連接埠會共用通道的功能)。 Apache SOAP 通道的任何用法都移轉到 SOAP over HTTP 端點接聽器和入埠連接埠。
- 不會移轉現有的過濾器。在 5.1.1 版中,已淘汰過濾器的使用,而在 7.0 版已移除對於過濾器的支援。 先前過濾器所扮演的角色,現在已改由 JAX-RPC 處理程式和服務整合匯流排調解組合來扮演。
- 從目標服務(而非閘道服務)的 WSDL 產生的 Web 服務用戶端,在更新版本中依預設會標示為錯誤。
- 如果您使用 5.1 版閘道服務 WSDL 產生 Web 服務用戶端,而 WSDL 連結和編碼樣式不是文件文字,則移轉到更新版本之後,您必須使用新的閘道服務 WSDL 來重新產生用戶端 Stub。
- WS-Security 連結會移轉為符合 WS-Security 草稿 13 規格的連結。但是:
- WS-Security 規格最終版本 (1.0)(在 WebSphere Application Server 第 6 版中實作)與草稿 13 版本不相容,所以 WebSphere Application Server 第 6 版 中已不支援使用 WS-Security 草稿 13。「WS-Security 初稿 13」已淘汰,它只應該用在容許繼續使用遵循「WS-Security 初稿 13」規格來撰寫的現有 Web 服務用戶端應用程式。
- 只有當移轉處理程序在執行目標伺服器的機器上執行時(在獨立式伺服器的情況下),或在執行部署管理程式的機器上執行時(在網路部署配置下),才會移轉 WS-Security 連結物件。
- 只會移轉「閘道服務」或「目標服務」WS-Security 配置所使用的 WS-Security 連結物件。 不會移轉您建立但未使用的任何連結物件。例如:如果 WS-Security 配置參照「簽署資訊」物件,而「簽署資訊」物件又參照「信任錨點」物件,則「簽署資訊」物件和「信任錨點」物件會隨著參照它們的 WS-Security 配置一起移轉。
註:
- 移轉作業會假設所移轉服務的外部網址不變。此假設出自於認為這些位址與 Web 伺服器相關聯,而與閘道所在的機器無關,因此,這些位址的主機名和埠號不受影響。 在您的配置中,如果外部網址指向閘道機器,請在完成移轉處理程序之後修改端點接聽器配置。
- 您可以使用 WebSphere Application Server Network Deployment 移轉任一配置設定檔(獨立式伺服器或部署管理程式)下執行的單一伺服器。 但是,建議您移轉到部署管理程式設定檔下執行的單一伺服器。如果移轉到獨立式伺服器設定檔,則後續就無法使用管理主控台來修改閘道配置。
- 相較於在 WebSphere Application Server 5.1 版中驗證 Web 服務訊息,啟用服務整合匯流排的 Web 服務對於 Web 服務訊息的驗證更為徹底。 因此,某些使用形式不完整的要求或回應(訊息組件命名不當)且在使用 5.1 版時沒問題的用戶端應用程式,現在都視為形式不完整。 有關解決此問題所需要的步驟,請參閱支援匯流排的 Web 服務:已知限制。
如果要將現有的閘道配置從 5.1 版應用程式伺服器,移轉到更新版本的應用程式伺服器或叢集上的閘道功能,請完成下列步驟:
程序
下一步
註:
- 如果 5.1 版閘道使用過濾器,請使用 JAX-RPC 處理程式與服務整合匯流排調解的組合,重建過濾器功能。
- 如果閘道配置中有任何閘道服務具有多個目標服務,則 5.1 版配置可能已使用遞送過濾器來選擇特定的目標服務。如果是這種情形,您必須進一步配置移轉的閘道,透過遞送調解選擇目標服務和埠。
- 更新版本中的 Web 服務閘道使用更多記憶體來處理訊息,如果您透過已移轉的閘道傳遞大型附件,Java 虛擬機器中可能會發生記憶體不足錯誤。如果要解決這個問題,請增加 JVM 資料堆大小。