Liberty Kernel

The kernel

這項特性提供的 SPI 套件

特性配置元素

您可以在 server.xml 檔中使用下列元素,來配置「Liberty 核心」特性:

config
定義伺服器處理配置資訊的方式。
屬性名稱 資料類型 預設值 說明
monitorInterval 精準度是毫秒的時間量 500ms 伺服器檢查配置更新項目的頻率。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
onError
  • IGNORE
  • FAIL
  • WARN
WARN 引起配置錯誤之後要採取的動作。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
updateTrigger
  • mbean
  • polled
  • disabled
polled 配置更新方法或觸發程式。
mbean
只有在被外部程式(如整合開發環境或管理應用程式)所呼叫的 MBean 提示時,伺服器才會更新配置。
polled
伺服器會在輪詢間隔掃描所有配置檔的變更,並且利用偵測到的變更來更新執行時期配置。
disabled
停用所有更新監視。伺服器正在執行時,將不會套用配置變更。
executor
定義 Liberty 核心預設執行程式的設定。請注意,一律要有唯一一個執行程式,並且只供 Liberty 執行時期使用,無法供應用程式直接存取。需要配置和利用執行程式的應用程式應改用「受管理的執行程式」。
屬性名稱 資料類型 預設值 說明
coreThreads int -1 要與此執行程式相關聯的恆定或核心執行緒數目。與執行程式相關聯的執行緒數目將會快速成長至這個數目。如果這個值小於 0,則會使用預設值。這個預設值是根據系統上的硬體執行緒數目所計算出來的。
keepAlive 精準度是毫秒的時間量 60s 閒置的執行緒在容許終止之前,保存在儲存區中的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
maxThreads int -1 可以與執行程式相關聯的執行緒數目上限。如果大於 0,這個值必須大於或等於 coreThreads 的值。 如果 maxThreads 的值小於或等於 0,則沒有執行緒數目上限。請注意,執行程式相關聯的實際執行緒數目,由 Liberty 核心動態決定,因此如果維持執行緒數目無上限,並不意指執行時期會主動建立大量的執行緒;它只會讓 Liberty 核心決定執行程式會有多少個相關聯的執行緒,而不需定義一個上限。
name string Default Executor Liberty 核心預設執行程式的名稱。
rejectedWorkPolicy
  • CALLER_RUNS
  • ABORT
ABORT 當執行程式無法暫置要執行之工作時要採用的原則。
CALLER_RUNS
在呼叫端的執行緒立即執行工作。
ABORT
發出異常狀況。
stealPolicy
  • STRICT
  • NEVER
  • LOCAL
LOCAL 要採用的工作竊取原則。這個原則的選項會決定工作如何排入佇列,以及執行緒如何取得已排入佇列的工作。
STRICT
產生工作的所有執行緒都會擁有一個本端工作堆。 當本端工作堆耗盡時,與執行程式相關聯的執行緒會從其他執行緒取得工作。
NEVER
廣域工作佇列用來饋送工作給與執行程式相關聯的執行緒。不會發生竊取。
LOCAL
未與執行程式相關聯的執行緒所產生的工作,會使用廣域工作佇列。與執行程式相關聯的執行緒所產生的工作放在本端工作堆上。這個工作堆是由產生者執行緒所擁有,除非另一個執行緒竊取工作堆。如果本端工作堆是空的,而且廣域工作佇列中沒有工作,與執行程式相關聯的執行緒,會取得與其他執行緒相關聯的工作。
featureManager
定義伺服器載入特性的方式。
屬性名稱 資料類型 預設值 說明
onError
  • IGNORE
  • FAIL
  • WARN
WARN 載入特性失敗之後要採取的動作。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
featureManager > feature
說明:指定伺服器執行時要使用的特性。
必要:false
資料類型:string
fileset
指定起自基本目錄並符合一組型樣的一組檔案。
屬性名稱 資料類型 預設值 說明
caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。
dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。
excludes string   要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。
id string   唯一的配置 ID。
includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。
scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
include
指定要包含在伺服器配置中的配置資源。
屬性名稱 資料類型 預設值 說明
location 檔案、目錄或 URL。   指定資源位置。這可以是檔案路徑或遠端資源的 URI。
onConflict
  • IGNORE
  • REPLACE
  • MERGE
MERGE 指定在發現衝突時,用來合併元素的行為。
IGNORE
併入檔案中的衝突元素會被忽略。
REPLACE
當元素衝突時,來自併入檔案的元素會取代衝突的元素。
MERGE
衝突的元素會合併。
optional boolean   當找不到所包含的資源時,容許跳過它。
installUtility
提供指令工具來管理 Liberty 資產,例如特性、修正程式、範例等。
屬性名稱 資料類型 預設值 說明
someProperty string String value 範例內容的說明
logging
控制日誌和追蹤訊息的擷取及輸出。
屬性名稱 資料類型 預設值 說明
consoleLogLevel
  • ERROR
  • WARNING
  • AUDIT
  • OFF
  • INFO
AUDIT 此記載層次用來過濾寫入系統串流的訊息。預設值是審核。
ERROR
錯誤訊息將寫入系統錯誤串流。
WARNING
警告訊息將寫入系統輸出串流。錯誤訊息將寫入系統錯誤串流。
AUDIT
審核和警告訊息將寫入系統輸出串流。錯誤訊息將寫入系統錯誤串流。
OFF
沒有任何伺服器輸出會寫入系統串流。只有 JVM 輸出會寫入系統串流。
INFO
資訊、審核和警告訊息將寫入系統輸出串流。錯誤訊息將寫入系統錯誤串流。
copySystemStreams boolean true 若為 true,則會將 System.out 寫入到系統輸出串流,將 System.err 寫入到錯誤串流。若為 false,則 System.out 和 System.err 將寫入到所配置的日誌,例如 messages.log 或 trace.log,但不會寫入到系統串流。預設值為 true。
hideMessage string   配置要在 console.log 和 message.log 檔中隱藏的訊息清單(以逗點區隔)。如果將訊息配置成隱藏,會將它們重新導向至 trace.log 檔。
logDirectory 目錄的路徑 ${server.output.dir}/logs 日誌檔的目錄位置。預設值是 ${server.output.dir}/logs。
maxFileSize int

下限:0

20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。
maxFiles int

下限:0

2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
messageFileName string messages.log 訊息輸出將寫入其中的檔案名稱(相對於已配置的日誌目錄)。預設值是 messages.log。
suppressSensitiveTrace boolean false 當追蹤非類型化資料時,例如通過網路連線接收位元組,伺服器追蹤可以顯現機密資料。若是如此,請防止在日誌和追蹤檔中機密資訊的潛在顯現。預設值是 false。
traceFileName string trace.log 追蹤輸出將寫入其中的檔案名稱(相對於已配置的日誌目錄)。預設值是 trace.log。
traceFormat
  • ENHANCED
  • BASIC
  • ADVANCED
ENHANCED 這種格式用於追蹤日誌。
ENHANCED
使用加強的基本追蹤格式。
BASIC
使用基本追蹤格式。
ADVANCED
使用進階追蹤格式。
traceSpecification string *=info 符合追蹤規格文法且指定各種追蹤元件起始狀態的追蹤規格。空值可接受且視為「停用所有追蹤」。任何未指定的元件都會起始設定為預設狀態 *=info。
variable
藉由指定變數的名稱和值來宣告新變數。
屬性名稱 資料類型 預設值 說明
name string   變數的名稱。
value string   要指派給變數的值。
zosLogging
z/OS 上的記載功能配置內容。
屬性名稱 資料類型 預設值 說明
enableLogToMVS boolean false 啟用遞送 USS 啟動伺服器訊息至 MVS 主控台。

指示主題類型的圖示 參照主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_kernel
檔名:rwlp_feature_kernel.html