企業應用程式設定

請利用這個頁面來配置企業應用程式。

如果要檢視這個管理主控台頁面,請按一下應用程式 > 企業應用程式 > application_name

相關概念
crun_classload.html
crun_entapp.html
crun_app_moduleversion.html

相關作業
trun_appl.html

相關參照
udat_nestjcaconfac.html
uejb_rimod.html
ucws_rlibref.html
uprs_rsession_manager.html
urun_rtargetmap.html
ucws_rvars.html
rcfg_objectnames.html

名稱

指定應用程式的邏輯名稱。應用程式名稱在 Cell 內必須是唯一的,且不能含有不可使用的字元。

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

不接受的字元
/   正斜線 $    錢幣符號 '    單引號
\   反斜線 =    等號 "   雙引號
*  星號 %  百分比符號 |     垂直線
,   逗點 +    加號 <   左角括弧
:   冒號 @  位址符號    右角括弧
;   分號 #    # 字號 &  '&' 符號 (and 符號)
?  問號 ]]> 沒有適用於這個字元組合的特定名稱
資料類型 字串

應用程式二進位檔

可指定應用程式 EAR 檔所要安裝的目錄。 這個應用程式二進位檔設定與應用程式安裝和更新精靈上的用來安裝應用程式的目錄欄位相同。

預設值是 APP_INSTALL_ROOT/cell_name 值, 其中 APP_INSTALL_ROOT 變數是 install_root/installedApps; 例如,C:\WebSphere\AppServer\profiles\profile_name\installedApps\cell_name

您可以指定一個絕對路徑或使用路徑對映變數,如:${MY_APPS}。 您可以在任何安裝架構使用路徑對映變數,(雖然當您將應用程式安裝在叢集,而叢集成員位於異質節點上時,尤其需要這麼做),因為,在這種情況下,可能無法指定絕對路徑。 代表現行 Cell 名稱的 WebSphere Application Server 變數 ${CELL} 也可以用在路徑對映變數中;例如:${MY_APP}/${CELL}

您可以在管理主控台的「WebSphere 變數」頁面中, 按一下環境 > WebSphere 變數來定義 WebSphere Application Server 變數。

資料類型 字串
單位 完整路徑名稱

使用二進位檔中的 Meta 資料

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

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

資料類型 Boolean
預設值 false

啟用分送

指定 WebSphere Application Server 要在安裝目的地展開或刪除應用程式二進位檔。預設值是啟用應用程式分散作業。專供安裝的應用程式所用的應用程式二進位檔,會展開到指定目錄下。 當您解除安裝和儲存您對配置所做的變更時,也會刪除二進位檔。如果停用這個選項,則必須確定在所有應用程式要執行之節點的目的目錄中,應用程式二進位檔都必須適當的展開。

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

這個啟用分送設定與應用程式安裝和更新精靈的分送應用程式欄位相同。

資料類型 Boolean
預設值 true

驗證

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

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

如果伺服器屬於某個叢集,資源可以定義在伺服器、它的節點、Cell 或叢集中。選取關閉表示沒有資源驗證, 警告表示與不正確的資源參照相關的警告訊息,失敗則會在發生不正確資源參照時,停止失敗的作業。

這個驗證設定與應用程式安裝和更新精靈中的驗證輸入關閉/警告/失敗欄位。

資料類型 字串
預設值 警告

類別載入器模式

指定類別載入器要先在母類別載入器中搜尋,或先在應用程式類別載入器中搜尋,來載入類別。開發套件類別載入器和 WebSphere Application Server 類別載入器的標準是 Parent First。 當指定 Parent Last 時,您的應用程式可以置換母類別載入器中所包含的類別,但如果您混合使用已置換的類別及非置換的類別,這個動作可能會造成 ClassCastException 或 LinkageErrors。

選項有 Parent FirstParent Last。 預設值是在應用程式類別載入器中搜尋前,先在母類別載入器中搜尋來載入類別。

若要讓您的應用程式使用 WebSphere Application Server 中的 Jakarta Commons Logging 的預設配置, 請將此應用程式類別載入器模式設為 Parent First。若要讓您的應用程式置換 WebSphere Application Server 中的 Jakarta Commons Logging 之預設配置, 您的應用程式必須提供採用受 Jakarta Commons Logging 支援之格式的配置, 並且此類別載入器模式必須設為 Parent Last。此外,若要置換預設配置, 請對您應用程式中的每一個 Web 模組設定類別載入器模式,以便載入正確的日誌程式 Factory。

資料類型 字串
預設值 Parent First

WAR 類別載入器原則

指定要使用單一類別載入器來載入這個應用程式的所有 WAR 檔,或每個 WAR 檔都使用不同的類別載入器。

選項有 ApplicationModule。預設值是利用個別類別載入器來載入每個 WAR 檔。

資料類型 字串
預設值 模組

啟用重新載入類別功能

指定在更新應用程式檔案時,是否要啟用類別重新載入。

如果是 EJB 模組或任何非 Web 模組, 選取啟用重新載入類別功能會將應用程式的 deployment.xml 檔中的 reloadEnabled 設定為 true。如果應用程式的類別定義變更, 則應用程式伺服器執行時期會停止再啟動應用程式來重新載入應用程式類別。

如果是諸如 Servlet 和 JavaServer Page (JSP) 檔案的 Web 模組,Web 儲存器只會在 ibm-web-ext.xmi 檔中的 IBM 延伸 reloadingEnabled 設定為 true 時才會重新載入 Web 模組。當您在組合工具中編輯 Web 模組的 Extended Deployment 描述子時, 可以將 reloadingEnabled 設定為 true

如果要啟用重新載入 Web 模組, 同時也希望啟用重新載入 EJB 和非 Web 模組,請執行下列動作:

  1. ibm-web-ext.xmi 檔中的 IBM 延伸 reloadingEnabled 設定為 true
  2. 選取這個啟用重新載入類別功能內容。
  3. 重新載入間隔內容設定為一個大於零的值(例如,1 到 2147483647)。

如果只要啟用重新載入 Web 模組, 而不啟用重新載入 EJB 和非 Web 模組,請執行下列動作:

  1. ibm-web-ext.xmi 檔中的 IBM 延伸 reloadingEnabled 設定為 true
  2. ibm-web-ext.xmi 檔中的 IBM 延伸重新載入間隔屬性設定為一個大於零的值(例如,1 到 2147483647)。
  3. 不要選取這個啟用重新載入類別功能內容。

如果要停用重新載入 Web 模組, 請將 ibm-web-ext.xmi 檔中的 IBM 延伸 reloadingEnabled 設定為 false。或者, 如果 Web 模組將 ibm-web-ext.xmi 檔中的 IBM 延伸 reloadingEnabled 設定為 true, 則利用管理主控台來停用重新載入的步驟如下:

  1. 選取這個啟用重新載入類別功能內容。
  2. 重新載入間隔內容設定為零 (0)。
資料類型 Boolean
預設值 false

重新載入間隔

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

這個重新載入間隔設定與應用程式安裝和更新精靈的重新載入間隔(秒)欄位相同。

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

這裡所指定的重新載入間隔,會置換 IBM 延伸規格中,為 EAR 檔中每一個非 Web 模組所指定的值 (它會輸流置換 IBM 延伸規格中,為 EAR 檔中的應用程式所指定的重新載入間隔)。只有在啟用類別重新載入功能時,重新載入間隔屬性才有效。

其範圍是零至 2147483647。

資料類型 整數
單位
預設值 3

啟動加權

指定在伺服器啟動時的應用程式啟動次序。 有最低啟動加權的應用程式會最先啟動。

資料類型 整數
預設值 1
範圍 0 至 2147483647

背景應用程式

指定應用程式是否必須在伺服器啟動前完全起始設定。

預設值 false 表示要等到應用程式啟動後, 伺服器啟動才會完成。

設定 true 會通知 WebSphere Application Server 應用程式可能會在背景執行緒上啟動, 因此伺服器啟動可能會繼續,不會等待應用程式啟動。因此, 當應用程式伺服器啟動時,應用程式可能尚未準備好供使用。

只有當應用程式是在第 6 版應用程式伺服器中執行時,才適用這項設定。

資料類型 Boolean
預設值 false

建立資源的 MBean

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

資料類型 Boolean
預設值 true

服務原則標籤

服務原則上可以看到下列屬性:

HTTP 工作類別 展開以檢視或管理 HTTP 要求的工作類別。
SOAP 工作類別 展開以檢視或管理 SOAP 要求的工作類別。
您可以在此標籤中執行下列動作:
  • 按一下檢視服務原則拓蹼, 以查看在樹狀結構階層中的服務原則和工作類別。
  • 管理工作類別,方法為針對給定的要求類型選取它們,並按一下新建刪除, 或是展開現有的工作類別,然後按一下編輯 HTTP 型樣, 在工作類別成員清單中新增或移除 URI。
  • 管理規則條件:
    • 若要建置新規則,請按一下新增規則。在新增規則之後, 您可以在規則詳細資料畫面中編輯它。
    • 若要移除現有的規則,請按一下刪除規則
    • 若要使用現有的規則,請在如果欄位中輸入它, 然後將它分類至適當的交易類別。
    • 若要設定工作類別的多個規則之優先順序, 請按一下上移下移。規則的次序是判斷相符項目的關鍵。如果第一個規則就找到相符項目,就不會繼續進行後續的規則。
    • 針對沒有規則的工作類別, 請從清單中指派 URI 給交易類別。
  • 請按一下套用確定來確定新的規則設定。

遞送原則標籤

遞送原則上可以看到下列屬性:

HTTP 工作類別 展開以檢視或管理 HTTP 要求的工作類別。
SOAP 工作類別 展開以檢視或管理 SOAP 要求的工作類別。
您可以在此標籤中執行下列動作:
  • 按一下檢視遞送原則拓蹼, 以查看在樹狀結構階層中的遞送原則和工作類別。
  • 管理工作類別,方法為針對給定的要求類型選取它們,並按一下新建刪除, 或是展開現有的工作類別,然後按一下編輯 HTTP 型樣,在工作類別成員清單中新增或移除 URI。
  • 管理規則條件:
    • 若要建置新規則,請按一下新增規則。在新增規則之後, 您可以在規則詳細資料畫面中編輯它。
    • 若要移除現有的規則,請按一下刪除規則
    • 若要設定工作類別的多個規則之優先順序, 請按一下上移下移。規則的次序是判斷相符項目的關鍵。如果第一個規則就找到相符項目,就不會繼續進行後續的規則。
    • 在編輯每一個新規則之後,請針對該規則按一下套用
    • 針對沒有規則的工作類別, 請指派此類別給下列其中一個交易類別:
      • 允許遞送至:在這裡選取版本名稱清單中, 選取版本名稱。
      • 拒絕遞送,帶有回覆碼:在這裡選取版本名稱清單中,選取版本名稱, 並在輸入回覆碼欄位中, 輸入回覆碼。
      • 將遞送重新導向至:從在這裡選取版本名稱清單中,選取版本名稱, 並在輸入要重新導向到的 URI 欄位中, 輸入 URI。
      • 允許用戶端親緣性遞送至:在這裡選取版本名稱清單中, 選取版本名稱。
  • 請按一下套用確定來確定新的規則設定。