Liberty Kernel
The kernel
這項特性提供的 IBM API 套件
這項特性提供的 SPI 套件
- com.ibm.websphere.crypto
- com.ibm.websphere.ras
- com.ibm.websphere.ras
- com.ibm.websphere.ras.annotation
- com.ibm.websphere.ras.annotation
- com.ibm.ws.ffdc
- com.ibm.ws.ffdc
- com.ibm.wsspi.config
- com.ibm.wsspi.kernel.filemonitor
- com.ibm.wsspi.kernel.service.location
- com.ibm.wsspi.kernel.service.utils
- com.ibm.wsspi.logging
- com.ibm.wsspi.logging
- com.ibm.wsspi.threading
- org.eclipse.equinox.log
- org.eclipse.osgi.framework.console
- org.eclipse.osgi.framework.eventmgr
- org.eclipse.osgi.framework.log
- org.eclipse.osgi.service.datalocation
- org.eclipse.osgi.service.debug
- org.eclipse.osgi.service.environment
- org.eclipse.osgi.service.localization
- org.eclipse.osgi.service.resolver
- org.eclipse.osgi.service.runnable
- org.eclipse.osgi.service.security
- org.eclipse.osgi.service.urlconversion
- org.eclipse.osgi.signedcontent
- org.eclipse.osgi.storagemanager
- org.eclipse.osgi.util
- org.osgi.service.cm
- org.osgi.service.component
- org.osgi.service.coordinator
- org.osgi.service.event
- org.osgi.service.log
- org.osgi.service.metatype
特性配置元素
您可以在 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
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- 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 主控台。