應用程式二進位檔設定

請利用這個頁面來配置應用程式二進位檔的位置和配送。

如果要檢視這個管理主控台頁面,請按一下 應用程式 > 應用程式類型 > WebSphere 企業應用程式 > application_name > 應用程式二進位檔

附註: 如果在此頁面上修改任何值,則會重新整理配置儲存庫中與應用程式相關的所有 meta 資料檔。
注意: 如果應用程式在執行中,變更應用程式設定會導致應用程式重新啟動。 在獨立式伺服器上,會在儲存變更之後重新啟動應用程式。 在多重伺服器產品上,會在儲存變更之後重新啟動應用程式,在安裝應用程式的節點上,檔案會同步化。 如果要控制多重伺服器產品上的同步化時機,請在「主控台」喜好設定頁面上取消選取與節點同步變更

位置(完整路徑)

指定企業應用程式保存檔 (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_name/application_name.ear (如果您未針對起始安裝指定 ${APP_INSTALL_ROOT}/${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 Application Server 變數,您可以在管理主控台中按一下 環境 > WebSphere 變數 來存取這個頁面。

    [AIX Solaris HP-UX Linux Windows][IBM i]避免麻煩: 在分散式作業系統環境中,路徑對映變數的範圍是從 nodeagent-level 範圍開始,而不是從伺服器層次範圍開始。 如果在節點代理程式層次的範圍中找不到該變數, 則會在節點層次的範圍中尋找變數,最後才是在 Cell 層次的範圍中尋找。
資訊 價值
資料類型 字串
單位 完整路徑名稱

使用配置資訊(二進位檔)

指定應用程式伺服器要使用位於應用程式部署文件(deployment.xml 檔,預設值)的連結、延伸規格和部署描述子,或使用在 EAR 檔中的連結、延伸規格和部署描述子。

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

這個使用二進位檔中的配置資訊設定與應用程式安裝和更新精靈的使用二進位檔配置欄位相同。 請只針對安裝在 6.x 版或更新版本的部署目標上的應用程式,選取這個設定。

資訊 價值
資料類型 布林
預設值 false

啟用二進位程式模組配送、展開並清除後置解除安裝

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

在單一伺服器的安裝架構上,當您解除安裝應用程式及儲存配置變更時,會刪除二進位檔。
附註: 在安裝應用程式之後,不想要變更「啟用二進位配送、擴充及清理後置解除安裝」。 如果您需要變更這個屬性,請將應用程式解除安裝,再用新的屬性值來安裝它。

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

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

重要事項: 如果您停用此選項,且未將應用程式二進位檔複製並展開至節點,則稍後儲存配置或手動同步化不會將應用程式二進位檔移至節點。

這個在解除安裝之後啟用二進位檔的配送、展開和清理設定與應用程式安裝和更新精靈的配送應用程式欄位相同。

資訊 價值
資料類型 布林
預設值 true

檔案許可權

針對所安裝應用程式中展開到在指定目錄的應用程式二進位檔,指定其存取權。

您必須啟用在解除安裝之後啟用二進位檔的配送、展開和清理選項來指定檔案許可權。

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

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

表 1. 清單選項 的檔案許可權字串集。 選取選項清單,或在文字欄位中指定檔案許可權字串。
多重選項清單選項 所設的檔案許可權字串
容許讀取所有檔案,但不能寫入 .*=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:
表 2. 檔案許可權作業 的 URI 範例。 結果會顯示在下表中。
數字 範例 URI
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
最佳作法: 不論作業系統為何,一律使用正斜線 (/) 作為檔案型樣中的檔案路徑分隔字元。

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

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

這項設定與應用程式安裝和更新精靈的檔案許可權欄位相同。

資訊 價值
資料類型 字串

應用程式建置層次

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

資訊 價值
資料類型 字串