某些 InterChange Server 元件需要其他的作業來完成它們的升級。
下列幾節說明完成這些升級的方法:
- 重要事項:
- 是否需要執行本節中的步驟,視您現行 InterChange Server 的版本而定:
- 如果是從 4.1.1 版的 InterChange Server 升級,
請執行本節中的步驟,將預先存在的 ICS 元件匯入至「整合元件程式庫 (ICL)」。
- 如果是從 4.2.0、4.2.1 或 4.2.2
版的 InterChange Server 升級, 則您不需要將 ICS 元件匯入至
ICL,因為預先存在的 ICL 仍然存在。繼續進行完成協同作業範本和對映升級中的指示。
從 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 類別檔中是否有下列程式碼:
- 如果對映和協同作業中的任何自訂程式碼使用 VisiBroker 特有的 CORBA
延伸規格,則這個程式碼將不會在 IBM Java ORB 下運作。
您必須將程式碼變為不專屬於任何廠商的 Java 程式碼。 如果協同作業或對映使用自訂
IDL 與對應的 Stub 搭配, 請使用 idlj 編譯器來重新編譯這些
Stub。對於所有平台而言,idlj 編譯器隨附於 JDK 且存放在 JDK CD 中。
- 註:
- 從 Sun 或 HP 中與 JDK 一起下載的 idlj 編譯器,可能無法與 IBM ORB
相容。請使用 JDK CD 提供的工具。
- IBM JDK 已通過認證,可與 Java 相容,
因此在執行先前編譯的協同作業和對映類別時,應該不會造成問題。
不過,如果任何協同作業或對映含有任何 Sun JDK 特有的自訂程式碼,
您就必須將該程式碼變為不專屬於任何廠商的 Java 程式碼。
如果變更任何 Java 類別檔,
您就必須重新編譯程式碼,然後將相關聯的元件重新部署至 ICS 儲存庫。
有關如何編譯對映的詳細資訊,請參閱 Map Development
Guide。有關如何編譯協同作業範本的詳細資訊, 請參閱 Collaboration
Development Guide。有關如何重新部署的詳細資訊,請參閱部署至 ICS。
- 重要事項:
- 是否需要執行本節中的步驟,視您現行 InterChange Server 的版本而定:
- 如果是從 4.1.1 版的 InterChange Server 升級,
請執行本節中的步驟,來轉換預先存在的協同作業範本和對映的格式。
- 如果是從 4.2.0、4.2.1 或 4.2.2
版的 InterChange Server 升級,
則不需要轉換協同作業範本或對映的格式。 繼續進行完成連接器升級中的指示。
利用 4.2.0 版之前的 InterChange Server
軟體版本所建立的協同作業範本和對映,
必須轉換成與現行軟體相容的新格式。在新格式中,
所有協同作業和對映資訊都儲存在儲存庫中,
作為協同作業範本和對映定義的一部分。
- 註:
- 利用 4.0.0 版之前的
InterChange Server
軟體版本所建立的協同作業範本和對映,使用的是目前已非必要項目的協同作業模型
(CollaborationName.clm) 檔和對映設計
(MapName.dlm) 檔。請尋求 IBM
技術支援人員的協助。
若要將協同作業範本和對映轉換為新的格式:
- 在連接的 Windows 機器上, 將預先存在的對映和範本,從 ICS
儲存庫匯入至「系統管理程式」內的整合元件程式庫 (ICL)。
有關如何使用「系統管理程式」的「匯入」元件精靈來匯入元件的詳細資訊,請參閱
Implementation Guide for WebSphere InterChange Server。
- 註:
- 「匯入」元件精靈會偵測任何以 4.2
之前的格式來表示的對映或協同作業範本。在這種情況下,它會問您是否要轉換它們。
若要將對映和協同作業範本轉換為 4.3
格式,請確實啟用「對映」和「協同作業範本」的勾選框。
- 如果由於升級類別檔 (請參閱升級元件類別檔),以致並未編譯已匯入的對映和協同作業範本,
請在此時編譯它們。有關如何編譯對映的詳細資訊, 請參閱 Map Development
Guide。有關如何編譯協同作業範本的詳細資訊, 請參閱 Collaboration
Development Guide。
- 使用改寫選項,將已升級的對映和協同作業範本部署至 UNIX 機器上的 ICS
儲存庫。如需相關資訊,請參閱部署至 ICS。
本節提供將連接器升級至 4.3 版 InterChange Server
所須執行步驟的相關資訊:
- 安裝相關配接器。
- 將連接器升級至整合分配管理系統:
- 如果已自訂任何連接器啟動 Script,您可能需要加以升級。 如需相關資訊,請參閱升級連接器啟動 Script。
- 驗證連接器升級。如需相關資訊,請參閱驗證連接器配置。
若要取得 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
包含連接器-代理程式資訊, 則會針對每一個列出的連接器建立個別的連接器配置檔。
- 配置檔的路徑已變更,因此您必須在自訂連接器啟動 Script 內呼叫
start_adapter.sh Script
的那一行上,指定這個檔案的完整路徑。做法為使用 -c 選項,如下所示:
start_adapter.sh -dconnector_name -nconnector_name
-cfully_qualified_name_of_new_config_file
- 若要在您的儲存庫中納入升級的連接器定義,
請使用「連接器配置程式」(位於執行「工具」的已連接 Windows 機器上),
以開啟隨連接器而提供的新連接器定義檔 (通常,所提供的檔案名稱是
connectorName.txt)。
在「連接器配置程式」中開啟檔案之後,
請設定連接器內容,然後選擇「另存專案」,將配置儲存到「系統管理程式」中。
從「系統管理程式」中,您可以將新的連接器配置部署至 InterChange Server, 如
Implementation Guide for WebSphere InterChange Server 中所述。
- 註:
- 若要確定升級的連接器有最新的內容,請參閱適當的配接器手冊。
若要將您的連接器從 WebSphere Message Broker (MQ Integrator、MQ
Integrator Broker 或 Business Integration Message Broker) 移轉至 InterChange
Server 系統 4.3 版,
請遵循下列步驟。這些步驟中有幾個必須在執行「工具」的已連接 Windows
機器上完成。
- 使用「系統管理程式」工具,來建立新的「整合元件程式庫」。
- 使用「連接器配置程式」,來確認本端配置中所指定的所有佇列對於 InterChange
Server 而言都有效。
- 對於每一個連接器定義檔,使用「連接器配置程式」,來執行下列動作:
- 將 DeliveryTransport 連接器內容從 WebSphere Message Broker-JMS
變為 JMS。
- 將 RepositoryDirectory 內容變為 REMOTE。
- 升級連接器內容,如下所示:
- 新增或刪除連接器特有內容。若要確定升級的連接器有最新的特有內容,請參閱相關的配接器手冊。
- 確定所有適當的標準內容都具有值。
若要確定升級的連接器有最新的標準內容,請參閱相關配接器手冊中的標準內容附錄。
- 使用「連接器配置程式」中的「儲存至專案」選項,將連接器定義儲存至「整合元件程式庫」。
- 使用「商業物件設計程式」工具來升級商業物件定義 (.xsd)
檔,以包含語言環境資訊。
- 使用「商業物件設計程式」中的「儲存至專案」選項,將商業物件定義儲存至「整合元件程式庫」。
- 從「系統管理程式」中,將已更新的連接器配置和商業物件定義部署至 InterChange
Server, 如 Implementation Guide for WebSphere InterChange Server
中所述。
所有 InterChange Server 啟動 Script 都已變更, 以因應從 VisiBroker ORB 到
IBM Java ORB 的移轉。 如果已修改 4.2.2 之前的連接器啟動
Script,則也需要對新的啟動 Script 做出類似的變更。
4.2.2 版推出了新的啟動 Script
結構,具有下列主要的變更:
- 所有系統環境變數都是新的,而且設定在單一的
CWSharedEnv.sh 檔中。所有啟動 Script
都會在其呼叫程序中讀取這個檔案。 它位於設定 ICS 全系統內容 (如 IBM Java ORB
的內容) 的這個檔案中。 如需此 CWSharedEnv.sh
檔的詳細資訊,請參閱 System Administration Guide。
- 若要啟動連接器,請使用 start_connName.sh 啟動
Script,其中包含連接器特有的資訊。 這個
start_connName.sh Script 會接著呼叫
start_adapter.sh 檔,其中包含所有連接器的一般設定。
它會設定配接器環境並呼叫連接器。
- 註:
- 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,請執行下列動作:
- 舊版的「交互作業能力物件參照」(.ior) 檔須透過 VisiBroker
ORB 而產生,會複製到含有存取用戶端的機器上, 因此必須換成 InterChange Server
啟動後,IBM Java ORB 所產生的 .ior 檔。
- AccessInterfaces.idl 檔必須利用 idlj
編譯器來重新編譯。請使用 JDK CD 隨附的 idlj 編譯器。
- 註:
- 如果您是從 Sun 或 HP 下載 JDK,則隨附的 idlj 編譯器可能與 IBM ORB
不相容。請使用 JDK CD 提供的 idlj 編譯器。
- 存取用戶端中的程式碼必須起始設定 IBM ORB 來代替 VisiBroker
ORB。例如,在取自於 Access Development Guide「Servlet
範例」的程式碼片段中, 必須對其中兩個 CORBA 起始設定內容進行變更,才能反映 IBM
ORB 的使用情形,而非 VisiBroker ORB。做法如下所示,變更部份是以粗體字來表示。
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);
正確更新後,用戶端存取程式碼將變成:
Properties orbProperties=new java.util.Properties();
orbProperties.setProperty("org.omg.CORBA.ORBClass",
"com.ibm.CORBA.iiop.ORB");
orbProperties.setProperty("org.omg.CORBA.ORBSingletonClass",
"com.ibm.rmi.corba.ORBSingleton");
org.omg.CORBA.ORB orb =
org.omg.CORBA.ORB.init((String[])null,orbProperties);
如果在 Servlet 內使用存取用戶端,則 IBM ORB 會內含在 WebSphere Application
Server 的執行時期中。因此,必須進行下列變更:
- 從類別路徑中移除所有 VisiBroker .jar 參照。
- 依說明重新編譯 AccessInterfaces.idl。
- 確保 Servlet 程式碼依說明起始設定 IBM ORB 來代替 VisiBroker ORB。
如果使用 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。
因為 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 的版本而定:
- 如果是從 4.1.1 版的 InterChange Server 升級, 您必須為 ICS
元件建立使用者專案。繼續進行建立專案中的指示。
- 如果是從 4.2.0、4.2.1 或 4.2.2
版的 InterChange Server 升級, 且已匯出現有的使用者專案 (如移轉現有的專案中所述), 請執行匯入現有的專案中的步驟,
來匯入任何現有的使用者專案。如果沒有現有的專案,則您可以遵循建立專案中的步驟。
如果已匯出現有的使用者專案,則您可以在 ICS 執行後匯入它們。 請將在連接的
Windows 機器上執行的「系統管理程式」連接至 ICS 實例,然後執行下列步驟:
- 展開「使用者專案」資料夾,再以滑鼠右鍵按一下「InterChange Server 專案」,
然後選取「匯入解決方案」。
- 選取從 4.3 之前的版本匯出時所建立的資料夾位置。
- 驗證是否已順利地匯入您所有的使用者專案。
建議您為每一個介面建立一個專案,並為共用元件 (如 Meta 物件和連接器)
建立個別的專案。 請將在連接的 Windows 機器上執行的「系統管理程式」連接至 ICS
實例,然後執行下列步驟:
- 以滑鼠右鍵按一下「使用者專案」,然後選取「新建使用者專案」。
- 指派一個名稱給使用者專案。這個名稱必須是介面的唯一識別名稱。
- 註:
- 使用者專案不能與現有的使用者專案或現有的 ICL 專案同名。
- 選取使用者專案的元件。這個步驟會建立每一個必要元件的捷徑。
元件本身仍會留在它們的 ICL 中。
有關如何建立專案的詳細資訊,請參閱 Implementation Guide for WebSphere
InterChange Server。
- 重要事項:
- 是否需要執行本節中的步驟,視您現行 InterChange Server 的版本而定:
- 如果是從 4.1.1 版的 InterChange Server 升級,
請執行本節中的步驟,將預先存在的 ICS 元件部署至新的儲存庫。
- 如果是從 4.2.0、4.2.1 或 4.2.2
版的 InterChange Server 升級,
您只有在修改了類別檔時,才需要部署協同作業範本或對映 (如升級元件類別檔中所述)。若要部署協同作業範本或對映,
請執行本節中的步驟。否則,請繼續進行驗證升級中的指示。
在連接的 Windows 機器上的「系統管理程式」中定義了 ICL
和使用者專案之後,即可將元件部署至 UNIX 機器上的 InterChange Server 儲存庫中。
如果未對 ICS 元件做出任何變更,則只需要重新部署對映和協同作業範本這些元件。
「系統管理程式」連接至 ICS 實例後,請執行下列作業:
- 以滑鼠右鍵按一下使用者專案,並選取「部署使用者專案」。
- 在已登錄及已連接的 ICS 實例中,選擇下拉清單內的目標 ICS 實例來進行部署。
- 停止並重新啟動 InterChange Server。
有關如何將元件部署至伺服器的詳細資訊,請參閱 Implementation Guide for
WebSphere InterChange Server。
