完成元件升級

某些 InterChange Server 元件需要其他的作業來完成它們的升級。 下列幾節說明如何完成那些升級:

匯入至 ICL

重要事項:
是否需要執行本節中的步驟,視您現行 InterChange Server 的版本而定:

從 4.2.x 版開始,開發 ICS 元件是在本端環境進行,而不是在 ICS 實例中進行 (如 4.1.1 中一般)。 因此,如果是從 4.1.1 版升級,則您必須在「系統管理程式」內建立「整合性元件程式庫 (ICL)」。ICL 會存放您的 InterChange Server 元件。如需如何建立 ICL 的相關指示,請參閱 System Integration Guide。 一旦建立了 ICL (或多個 ICL) 之後,您已準備好從 InterChange Server 儲存庫匯入元件。

註:
建議您以片段方式匯入 ICS 元件, 因為匯入大塊資料可能使得速度變慢,而且可能導致「系統管理程式」發生記憶體錯誤。 如果具有不尋常的大量元件,您甚至可能想要進一步地中斷匯入程序。 建議的元件匯入順序如表 17 中所示。

表 17. 匯入 ICS 元件的順序
順序 ICS 元件 匯入的步驟
1 商業物件

將預先存在的商業物件定義,從 ICS 儲存庫匯入至「系統管理程式」內的 ICL。請參閱 Implementation Guide for WebSphere InterChange Server,以取得如何使用「系統管理程式」的「匯入」元件精靈來匯入元件的詳細資訊。

2 對映 完成協同作業範本和對映升級
3 協同作業範本和協同作業物件 完成協同作業範本和對映升級
4 連接器 完成連接器升級
5 關係

將預先存在的關係定義,從 ICS 儲存庫匯入至「系統管理程式」內的 ICL。請參閱 Implementation Guide for WebSphere InterChange Server,以取得如何使用「系統管理程式」的「匯入」元件精靈來匯入元件的詳細資訊。

完成協同作業範本和對映升級

一旦升級了 ICS 儲存庫,您就準備好完成任何預先存在的對映和協同作業範本的升級。 這個升級包括下列步驟:

升級元件類別檔

必須檢查預先存在的 Java 類別 (.class) 檔找出是否有對映和協同作業範本,以確定程式碼與新版本相容。

註:
確定您的類別檔位於新版本的適當目錄中,如下所示:

檢查預先存在的 Java 類別檔中是否有下列程式碼:

如果變更任何 Java 類別檔, 則您必須重新編譯程式碼,然後將相關聯的元件重新部署至 ICS 儲存庫。 如需如何編譯對映的相關資訊,請參閱 Map Development Guide。如需如何編譯協同作業範本的相關資訊, 請參閱 Collaboration Development Guide

完成連接器升級

本節提供將連接器升級至 4.3 版 InterChange Server 之步驟的相關資訊:

  1. 安裝相關配接器。
  2. 將連接器升級至整合分配管理系統:
  3. 如果已自訂任何連接器啟動 Script,您可能需要升級它們。 如需詳細資訊,請參閱升級連接器啟動 Script
  4. 驗證連接器升級。如需詳細資訊,請參閱驗證連接器配置

升級連接器至新的 ICS

若要讓 WebSphere Business Integration Adapters 與您的 InterChange Server 一起運作,您必須安裝 WebSphere Business Integration Adapter 2.4 版。不過,若為全新安裝,您不能只複製任何現有的配接器目錄 (位於 ProductDir\connectors 目錄的子目錄中),因為它們是「WebSphere Business Integration Adapters 安裝程式」提供的共用元件。 因為不再有適用於所有配接器的單一「安裝程式」,所以您必須使用每一個相關配接器自己的「安裝程式」來進行安裝。

註:
當 InterChange Server 是您的整合分配管理系統時,您需要安裝 Adapter Framework 產品。

如需如何安裝配接器的詳細指示,請參閱個別的配接器手冊。

如果 ICS 配置檔 (InterchangeSystem.cfg) 包含連接器-代理程式資訊, 則會針對每一個列出的連接器建立個別的連接器特定配置檔。

  1. 指定已針對特定連接器更新的本端配置檔:
    1. 導覽至「開始」>「程式集」> IBM WebSphere Integration Adapters >「配接器」>「連接器」> 「連接器名稱」
    2. 以滑鼠右鍵按一下連接器名稱並選取「內容」。
    3. 在「目標」欄位的路徑尾端插入 -c filename 指令,其中 filename 是擁有該連接器項目之本端配置檔的完整路徑。
  2. 若要在您的儲存庫中納入升級的連接器定義, 請使用「連接器配置程式」來開啟連接器所提供的新連接器定義檔 (通常,所提供的檔案名稱是 connectorName.txt)。

    在「連接器配置程式」中開啟檔案之後, 請設定連接器內容,然後選擇「另存專案」,將配置儲存到「系統管理程式」中。 從「系統管理程式」中,您可以將新的連接器配置部署至 InterChange Server, 如 Implementation Guide for WebSphere InterChange Server 中所述。

    註:
    若要確定您有已升級連接器的最新內容,請參閱適當的配接器手冊。

如果您正在升級 WebSphere Business Integration Adapters 產品, 並正在使用 ICS 作為整合分配管理系統,您必須重新套用對配接器捷徑的任何自訂。 在配接器升級期間會改寫捷徑。

從 WebSphere 訊息分配管理系統移轉至 ICS

若要將您的連接器從「WebSphere 訊息分配管理系統」 (MQ Integrator、MQ Integrator Broker 或 Business Integration Message Broker) 移轉至 InterChange Server 系統, 請遵循下列步驟:

  1. 將連接器特有的配置和商業物件定義 (.xsd) 檔,從 WebSphere Message Broker 目錄複製至 InterChange Server 目錄。
  2. 確認本端配置中指定的所有佇列對於 InterChange Server 而言都有效。
  3. 使用「連接器配置程式」工具,將 DeliveryTransport 連接器內容從 WebSphere Message Broker-JMS 變更為 JMS
  4. 使用「連接器配置程式」工具,將 RepositoryDirectory 內容變更為 REMOTE
  5. 升級連接器內容:
  6. 使用「商業物件設計程式」工具,升級商業物件定義 (.xsd) 檔以包含語言環境資訊。
  7. 使用「系統管理程式」工具來建立專案,其中包含連接器特有的配置和商業物件定義檔案。
  8. 將專案部署至 ICS 儲存庫。如需部署專案的相關資訊,請參照 Implementation Guide for WebSphere InterChange Server

升級連接器啟動 Script

所有 InterChange Server 啟動 Script 都已變更, 以因應從 VisiBroker ORB 移轉至 IBM Java ORB。 如果已修改 4.3 之前的連接器啟動 Script, 則也應該對新的啟動 Script 做出類似的變更。

這個版本引進了啟動 Script 結構,其主要變更如下:

註:
IBM 目前提供的大部分配接器尚未對它們的啟動 Script 使用這個新的結構。 您不需要修改這些 IBM 提供的配接器的啟動 Script。 只有自訂配接器的啟動 Script 才應該修改。

如果已在舊版中自訂了任何連接器啟動 Script, 則您應該重新檢查它們,以確定您的自訂以這個新的啟動 Script 結構出現在正確的檔案中。

註:
在連接器啟動 Script 中,請確定對於任何您的連接器所使用的自訂資料處理常式而言, 您已將 .jar 檔併入 CLASSPATH (或 JCLASSES) 變數中。 尤其,驗證資料處理常式列示在 CLASSPATH 的順序。比方說, 如果您使用 XML 資料處理常式,請確定 CwXMLDataHandler.jar 檔是在 CwDataHandler.jar 檔的前面。 xml.class 檔同時存在於這兩個 .jar 檔中, 而且您想要確定 CwXMLDataHandler.jar 中的 xml.class 檔就是已執行的 xml.class 檔。

驗證連接器配置

在完成任何連接器升級或修改之後,請確定新環境的連接器已正常的配置。 若要執行此動作:

升級存取用戶端

因為自 4.2.2 起 IBM ORB 已經取代 VisiBroker, 所以 VisiBroker 可能不會與 InterChange Server 4.3.0 版一起出現。與 4.3.0 版一起安裝的 IBM ORB 是唯一支援的存取用戶端。您必須先對舊版存取用戶端做一些變更,才能與 4.3 版一起運作。程式碼變更如下:

...
 Properties orbProperties=new java.util.Properties();
 orbProperties.setProperty("org.omg.CORBA.ORBClass", "com.inprise.vbroker.orb.ORB");
 orbProperties.setProperty("org.omg.CORBA.ORBSingletonClass",
 "com.inprise.vbroker.orb.ORBSingleton");
 org.omg.CORBA.ORB orb = org.omg.CORBA.ORB.init((String[])null, orbProperties);
 ...
 

請移除包含有 setProperty() 方法呼叫 (參照到 VisiBroker 類別 com.inprise.vborker.org.*) 的二行指令, 以便讓組織架構使用 JDK 預設的 ORB 實作方式,而非 VisiBroker。

存取用戶端可與任何與 CORBA 2.3 相容的標準 ORB 一起運作。非 IBM ORB,請參閱該特定 ORB 供應商以了解任何可能的相容性問題。

存取用戶端仍然可以使用 IgetInterchangeAccessSession() 方法來取得其存取階段作業,如下所示:

accessSession = accessEngine.IgetInterchangeAccessSession(userName, passWord);
 

有關 4.3 版所引進的新安全機制,反而建議您使用 SecureLoginUtility 來取得存取階段作業,如下所示:

Properties props = new Properties();
 props.put("username", "admin");
 props.put("password", "admin");
 accessSession = SecureLoginUtility.login(accessEngine , props);
 

在這種方法中,使用者名稱及密碼均加密。它可防止任何機密資訊在傳輸期間遭到竊取。

升級其他元件

如果已建立的任何其他元件具有自訂 .jar 檔 (如資料處理常式), 則您必須將自訂 .jar 檔複製至新目錄結構中的適當位置。通常, 自訂 .jar 檔位於產品目錄的 lib 子目錄。

註:
您也必須確定這些自訂 .jar 檔列示在適當的啟動 Script 中。如需詳細資訊,請參閱升級伺服器啟動 Script

處理使用者專案

重要事項:
是否需要執行本節中的步驟,視您現行 InterChange Server 的版本而定:

匯入現有的使用者專案

如果已匯出現有的使用者專案,則一旦 ICS 執行時,您就可以匯入它們。 請將「系統管理程式」連接至 ICS 實例,然後執行下列步驟:

  1. 展開「使用者專案」資料夾、用滑鼠右鍵按一下「InterChange Server 專案」, 然後選取「匯入解決方案」。
  2. 選取從 4.3 之前的版本匯出期間所建立的資料夾位置。
  3. 驗證您所有的使用者專案都已順利匯入。

建立專案

建議您為每一個介面建立一個專案,以及為共用元件 (如 Meta 物件和連接器) 建立個別的專案。 請將「系統管理程式」連接至 ICS 實例,然後執行下列步驟:

  1. 用滑鼠右鍵按一下「使用者專案」,然後選取「新建使用者專案」。
  2. 指派一個名稱給使用者專案。這個名稱應該專門識別介面。
    註:
    使用者專案的名稱不能與現有的使用者專案或現有的 ICL 專案相同。
  3. 選取使用者專案的元件。這個步驟會建立每一個必要元件的捷徑。 元件本身仍會留在它們的 ICL 中。

如需如何建立專案的詳細資訊,請參閱 Implementation Guide for WebSphere InterChange Server

Copyright IBM Corp. 1997, 2004