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)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 onError - IGNORE
- FAIL
- WARN
WARN 发生配置错误时要执行的操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
updateTrigger - mbean
- polled
- disabled
polled 配置更新方法或触发器。 - mbean
- 仅当接收到来自外部程序(例如集成开发环境或管理应用程序)所调用的 MBean 的提示时,服务器才将更新配置。
- polled
- 服务器将按照轮询时间间隔对所有配置文件进行扫描以检测更改,并使用该检测到的更改对运行时配置进行更新。
- disabled
- 禁用所有更新监视。在服务器处于运行状态时,将不会应用配置更改。
- executor
- 为 Liberty 内核缺省执行程序定义设置。请注意,始终有一个且正好一个缺省执行程序,仅供 Liberty 运行时使用且应用程序不可直接访问。需要配置并使用执行程序的应用程序应改用受管执行程序。
属性名称 数据类型 缺省值 描述 coreThreads 整形 -1 要与该执行程序相关联的稳定状态线程数或核心线程数。要与此执行程序关联的线程数将迅速增长到此数目。如果此值小于 0,那么将使用缺省值。根据系统上的硬件线程数计算此缺省值。 keepAlive 具有毫秒精度的时间段 60s 在允许空闲线程终止之前,要在线程池中保留该线程的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 maxThreads 整形 -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 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,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 布尔型 true 如果为 true,那么会将 System.out 写入到系统输出流,并将 System.err 写入到系统错误流。如果为 false,那么 System.out 和 System.err 将写入到已配置的日志(例如 messages.log 或 trace.log),但不会写入到系统流。缺省值为 true。 hideMessage string 配置为在 console.log and message.log 文件中隐藏的消息的逗号分隔列表。如果这些消息配置为隐藏,那么它们会重定向至 trace.log 文件。 logDirectory 目录路径 ${server.output.dir}/logs 日志文件的目录的位置。缺省值为 ${server.output.dir}/logs。 maxFileSize int 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 maxFiles int 最小值:0
2 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。 messageFileName string messages.log 会将消息输出写入其中的文件的名称(相对于配置的日志目录)。缺省值为 messages.log。 suppressSensitiveTrace 布尔型 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 布尔型 false 允许将 USS 启动的服务器消息路由至 MVS 控制台。