請利用這個頁面,來指定將 Java™ Platform Enterprise Edition (Java EE) 應用程式安裝到 WebSphere® Application Server 部署目標的選項。 如果您沒有指定任何值,就會使用選項的預設值。 安裝好應用程式之後,您可以在企業應用程式設定頁面中,指定許多這些選項的值。
如果要檢視這個管理主控台頁面,請按一下應用程式 > 新建應用程式 > 新建企業應用程式,然後在「準備安裝應用程式」頁面中指定應用程式所需要的值。
應用程式的安裝和更新精靈,有相同的「選取安裝選項」頁面。
請指定是否要在安裝過程中,前置編譯 JavaServer Pages (JSP) 檔。 依預設不會前置編譯 JSP 檔。
這個選項只安裝在 6.1 版或更新版本的部署目標中。
如果您選取前置編譯 JavaServer Pages 檔,且嘗試將應用程式安裝在舊版的部署目標(如 5.x 版)中,安裝會遭到拒絕。 您只能將應用程式部署到版本與產品相同的部署目標中。 如果應用程式的目標伺服器版本比產品還舊,您將無法部署到這些目標中。
資料類型 | 布林 |
預設值 | false |
指定將安裝企業保存檔 (EAR) 的目錄。
依預設,EAR 檔是安裝在 profile_root/installedApps/cell_name/application_name.ear 目錄中。
設定選項包括:
預設值是 ${APP_INSTALL_ROOT}/cell_name,其中 ${APP_INSTALL_ROOT} 變數是 profile_root/installedApps。 含有安裝的應用程式之 EAR 檔名的目錄會附加到 ${APP_INSTALL_ROOT}/cell_name 中。 因此,如果未指定目錄,EAR 檔會安裝在 profile_root/installedApps/cell_name/application_name.ear 目錄中。
如果您在應用程式安裝目錄中指定目錄,應用程式是安裝在 specified_path/application_name.ear 目錄中。 含有安裝的應用程式之 EAR 檔名稱的目錄會附加到應用程式安裝目錄所指定的路徑中。 比方說,如果您要安裝 Clock.ear,且在 Windows® 機器上指定 C:/myapps,應用程式會安裝在 myapps/Clock.ear 目錄中。 ${APP_INSTALL_ROOT} 變數設為指定的路徑。
如果您想要將應用程式從一個 Cell 中匯出,稍後再將匯出的應用程式安裝到另一個 Cell,請針對初次安裝的應用程式來指定 ${CELL} 變數。 例如,在這項設定中指定 ${APP_INSTALL_ROOT}/${CELL}。 匯出應用程式會建立一個含有應用程式及其部署配置的加強型 EAR 檔。 除非您指定了 ${CELL} 變數,否則,部署配置會將初次安裝的 Cell 名稱保留在目的地目錄中。 指定 ${CELL} 變數,可以確保目的地目錄含有現行 Cell 名稱,而不是原始 Cell 名稱。
匯出的 EAR 檔是含有應用程式及其部署配置的加強型 EAR 檔。 部署配置會保留先前安裝的應用程式所用的應用程式安裝目錄值。 除非您在這次安裝的應用程式安裝目錄中指定另一個值,否則,加強型 EAR 檔會安裝到先前安裝的相同目錄中。
如果在初次安裝期間,您並未指定 ${CELL} 變數,部署配置會使用目的地目錄中初次安裝的 Cell 名稱。 如果是安裝在另一個 Cell 上,請指定 ${APP_INSTALL_ROOT}/cell_name/application_name.ear,其中 cell_name 是加強型 EAR 檔要安裝到其中的 Cell 名稱。 如果您並未指定現行 Cell 名稱,cell_name 便是原始 Cell 名稱,即使您將加強型 EAR 檔安裝在不同名稱的 Cell 上,也是如此。
您可以指定一個絕對路徑或使用路徑對映變數,如:${MY_APPS}。 在任何安裝架構中,都可以使用路徑對映變數。
在成員都位於異質節點上的叢集中安裝應用程式時,尤其需要使用路徑對映變數,因為在這種情況下,可能無法指定絕對路徑。 代表現行 Cell 名稱的 WebSphere Application Server 變數 ${CELL} 也可以用在路徑對映變數中;例如,${MY_APP}/${CELL}。 您可以按一下環境 > WebSphere 變數來存取「WebSphere 變數」主控台頁面,在其中定義 WebSphere Application Server 變數。
這個應用程式安裝目錄欄位與「應用程式二進位檔」頁面中的位置(完整路徑)設定相同。
資料類型 | 字串 |
單位 | 完整路徑名稱 |
指定產品在安裝期間是否要展開安裝位置中的應用程式二進位檔,以及在解除安裝期間是否要刪除應用程式的二進位檔。預設值是啟用應用程式分散作業。安裝的應用程式之應用程式二進位檔會展開到指定目錄。
在單一伺服器的產品上,當您解除安裝和儲存配置變更時,會刪除二進位檔。
在多重伺服器的產品上,當您解除安裝和儲存配置變更,以及將變更同步化時,會刪除二進位檔。
如果停用這個選項,您必須確定在執行應用程式的所有節點的目的地目錄中,已適當展開應用程式二進位檔。
這個配送應用程式欄位與「應用程式二進位檔」頁面上的在解除安裝之後啟用二進位檔的配送、展開和清理設定相同。
資料類型 | 布林 |
預設值 | true |
指定應用程式伺服器要使用位於應用程式部署文件(deployment.xml 檔,預設值)的連結、延伸規格和部署描述子,或使用在企業保存檔 (EAR) 檔中的連結、延伸規格和部署描述子。請只針對安裝在 6.0 版或更新版本的部署目標上的應用程式,選取這個設定。這項設定對安裝在 5.x 部署目標上的應用程式無效。
預設值 (false) 是不使用 deployment.xml 中的連結、延伸規格和部署描述子。 如果要使用 EAR 檔中的連結、延伸規格和部署描述子,請啟用這項設定 (true)。
這個使用二進位配置欄位與「應用程式二進位檔」頁面上的使用二進位配置資訊設定相同。
資料類型 | 布林 |
預設值 | false |
指定在應用程式安裝期間,是否要執行 EJBDeploy 工具。
在安裝 EJB 1.x 或 2.x 模組期間,執行了 EJB 部署工具。 在安裝 EJB 3.0 版模組期間,並不執行 EJB 部署工具。
這個選項只安裝在 6.1 版或更新版本的部署目標中。
如果您選取部署 Enterprise Bean,且嘗試將應用程式安裝在舊版的部署目標(如 6.0 版)中,安裝會遭到拒絕。 您只能將應用程式部署到 WebSphere 版本與產品相同的目標中。 如果應用程式的目標伺服器版本比產品還舊,您將無法部署到這些目標中。
另外,如果您在提供選項來執行 EJB 部署頁面中,選取部署 Enterprise Bean 並指定資料庫類型,所選資料庫類型會改寫先前針對所有 EJB 模組所定義的後端系統 ID。 如果要啟用個別 EJB 模組的後端系統 ID,請在提供選項來執行 EJB 部署頁面中,將資料庫類型設為 "" (null)。
啟用這項設定可能使安裝程式執行好幾分鐘。
資料類型 | 布林 |
預設值 | true (EJB 3.0 模組是 false) |
指定應用程式的邏輯名稱。應用程式名稱在 Cell 內必須是唯一的,且不能含有不受支援的字元。
應用程式名稱的開頭不能為句點 (.)、前端或尾端不能含有空格,也不能含有下列任一字元:
不受支援的字元 | ||
---|---|---|
/ 正斜線 | $ 錢幣符號 | ' 單引號 |
\ 反斜線 | = 等號 | " 雙引號 |
* 星號 | % 百分比符號 | | 垂直線 |
, 逗點 | + 加號 | < 左括弧 |
: 冒號 | @ at 符號 | > 右角括弧 |
; 分號 | # # 字號 | & ?'&' 符號 |
? 問號 | ]]> 這個字元組合沒有特定名稱 |
這個應用程式名稱欄位與「企業應用程式設定」頁面中的名稱設定相同。
資料類型 | 字串 |
指定當應用程式啟動時,是否要建立應用程式內各項資源(如 Servlet 或 JSP 檔)的 MBean。 預設值是建立 MBean。
這個欄位與「啟動行為」頁面上的建立資源 MBean 設定相同。
資料類型 | 布林 |
預設值 | true |
指定產品執行時期是否要在執行應用程式時,偵測應用程式類別的變更。 如果啟用這項設定且應用程式類別已變更,則應用程式會停止並重新啟動,以重新載入更新過的類別。
依預設不會啟用重新載入類別功能。
這個欄位與「類別載入和更新偵測」頁面上的置換 Web 和 EJB 模組的類別重新載入設定相同。
資料類型 | 布林 |
預設值 | false |
指定掃描應用程式檔案系統來找出更新的檔案的秒數。預設值是 EAR 檔的 IBM® 延伸規格 (META-INF/ibm-application-ext.xmi) 檔中的重新載入間隔屬性值。
只有在啟用類別重新載入功能時,重新載入間隔屬性才有效。
如果要啟用重新載入,請指定一個大於零的值(例如,1 到 2147483647)。如果要停用重新載入,請指定零 (0)。其範圍是零至 2147483647。
這個重新載入間隔(秒)欄位與「類別載入和更新偵測」頁面上的更新檔案的輪詢間隔設定相同。
資料類型 | 整數 |
單位 | 秒 |
預設值 | 3 |
指定在應用程式安裝期間,是否要執行 Web 服務部署工具 wsdeploy。
這個工具會產生執行使用 Web 服務之應用程式所需的程式碼。預設值是不執行 wsdeploy 工具。 如果 EAR 檔含有使用 Web 服務的模組,且先前未從組合工具的部署功能表選項或從指令行中執行 wsdeploy 工具來處理它,您就必須啟用這項設定。
這個選項只安裝在 6.1 版或更新版本的部署目標中。
如果您選取部署 Web 服務,且嘗試將應用程式安裝在舊版的部署目標(如 5.x 版)中,安裝會遭到拒絕。 您只能將應用程式部署到版本與產品相同的目標中。 如果應用程式的目標伺服器版本比產品還舊,您將無法部署到這些目標中。
資料類型 | 布林 |
預設值 | false |
指定產品是否要在應用程式安裝或更新期間,檢查指定的應用程式參照,以及如果啟用驗證,是否要警告您不正確參照或是使作業失敗。
應用程式參照的資源通常會使用儲存器管理的持續性 (CMP) Bean 的資料來源,或是使用部署描述子中定義的資源參照或資源環境參照。驗證會檢查應用程式所參照的資源是否定義在這個應用程式的部署目標範圍中。
選取關閉表示沒有資源驗證,警告表示與不正確的資源參照相關的警告訊息,失敗則會在發生不正確資源參照時,停止失敗的作業。
這個驗證輸入關閉/警告/失敗欄位與「企業應用程式設定」頁面上的應用程式參照驗證設定相同。
資料類型 | 字串 |
預設值 | 警告 |
指定是否應該處理內嵌配置。 內嵌配置由 resource.xml 和 variables.xml 等檔案組成。 在選取之後或其值為 true 時,會從 .ear 檔中,將內嵌配置載入應用程式範圍中。 如果 .ear 檔並未包含內嵌配置,預設值是 false。 如果 .ear 檔包含內嵌配置,預設值是 true。
這項設定會影響加強型 EAR 檔的安裝。加強型 EAR 檔會在您匯出已安裝的應用程式時產生。
若為 false,加強型 EAR 檔的安裝方式會如同其他任何應用程式一樣,並且產品會忽略其內嵌配置。
如果您從現行 Cell 以外的 Cell 中匯出應用程式,且在初次安裝應用程式時,並未針對 應用程式安裝目錄來指定 $(CELL) 變數,請取消選取這項設定 (false),以在 profile_root/installedApps/current_cell_name 目錄中展開加強型 EAR 檔。 否則,如果選取這項設定 (true),加強型 EAR 檔便會在 profile_root/installedApps/original_cell_name 目錄中展開,其中 original_cell_name 是初次安裝應用程式所在的 Cell。 如果初次安裝應用程式時,針對應用程式安裝目錄指定了 $(CELL) 變數,安裝作業便會在 profile_root/installedApps/current_cell_name 目錄中展開加強型 EAR 檔。
資料類型 | 布林 |
預設值 | false(取消選取) |
指定展開到指定目錄下的已安裝應用程式之應用程式二進位檔的存取權。
您必須啟用配送應用程式選項來指定檔案許可權。
您可以在文字欄位中指定檔案許可權。您也可以從多重選項清單中選取一些常用的檔案許可權,以設定它們。 清單選項會改寫您在文字欄位中所設的檔案許可權。
您可以設定清單中下列一或多個檔案許可權字串。如果您選取多個選項,則會合併檔案許可權字串。
多重選項清單選項 | 所設的檔案許可權字串 |
---|---|
容許讀取所有檔案,但不能寫入 | .*=755 |
容許執行檔執行 | .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 |
容許每一位讀取 HTML 和影像檔 | .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755 |
您也可以不使用多重選項清單來指定檔案許可權,而改在文字欄位中指定檔案許可權字串。檔案許可權所用的字串格式如下:
file_name_pattern=permission#file_name_pattern=permission
其中 file_name_pattern 是檔名過濾器的正規表示式(例如,.*\\.jsp 代表所有 JSP 檔),permission 會提供檔案存取控制清單 (ACL),# 則是多個 file_name_pattern 和 permission 項目之間的分隔字元。 如果 # 是 file_name_pattern 字串中的字元,請改用 \#。
如果字串中有多個檔名型樣和檔案許可權符合應用程式內的統一資源識別碼 (URI),產品會對檔案使用最嚴格的適用檔案許可權。 比方說,如果檔案許可權字串為 .*\\.jsp=775#a.*\\.jsp=754,abc.jsp 檔的檔案許可權便是 754。
1 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war |
2 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp |
3 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF |
4 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class |
5 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class |
6 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF |
檔案型樣比對結果為:
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp而您指定如下的檔案型樣字串:
.*MyApp.ear$=755#.*\.jsp=644檔案型樣比對結果為:
在 Windows 平台上,您不能取消設定檔案的許可權。
使用 POSIX 樣式許可權位元時,表示檔案可讀取的位元是 4,可寫入是 2,而可執行是 1。因此,Windows 平台上的檔案許可權會是 5 或 7。此外,POSIX 樣式有 user、group 和 world 許可權。在 Windows 平台中,您只能對檔案設定 user 許可權。group 和 world 許可權位元會被忽略。
這裡所指定是應用程式層次的存取權。 您也可以在節點層次配置中指定應用程式二進位檔的存取權。 節點層次的檔案許可權指定可提供給應用程式二進位檔的最大(最寬鬆)的許可權。 這裡指定的應用程式層次存取權只能比節點層次指定的存取權更嚴格或相同。
這項設定與「應用程式二進位檔」頁面上的檔案許可權欄位相同。
資料類型 | 字串 |
指定用來識別應用程式建置版本的不可編輯的字串。
這個應用程式建置 ID 欄位與「應用程式二進位檔」頁面上的應用程式建置層次欄位相同。
資料類型 | 字串 |
指定應用程式是否能夠利用標準要求分派器機制,跨越在受管理節點環境的不同 Java 虛擬機器中之各個 Web 模組,將併入項目分派給各項資源。
這個欄位與「遠端要求分派內容」頁面上的容許將併入項目分派至遠端資源欄位相同。
資料類型 | 布林 |
預設值 | false |
指定企業應用程式是否能夠處理來自應用程式的併入要求。
這個欄位與「遠端要求分派內容」頁面上的容許處理來自遠端資源的併入項目欄位相同。
資料類型 | 布林 |
預設值 | false |
指定產品是否以您在安裝的企業應用程式來建立新的商業層次應用程式,或使企業應用程式成為現有商業層次應用程式的組合單元。
預設值是以 WebSphere:blaname=Anyasset,blaedition=BASE 設定值來建立新的商業層次應用程式。 當您從下拉清單中選擇建立新的商業層次應用程式時,產品會建立一個與企業應用程式同名的商業層次應用程式。如果已有一個商業層次應用程式使用您的企業應用程式名稱,產品就不會建立新商業層次應用程式;它會將您的企業應用程式當成組合單元,新增到該現有的商業層次應用程式中。
如果要將企業應用程式新增到現有的商業層次應用程式中,請從下拉清單中選取現有的商業層次應用程式。 產品會使您的企業應用程式成為現有商業層次應用程式的組合單元。
資料類型 | 字串 |
預設值 | 建立一個與所安裝企業應用程式同名的新的商業層次應用程式。
WebSphere:blaname=Anyasset,blaedition=BASE |
指定 Web 模組是否可以在個別執行緒上同時分派各個要求,如果可以,是由伺服器或用戶端來分派要求。 並行分派可以改進 Servlet 回應時間。
如果作業彼此相依,請勿啟用非同步要求的分派。 選取已停用。當作業相依時,並行分派可能會造成錯誤。
選取伺服器端,伺服器便能夠同時分派要求。 選取用戶端,用戶端便能夠同時分派要求。
資料類型 | 字串 |
預設值 | 停用 |
指定產品是否指派不完整 EJB 參照目標的預設 JNDI 值,或自動解析這些目標。
請選取這個選項,以便在參照來自 EJB 2.1 或舊版模組時,或來自 Web 2.3 或舊版模組時,自動解析 EJB 參照目標。 如果您啟用這個選項,執行時期儲存器會提供一個預設值,或針對任何不含連結的 EJB 參照來自動解析 EJB 參照。
如果您已在「準備安裝應用程式」頁面上選取產生預設連結,就不需要選取這個選項。 產品會產生預設值。
如果您選取容許自動解析 EJB 參照目標,應用程式中的所有模組都必須共用同一個部署目標。 如果您選取這個選項,且所有應用程式模組並沒有共用同一部伺服器,在「摘要」頁面上,按一下完成之後,產品會顯示一則警告訊息,且不會安裝應用程式。 您必須先取消選取這項設定,再按一下完成,才能安裝應用程式。
資料類型 | 布林 |
預設值 | false |