使用主控台來安裝企業應用程式檔案

Java™ Platform Enterprise Edition (Java EE) 應用程式檔案的安裝,包括將已組合的企業應用程式、Web、Enterprise Bean (EJB) 或其他可安裝模組放到已配置來存放檔案的伺服器或叢集中。 已安裝的檔案若可適當地啟動及執行,被認為是已部署

開始之前

安裝企業應用程式檔案之前,請確定您是將應用程式檔案安裝到相容的部署目標。 如果部署目標不相容,請選取不同的目標。

(選擇性)決定您安裝的應用程式是否使用其他已部署的應用程式也使用的程式庫檔案。 您可以為所有這些共用檔案定義一個共用程式庫。使用共用程式庫可減少工作站或伺服器上的程式庫檔案份數。

關於這項作業

如果要將新的企業應用程式檔案安裝到 WebSphere® Application Server 配置,您可以使用下列選項:

  • 管理主控台
  • wsadmin Script
  • 受監控的目錄部署
  • 應用程式內容檔
  • Java MBean 程式

下列步驟說明如何利用管理主控台來安裝應用程式、EJB 元件、階段作業起始通訊協定 (SIP) 保存檔 (SAR) 或 Web 模組。

避免困難 避免困難: 在應用程式安裝精靈中的完成步驟開始之後,如果您又決定不安裝應用程式,請按一下取消,結束此作業。 請先按一下應用程式安裝頁面的取消,而不要直接移至另一個管理主控台頁面。gotcha

程序

  1. 在主控台導覽樹狀結構中,按一下應用程式 > 新建應用程式 > 新建企業應用程式
  2. 在第一個準備安裝應用程式」頁面中
    1. 指定來源企業應用程式檔案(.ear 檔,或稱為 EAR 檔)的完整路徑名稱。

      您要安裝的 EAR 檔可以在用戶端機器(執行 Web 瀏覽器的機器)或伺服器機器(用戶端連接的機器)。 如果您指定用戶端機器上的 EAR 檔,管理主控台會將 EAR 檔上傳到執行主控台的機器,然後繼續安裝應用程式。

      您也可以指定安裝獨立式 Web 保存檔 (WAR)、SAR 檔或 Java 保存檔 (JAR)。

      [IBM i]如果 EAR 檔在伺服器機器上,且這個伺服器是 IBM® i 伺服器,請確保使用者設定檔 QEJBSVR 有這個 EAR 檔的 *R 權限,以及對這個 EAR 檔所在路徑的所有目錄至少具有 *X 權限。

      避免困難 避免困難: 如果您試圖從遠端檔案系統安裝應用程式,而且 Java 虛擬機器 (JVM) 已登錄為 Microsoft Windows 服務,則管理主控台不會顯示對映的網路磁碟機。 在這個實務中,這個 Windows 服務會作為新的登入階段作業來執行,其安全 ID (SID) 與使用者階段作業不同。 因此,這個服務無法操作由登入使用者建立的對映網路磁碟機。 如果要從遠端檔案系統安裝應用程式,您必須使用 WASService 指令,從 Windows 服務取消登錄 JVM。如需相關資訊,請參閱 WASService 指令的相關文件。gotcha
    2. 下一步
  3. 在「準備安裝應用程式」第二頁:
    1. 選擇是否檢視所有安裝選項。
      捷徑 - 僅當需要其他資訊時才提示
      顯示模組對映步驟,以及為了成功安裝應用程式而要求您指定必要資訊的任何步驟。
      詳細 - 顯示所有安裝選項和參數
      顯示所有安裝選項。
    2. 選擇是否產生預設連結。

      選取產生預設連結,由本產品為不完整的 Java 命名和目錄 (JNDI) 及其他應用程式連結提供預設值。 本產品不會變更現有的連結。

      您不需要為 EJB 3.x 模組的 EJB Bean 介面、本端 Home 介面、遠端 Home 介面或商業介面指定 JNDI 值。 本產品會在執行時期指派儲存器的預設值。同樣地,對於 EJB 3.x 或 Web 2.4 或更新版本的模組內的任何 EJB 參照,您不需要指定 JNDI 值,因為本產品會在執行時期自動解析目標。 即使選取產生預設連結,本產品也不會為這些 JNDI 值產生預設值,但會為其他連結產生預設值,例如虛擬主機。

      新特性 新特性:
      依預設,Java EE 連結不會使用預先配置的預設資源。 請選取使用 Java EE 預設連結,使產生的連結成為 Java EE 預設值。newfeat

      您可以自訂產生預設連結時使用的預設值。Preparing for application installation binding settings說明可用的自訂作業並提供連結範例。

    3. 下一步 如果出現安全警告,請按一下繼續。 這時會顯示「安裝新的應用程式」頁面。 如果是選擇產生預設連結,您可以前往摘要步驟。Example: Installing an EAR file using the default bindings提供步驟範例。
  4. 依需要指定安裝選項的值。

    除了按下一步,您也可以按步驟號碼來直接移至該頁面。您要安裝的應用程式或模組的內容會決定顯示的頁面。

    表 1. 精靈頁面說明. 下表說明精靈的每一頁。
    頁面 說明
    選取安裝選項 選取安裝選項頁面中,提供產品特定的設定值。 如果不指定值,則會使用預設值。
    將模組對映至伺服器 將模組對映至伺服器頁面上,指定部署目標,以便在其中安裝您的應用程式包含的模組。模組可以安裝在相同的部署目標,或分散安裝到多個部署目標。 每一個模組必須對映到一個目標伺服器。

    在單一伺服器產品上,部署目標可以是應用程式伺服器或 Web 伺服器。

    在多重伺服器產品上,部署目標可以是應用程式伺服器、應用程式伺服器叢集或 Web 伺服器。

    提供編譯 JSP 的選項 如果已在選取安裝選項頁面中啟用前置編譯 JavaServer Pages 檔設定,且您的應用程式使用 JavaServer Pages (JSP) 檔,您可以在提供選項來編譯 JSP 頁面中指定 JSP 編譯器選項。
    提供 Bean 的 JNDI 名稱 提供 Bean 的 JNDI 名稱頁面上,指定每個 EJB 2.1 及更早版本模組中之每個 Enterprise Bean 的 JNDI 名稱。 您必須為應用程式中定義的每個 Enterprise Bean 指定 JNDI 名稱。 比方說,對於 EJB 模組 MyBean.jar,請指定 MyBean

    至於 EJB 3.x 模組,您可以指定 JNDI 名稱、本端 Home JNDI 名稱、遠端 Home JNDI 名稱,或不指定 JNDI 名稱。 如果不指定值,本產品會提供預設值。

    連結 EJB 商業 連結 EJB 商業頁面中,您可以指定 EJB 3.x 模組的商業介面 JNDI 名稱。 如果您在提供 Bean 的 JNDI 名稱頁面中,指定了 Bean 的 JNDI 名稱,請勿在這個頁面中指定相同 Bean 的商業介面 JNDI 名稱。 如果您沒有指定 Bean 的 JNDI 名稱,就可以選擇性地指定商業介面 JNDI 名稱。 未指定商業介面 JNDI 名稱時,本產品會提供儲存器預設值。對於無介面視圖,商業介面值是空字串 ("")。
    對映含有 1.x Entity Bean 之模組的預設資料來源 如果應用程式使用的 EJB 模組包含基於 EJB 1.x 規格的「儲存器管理的持續性 (CMP)」Bean,請在對映包含 1.x Entity Bean 之模組的預設資料來源中,為 EJB 模組的預設資料來源指定 JNDI 名稱。 如果為個別 CMP Bean 指定資料來源,則 EJB 模組的預設資料來源為選用。
    將 EJB 參照對映至 Bean 如果您的應用程式定義了 EJB 參照,在將 EJB 參照對映至 Bean 頁面中,請指定代表 EJB 參照中指定的邏輯名稱之 Enterprise Bean 的 JNDI 名稱。

    如果 EJB 參照來自 EJB 3.x 或 Web 2.4 或更新版本的模組,則 JNDI 名稱為選用。 對於舊版的模組,應用程式中定義的每一個 EJB 參照必須連結到 EJB 檔。

    如果容許自動解析 EJB 參照目標已啟用,則所有模組的 JNDI 名稱皆為選用。 對於不完整的連結,本產品會提供儲存器預設值,或自動解析 EJB 參照。

    將資源參照對映至資源 如果應用程式定義資源參照,請在將資源參照對映至資源中指定資源的 JNDI 名稱,以代表資源參照中定義的邏輯名稱。 您可以選擇性地指定資源的登入配置名稱和鑑別內容。 指定鑑別內容之後,按一下確定以儲存值並回到對映步驟。 您可以選擇性地指定延伸資料來源內容,以便啟用利用異質儲存區來連接 DB2® 資料庫的資料來源。按一下「摘要」頁面的完成之前,應用程式中定義的每一個資源參照,必須連結到 WebSphere Application Server 配置中定義的資源。
    對映 Web 模組的虛擬主機 如果您的應用程式使用 Web 模組,請在對映 Web 模組的虛擬主機中,從清單中選取要對映至應用程式中定義之 Web 模組的虛擬主機。 使用 URL 存取 Web 模組中的構件時(例如 Servlet 和 JSP 檔),URL 中會用到虛擬主機定義中指定的埠號。 每一個 Web 模組都必須有可供它對映的虛擬主機。 如果沒有指定所有必要的虛擬主機,在您按一下「摘要」頁面中的完成之後,會出現驗證錯誤。
    將安全角色對映至使用者或群組 如果應用程式在其部署描述子中定義安全角色,請在將安全角色對映至使用者或群組中,指定對映到每一個安全角色的使用者和群組。 選取角色來選取所有角色或選取個別角色。針對每個角色,您可以指定是否要對映預先定義的使用者,例如每個人所有已鑑別的使用者。 如果要從使用者登錄中選取特定的使用者或群組,請執行下列動作:
    1. 選取一個角色,然後按一下查閱使用者查閱群組
    2. 在顯示的「查閱使用者或群組」頁面,輸入搜尋準則從使用者登錄中擷取使用者或群組清單。
    3. 從顯示的結果中,選取個別使用者或群組。
    4. 按一下確定,將選取的使用者或群組對映到將安全角色對映至使用者或群組頁面上選取的角色。
    將執行身分角色對映到使用者 如果應用程式在其部署描述子中定義了「執行身分」角色,請在將執行身分角色對映至使用者中,指定每個「執行身分」角色的「執行身分」使用者名稱和密碼。 與另一個 Enterprise Bean 互動時必須以特定角色執行的 Enterprise Bean 需要使用「執行身分」角色。選取角色來選取所有角色或選取個別角色。選取角色後,請輸入使用者名稱、密碼和驗證密碼的值,然後按一下套用
    確定所有不受保護的 1.x 方法都有正確的保護層次 如果應用程式包含的 EJB 1.x CMP Bean 沒有為某些 EJB 方法定義方法權限,請在確定所有未受保護的 1.x 方法都有正確的保護層次中,指定是否維持不保護這些方法,或將保護指派為拒絕所有存取。
    連結訊息驅動 Bean 的接聽器 如果應用程式包含訊息驅動 Enterprise Bean,對於連結訊息驅動 Bean 的接聽器,請提供每個訊息驅動 Bean 的接聽器埠名稱或啟動規格 JNDI 名稱。
    對映含有 2.x Entity Bean 之模組的預設資料來源 如果您的應用程式使用 EJB 模組,其中包含的 CMP Bean 是以 EJB 2.x 規格為基礎,請在對映含有 2.x Entity Bean 之模組的預設資料來源中,對要作為 EJB 模組的預設資料來源,指定預設資料來源的 JNDI 名稱,以及資源授權類型。 您可以選擇性地指定資料來源的登入配置名稱和鑑別內容。 當建立鑑別內容時,您必須按一下確定來儲存值,以及返回對映步驟。 您可以選擇性地指定延伸資料來源內容,以便啟用利用異質儲存區來連接 DB2 資料庫的資料來源。 如果為個別 CMP Bean 指定資料來源,則 EJB 模組的預設資料來源為選用。
    對映所有 2.x CMP Bean 的資料來源 如果應用程式具有基於 EJB 2.x 的 CMP Bean,請在對映所有 2.x CMP Bean 的資料來源頁面,為每一個 2.x CMP Bean 指定要使用的資料來源的 JNDI 名稱和資源授權類型。

    您可以選擇性地指定資料來源的登入配置名稱和鑑別內容。 當建立鑑別內容時,您必須按一下確定來儲存值,以及返回對映步驟。 如果包含 CMP Bean 的 EJB 模組指定預設資料來源,則對於個別 CMP Bean 而言,資料來源屬性為選用。 如果未指定 EJB 模組的預設資料來源和個別 CMP Bean 的資料來源,則按一下完成後會出現驗證錯誤,並且取消安裝。

    確定所有不受保護的 2.x 方法都有正確的保護層次 如果應用程式包含的 EJB 2.x CMP Bean 在部署描述子中沒有為某些 EJB 方法定義方法權限,請在確定所有未受保護的 2.x 方法都有正確的保護層次頁面中,指定是否要指派特定的角色給未受保護的方法、將方法新增至排除清單,或將它們標示為取消選取。 新增至排除清單的方法會標示為無法呼叫。對於標示為取消選取的方法,在呼叫它們之前,不會執行授權檢查。
    提供選項來執行 EJB 部署 如果已在選取安裝選項頁面中啟用部署 Enterprise Bean 設定,您可以在提供選項來執行 EJB 部署頁面中,指定 EJB 部署工具的選項。 在此頁面上,您可以指定執行 EJB 部署工具時要使用的其他類別路徑、RMIC 選項、資料庫類型和資料庫綱目名稱。

    在安裝或更新包含 EJB 模組的應用程式時,您可以在此頁面上指定 EJB 部署工具選項。安裝 EJB 1.x 或 2.x 模組期間會執行 EJB 部署工具。 安裝 EJB 3.x 模組期間不會執行 EJB 部署工具。

    對映共用程式庫 共用程式庫參照共用程式庫對映頁面中,指定您的應用程式或 Web 模組要使用的共用程式庫檔案。 必須存在已定義的共用程式庫,才能使應用程式或模組與程式庫檔案相關聯。
    對映共用程式庫關係 對映共用程式庫關係頁面上,指定企業應用程式中的模組所參照之共用程式庫的關係 ID 和組合單元名稱。

    安裝企業應用程式時,對於您在選取安裝選項頁面的商業層次應用程式名稱中指定的商業層次應用程式,本產品會為此應用程式中的每一個共用程式庫關係建立組合單元。

    提供 Web 模組的 JSP 重新載入選項 如果您的應用程式使用 Web 模組,請在提供 Web 模組的 JSP 重新載入選項中,配置 JavaServer Pages (JSP) 檔的類別重新載入。
    對映 Web 模組的環境定義根目錄 如果您的應用程式使用的 Web 模組是定義在應用程式 XML 部署描述子中,請在對映 Web 模組的環境定義根目錄中,指定應用程式中每個 Web 模組的環境定義根目錄。

    本產品在此頁面上不包含註釋中的 Web 模組。

    起始設定 Servlet 參數 如果您的應用程式使用的 Web 模組支援 Servlet 2.5,請在起始設定 Servlet 參數中,指定或置換傳給 Web 模組 Servlet 過濾器之 init 方法的起始參數。

    此頁面會顯示模組 XML 部署描述子中的 Servlet。此頁面不提供註釋中的 Servlet 部署資訊。

    對映 EJB 模組的環境項目 如果您的應用程式使用 EJB 模組,請在對映 EJB 模組的環境項目中,配置 EJB 模組的環境項目,例如:實體、階段作業或訊息驅動 Bean。
    對映用戶端模組的環境項目 如果您要部署一或多個應用程式用戶端模組,請在對映用戶端模組的環境項目中,針對部署為 JAR 檔的用戶端模組配置環境項目。 如果要檢視「對映用戶端模組的環境項目」頁面,請選取「選取安裝選項」頁面上的部署用戶端模組選項。
    對映 Web 模組的環境項目 如果您的應用程式使用的 Web 模組支援 Servlet 2.5,請在對映 Web 模組的環境項目中,配置 Web 模組環境項目(例如,Servlet 和 JSP 檔)。
    對映應用程式層次的環境項目 如果您的應用程式定義一或多個環境項目,請在對映應用程式層次的環境項目中,配置部署為 EAR 檔之應用程式的環境項目。
    將資源環境項目參照對映至資源 如果應用程式包含資源環境參照,請在將資源環境項目參照對映至資源中,指定資源的 JNDI 名稱,以對映到資源環境參照中定義的邏輯名稱。 如果每一個資源環境參照沒有相關聯的資源,則按一下完成後會出現驗證錯誤。
    更正系統身分的使用 如果您的應用程式將執行身分定義為系統身分,在更正系統身分的使用中,您可以選擇性地將它改成執行身分角色,並針對所指定的「執行身分」角色指定一個使用者名稱和密碼。 選取系統身分暗示會利用 WebSphere Application Server 安全伺服器 ID 來進行呼叫,由於這個 ID 擁有較多專用權,所以使用時務必小心謹慎。
    更正所有資源參照的隔離層次 如果應用程式有資源參照對映至具有執行後端處理之 Oracle 資料庫的資源,對於更正所有資源參照的隔離層次,請指定或更正在應用程式使用這類資源時,所用的隔離層次。Oracle 資料庫僅支援 ReadCommitted 和 Serializable 隔離層次。
    對映 JASPI 提供者 如果您的應用程式具有 Web 模組,則您可以在對映 JASPI 提供者頁面上指定值,以從廣域或網域安全配置置換 JASPI 設定。 依預設,應用程式會繼承 WebSphere Application Server 廣域或網域安全配置中定義的 JASPI 設定,而 Web 模組會繼承應用程式設定。
    連結訊息目的地參照至受管理物件 如果應用程式使用訊息驅動 Bean,請在將訊息目的地參照連結至受管理物件中,指定 J2C 受管理物件的 JNDI 名稱,以便將訊息目的地參照連結到訊息驅動 Bean。

    如果訊息目的地參照來自 EJB 3.0 或或更新版本的模組,則 JNDI 名稱為選用,執行時期會提供儲存器預設值。

    小心: 如果多個訊息目的地參照鏈結到相同的訊息目的地,則只會收集一個 JNDI 名稱。 當訊息目的地參照鏈結到與訊息驅動 Bean 相同的訊息目的地,而且已收集目的地 JNDI 名稱時,不會收集訊息目的地參照的目的地 JNDI 名稱。
    提供 JCA 物件的 JNDI 名稱 如果您的應用程式包含內嵌的 .rar 檔,請在提供 JCA 物件的 JNDI 名稱中,指定每個 JCA Connection Factory、受管理物件和啟動規格的名稱和 JNDI 名稱。
    將 J2C 啟動規格連結至目的地 JNDI 名稱 如果您的應用程式包含內嵌的 .rar 檔,它的 activationSpec 內容值是 Destination,內部檢查類型是 javax.jms.Destination,請在連結 J2C 啟動規格至目的地 JNDI 名稱中,指定它所連結的每項啟動之 jndiName 值。
    選取現行後端系統 ID 如果應用程式所包含的 EJB 模組已利用組合工具來產生部署程式碼,供多個後端資料庫使用,請在選取現行後端系統 ID 中,指定代表在執行 EJB 模組時所使用之後端資料庫的後端系統 ID。

    如需後端資料庫的相關資訊,請參閱有關 EJB 部署工具的主題。

    如果在「選取安裝選項」頁面中啟用了部署 Enterprise Bean 設定,且在「提供選項來執行 EJB 部署」頁面中指定了以外的資料庫類型,就不會顯示這個步驟。

    模組的 meta 資料 如果應用程式具有 EJB 3.x 或 Web 2.5 模組,您可以鎖定一或多個 EJB 3.x 或 Web 2.5 模組的部署描述子。 如果您將 metadata-complete 屬性設為 true 並鎖定部署描述子,本產品會以 XML 格式撰寫完整的模組部署描述子,包括註釋中的部署資訊。
    提供選項以執行 Web 服務部署 如果在選取安裝選項頁面中啟用了部署 Web 服務設定,且您的應用程式使用 Web 服務,您可以在提供選項來執行 Web 服務部署頁面中指定 wsdeploy 指令選項。 如需此頁面的相關資訊,請參閱 wsdeploy -cp-jardir 選項的說明。
    配置遠端要求分派內容 如果您正在使用遠端要求分派器,則必須先配置再使用它。 遠端要求分派器 (RRD) 是 Web 儲存器的外掛延伸,可讓應用程式架構、Servlet 及 JavaServer Pages 將來自目前執行中的資源 Java 虛擬機器 (JVM) 以外的內容,加入傳送到用戶端的回應中。 如需在管理主控台的何處可配置這些內容的相關資訊,請參閱「遠端分派器內容設定」。
    顯示模組建置 ID 如果企業應用程式之模組的 MANIFEST.MF 檔指定了建置 ID,那麼這個頁面會顯示該模組的建置 ID。
  5. 在「摘要」頁面上,驗證將要安裝應用程式模組的 Cell、節點和伺服器:
    1. Cell/節點/伺服器旁邊,按一下請按一下這裡
    2. 驗證設定。
    3. 回到「摘要」頁面。
    4. 按一下完成

結果

出現許多訊息,指出應用程式檔案是否安裝成功。

如果「選取安裝選項」頁面上的驗證輸入:關/警告/失敗設為警告(預設值),可能會顯示多項驗證警告。 如果設定為失敗,驗證警告可能會造成錯誤。

如果您收到 OutOfMemory 異常狀況,且來源應用程式檔並未安裝,可能是您的系統沒有足夠的記憶體,或應用程式含有太多模組而無法順利安裝到伺服器中。 在此情況下,請檢查 SystemOut.logSystemErr.log,以及錯誤所牽涉的機器的首次失敗資料擷取 (FFDC) 日誌檔,以判斷哪個系統上的哪些 Java 程序發生此錯誤。 在發生異常狀況的系統上,請嘗試將 Java 資料堆大小上限增加 256 MB。 如需相關資訊,請參閱調整 IBM Java 虛擬機器的相關文件。 調整資料堆大小上限之後,請嘗試重新安裝應用程式檔案。 根據安裝此應用程式所需的記憶體數量而定,您可能需要多次提高資料堆大小上限。 如果已達到 JVM 支援的資料堆大小上限,但問題仍然發生,請嘗試減少模組來重新包裝應用程式。

[z/OS]如果您正在 Internet Explorer 瀏覽器中使用應用程式安裝精靈,應用程式安裝可能會斷斷續續地失敗。 Internet Explorer 瀏覽器不會傳送伺服器預期的所有加密資料。 如果要安裝應用程式,請在 Firefox 1.5 或更新版本的瀏覽器中使用應用程式安裝精靈,或使用 wsadmin 工具。

[z/OS]在 z/OS® 作業系統中,可能無法安裝大於 10 MB 的應用程式檔案。 當應用程式伺服器 protocol_http_large_data_inbound_buffer 自訂內容設為零 (0) 時(預設值),您無法安裝大於 10 MB 的應用程式檔案。 請將 protocol_http_large_data_inbound_buffer 設為大於應用程式檔案大小的值。 比方說,如果您要安裝的 EAR 檔大小為 15 MB,請將 protocol_http_large_data_inbound_buffer 設為 20 MB:
  1. 按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > server_name > 伺服器基礎架構 > 管理 > 自訂內容
  2. protocol_http_large_data_inbound_buffer 應用程式伺服器自訂內容設為 20000000
  3. 停止並重新啟動應用程式伺服器。
  4. 嘗試重新安裝 EAR 檔。

下一步

成功安裝應用程式檔案之後,請執行下列動作:

  1. 將變更儲存到配置。

    例如,按一下應用程式安裝訊息中的儲存鏈結。

    應用程式會向管理配置登錄,而應用程式檔案會複製到目標目錄,依預設為 app_server_root/installedApps/cell_name 或您指定的目錄。

    對於單一伺服器產品,儲存變更時會將應用程式檔案複製到目的地目錄。

    對於多伺服器產品,部署管理程式的配置與個別節點的配置同步處理時,檔案會複製到遠端節點。

    如果您按一下應用程式安裝訊息中的儲存鏈結,「準備安裝應用程式」頁面會再次出現。 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式來結束頁面,並在已安裝的應用程式清單中查看您的應用程式。

  2. 啟動應用程式。
  3. 測試應用程式。例如,從 Web 瀏覽器指向已部署的應用程式的 URL,檢查應用程式的效能。必要的話,編輯應用程式配置。

指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_instwiz
檔名:trun_app_instwiz.html