在準備 ICS 系統進行升級時,您有兩個移轉 ICS 資料庫的選項:原位資料庫移轉及非原位資料庫移轉。 原位資料庫移轉表示重複使用舊的儲存庫,並在 ICS 伺服器第一次啟動期間, 讓 ICS 執行儲存庫的升級。非原位資料庫移轉表示利用全新的和空的儲存資料庫來進行升級。
使用非原位資料庫移轉來升級 InterChange Server 系統包括下列步驟。 如果使用原位資料庫移轉,則指示中的變更將標示為「原位資料庫移轉」。
備份 InterChange Server 系統可讓您回復在安裝新版本期間可能不慎改寫的任何檔案。 在執行升級程序之前,請備份靜態資料和動態資料 (您定期備份的可變更資料,不管是否升級)。如需靜態和動態資料範例,請參閱表 15。
若要備份系統,請執行下列動作:
repos_copy -sWICS -oRepository430.txt -uadmin -pnull
若為 4.1.1,repos_copy 公用程式會在 *.txt 或 *.in 檔案中,建立儲存庫物件的備份。
若為 4.2.2 及更新版本,repos_copy 公用程式會在 *.jar 檔案中,建立儲存庫物件的備份。
ProductDir\mqseries\crossworlds_mq.tst
IBM 建議進行整個 InterChange Server 產品目錄的系統備份。
表 15 彙總如何備份不同的 ICS 元件。
表 15. InterChange Server 資料的備份方法
將 InterChange Server 系統升級至 4.3 版之前,您必須確定系統處於靜止狀態。 這表示必須完成所有進行中的事件而且必須解決所有未完成的交易之後,才能備份環境並執行升級程序。
下列步驟說明如何使 InterChange Server 系統處於靜止狀態:
如需如何溫和停止執行中的系統之詳細資訊,請參閱 System Administration Guide。
下列步驟列出解除安裝協力廠商軟體的適當順序。
如果任何 InterChange Server 元件以服務的形式在執行,請在執行升級之前,解除安裝那些服務。 因為新的版本將位於不同的位置,所以現有的服務定義將不正確。 當升級完成時,請參閱"進階配置選項", 以取得關於將 InterChange Server 元件配置為服務的指示。
下列步驟列出安裝 InterChange Server 元件的適當順序。
如果是從舊版 InterChange Server 移轉,請查看您是否也須升級資料庫軟體。 如需支援的資料庫軟體清單,請參閱「軟體需求」一節 (請參閱軟體需求)。 請比較現有的資料庫軟體版本與 4.3 版產品支援的版本。
如果您必須升級資料庫軟體,請確定資料庫管理者 (DBA) 採取下列步驟:
有關如何執行備份及升級資料庫軟體的指示,請參閱您的資料庫伺服器文件。如需如何移轉資料庫的詳細資訊, 請繼續進行步驟 8 - 載入儲存庫。
當升級 WebSphere MQ 時,您可以採用下列其中一條路徑:
當安裝 WebSphere 5.3 時, 請確定您選擇「自訂安裝」及包括「Java 傳訊」的選項。 如果您選擇「一般」,將不會安裝必要的 Java 傳訊檔。如需詳細指示,請參閱安裝 WebSphere MQ。
如需詳細指示,請參閱升級 WebSphere MQ。
一旦升級了 WebSphere MQ 軟體,您就需要配置它,才能與 InterChange Server 搭配使用。 如需相關資訊,請參閱配置 WebSphere MQ中的說明。
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 暫時性命名伺服器」相同的主機上,且必須留在這個相同的主機上而定:
已在安裝作業提供的啟動 Script 中,設定了如何使用內容來設定 IBM Java ORB。 不過,如果 4.3 版之前的 InterChange Server 使用 Inprise VisiBroker 軟體,且您自訂了任何 VisiBroker ORB 內容,則您可能需要對新的 Script 做出類似的變更, 以因應將 4.3 版移轉至 IBM ORB。如需 IBM ORB 內容及其 VisiBroker 對等項目的詳細資訊,請參閱升級 ORB 內容。
為了調整 ORB,VisiBroker ORB 中會呈現各種 ORB 相關內容。 如果已在任何自訂的 Script 或軟體中使用了這些內容, 則您必須驗證是否已對 IBM Java ORB 適當地設定它們。表 16 會列出部份 VisiBroker ORB 內容, 以及它們在 IBM Java ORB 中的相等名稱。
如果您具有任何來自 4.3 之前安裝版本的自訂 Script (參照 VisiBroker ORB 內容), 則它們會換成表 16中底下所列出的 IBM ORB 對等項目..
表 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。
如需其他升級資訊,請參閱升級伺服器 Script和完成元件升級。
附註:
確定「佇列管理程式」和「接聽器」都已開啟並且正在執行中。
如需如何啟動 InterChange Server 的相關指示,請參閱"設定 InterChange Server"。
您可以檢查 ProductDir 目錄中的 InterchangeSystem.log 檔,以確認啟動是否順利完成。
使用 repos_copy 指令,從舊版載入儲存庫檔案。 例如,如果 ICS 名稱是 WICS、使用者名稱/密碼是 admin/null, 儲存庫檔案名稱是 repos_backup.jar (如果從 4.1.1 升級,請使用 repos_backup.in), 請輸入下列指令
repos_copy -sWICS_NAME -irepos_backup.jar -uadmin - pnull
如需儲存庫的詳細資訊,請參閱升級儲存庫。
如果您是從 ICS 4.1.1 升級,請執行下列步驟,來升級工具的舊 DLM 和協同作業。
如需 ICL 的詳細資訊,請參閱匯入至 ICL。
4.2.x 版伺服器不需要這些步驟。
若要驗證升級是否順利完成,您必須確定儲存庫綱目已建立並且所有物件都已順利載入。 若要執行這個動作,請驗證下列:
如果已在預先存在的 InterChange Server 系統中建立了自訂檔案, 則您需要評估下列檔案來判定它們是否需要升級:
已變更所有啟動 Script,以因應從 VisiBroker ORB 移至 IBM Java ORB, 並支援 IBM JRE。這些變更包括:
如果已自訂任何 4.3 前的啟動 Script,則您必須對新的 4.3 Script 做出類似的變更。 您可能需要對這些啟動 Script 進行下列自訂:
比方說,如果您具有任何自訂的資料處理常式,請在 CLASSPATH 變數中加入它們的 .jar 檔。
一旦完成了升級程序及其測試,您就可以從伺服器啟動中移除 -design 選項, 以便 InterChange Server 能夠在正式作業模式中啟動。
工具配置檔 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 之前的儲存庫中的綱目。 在進行升級程序時,您必須決定要將哪些物件載入到儲存庫:
針對您選擇安裝的任何特定 ICS 元件 (不是個別安裝),「安裝程式」會自動將適當的輸入檔案複製到 ProductDir\repository 目錄。這些輸入檔包含新元件 (您已安裝為 4.3 版本一部份) 的儲存庫物件。
如果已利用 repos_copy 備份了 ICS 儲存庫, 則您將具有一或多個儲存庫檔案,包含元件 (來自預先存在的 ICS 版本) 的儲存庫物件。
您可以使用「系統管理程式」的「InterChange Server 元件管理」檢視畫面,來瀏覽已載入伺服器的元件。
如果是從 4.1.1 版的 InterChange Server 升級, 而且必須升級您的資料庫軟體,則您的 DBA 應該已安裝新的資料庫伺服器, 並已處理 ICS 資料庫所需的任何變更,包括 ICS 儲存庫。 您已在「ICS 配置」精靈中指定了這些 ICS 資料庫的名稱,因為這是 ICS 安裝程序的一部份。 當您啟動了新版本的 ICS 時,伺服器已升級了儲存資料庫中的綱目。 若要起始設定這個新的儲存庫,您必須載入預先存在的儲存庫物件。
若要準備載入儲存庫,請採取下列步驟:
ProductDir\DLMs\classes\NativeMaps
ProductDir\collaborations\classes\UserCollaborations
其中 ProductDir 是新 4.3 版的產品目錄。 這個步驟確定現有對映和協同作業的 .class 檔位於新的 4.3 目錄結構。
下列幾節將說明這些步驟中的每一個步驟,是如何處理預先存在的儲存庫物件。
檢查現有的 repos_copy 備份檔 (稱為儲存庫檔案),來確定所有值是否與新的儲存庫相關。 建立現有儲存庫檔案的備份版本,然後編輯原始儲存庫檔案來修正下列資訊:
匯入關係時,您必須驗證每一個關係的下列屬性在儲存庫檔案內是否有效:
如果這些屬性識別一個在 repos_copy 匯入至 ICS 儲存庫期間找不到的資料庫,InterChange Server 將回復整個匯入作業。 不過,如果您刪除了每一個關係的上述屬性, InterChange Server 會使用儲存庫作為預設關係資料庫。
以 4.1.1 格式表示的資料庫連線儲存區無法匯入新的儲存庫。 因此,您必須從儲存庫檔案中刪除任何連線儲存區。 在 ICS 實例升級之後,您必須在「系統管理程式」內,建立這些連線儲存區。
在您匯入預先存在的儲存庫物件之前, 您必須刪除任何可能已經存在於 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 選項,將這些儲存庫物件匯入新的儲存庫。
例如,假設您具有 Repository411.txt 儲存庫檔案。下列 repos_copy 指令將載入這個檔案內的所有儲存庫物件:
repos_copy -iRepository411.txt -sserverName -uuserName -ppassword -r*
在先前的 repos_copy 指令中:
一旦預先存在的儲存庫物件位於新的儲存庫,您就仍須執行其他步驟, 才能完成協同作業範本與對映的升級。如需詳細資訊,請參閱完成協同作業範本和對映升級。