完成元件升級

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

匯入至 ICL

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

從 4.2.0 版開始,ICS 元件的開發是在本端環境進行,而不是在 ICS 實例中進行 (如 4.1.1 中一般)。 因此,如果是從 4.1.1 版升級,您必須在執行「工具」的 Windows 機器上, 於「系統管理程式」內建立「整合性元件程式庫 (ICL)」。 ICL 可存放您的 InterChange Server 元件。 有關如何建立 ICL 的指示,請參閱 System Integration Guide。 在建立了 ICL (或多個 ICL) 之後,即可從 UNIX 機器上的 InterChange Server 儲存庫匯入元件。

註:
建議您以片段方式匯入 ICS 元件, 因為匯入大區塊資料的速度可能很慢,而且可能導致「系統管理程式」發生記憶體錯誤。 若您的元件數量極為繁多,您可以中斷匯入程序進一步的執行。 建議的元件匯入順序如表 33 中所示。

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

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

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

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

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

只在您是從 4.1.1 版升級時,才需要本節中的指示。

在升級了 ICS 儲存庫之後,即可進行預先存在的對映和協同作業範本的升級。 這個升級包括下列步驟:

升級元件類別檔

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

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

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

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

將元件轉換為新的格式

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

利用 4.2.0 版之前的 InterChange Server 軟體版本所建立的協同作業範本和對映, 必須轉換成與現行軟體相容的新格式。在新格式中, 所有協同作業和對映資訊都儲存在儲存庫中, 作為協同作業範本和對映定義的一部分。

註:
利用 4.0.0 版之前的 InterChange Server 軟體版本所建立的協同作業範本和對映,使用的是目前已非必要項目的協同作業模型 (CollaborationName.clm) 檔和對映設計 (MapName.dlm) 檔。請尋求 IBM 技術支援人員的協助。

若要將協同作業範本和對映轉換為新的格式:

  1. 在連接的 Windows 機器上, 將預先存在的對映和範本,從 ICS 儲存庫匯入至「系統管理程式」內的整合元件程式庫 (ICL)。 有關如何使用「系統管理程式」的「匯入」元件精靈來匯入元件的詳細資訊,請參閱 Implementation Guide for WebSphere InterChange Server
    註:
    「匯入」元件精靈會偵測任何以 4.2 之前的格式來表示的對映或協同作業範本。在這種情況下,它會問您是否要轉換它們。 若要將對映和協同作業範本轉換為 4.3 格式,請確實啟用「對映」和「協同作業範本」的勾選框。
  2. 如果由於升級類別檔 (請參閱升級元件類別檔),以致並未編譯已匯入的對映和協同作業範本, 請在此時編譯它們。有關如何編譯對映的詳細資訊, 請參閱 Map Development Guide。有關如何編譯協同作業範本的詳細資訊, 請參閱 Collaboration Development Guide
  3. 使用改寫選項,將已升級的對映和協同作業範本部署至 UNIX 機器上的 ICS 儲存庫。如需相關資訊,請參閱部署至 ICS

完成連接器升級

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

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

升級連接器至新的 ICS

若要取得 WebSphere Business Integration Adapters 來使用 InterChange Server, 您必須安裝 2.6 版的 WebSphere Business Integration Adapter。不過,若為全新安裝,您不能只複製現有的配接器目錄 (位於 ProductDir/connectors 目錄的子目錄中), 因為有「WebSphere Business Integration Adapters 安裝程式」提供的共用元件。不再有適用於所有配接器的單一「安裝程式」, 因此您必須使用每一個相關配接器自己的「安裝程式」來進行安裝。

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

有關如何安裝配接器的詳細資訊,請參閱個別的配接器手冊。

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

  1. 配置檔的路徑已變更,因此您必須在自訂連接器啟動 Script 內呼叫 start_adapter.sh Script 的那一行上,指定這個檔案的完整路徑。做法為使用 -c 選項,如下所示:
    start_adapter.sh -dconnector_name -nconnector_name
      -cfully_qualified_name_of_new_config_file
     
  2. 若要在您的儲存庫中納入升級的連接器定義, 請使用「連接器配置程式」(位於執行「工具」的已連接 Windows 機器上), 以開啟隨連接器而提供的新連接器定義檔 (通常,所提供的檔案名稱是 connectorName.txt)。

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

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

從 WebSphere Message Broker 移轉至 ICS

若要將您的連接器從 WebSphere Message Broker (MQ Integrator、MQ Integrator Broker 或 Business Integration Message Broker) 移轉至 InterChange Server 系統 4.3 版, 請遵循下列步驟。這些步驟中有幾個必須在執行「工具」的已連接 Windows 機器上完成。

  1. 使用「系統管理程式」工具,來建立新的「整合元件程式庫」。
  2. 使用「連接器配置程式」,來確認本端配置中所指定的所有佇列對於 InterChange Server 而言都有效。
  3. 對於每一個連接器定義檔,使用「連接器配置程式」,來執行下列動作:
    1. DeliveryTransport 連接器內容從 WebSphere Message Broker-JMS 變為 JMS
    2. RepositoryDirectory 內容變為 REMOTE
    3. 升級連接器內容,如下所示:
      • 新增或刪除連接器特有內容。若要確定升級的連接器有最新的特有內容,請參閱相關的配接器手冊。
      • 確定所有適當的標準內容都具有值。 若要確定升級的連接器有最新的標準內容,請參閱相關配接器手冊中的標準內容附錄。
  4. 使用「連接器配置程式」中的「儲存至專案」選項,將連接器定義儲存至「整合元件程式庫」。
  5. 使用「商業物件設計程式」工具來升級商業物件定義 (.xsd) 檔,以包含語言環境資訊。
  6. 使用「商業物件設計程式」中的「儲存至專案」選項,將商業物件定義儲存至「整合元件程式庫」。
  7. 從「系統管理程式」中,將已更新的連接器配置和商業物件定義部署至 InterChange Server, 如 Implementation Guide for WebSphere InterChange Server 中所述。

升級連接器啟動 Script

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

4.2.2 版推出了新的啟動 Script 結構,具有下列主要的變更:

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

如果您在 4.2.2 之前的版本中自訂了連接器啟動 Script, 則您應該重新檢查它們,以確定您的自訂以這個新的啟動 Script 結構 (4.3 也使用這個結構) 出現在正確的檔案中。

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

驗證連接器配置

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

升級存取用戶端

若要使用 IBM Java ORB,或想使用另一個符合 CORBA 2.3 的 ORB 實作方式, 則必須升級存取用戶端。請聯絡 ORB 廠商來確定您的 ORB 與 CORBA 2.3 相符。本節的其餘部份假設您使用的是 IBM Java ORB。

若要升級目前使用 VisiBroker ORB 的存取用戶端,以利使用 IBM Java ORB,請執行下列動作:

如果在 Servlet 內使用存取用戶端,則 IBM ORB 會內含在 WebSphere Application Server 的執行時期中。因此,必須進行下列變更:

如果使用 WebSphere Access for EJB,則 IBM Java ORB 會內含於 WebSphere Application Server 執行時期中。在這種情況下,唯一必要的變更就是從類別路徑中移除 VisiBroker .jar 參照,因為 Access for EJB .jar 檔包含所有其他必要的成品,如已編譯的 IDL 和 Session Bean。

升級其他元件

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

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

升級 SNMP

因為 4.3 版的「SNMP 代理程式」中發生內部資料結構變更, 所以無法再辨識舊的狀態檔 (sts)。狀態檔包含下列項目的相關資訊: 「代理程式」的群體名稱 (作用有如密碼)、設陷轉送目標、目標 ICS 連線, 以及 RBAC 安全使用者名稱和密碼。 在升級至 4.3 版「SNMP 代理程式」之後,您將需要執行「SNMP 配置管理程式」, 才能重新輸入先前在狀態檔中儲存的資訊。

您也必須以手動方式重新配置與「SNMP 代理程式」搭配使用的「管理主控台」, 因為 MIB 檔將會變更。「管理主控台」會使用 MIB 檔,來了解「SNMP 代理程式」所提供的資訊。 這個檔案在 4.3 版中做了修改,因此使用新的「SNMP 代理程式」的使用者,必須將新的 MIB 檔載入他們的「管理主控台」中。

註:
儘管配置檔的格式保持不變,但檔案名稱已從 cwsnmpagent.cfg 變為 wbi_snmpagent.cfg,因此強烈建議您使用 SNMP 配置精靈, 來建立新的版本。請務必在啟動「SNMP 代理程式」之前執行這個動作。

升級系統監視器

如果您使用「系統監視器」,則將移轉現有的「檢視畫面」及「監視器」, 使它們能與 ICS 4.3 版相容。這會在使用者登入「系統監視器」時自動完成。

處理使用者專案

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

匯入現有的專案

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

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

建立專案

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

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

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

部署至 ICS

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

在連接的 Windows 機器上的「系統管理程式」中定義了 ICL 和使用者專案之後,即可將元件部署至 UNIX 機器上的 InterChange Server 儲存庫中。 如果未對 ICS 元件做出任何變更,則只需要重新部署對映和協同作業範本這些元件。

「系統管理程式」連接至 ICS 實例後,請執行下列作業:

  1. 以滑鼠右鍵按一下使用者專案,並選取「部署使用者專案」。
  2. 在已登錄及已連接的 ICS 實例中,選擇下拉清單內的目標 ICS 實例來進行部署。
  3. 停止並重新啟動 InterChange Server。

有關如何將元件部署至伺服器的詳細資訊,請參閱 Implementation Guide for WebSphere InterChange Server

Copyright IBM Corp. 1997, 2004