選取安裝選項設定

請指定是否要在安裝過程中，前置編譯 JavaServer Pages (JSP) 檔。 依預設不會前置編譯 JSP 檔。

在這個選項中，只需要安裝到 9.0 版部署目標。

如果您選取前置編譯 JavaServer Pages 檔，且嘗試將應用程式安裝在舊版的部署目標（如第 8 版），安裝會遭到拒絕。 您只能將應用程式部署到版本與產品相同的部署目標中。 如果應用程式的目標伺服器版本比產品還舊，您將無法部署到這些目標中。

指定將安裝企業保存檔 (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 變數。

  避免麻煩：在分散式作業系統環境中，路徑對映變數的範圍是從節點代理程式層次的範圍開始，而非從伺服器層次的範圍開始。如果在節點代理程式層次的範圍中找不到該變數， 則會在節點層次的範圍中尋找變數，最後才是在 Cell 層次的範圍中尋找。gotcha

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

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

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

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

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

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

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

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

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

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

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

如果 EJB 模組包裝在 Web 保存檔 (WAR) 中，您不需要啟用這個設定。

在安裝 EJB 1.x 或 2.x 模組期間，執行了 EJB 部署工具。 安裝 EJB 3.x 版模組期間，並不會執行 EJB 部署工具。

在這個選項中，只需要安裝到 9.0 版部署目標。

如果您選取部署 Enterprise Bean，且試圖將應用程式安裝在舊版的部署目標（如第 8 版）中，安裝會遭到拒絕。 您只能將應用程式部署到其 WebSphere 版本與產品相同的目標中。 如果應用程式的目標伺服器版本比產品還舊，您將無法部署到這些目標中。

另外，如果您在提供選項來執行 EJB 部署頁面中，選取部署 Enterprise Bean 並指定資料庫類型，所選資料庫類型會改寫先前針對所有 EJB 模組所定義的後端系統 ID。 如果要啟用個別 EJB 模組的後端系統 ID，請在提供選項來執行 EJB 部署頁面中，將資料庫類型設為 "" (null)。

啟用這項設定可能使安裝程式執行好幾分鐘。

指定應用程式的邏輯名稱。應用程式名稱在 Cell 內必須是唯一的，且不能含有不受支援的字元。

應用程式名稱的開頭不能為句點 (.)，前端或尾端不能含有空格，也不能含有下列任一字元：

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

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

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

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

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

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

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

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

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

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

支援的配置：對於 IBM 延伸和連結檔而言，.xmi 或 .xml 副檔名取決於您是使用 Java EE 5 之前的應用程式或模組，或 Java EE 5 或更新版本的應用程式或模組。 IBM 延伸或連結檔稱為 ibm-*-ext.xmi 或 ibm-*-bnd.xmi，其中 * 是延伸或連結檔的類型，例如：app、application、ejb-jar 或 web。 適用的條件如下：

• 如果應用程式或模組使用第 5 版之前的 Java EE，副檔名必須是 .xmi。
• 如果應用程式或模組使用 Java EE 5 或更新的版本，副檔名必須是 .xml。如果 .xmi 檔是隨附在應用程式或模組，則本產品會忽略 .xmi 檔。

不過，即使應用程式含有 Java EE 5 之前的檔案，且所用的副檔名是 .xmi，其中也可以有 Java EE 5 或更新版本的模組。

ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi 和 ibm-portlet-ext.xmi 檔會繼續使用 .xmi 副檔名。

sptcfg

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

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

在這個選項中，只需要安裝到 9.0 版部署目標。

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

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

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

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

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

指定是否應該處理內嵌配置。 內嵌配置由 resource.xml、variables.xml 和 deployment.xml 等之類的檔案組成。您可以收集產品特定的部署資訊，並將它儲存在應用程式 EAR 檔中。 之後，您可以利用應用程式管理介面，將這類 EAR 檔安裝到伺服器配置中。

這樣一個應用程式 EAR 檔是加強型 EAR 檔，會在您匯出已安裝的應用程式時建立。「內嵌配置」勾選框用來識別這類的加強型 EAR 檔。依預設，如果偵測到應用程式是一個加強型 EAR，會選取「處理內嵌配置」勾選框。不論您是否勾選「處理內嵌配置」勾選框，都會在應用程式安裝選項中預先移入內嵌配置中的資訊。在部署程序期間，使用者可以置換這些值。

如果匯出的 EAR 檔（加強型 EAR 檔）含有共用程式庫及其配置資訊，應用程式的安裝程序會因您是否選取「處理內嵌配置」勾選框而有不同。對於已定義共用程式庫配置的應用程式，如果選取這個勾選框，則安裝這個應用程式時，會一起安裝這些共用程式庫，並且會根據內嵌配置中的資訊，來配置這個應用程式。對於已定義共用程式庫配置的應用程式，如果沒有選取這個勾選框，則仍然會安裝這個 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 檔。

指定展開到指定目錄下的已安裝應用程式之應用程式二進位檔的存取權。

您必須啟用配送應用程式選項來指定檔案許可權。

您可以在文字欄位中指定檔案許可權。您也可以從多重選項清單中選取一些常用的檔案許可權，以設定它們。 清單選項會改寫您在文字欄位中所設的檔案許可權。

您可以設定清單中下列一或多個檔案許可權字串。如果您選取多個選項，則會合併檔案許可權字串。

您也可以不使用多重選項清單來指定檔案許可權，而改在文字欄位中指定檔案許可權字串。檔案許可權所用的字串格式如下：

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。

最佳做法：當您在檔案比對型樣方面使用正規表示式時，會拿整個字串 URI 和指定的檔案許可權型樣相比較。您必須按照 Java 程式設計 API 所定義的，使用正規表示式提供更精確的比對型樣。比方說，假設在檔案許可權作業期間會處理如下的目錄和檔案 URI：best-practices

檔案型樣比對結果為：

• 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

最佳做法：不論作業系統為何，請一律在檔案型樣中以正斜線 (/) 作為檔案路徑分隔字元。best-practices

在 Windows 作業系統上，您無法取消設定檔案的讀取權。 當使用 POSIX 樣式許可權位元時，表示檔案可讀取的位元是 4，可寫入是 2，可執行是 1。 因此，Windows 作業系統上的檔案許可權會是 5 或 7。 另外，POSIX 樣式有 user、group 和 world 許可權。 在 Windows 作業系統中，您只能對檔案設定 user 許可權。group 和 world 許可權位元會被忽略。

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

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

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

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

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

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

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

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

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

預設值是以 WebSphere:blaname=Anyasset,blaedition=BASE 設定值來建立新的商業層次應用程式。 當您從下拉清單中選擇建立新的商業層次應用程式時，產品會建立一個與企業應用程式同名的商業層次應用程式。如果已有一個商業層次應用程式使用您的企業應用程式名稱，產品就不會建立新商業層次應用程式；它會將您的企業應用程式當成組合單元，新增到該現有的商業層次應用程式中。

如果您需要利用「共用程式庫關係和對映設定」頁面，來指定在商業層次應用程式中之現有共用程式庫的相依關係，請從下拉清單中選取商業層次應用程式名稱。如果您選擇建立新的商業層次應用程式，且具備預設名稱的商業層次應用程式已存在，則這個頁面不會顯示任何共用程式庫。

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

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

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

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

指定產品是否指派不完整 EJB 參照目標的預設 JNDI 值，或自動解析這些目標。

請選取這個選項，以便在參照來自 EJB 2.1 或舊版模組時，或來自 Web 2.3 或舊版模組時，自動解析 EJB 參照目標。 如果您啟用這個選項，執行時期儲存器會提供一個預設值，或針對任何不含連結的 EJB 參照來自動解析 EJB 參照。

如果您已在「準備安裝應用程式」頁面上選取產生預設連結，就不需要選取這個選項。 產品會產生預設值。

如果您選取容許自動解析 EJB 參照目標，應用程式中的所有模組都必須共用同一個部署目標。 如果您選取這個選項，且所有應用程式模組並沒有共用同一部伺服器，當您在「摘要」頁面上按一下完成之後，產品會顯示一則警告訊息，且不會安裝應用程式。 您必須先取消選取這項設定，再按一下完成，才能安裝應用程式。

指定是否部署用戶端模組。

如果要部署的檔案有一或多個用戶端模組，且您想為用戶端模組配置環境項目，請選取這個選項（設為 true）。 另外，也請選取這個選項來配置 EJB 參照、資源參照、資源環境參照或訊息目的地參照之類的資源。 選取這個選項可讓您檢視「對映用戶端模組的環境項目」頁面。如果您將用戶端模組部署到部署管理程式的聯合節點（聯合），或部署到應用程式伺服器（已部署的伺服器），請選取這個選項，將用戶端部署模式設為部署管理程式適用的值，聯合或已部署的伺服器。

如果您選取這個選項，則只能將用戶端模組安裝到 8.0 版或更新版的部署目標。

指定要將用戶端模組部署到隔離的部署目標（隔離）、部署管理程式的聯合節點（聯合），或應用程式伺服器（已部署的伺服器）。

用戶端部署模式選項會影響 java: 查閱的處理方式。 所有 Java URL 名稱空間（廣域、應用程式、模組和元件）都在隔離的用戶端程序的本端中。 名稱空間所在的伺服器，是在「聯合」和「已部署的伺服器」用戶端程序中。 所選作為用戶端模組目標的伺服器或叢集，決定了這些名稱空間的建立位置。 所有對象是「聯合」或「已部署的伺服器」用戶端模組的 java: 查閱，都會導向目標伺服器或叢集。 用戶端模組實際上不會在目標伺服器或叢集中執行。 多個相同用戶端模組的實例，全部都會共用聯合和已部署的伺服器模組中的元件名稱空間。 選擇聯合模式只是宣告利用「Java 網路啟動通訊協定 (JNLP)」來啟動用戶端模組的意圖，但對於「聯合」和「已部署的伺服器」這兩個模式而言，「Java 命名和目錄介面 (JNDI)」機制是相同的。

指定是否對照已發佈的 Java EE 部署描述子綱目來驗證部署描述子。 當選取這個選項時，產品會分析每個部署描述子來判斷部署描述子的 Java EE 規格版本，選取適當的綱目，然後對照 Java EE 部署描述子綱目來檢查部署描述子。 驗證錯誤會產生錯誤訊息。

Java EE 部署描述子綱目也稱為 DTD。

如果您選取這個選項，您只能將應用程式或模組安裝在 8.0 版或更新版的部署目標。