選取安裝選項設定

請利用這個畫面來指定將 Java™ Platform Enterprise Edition (Java EE) 應用程式安裝到 WebSphere® Application Server 部署目標的選項。 如果您沒有指定任何值,就會使用選項的預設值。 安裝好應用程式之後,您可以在企業應用程式設定頁面中,指定許多這些選項的值。

若要檢視這個管理主控台畫面,請按一下應用程式 > 新的應用程式 > 新的企業應用程式,然後在「準備安裝應用程式」頁面中指定應用程式所需要的值。

安裝和更新應用程式的精靈有相同的「選取安裝選項」畫面。

前置編譯 JavaServer Pages 檔

請指定是否要在安裝過程中,前置編譯 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} 變數設為指定的路徑。

  • 指定應用程式之初次安裝的 ${APP_INSTALL_ROOT}/${CELL}

    如果您想要將應用程式從一個 Cell 中匯出,稍後再將匯出的應用程式安裝到另一個 Cell,請針對初次安裝的應用程式來指定 ${CELL} 變數。 比方說,在這項設定中指定 ${APP_INSTALL_ROOT}/${CELL}。 匯出應用程式會建立一個含有應用程式及其部署配置的加強型 EAR 檔。 除非您指定了 ${CELL} 變數,否則,部署配置會將初次安裝的 Cell 名稱保留在目的地目錄中。 指定 ${CELL} 變數,可以確保目的地目錄含有現行 Cell 名稱,而不是原始 Cell 名稱。

    重要: 如果在單一伺服器配置中安裝應用程式時未指定安裝目錄,應用程式會安裝在 ${APP_INSTALL_ROOT}/cell_name。 當伺服器成為多重伺服器配置的一部分(使用 addNode 公用程式)時,新配置的 Cell 名稱會成為部署管理程式節點的 Cell 名稱。 如果 addNode 公用程式使用 -includeapps 選項,在 addNode 作業之前安裝的應用程式,仍會使用安裝目錄 ${APP_INSTALL_ROOT}/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 找到應用程式檔案。
  • 如果已匯出應用程式,且您要將匯出的 EAR 檔安裝在另一個 Cell 或位置,如果初次安裝並未指定 ${APP_INSTALL_ROOT}/${CELL},請指定 ${APP_INSTALL_ROOT}/cell_name/application_name.ear

    匯出的 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 變數。

這個應用程式安裝目錄欄位與「應用程式二進位檔」頁面中的位置(完整路徑)設定相同。

資料類型 字串
單位 完整路徑名稱
分散式應用程式

指定產品在安裝期間是否要展開安裝位置中的應用程式二進位檔,以及在解除安裝期間是否要刪除應用程式的二進位檔。預設值是啟用應用程式分散作業。安裝的應用程式之應用程式二進位檔會展開到指定目錄。

在單一伺服器的產品上,當您解除安裝和儲存配置變更時,會刪除二進位檔。

在多重伺服器的產品上,當您解除安裝和儲存配置變更,以及將變更同步化時,會刪除二進位檔。

如果停用這個選項,您必須確定在執行應用程式的所有節點的目的地目錄中,已適當展開應用程式二進位檔。

避免問題: 如果您停用這個選項,且您不要將應用程式二進位檔複製和展開至各個節點,稍後儲存配置或手動同步化時,不會自動將應用程式二進位檔移至節點。 gotcha

這個配送應用程式欄位與「應用程式二進位檔」頁面上的在解除安裝之後啟用二進位檔的配送、展開和清理設定相同。

資料類型 布林
預設值 true
使用二進位配置

指定應用程式伺服器要使用位於應用程式部署文件(deployment.xml 檔,預設值)的連結、延伸規格和部署描述子,或使用在企業保存檔 (EAR) 檔中的連結、延伸規格和部署描述子。請只針對安裝在 6.0 版或更新版本的部署目標上的應用程式,選取這個設定。這項設定對安裝在 5.x 部署目標上的應用程式無效。

預設值 (false) 是不使用 deployment.xml 中的連結、延伸規格和部署描述子。 若要使用 EAR 檔中的連結、延伸規格和部署描述子,請啟用這項設定 (true)。

這個使用二進位配置欄位與「應用程式二進位檔」頁面上的使用二進位配置資訊設定相同。

資料類型 布林
預設值 false
部署 Enterprise Bean

指定在應用程式安裝期間,是否要執行 EJBDeploy 工具。

工具會產生執行 Enterprise Bean (EJB) 檔所需要的程式碼。 在下列情況下,您必須啟用這項設定:
  • EAR 檔是利用 Rational® Application Developer 等組合工具來組合的,且組合期間未執行 EJBDeploy 工具。
  • EAR 檔不是利用 Rational Application Developer 等組合工具來組合的。
  • 使用 5.0 版以前的應用程式組合工具 (AAT) 版本組合了 EAR 檔。

在安裝 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 符號 >  右角括弧
;   分號 #    # 字號 & ?'&' 符號
? 問號 ]]> 這個字元組合沒有特定名稱

這個應用程式名稱欄位與「企業應用程式設定」頁面中的名稱設定相同。

資料類型 字串
建立資源的 MBean

指定當應用程式啟動時,是否要建立應用程式內各項資源(如 Servlet 或 JSP 檔)的 MBean。 預設值是建立 MBean。

這個欄位與「啟動行為」頁面上的建立資源 MBean 設定相同。

資料類型 布林
預設值 true
置換 Web 和 EJB 模組的類別重新載入設定

指定產品執行時期是否要在執行應用程式時,偵測應用程式類別的變更。 如果啟用這項設定且應用程式類別已變更,則應用程式會停止並重新啟動,以重新載入更新過的類別。

依預設不會啟用重新載入類別功能。

這個欄位與「類別載入和更新偵測」頁面上的置換 Web 和 EJB 模組的類別重新載入設定相同。

資料類型 布林
預設值 false
重新載入間隔(秒)

指定掃描應用程式檔案系統來找出更新的檔案的秒數。預設值是 EAR 檔的 IBM® 延伸規格 (META-INF/ibm-application-ext.xmi) 檔中的重新載入間隔屬性值。

只有在啟用類別重新載入功能時,重新載入間隔屬性才有效。

若要啟用重新載入,請指定一個大於零的值(例如,1 到 2147483647)。若要停用重新載入,請指定零 (0)。其範圍是零至 2147483647。

這個重新載入間隔(秒)欄位與「類別載入和更新偵測」頁面上的更新檔案的輪詢間隔設定相同。

資料類型 整數
單位
預設值 3
部署 Web 服務

指定在應用程式安裝期間,是否要執行 Web 服務部署工具 wsdeploy

這個工具會產生執行使用 Web 服務之應用程式所需的程式碼。預設值是不執行 wsdeploy 工具。 如果 EAR 檔含有使用 Web 服務的模組,且先前未從組合工具的部署功能表選項或從指令行中執行 wsdeploy 工具來處理它,您就必須啟用這項設定。

這個選項只安裝在 6.1 版或更新版本的部署目標中。

如果您選取部署 Web 服務,且試圖將應用程式安裝在舊版的部署目標(如 5.x 版)中,安裝會遭到拒絕。 您只能將應用程式部署到版本與產品相同的目標中。 如果應用程式的目標伺服器版本比產品還舊,您將無法部署到這些目標中。

資料類型 布林
預設值 false
驗證輸入關閉/警告/失敗

指定產品是否要在應用程式安裝或更新期間,檢查指定的應用程式參照,以及如果啟用驗證,是否要警告您不正確參照或是使作業失敗。

應用程式參照的資源通常會使用儲存器管理的持續性 (CMP) Bean 的資料來源,或是使用部署描述子中定義的資源參照或資源環境參照。驗證會檢查應用程式所參照的資源是否定義在這個應用程式的部署目標範圍中。

選取關閉表示沒有資源驗證,警告表示與不正確的資源參照相關的警告訊息,失敗則會在發生不正確資源參照時,停止失敗的作業。

這個驗證輸入關閉/警告/失敗欄位與「企業應用程式設定」頁面上的應用程式參照驗證設定相同。

資料類型 字串
預設值 警告
程序內嵌配置

指定是否應該處理內嵌配置。 內嵌配置由 resource.xmlvariables.xml 等檔案組成。 在選取之後或其值為 true 時,會從 .ear 檔中,將內嵌配置載入應用程式範圍中。 如果 .ear 檔並未包含內嵌配置,預設值是 false。 如果 .ear 檔包含內嵌配置,預設值是 true

資料類型 布林
預設值 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_patternpermission 項目之間的分隔字元。 如果 #file_name_pattern 字串中的字元,請改用 \#

如果字串中有多個檔名型樣和檔案許可權符合應用程式內的統一資源識別碼 (URI),產品會對檔案使用最嚴格的適用檔案許可權。 比方說,如果檔案許可權字串為 .*\\.jsp=775#a.*\\.jsp=754abc.jsp 檔的檔案許可權便是 754。

最佳作法: 當您在檔案比對型樣方面使用正規表示式時,會拿整個字串 URI 和指定的檔案許可權型樣相比較。您必須按照 Java 程式設計 API 所定義的,使用正規表示式提供更精確的比對型樣。例如,假設在檔案許可權作業期間會處理如下的目錄和檔案 URI: bprac
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

檔案型樣比對結果為:

  • MyWarModule.war 不符合任何 URI
  • .*MyWarModule.war.* 符合所有 URI
  • .*MyWarModule.war$ 只符合 URI 1
  • .*\\.jsp=755 只符合 URI 2
  • .*META-INF.* 符合 URI 3 和 6
  • .*MyWarModule.war/.*/.*\.class 符合 URI 4 和 5
如果您針對檔案許可權指定一個目錄名稱型樣,則會根據指定的值來設定目錄許可權。否則,設定在目錄上的檔案許可權值會和其母項相同。例如,假設您的檔案和目錄結構如下:
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp
而您指定如下的檔案型樣字串:
.*MyApp.ear$=755#.*\.jsp=644
檔案型樣比對結果為:
  • 目錄 MyApp.ear 設為 755
  • 目錄 MyWarModule.war 設為 755
  • 目錄 MyWarModule.war 設為 755
最佳作法: 不論作業系統為何,請一律在檔案型樣中以正斜線 (/) 作為檔案路徑分隔字元。bprac

[Windows] 在 Windows 平台上,您不能取消設定檔案的許可權。 使用 POSIX 樣式許可權位元時,表示檔案可讀取的位元是 4,可寫入是 2,而可執行是 1。因此,Windows 平台上的檔案許可權會是 5 或 7。此外,POSIX 樣式有 usergroupworld 許可權。在 Windows 平台中,您只能對檔案設定 user 許可權。groupworld 許可權位元會被忽略。

這裡所指定是應用程式層次的存取權。 您也可以在節點層次配置中指定應用程式二進位檔的存取權。 節點層次的檔案許可權指定可提供給應用程式二進位檔的最大(最寬鬆)的許可權。 這裡指定的應用程式層次存取權只能比節點層次指定的存取權更嚴格或相同。

這項設定與「應用程式二進位檔」頁面上的檔案許可權欄位相同。

資料類型 字串
應用程式建置 ID

指定用來識別應用程式建置版本的不可編輯的字串。

這個應用程式建置 ID 欄位與「應用程式二進位檔」頁面上的應用程式建置層次欄位相同。

資料類型 字串
容許將併入項目分派給遠端資源

指定應用程式是否能夠利用標準要求分派器機制,跨越在受管理節點環境的不同 Java 虛擬機器中之各個 Web 模組,將併入項目分派給各項資源。

這個欄位與「遠端要求分派內容」頁面上的容許將併入項目分派至遠端資源欄位相同。

資料類型 布林
預設值 false
容許處理來自遠端資源的併入項目

指定企業應用程式是否能夠處理來自應用程式的併入要求。

這個欄位與「遠端要求分派內容」頁面上的容許處理來自遠端資源的併入項目欄位相同。

資料類型 布林
預設值 false
商業層次應用程式名稱

指定產品是否以您在安裝的企業應用程式來建立新的商業層次應用程式,或使企業應用程式成為現有商業層次應用程式的組合單元。

預設值是以 WebSphere:blaname=Anyasset,bledition=1.0 設定值來建立新的商業層次應用程式。 當您從下拉清單中選擇建立新的商業層次應用程式時,產品會建立一個與企業應用程式同名的商業層次應用程式。

若要將企業應用程式新增到現有的商業層次應用程式中,請從下拉清單中選取現有的商業層次應用程式。 產品會使您的企業應用程式成為現有商業層次應用程式的組合單元。

資料類型 字串
預設值 建立一個與所安裝企業應用程式同名的新的商業層次應用程式。

WebSphere:blaname=Anyasset,bledition=1.0

非同步要求分派類型

指定 Web 模組是否可以在個別執行緒上同時分派各個要求,如果可以,是由伺服器或用戶端來分派要求。 並行分派可以改進 Servlet 回應時間。

如果作業彼此相依,請勿啟用非同步要求的分派。 選取已停用。當作業相依時,並行分派可能會造成錯誤。

選取伺服器端,伺服器便能夠同時分派要求。 選取用戶端,用戶端便能夠同時分派要求。

資料類型 字串
預設值 停用



標示(線上)的鏈結表示需要存取網際網路。

相關概念
相關工作
相關參考
準備應用程式安裝設定
企業應用程式設定
應用程式二進位檔設定
啟動行為設定
類別載入和更新偵測設定
遠端分派器內容設定


檔名: urun_rapp_installoptions.html