移轉 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 版閘道;然後,要求端應用程式就可以切換為使用新的閘道配置,而現有的 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 版應用程式伺服器,移轉到更新版本的應用程式伺服器或叢集上的閘道功能,請完成下列步驟:

程序

  1. 選擇性的: 5.1 版閘道中移除任何過濾器。
    您可以移轉包含過濾器的閘道。但是,過濾器無法在更新的版本中使用,因此您可能會想在移轉之前從配置中移除它們,請完成下列步驟:
    1. 檢查您的 5.1 版閘道是否使用過濾器。 如需相關資訊,請參閱 WebSphere Application Server 5.1 版主題:列出和管理閘道部署的過濾器
    2. 移除任何過濾器。 如需相關資訊,請參閱the WebSphere Application Server 5.1 版主題:從 Web 服務閘道移除過濾器
    移轉之後,您可以使用 JAX-RPC 處理程式與服務整合匯流排調解的組合,重建過濾器功能。如果您移轉的 Web 服務閘道含有遞送過濾器,您就可以重建過濾器功能。
  2. 選擇更新版本且位於網路部署 Cell 中的單一伺服器或叢集作為目標伺服器或叢集。
  3. 將目標伺服器或叢集配置為服務整合匯流排的成員。
  4. 在目標伺服器或叢集的 Cell 範圍配置「服務資料物件 (SDO)」儲存庫。
  5. 如果要移轉任何 EJB 連結,而且希望它們繼續使用 RPC 編碼的連結或文件文字以外的任何連結,請將正確類型的連結新增至 EJB 連結 WSDL。 必須執行此步驟,因為 5.1 版閘道預設連結是 RPC 編碼,而在更新的版本中,預設連結是文件文字
  6. 請確定來源(5.1 版)應用程式伺服器正在執行,然後使用 5.1 版閘道使用者介面,將 5.1 版應用程式伺服器的閘道配置備份為專用配置。 如需相關資訊,請參閱 WebSphere Application Server 5.1 版主題:備份閘道配置
  7. 選擇性的: 停止 5.1 版應用程式伺服器。
    註: 如果要移轉正式用途的閘道,請讓 5.1 版閘道保持執行,直到更新版本中的閘道配置完成為止,然後將要求端應用程式切換為使用新的閘道配置,而現有的 5.1 版閘道繼續運作。 然而,這兩個版本的閘道不必同時執行,而您在啟動更新版本的伺服器或叢集之前,可能需要停止 5.1 版伺服器(例如,在相同的機器且使用相同的埠號,安裝更新版本的伺服器或叢集來直接取代 5.1 版伺服器)。
  8. 啟動更新版本的目標應用程式伺服器或叢集,如果是受管理 Cell 內的單一伺服器或叢集,還要啟動目標 Cell 的部署管理程式。
  9. 確認用來定義 5.1 版應用程式伺服器上目標服務的所有 WSDL 文件都在給定的位置上。 如果 WSDL 位置是 UDDI 參照,請確認參照的 UDDI 登錄是否存在。
  10. 選擇性的: 如果移轉的閘道使用 JAX-RPC 處理程式和處理程式清單,請確定基礎處理程式類別在執行時期可用。
  11. 如果要將匯出的配置移轉到更新版本的應用程式伺服器或叢集中的新閘道實例,請完成下列步驟:
    1. 開啟命令提示字元,切換至 app_server_root/util 目錄。
    2. 請執行下列指令:
      [IBM i]註: [IBM i]wsadmin Scripting 用戶端是從 Qshell 執行. [IBM i]如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.
      migratewsgw[AIX Solaris HP-UX Linux Windows][z/OS].ext -C=cell_name [-S=server_name -N=node_name] 
                          [-X=cluster_name] -B=bus_name 
                           -G=v5_gateway_configuration_file_name 
                          [-H=administration_hostname] [-A=administration_port] 
                          [-U=gateway_instance_name] [-P=object_prefix] 
                          [-username=WAS_user_ID -password=WAS_password]
      其中:
      • [AIX Solaris HP-UX Linux Windows][z/OS].ext 在 Windows 系統上是副檔名 .bat,在 Unix 或 Linux 系統上是 .sh
      • 方括弧 ("[ ]") 表示一個參數或一組參數在某些情況下為選用。
      • server_namenode_name 一起(對於單一伺服器)或 cluster_name(對於叢集)定義閘道配置移轉到的伺服器或叢集。
      • cell_nameserver_namenode_name(或 cluster_name)、administration_hostnameadministration_port,共同定義更新版本的應用程式伺服器(或叢集)的連線。 server_namecluster_name 指定建立端點接聽器和出埠連接埠目的地所在的目標應用程式伺服器或叢集的名稱。 如果要移轉到受管理 Cell 中的伺服器或叢集,則 administration_hostnameadministration_port 定義部署管理程式的主機名稱和 SOAP 管理埠號。 如果要移轉到不在受管理 Cell 中的伺服器,則 administration_hostnameadministration_port 定義獨立式伺服器的主機名稱和埠號,而且為選用。 如果省略,指令會假設預期的值為 localhost:8880(亦即獨立式伺服器的 WebSphere Application Server 預設值)。
        [IBM i]註: 對於 IBM i 平台,administration_hostname 是必要的。
      • v5_gateway_configuration_file_name 是匯出的 5.1 版專用閘道 XML 配置檔的完整路徑和檔名。
      • bus_namegateway_instance_name 共同定義您在此匯流排內建立的閘道實例。 只有當您想要在此匯流排內建立多個閘道實例時,才需要 gateway_instance_name。 如果省略這個選用參數,則會指派預設名稱。
      • object_prefix 這個字串作為移轉處理程序所定義的物件的名稱字首。 如果省略,則會改用移轉的服務的名稱空間 URI(預設值 urn:ibmwsgw)。
      • 如果目標應用程式伺服器或叢集受密碼保護,則 WAS_user_IDWAS_password 是必要的。
  12. 選擇性的: 如果移轉處理程序變更所移轉服務的外部網址,請修改端點接聽器配置來更新這些位址。 如果外部網址指向閘道機器,而不是 Web 伺服器,而且您已將閘道移轉到不同的機器或相同機器上不同的埠,則必須這麼做。

下一步

註:
  • 如果 5.1 版閘道使用過濾器,請使用 JAX-RPC 處理程式與服務整合匯流排調解的組合,重建過濾器功能。
  • 如果閘道配置中有任何閘道服務具有多個目標服務,則 5.1 版配置可能已使用遞送過濾器來選擇特定的目標服務。如果是這種情形,您必須進一步配置移轉的閘道,透過遞送調解選擇目標服務和埠
  • 更新版本中的 Web 服務閘道使用更多記憶體來處理訊息,如果您透過已移轉的閘道傳遞大型附件,Java 虛擬機器中可能會發生記憶體不足錯誤。如果要解決這個問題,請增加 JVM 資料堆大小。

指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsg_coex_migrate
檔名:twsg_coex_migrate.html