準備現有的 ICS 系統

在準備 ICS 系統進行升級時,您有兩個移轉 ICS 資料庫的選項:原位資料庫移轉及非原位資料庫移轉。 原位資料庫移轉表示重複使用舊的儲存庫,並在 ICS 伺服器第一次啟動期間, 讓 ICS 執行儲存庫的升級。非原位資料庫移轉表示利用全新的和空的儲存資料庫來進行升級。

使用非原位資料庫移轉來升級 InterChange Server 系統包括下列步驟。 如果使用原位資料庫移轉,則指示中的變更將標示為「原位資料庫移轉」。

  1. 步驟 1 - 備份 InterChange Server 系統
  2. 步驟 2 - 使系統處於靜止狀態
  3. 步驟 3 - 解除安裝 InterChange Server 及「協力廠商」軟體
  4. 步驟 4 - 安裝 InterChange Server 及「協力廠商」軟體
  5. 步驟 5 - 升級 Object Request Broker
  6. 步驟 6 - 升級 InterChange Server
  7. 步驟 7 - 啟動 InterChange Server 及「協力廠商」軟體
  8. 步驟 8 - 載入儲存庫
  9. 步驟 9 - 從 4.1.1 版移轉的特殊升級程序
  10. 步驟 10 - 驗證升級

步驟 1 - 備份 InterChange Server 系統

備份 InterChange Server 系統可讓您回復在安裝新版本期間可能不慎改寫的任何檔案。 在執行升級程序之前,請備份靜態資料和動態資料 (您定期備份的可變更資料,不管是否升級)。如需靜態和動態資料範例,請參閱表 15

若要備份系統,請執行下列動作:

表 15 彙總如何備份不同的 ICS 元件。

表 15. InterChange Server 資料的備份方法
資料類型 備份方法
靜態資料

儲存庫
使用 repos_copy 公用程式儲存部分或所有自訂的 InterChange Server 元件。 如需詳細資訊,請參閱 System Administration Guide 中,如何備份 InterChange Server 元件的說明。

自訂協同作業 Java 類別檔 (.class) 及訊息檔 (.msg) ProductDir 目錄的 collaborations 子目錄併入系統備份:
ProductDir\collaborations 
 

自訂對映 Java 類別檔 (.class) 若要將這些檔案併入系統備份,請確定下列目錄位於系統備份:
ProductDir\DLMs 
 

自訂連接器 將下列目錄併入您的系統備份中: ProductDir\connectors\connector_name,其中 『connector_name』 是自訂連接器的名稱。

自訂的啟動 Script 如果您自訂了任何啟動 Script,請確定它們已併入您的系統備份中。

ICS 配置檔 (InterchangeSystem.cfg) 在您的系統備份中併入 ICS 配置檔 (位於 ProductDir 目錄中)。
動態資料

交互參照、失敗事件及關係表格 使用資料庫的資料庫備份公用程式。 如需詳細資訊,請參閱 System Administration Guide 中,如何備份 InterChange Server 元件的說明。

連接器事件保存表格 針對包含這些表格的資料庫使用資料庫備份公用程式。

日誌檔 將下列目錄併入系統備份:
ProductDir
 

步驟 2 - 使系統處於靜止狀態

將 InterChange Server 系統升級至 4.3 版之前,您必須確定系統處於靜止狀態。 這表示必須完成所有進行中的事件而且必須解決所有未完成的交易之後,才能備份環境並執行升級程序。

下列步驟說明如何使 InterChange Server 系統處於靜止狀態:

  1. 重新提出失敗的事件或捨棄事件 (此步驟是選用的)。您可以選擇將失敗事件升級至 ICS, 然後在系統完成升級之後處理它。
  2. PollFrequency 內容設為 No,阻止所有配接器輪詢事件表格。
  3. 讓所有事件通過系統,包括所有處理中的事件。必須解決所有未完成的交易。
  4. 停止協同作業。這項作業可確保在升級期間,沒有事件通過 InterChange Server。
  5. 移除佇列中的舊事件來清除佇列。
    註:
    唯有在您未在處理失敗事件並選擇從應用程式重新提出事件時,才需執行步驟 5。 如果您選擇要升級失敗事件,且您正在使用 MQ 傳輸,請「不要」清除佇列。 您應該備份佇列,然後在升級之後還原它們。 如需備份佇列的相關資訊,請參閱 MQ 文件。
  6. 關閉 InterChange Server 及所有相關的元件。
  7. 關閉資料庫。
  8. 關閉 4.2.2 版之前的 ORB (Visibroker) for ICS 版本。
  9. 關閉 MQSeries。

如需如何溫和停止執行中的系統之詳細資訊,請參閱 System Administration Guide

步驟 3 - 解除安裝 InterChange Server 及「協力廠商」軟體

下列步驟列出解除安裝協力廠商軟體的適當順序。

  1. 解除安裝 ORB (Visibroker) (適用於 4.2.2 之前的版本)
  2. 解除安裝 InterChange Server (ICS)
  3. 解除安裝 JDK
  4. 除去您的儲存庫表格。升級 ICS 時將重新建置這些表格。
    註:
    若為原位資料庫升級,您不需要除去儲存庫表格, 因為您將在新的安裝版本中重複使用儲存庫。

如果任何 InterChange Server 元件以服務的形式在執行,請在執行升級之前,解除安裝那些服務。 因為新的版本將位於不同的位置,所以現有的服務定義將不正確。 當升級完成時,請參閱"進階配置選項", 以取得關於將 InterChange Server 元件配置為服務的指示。

步驟 4 - 安裝 InterChange Server 及「協力廠商」軟體

下列步驟列出安裝 InterChange Server 元件的適當順序。

重要事項:
如果您必須升級任何協力廠商軟體,務必安排「系統管理者」先備份軟體之後再升級。
  1. 安裝 IBM JDK 1.4.2.
  2. 安裝或升級 DBMS,以及如果您想要保存執行時期資料,請還原執行時期表格。

    如果是從舊版 InterChange Server 移轉,請查看您是否也須升級資料庫軟體。 如需支援的資料庫軟體清單,請參閱「軟體需求」一節 (請參閱軟體需求)。 請比較現有的資料庫軟體版本與 4.3 版產品支援的版本。

    如果您必須升級資料庫軟體,請確定資料庫管理者 (DBA) 採取下列步驟:

    有關如何執行備份及升級資料庫軟體的指示,請參閱您的資料庫伺服器文件。如需如何移轉資料庫的詳細資訊, 請繼續進行步驟 8 - 載入儲存庫

  3. 安裝或升級至 WebSphere MQ 5.3.02 (CSD07)。
    重要事項:
    是否需要執行本節中的步驟,視您現行 InterChange Server 的版本而定:
    • 如果是從 4.2.0、4.2.1 或 4.2.2 版的 InterChange Server 升級, 您不需要升級 WebSphere MQ。
    • 如果是從 4.1.1 版的 InterChange Server 升級, 請執行本節中的步驟,將 WebSphere MQ 移轉至新的版本。

    當升級 WebSphere MQ 時,您可以採用下列其中一條路徑:

    一旦升級了 WebSphere MQ 軟體,您就需要配置它,才能與 InterChange Server 搭配使用。 如需相關資訊,請參閱配置 WebSphere MQ中的說明。

  4. 在舊版 ICS 所在目錄以外的新目錄中,安裝 InterChange Server。

步驟 5 - 升級 Object Request Broker

WebSphere InterChange Server 系統不再使用 VisiBroker Object Request Broker (ORB) 來處理 ICS 與其用戶端 (如連接器、 WebSphere Business Integration 工具、SNMP 代理程式及存取用戶端) 之間的通訊。 InterChange Server 系統現在會改用 IBM Java ORB。「ICS 安裝程式」在安裝 Java Runtime Environment (JRE) 時, 會自動安裝 IBM Java ORB。

InterChange Server 現在使用「IBM 暫時性命名伺服器」, 來代替 VisiBroker Smart Agent 提供它的命名服務。 若要升級系統來使用新的命名伺服器,請執行下列其中一個動作, 視 VisiBroker Smart Agent 是否安裝在與「IBM 暫時性命名伺服器」相同的主機上,且必須留在這個相同的主機上而定:

註:
如需 IBM Java ORB 的一般概觀,請參閱 System Administration Guide

已在安裝作業提供的啟動 Script 中,設定了如何使用內容來設定 IBM Java ORB。 不過,如果 4.3 版之前的 InterChange Server 使用 Inprise VisiBroker 軟體,且您自訂了任何 VisiBroker ORB 內容,則您可能需要對新的 Script 做出類似的變更, 以因應將 4.3 版移轉至 IBM ORB。如需 IBM ORB 內容及其 VisiBroker 對等項目的詳細資訊,請參閱升級 ORB 內容

升級 ORB 內容

為了調整 ORB,VisiBroker ORB 中會呈現各種 ORB 相關內容。 如果已在任何自訂的 Script 或軟體中使用了這些內容, 則您必須驗證是否已對 IBM Java ORB 適當地設定它們。表 16 會列出部份 VisiBroker ORB 內容, 以及它們在 IBM Java ORB 中的相等名稱。

如果您具有任何來自 4.3 之前安裝版本的自訂 Script (參照 VisiBroker ORB 內容), 則它們會換成表 16中底下所列出的 IBM ORB 對等項目..

註:
表 16 的部分內容名稱中已插入換行符號,可讓名稱整個放入表格資料格內。 實際內容名稱不包括空格或換行符號。

表 16. IBM ORB 內容及其 VisiBroker 對等項目
IBM ORB 內容 對等 VisiBroker 內容 說明
org.omg.CORBA.ORBInitialHost vbroker.agent.addr 指定執行「IBM 暫時性命名伺服器」(tnameserv) 之機器的 IP 位址或主機名稱。這個內容的預設值是 localhost
org.omg.CORBA.ORBInitialPort vbroker.agent.port 指定「IBM 暫時性命名伺服器」接聽所在的埠。
com.ibm.CORBA.ListenerPort vbroker.se.iiop_tp.scm.iiop_tp. listener.port ORB 伺服器將在其中接聽進入要求的埠。 如果指定了這個內容,ORB 將在 ORB.init() 期間啟動接聽。依預設,這個埠是動態指派的。將繼續支援 VisiBroker 內容名稱 OAport
com.ibm.CORBA.LocalHost vbroker.se.iiop_tp.host 這個內容代表 ORB 執行所在之機器的主機名稱 (或 IP 位址)。 伺服器端 ORB 會使用本端主機名稱,將伺服器的主機名稱放入遠端物件的 IOR。 如果未設定這個內容,將呼叫下列來擷取本端主機:InetAddress.getLocalHost();
若為 4.3,將繼續支援 VisiBroker 內容名稱 OAipAddr
com.ibm.CORBA.ThreadPool. MaximumSize vbroker.se.iiop_tp.scm.iiop_tp. dispatcher.threadMax 指定「伺服器連線管理程式」可建立的執行緒數量上限。 預設值 0 暗示沒有限制。若為 4.3,將繼續支援 VisiBroker 內容名稱 OAthreadMax
com.ibm.CORBA.ThreadPool. InactivityTimeout vbroker.se.iiop_tp.scm.iiop_tp. dispatcher.threadMaxIdle 指定在毀損閒置執行緒之前的時間量 (以秒為單位)。 將繼續支援 VisiBroker 內容名稱 OAthreadMaxIdle
com.ibm.CORBA.BufferSize vbroker.orb.streamChunkSize 第一次嘗試時將從 Socket 讀取的位元組數目 (作為 GIOP 訊息)。 緩衝區大小若越大,就越有可能一次嘗試就讀取整個訊息,因而增進效能。 預設值是 2048。

在 4.3 版之前的 InterChange Server, VisiBroker ORB 提供了 osfind 工具,來識別已向 InterChange Server 登錄的所有 ORB 物件。 基於這個目的,IBM Java ORB 提供了名為 CosNameServer_Dump 的工具。這個工具位於 ProductDir\bin 目錄中。如需詳細資訊,請參閱 System Administration Guide

步驟 6 - 升級 InterChange Server

如需其他升級資訊,請參閱升級伺服器 Script完成元件升級

附註:

  1. 升級期間,您必須將新版本安裝至不同位置。

  2. 當「安裝程式」要求您為 ICS 實例命名時,請確定 ICS 實例的這個名稱與 4.3 版之前的名稱相同, 以確定失敗事件的可攜性。

  3. 若要取得原始 InterChange Server 配置資訊, 您可以在「安裝程式」啟動「InterChange Server 配置」精靈時, 採取下列其中一項動作:

步驟 7 - 啟動 InterChange Server 及「協力廠商」軟體

  1. 重新啟動 InterChange Server 機器。
  2. 執行位於 ProductDir\bin 目錄的批次檔 PersistentNameServer.bat, 來啟動 IBM ORB 的「持續性命名伺服器」。
  3. 啟動 IBM MQSeries。

    確定「佇列管理程式」和「接聽器」都已開啟並且正在執行中。

  4. 如果您正在本端環境中執行資料庫,請啟動它。
  5. 如果從 4.1.1 升級,請將先前針對 DLM 和協同作業備份的 .class、.java 及訊息檔, 複製至適當的目錄。若為 DLM,請將檔案複製至 ProductDir\DLMs\classesProductDir\DLMs\messages。 若為協同作業,請將檔案複製至 ProductDir\collaborations\classesProductDir\collaborations\messages
  6. 若是資料庫原位移轉:您必須將 ICS 指向原始儲存庫所在的資料庫。您可以重複使用舊的 InterchangeSystem.cfg 檔,或透過 ICS 配置精靈設定資料庫參數, 來執行這個動作。
  7. 啟動 InterChange Server。

    如需如何啟動 InterChange Server 的相關指示,請參閱"設定 InterChange Server"

    註:
    伺服器名稱必須與舊版的名稱相同, 如此才能確保可順利轉移失敗事件。

    您可以檢查 ProductDir 目錄中的 InterchangeSystem.log 檔,以確認啟動是否順利完成。

    註:
    若在升級 InterChange Server 系統之後,InterChange Server 無法啟動, 請檢視此升級程序以確定您是否遵循所有指示。 若仍然無法得知失敗原因,在嘗試調整或從備份還原之前,可尋求 IBM 技術支援的協助。

步驟 8 - 載入儲存庫

註:
如果進行原位資料庫升級,就不需要這個步驟。

使用 repos_copy 指令,從舊版載入儲存庫檔案。 例如,如果 ICS 名稱是 WICS、使用者名稱/密碼是 admin/null, 儲存庫檔案名稱是 repos_backup.jar (如果從 4.1.1 升級,請使用 repos_backup.in), 請輸入下列指令

repos_copy -sWICS_NAME -irepos_backup.jar -uadmin - pnull
 

如需儲存庫的詳細資訊,請參閱升級儲存庫

步驟 9 - 從 4.1.1 版移轉的特殊升級程序

如果您是從 ICS 4.1.1 升級,請執行下列步驟,來升級工具的舊 DLM 和協同作業。

  1. 重新啟動剛安裝的伺服器。
  2. 在「系統管理程式」中,連接至伺服器。
  3. 建立暫時 ICL (整合元件程式庫),然後從伺服器匯入所有元件。
  4. 編譯所有對映和協同作業範本。
  5. 建立專案並包括所有來自先前建立的 ICL 的元件。
  6. 刪除伺服器上的儲存庫。
  7. 將專案部署至伺服器。

如需 ICL 的詳細資訊,請參閱匯入至 ICL

4.2.x 版伺服器不需要這些步驟。

步驟 10 - 驗證升級

若要驗證升級是否順利完成,您必須確定儲存庫綱目已建立並且所有物件都已順利載入。 若要執行這個動作,請驗證下列:

升級伺服器 Script

如果已在預先存在的 InterChange Server 系統中建立了自訂檔案, 則您需要評估下列檔案來判定它們是否需要升級:

升級伺服器啟動 Script

已變更所有啟動 Script,以因應從 VisiBroker ORB 移至 IBM Java ORB, 並支援 IBM JRE。這些變更包括:

如果已自訂任何 4.3 前的啟動 Script,則您必須對新的 4.3 Script 做出類似的變更。 您可能需要對這些啟動 Script 進行下列自訂:

升級工具配置檔

工具配置檔 cwtools.cfg 的其中一項作業,就是提供要在編譯時併入的自訂 .jar 檔。 如果已建立了自訂 .jar 檔,則您必須將這些自訂檔案新增至 classpath 變數中的 codeGeneration 區段。cwtools.cfg 檔位於下列目錄:

ProductDir/bin
 

驗證環境變數

所有系統環境變數在單一 CWSharedEnv 檔中都是新的設定。 所有啟動 Script 都會讀取這個檔案作為其呼叫程序的一部分。 它位於設定 ICS 全系統內容 (如 IBM Java ORB 的內容) 的這個檔案中。 請確定已正確地設定下列全系統內容,因為這是升級程序的一部份:

如需 CWSharedEnv 檔的詳細資訊,請參閱 System Administration Guide

評估自訂元件

如果具有任何使用儲存庫表格 (如 Script、資料庫表格或儲存程序) 的完全自訂元件, 您必須評估每一個元件,才能判定它是否必須升級。 比方說,如果儲存程序使用一個已在新版本中變更的儲存庫表格, 則您必須修改這個儲存程序,才能使用新的儲存庫表格結構。

註:
如果綱目沒有變更,您應該不需要變更事件表格,也不需要變更觸發函式。

升級儲存庫

InterChange Server 儲存庫是一個資料庫,可保存關於 InterChange Server 元件的 Meta 資料。 「ICS 安裝程式」不會自動升級您的 ICS 儲存庫內容。 不過,當您在前一個步驟中啟動了 ICS 時, ICS 就會利用任何 4.3 變更來升級 4.3 之前的儲存庫中的綱目。 在進行升級程序時,您必須決定要將哪些物件載入到儲存庫:

您可以使用「系統管理程式」的「InterChange Server 元件管理」檢視畫面,來瀏覽已載入伺服器的元件。

載入預先存在的儲存庫物件

如果是從 4.1.1 版的 InterChange Server 升級, 而且必須升級您的資料庫軟體,則您的 DBA 應該已安裝新的資料庫伺服器, 並已處理 ICS 資料庫所需的任何變更,包括 ICS 儲存庫。 您已在「ICS 配置」精靈中指定了這些 ICS 資料庫的名稱,因為這是 ICS 安裝程序的一部份。 當您啟動了新版本的 ICS 時,伺服器已升級了儲存資料庫中的綱目。 若要起始設定這個新的儲存庫,您必須載入預先存在的儲存庫物件。

若要準備載入儲存庫,請採取下列步驟:

  1. 將對映和協同作業的現有 Java 類別 (.class) 檔複製至新的目錄結構:

    其中 ProductDir 是新 4.3 版的產品目錄。 這個步驟確定現有對映和協同作業的 .class 檔位於新的 4.3 目錄結構。

  2. 確定 ICS 系統針對關係和資料庫連線所使用的所有資料庫都在執行中。 也請確定 ICS 正在執行中。
  3. 利用下列步驟來載入預先存在的儲存庫物件:
    1. 編輯儲存庫檔案以修正數個不相容性。如需詳細資訊,請參閱底下的準備儲存庫檔案
    2. 清除儲存庫中的任何儲存庫物件。
    3. 載入預先存在的物件。

    下列幾節將說明這些步驟中的每一個步驟,是如何處理預先存在的儲存庫物件。

準備儲存庫檔案

檢查現有的 repos_copy 備份檔 (稱為儲存庫檔案),來確定所有值是否與新的儲存庫相關。 建立現有儲存庫檔案的備份版本,然後編輯原始儲存庫檔案來修正下列資訊:

註:
如果您不想要在預先存在的儲存庫物件的檔案中載入所有儲存庫物件, 則可以從您匯入 4.3 儲存庫的儲存庫檔案中移除不想要的物件。

清除新的儲存庫

在您匯入預先存在的儲存庫物件之前, 您必須刪除任何可能已經存在於 4.3 儲存庫的重複物件。 這個步驟是必要的,因為 repos_copy 公用程式在將舊版格式匯入儲存庫時無法辨識 -ar-arp 選項 (用來處理重複物件)。 如果 ICS 在儲存庫檔案中找到任何重複物件, 它將回復整個匯入作業。

若要刪除這些儲存庫物件,請使用 repos_copy 公用程式的 -d 選項。例如,下列 repos_copy 指令會刪除儲存庫的內容:

repos_copy -sNewICSinstance -uadmin -pnull -d
 

在先前的 repos_copy 指令中:

匯入儲存庫檔案

若要將儲存庫檔案的內容載入儲存庫,請使用 repos_copy 公用程式。如步驟 1 - 備份 InterChange Server 系統中所述,您應該已利用 repos_copy 公用程式的 -o 選項,匯出了預先存在的儲存庫物件, 來建立一或多個儲存庫檔案。現在您將利用 repos_copy-i 選項,將這些儲存庫物件匯入新的儲存庫。

註:
匯入作業將載入儲存庫檔案中定義的所有儲存庫物件, 但是任何專案定義除外。專案定義不再儲存於儲存庫中。 它們現在是透過「整合元件程式庫 (ICL)」和使用者專案來定義的。如需詳細資訊,請參閱匯入現有的使用者專案

例如,假設您具有 Repository411.txt 儲存庫檔案。下列 repos_copy 指令將載入這個檔案內的所有儲存庫物件:

 repos_copy -iRepository411.txt -sserverName -uuserName -ppassword -r*
 

在先前的 repos_copy 指令中:

一旦預先存在的儲存庫物件位於新的儲存庫,您就仍須執行其他步驟, 才能完成協同作業範本與對映的升級。如需詳細資訊,請參閱完成協同作業範本和對映升級

Copyright IBM Corp. 1997, 2004