WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 作業系統: AIX, HP-UX, Linux, Solaris, Windows

使用主控台安裝調解模組 EAR 檔

安裝調解模組包括將調解模組的可安裝 EAR 檔,移至會控管該調解模組的伺服器或叢集中。可適當啟動及執行的已安裝調解模組, 則視為已部署

開始之前

如果您已將調解模組匯出至 JAR 檔, 接著請使用 serviceDeploy 指令,從調解模組 EAR 檔建立可安裝的 EAR 檔。如需建立調解模組之可安裝 EAR 檔的詳細資訊, 請參閱部署調解模組

執行這項作業的原因和時機

要使 WebSphere ESB 能夠使用調解模組所提供的功能來整合應用程式和服務, 您需要將模組的 EAR 檔安裝到伺服器或叢集中,然後啟動已部署的模組。

這個主題說明如何使用管理主控台來安裝調解模組 EAR 檔。 另外,您也可以使用其他方法(像是 wsadmin 工具的 install 或 installinteractive 指令), 其方式與將企業應用程式檔案安裝至 WebSphere Application Server 相同。

重要: 在開始執行下列步驟之後,如果您決定不要安裝應用程式,請按一下取消來結束作業。請勿在沒有按應用程式安裝頁面中的取消之前,直接移至另一個管理主控台頁面。

如果要使用管理主控台來安裝調解模組 EAR 檔, 請完成下列步驟:

這項作業的步驟

  1. 在主控台導覽樹中按一下應用程式 > 安裝新的應用程式 這時會顯示兩個「準備安裝應用程式」頁面中的第一頁。
  2. 在第一個「準備安裝應用程式」頁面中,完成下列子步驟:
    1. 指定調解模組 EAR 檔(.ear 檔)的完整路徑名稱。 您安裝的 EAR 檔可以位於用戶端機器(執行管理主控台 Web 瀏覽器的機器)中,也可以位於伺服器機器(用戶端連接的機器)中。如果您指定在用戶端機器的 EAR 檔,管理主控台會將 EAR 檔上載至執行主控台的機器,再繼續安裝應用程式。
    2. 下一步
  3. 在第二個準備安裝應用程式頁面中,完成下列子步驟:
    1. 選取是否要產生預設連結。

      使用預設連結會使得應用程式中任何不完整的連結, 都填入預設值。 現有的連結不會改變。

      您可以自訂在產生預設連結時所用的預設值。

    2. 下一步 如果出現安全警告,請按一下繼續。 畫面上會顯示安裝新的應用程式頁面。如果您選擇產生預設連結, 且應用程式未使用資源配接器,您可以繼續進行「摘要」步驟(以下最後一個步驟)。
  4. 步驟:選取安裝選項畫面中,提供以下設定的值。 如需這個頁面之設定的詳細資訊, 請參閱選取安裝選項設定。 如果您沒有指定任何值,則會使用預設值。
    1. 安裝應用程式的目錄中,指定要安裝應用程式 EAR 檔的目錄。 預設值是 APP_INSTALL_ROOT/cell_name 的值,其中 APP_INSTALL_ROOT 變數是 install_root/installedApps。 比方說,如果 WebSphere ESB 是在 Windows 上安裝到 C:\Program Files\WESB\ 中,則預設位置是 C:\Program Files\WESB\profile_name\installedApps\cell_name
      註: 如果在以獨立式設定檔安裝應用程式時未指定安裝目錄, 則應用程式會安裝在 APP_INSTALL_ROOT/base_cell_name 中。 如果您新增獨立式伺服器至部署管理程式 Cell,則新伺服器配置的 Cell 名稱會變成部署管理程式節點的 Cell 名稱。如果 addNode 公用程式使用了 -includeapps 選項, 在 addNode 作業之前安裝的應用程式仍會使用安裝目錄 APP_INSTALL_ROOT/base_cell_name。 不過,在獨立式伺服器加入網路配置之後才安裝的應用程式,則會使用預設安裝目錄 APP_INSTALL_ROOT/network_cell_name。如果要在執行 addNode 作業時,將應用程式移至 APP_INSTALL_ROOT/network_cell_name 位置, 您應該在安裝期間,將安裝目錄明確指定為 ${APP_INSTALL_ROOT}/${CELL}。在這種情況下,您一定可以在 APP_INSTALL_ROOT/current_cell_name 下找到應用程式檔案。
    2. 分散式應用程式中,指定 WebSphere ESB 是要展開或刪除安裝目的地中的應用程式二進位檔。 預設值是啟用應用程式分散作業。因此,當您在主控台中儲存變更時,會將新安裝的應用程式的應用程式二進位檔展開在指定的目錄中。當您解除安裝和儲存您對配置所做的變更時,也會刪除二進位檔。如果停用這個選項,則必須確定在所有應用程式預期執行之節點的目的地目錄中,應用程式二進位檔都必須適當地展開。
      重要: 如果您停用這個選項,且您不要將應用程式二進位檔複製和展開至各個節點,稍後儲存配置或手動同步化時,不會自動將應用程式二進位檔移至節點。
    3. 使用二進位配置中,指定伺服器或叢集所使用的連結、 延伸規格和部署描述子是位於應用程式部署文件 deployment.xml 檔(預設值)中,還是位於 EAR 檔中。
    4. 應用程式名稱中,輸入應用程式的名稱。 在 Cell 中,應用程式名稱必須是唯一的,不能含有無法作為物件名稱的字元。 如需物件名稱不接受的字元清單, 請參閱物件名稱
    5. 建立資源的 MBean 中,指定是否在啟動應用程式時建立應用程式內各項資源(如 Servlet 或 JSP 檔)的 MBean。 預設值是會建立 MBean 實例。
    6. 針對啟用類別重新載入,指定是否要在更新應用程式檔案時啟用類別重新載入。 依預設不會啟用重新載入類別功能。 啟用重新載入類別功能會將調解模組之 deployment.xml 檔中的 reloadEnabled 設為 true。如果調解模組的類別定義已變更, 則伺服器執行時期會停止再啟動應用程式,來重新載入應用程式類別。
    7. 重新載入間隔(秒)中,指定掃描應用程式檔系統來找出更新檔案的秒數。 預設值是 EAR 檔的 IBM 延伸 (META-INF/ibm-application-ext.xmi) 檔中的重新載入間隔屬性值。 如果要啟用重新載入,請指定一個大於零的值(例如,1 到 2147483647)。如果要停用重新載入,請指定零 (0)。

      只有在啟用類別重新載入功能時,這裡指定的重新載入間隔才會生效。

    8. 部署 Web 服務中,指定在應用程式安裝期間是否執行 Web 服務部署工具 wsdeploy 這個工具會產生執行使用 Web 服務之應用程式所需的程式碼。預設值是不執行 wsdeploy 工具。 如果 EAR 檔含有使用 Web 服務的模組,且先前未從組合工具的部署功能表選項或從指令行中執行 wsdeploy 工具來處理它,您就必須啟用這個設定。
    9. 驗證輸入關閉/警告/失敗中,指定 WebSphere ESB 是否要在應用程式安裝或更新期間檢查指定的應用程式參照; 如果啟用驗證,則會警告您參照不正確或使作業失敗。 應用程式參照的資源通常會使用儲存器管理持續性 (CMP) Bean 的資料來源, 或是使用部署描述子中定義的資源參照或資源環境參照。驗證會檢查應用程式所參照的資源是否定義在這個應用程式的部署目標範圍中。 選取關閉表示沒有資源驗證, 警告表示與不正確的資源參照相關的警告訊息,失敗則會在發生不正確資源參照時,停止失敗的作業。
    10. 程序內嵌配置中,指定是否應該處理內嵌配置。 內嵌配置由 resource.xmlvariables.xml 等檔案組成。 在選取之後或其值為 true 時,會從 .ear 檔中,將內嵌配置載入應用程式範圍中。如果 .ear 檔並未包含內嵌配置,預設值是 false。 如果 .ear 檔包含內嵌配置,預設值是 true
  5. 步驟:將模組對映至伺服器畫面中,從叢集和伺服器清單中,選取每個模組的目標伺服器或叢集。 選取模組旁的勾選框來選取調解模組。

    如果應用程式使用 WebSphere Adapter,請指定每一個 RAR 檔的目標伺服器或叢集。同時,請將使用 RAR 模組中定義之資源配接器的所有其他模組, 都對映至相同的目標。

    註: 在將 RAR 檔安裝至伺服器時, WebSphere ESB 會尋找連接器模組的 Manifest (MANIFEST.MF)。它會先查看 RAR 檔的 connectorModule.jar 檔,再從 _connectorModule.jar 檔載入 Manifest。如果類別路徑項目是在 connectorModule.jar 檔的 Manifest 中,RAR 檔就會使用該類別路徑。如果要確保已安裝的連接器模組可以找到它所需的類別和資源,請利用主控台來勾選 RAR 的類別路徑設定。如需類別路徑設定的詳細資訊, 請參閱管理主控台的「資源配接器」設定值和「WebSphere 關聯式資源配接器」設定值。

    您可以指定 Web 伺服器來作為將要求遞送至應用程式的目標。 每個 Web 伺服器的外掛程式配置檔 (plugin-cfg.xml) 都是基於透過它來遞送的應用程式而產生的。如果您要 Web 伺服器處理應用程式,請利用 Ctrl 鍵來同時選取應用程式伺服器或叢集和 Web 伺服器, 以便根據透過這個 Web 伺服器遞送的應用程式來產生這個 Web 伺服器的外掛程式配置檔 plugin-cfg.xml

  6. 如果您的應用程式定義了資源參照,針對步驟:將資源參照對映至資源,請指定代表資源參照中所定義的邏輯名稱之資源的 JNDI 名稱。 在按一下「摘要」畫面中的完成之前,應用程式中定義的每一個資源參照都必須連結至 WebSphere ESB 配置中所定義的一項資源。
    1. 選擇性的: 指定資源的登入配置名稱和鑑別內容。
    2. 按一下確定來儲存值,並返回對映步驟。
  7. 如果您的應用程式使用 Web 模組,針對步驟:對映 Web 模組的虛擬主機,請從清單中選取應該對映至應用程式中所定義之 Web 模組的虛擬主機。

    虛擬主機定義所指定的埠號會用在 URL 中,用來存取構件,例如,Web 模組中的 Servlet 和 JSP 檔。每個 Web 模組都必須有一個對映的虛擬主機。 如果沒有指定所有必要的虛擬主機,在您按一下「摘要」畫面中的完成之後,會出現驗證錯誤。

  8. 如果應用程式的部署描述子中已定義了安全角色,針對步驟:將安全角色對映至使用者/群組,請指定對映至每個安全角色的使用者和群組。

    選取角色來選取所有角色或選取個別角色。針對每一個角色,請選取下列其中一個選項來指定應套用安全設定的方式:

    選項 敘述
    每個人 這等於沒有安全設定。
    所有已鑑別的使用者 以有效的使用者名稱和密碼進行鑑別的任何人, 都是該角色的成員。
    對映的使用者 個別使用者會列成該角色的成員。
    對映的群組 群組是新增使用者最方便的方式, 已識別之群組的每一個成員都會成為該角色的成員。

    如果是對映的使用者對映的群組, 如果要從使用者登錄中選取特定使用者或群組,請完成下列子步驟:

    1. 選取一個角色,再按一下查閱使用者查閱群組
    2. 在顯示的「查閱使用者/群組」畫面中,輸入搜尋準則,從使用者登錄中擷取使用者或群組的清單。
    3. 從所顯示的結果中,選取個別使用者或群組。
    4. 按一下確定,將選取的使用者或群組對映至在步驟:將安全角色對映至使用者/群組畫面中選取的角色。
  9. 如果應用程式在其部署描述子中定義了「執行身分」角色,針對步驟:將執行身分角色對映至使用者,請指定每個「執行身分」角色的「執行身分」使用者名稱和密碼。 「執行身分」角色是由必須以特定的角色身分來執行的 Enterprise Bean,在與另一個 Enterprise Bean 互動時所使用。選取角色來選取所有角色或選取個別角色。選好角色之後,請輸入使用者名稱、密碼的值,再驗證密碼,並按一下套用
  10. 如果您的應用程式含有資源環境參照,請在步驟:將資源環境參照對映至資源中,指定對映至資源環境參照中所定義的邏輯名稱之資源的 JNDI 名稱。 如果每個資源環境參照都沒有相關的資源,在您按一下完成之後,會出現驗證錯誤。
  11. 如果您的應用程式將執行身分定義為系統身分,在步驟:用執行系統身分來取代執行身分角色中,您可以選擇將它改成執行身分角色,再指定一個使用者名稱和密碼給所指定的執行身分角色。 選取系統身分隱含呼叫是利用 WebSphere Application Server 安全伺服器 ID 來完成的,應該小心使用,因為這個 ID 有較多專用權。
  12. 如果您的應用程式有對映至以 Oracle 資料庫來執行後端處理程序之資源的資源參照,針對步驟:指定 Oracle 類型提供者的隔離層次,請指定或更正應用程式使用這些資源時,這些資源所用的隔離層次。 Oracle 資料庫只支援 ReadCommitted 和 Serializable 這兩種隔離層次。
  13. 在「摘要」畫面中,驗證要安裝應用程式模組的 Cell、節點和伺服器:
    1. Cell/節點/伺服器旁邊,按一下請按一下這裡
    2. 請驗證設定。
    3. 按一下完成

結果

這時會顯示若干訊息,指出您的應用程式檔案是否已順利安裝。

如果您收到 OutOfMemory 異常狀況且沒有安裝來源應用程式檔案, 就表示系統記憶體可能不足,或應用程式含有太多模組,因而無法順利安裝在伺服器中。如果異常狀況不是因為系統記憶體不足,請重新包裝您的應用程式,使 .ear 檔包含較少的模組。如果異常狀況不是因為系統記憶體不足,也不是因為模組數太多,請檢查您在執行管理主控台之應用程式伺服器的「Java 虛擬機器」頁面中指定的選項。之後,再嘗試重新安裝應用程式檔案。

For Windows platforms 在安裝期間,會將某些應用程式檔案解壓縮在配置階段作業所代表的目錄中,當儲存配置時,這些檔案會儲存在 WebSphere Application Server 配置儲存庫中。在 Windows 機器中,檔案路徑的限制是 256 字元。 因此,如果配置階段作業或配置儲存庫中應用程式檔案的路徑超出 256 字元的限制,應用程式的安裝可能會失敗。 您可能會見到 FileNotFound 異常狀況,訊息會指出路徑名稱太長。 如果要克服這些問題,請縮短應用程式名稱和模組 URI 名稱,以便縮短檔案路徑長度。 之後,再嘗試重新安裝應用程式檔案。

下一步

順利安裝應用程式檔案之後,請完成下列動作:
  1. 將應用程式需要的任何共用程式庫, 連結至應用程式。
  2. 儲存配置變更。登錄在管理配置和應用程式檔中的應用程式會複製到目標目錄中,也就是預設的 install_root/installedApps/cell_name,或您指定的目錄。 如果是安裝到 Network Deployment 設定檔,當部署管理程式的配置與個別節點上的配置進行同步時, 檔案會複製到遠端節點。
  3. 如果模組是部署在伺服器叢集中,請按一下「企業應用程式」頁面中的依序套用更新, 在叢集的所有成員上傳送變更後的配置。「依序套用更新」會循序更新包含叢集成員之節點中的配置。

要使 WebSphere ESB 能夠使用調解模組所提供的功能來整合應用程式和服務, 您必須啟動已部署的模組。您可以手動啟動模組, 也可以將它配置成自動啟動。您也可以用其他方式來管理模組; 比方說,變更模組的配置、停止或更新模組,或是管理其活動。


Task topic

使用條款 | 此頁的評等

「時間戳記」圖示前次更新: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ae\trun_app_instwiz.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)