如果開發的應用程式包含內嵌 WebSphere Adapter,就會將配接器隨著應用程式一起部署。您不需要個別安裝配接器。此處說明安裝應用程式與內嵌配接器的步驟。
開始之前
只有在開發包含內嵌 WebSphere Adapter 的應用程式,並使用應用程式內的資源配接器保存檔 (RAR) 模組來組合時,才應該執行這項作業。如需組合應用程式的相關資訊,
請參閱
組合應用程式。
執行這項作業的原因和時機
如果應用程式需要存取「企業資訊系統 (EIS)」中的資料,可以利用「J2EE 連接器架構」連接器來取得。
如「J2EE 連接器架構 (JCA)」規格所說明,每個企業資訊系統 (EIS) 都需要資源配接器和 Connection Factory。如果要部署包含內嵌 WebSphere Adapter 的應用程式,您可以安裝應用程式檔案並且建立 J2C Connection Factory,或選取現有的 Connection Factory 供應用程式使用。
如果要安裝包含內嵌 WebSphere Adapter 的應用程式,請使用管理主控台來完成下列步驟:
這項作業的步驟
- 安裝應用程式。 例如,您可以遵循使用主控台來安裝調解模組 EAR
檔中的步驟。
在「將模組對映至伺服器」的步驟中,指定每一個 RAR 檔的目標伺服器或叢集。請務必將其他使用 RAR 模組所定義之資源配接器的所有模組對映至相同目標。此外,請將 Web 伺服器指定為當作對這個應用程式送出要求時之路由器的目標。
每個 Web 伺服器的外掛程式配置檔 (plugin-cfg.xml) 都是基於透過該 Web 伺服器來遞送的應用程式而產生。
註: 將 RAR 檔安裝到伺服器時,WebSphere ESB 會尋找連接器模組的 Manifest (MANIFEST.MF)。它會先查看 RAR 檔的 connectorModule.jar 檔,
再從 _connectorModule.jar 檔載入 Manifest。如果類別路徑項目是在 connectorModule.jar 檔的 Manifest 中,RAR 就會使用該類別路徑。如果要確保已安裝的連接器模組可以找到它所需的類別和資源,請利用主控台來勾選 RAR 的類別路徑設定。如需類別路徑設定的相關資訊,
請參閱管理主控台的「資源配接器」設定和「WebSphere 關聯式資源配接器」設定。
- 儲存您對主要配置的變更。 按一下。
- 為新安裝的應用程式建立 Connection Factory。 使用管理主控台來完成下列子步驟:
- 選取新安裝的應用程式
- 在導覽窗格中,按一下
- 在內容窗格中,按一下應用程式的名稱
- 在頁面的「相關項目」區段中,按一下連接器模組。
- 按一下 RAR 檔的名稱。
- 在頁面的「其他內容」區段中,按一下資源配接器。
- 在頁面的「其他內容」區段中,按一下 J2C Connection Factory。
- 按一下現有的 Connection Factory 名稱來更新它,或按一下新建來建立新的 Connection Factory。
註: 如果使用「EIS 匯入」或「EIS 匯出」來配置 WebSphere Adapter,就會有可以更新的一個現有 Connection Factory 或啟動規格。
- 選擇性的: 指定 XA 回復的鑑別別名,或使用元件管理的鑑別別名。 只有支援 XA 交易的資源會顯示這個欄位。
- 選擇性的: 選取元件管理的鑑別別名。
如果沒有想要的別名可以使用,或您想要定義一個不同的別名,請執行下列動作:
- 按一下套用。
- 在「相關項目」下,按一下 J2C 鑑別資料項目。
- 按一下新建。
- 指定一般內容。
- 按一下確定來返回「J2C Connection Factory 設定」畫面。
如果您的任何應用程式元件是利用資源參照中所指定的 empty-argument getConnection() 方法以及
應用程式或 Per Connection Factory 鑑別來從這個 Connection Factory 取得連線,請選取或定義一個別名。
如果您所安裝的配接器包含原始路徑元素,請考量下列事項:如果您有多個原始路徑元素,而其中一個原生程式庫(原生程式庫 A)相依於另一個程式庫(原生程式庫 B),
則您必須將原生程式庫 B 複製到系統目錄中。由於大部分 UNIX 系統的限制,試圖載入原生程式庫時,並不會查看現行目錄。
當您建立及儲存 Connection Factory 之後,您便可修改各種應用程式模組所定義的資源參照,並在適當的地方指定 Connection Factory 的 Java 命名和目錄介面 (JNDI) 名稱。
註: 針對每一個 Java 虛擬機器 (JVM) 實例,只能載入一次原生程式庫。每一個應用程式都有它本身的類別載入器,所以內含內嵌 RAR 檔的不同應用程式無法同時使用相同的原生程式庫。當第二個應用程式嘗試載入程式庫時,它就會接收到異常狀況。
如果部署在應用程式伺服器中的應用程式有使用內含原始路徑元素的內嵌 RAR 檔,請務必確認您已徹底關閉應用程式伺服器,沒有遺留任何未完成的交易。如果應用程式伺服器沒有徹底關閉,
當伺服器重新啟動時,它會執行回復,並載入任何所需的 RAR 檔與原生程式庫。當回復程序完成時,請不要試圖執行任何應用程式相關工作。請關閉伺服器,然後重新啟動。這一次重新啟動時,應用程式伺服器不會再執行回復程序,應用程式處理程序會正常進行。