第 20 章 KIE 服务器系统属性


KIE 服务器接受以下系统属性(bootstrap 交换机)来配置服务器的行为:

Expand
表 20.1. 禁用 KIE 服务器扩展的系统属性
属性默认描述

org.drools.server.ext.disabled

true,false

false

如果设为 true,则禁用商业规则管理(BRM)支持(例如,规则支持)。

org.jbpm.server.ext.disabled

true,false

false

如果设置为 true,则禁用 Red Hat Process Automation Manager 支持(例如,进程支持)。

org.jbpm.ui.server.ext.disabled

true,false

false

如果设置为 true,则禁用 Red Hat Process Automation Manager UI 扩展。

org.jbpm.case.server.ext.disabled

true,false

false

如果设置为 true,则禁用 Red Hat Process Automation Manager 问题单管理扩展。

org.optaplanner.server.ext.disabled

true,false

false

如果设置为 true,则禁用红帽构建的 OptaPlanner 支持。

org.kie.prometheus.server.ext.disabled

true,false

true

如果设置为 true,则禁用 Prometheus 服务器扩展。

org.kie.scenariosimulation.server.ext.disabled

true,false

true

如果设置为 true,则禁用测试场景服务器扩展。

org.kie.dmn.server.ext.disabled

true,false

false

如果设置为 true,则禁用 KIE Server DMN 支持。

org.kie.swagger.server.ext.disabled

true,false

false

如果设置为 true,则禁用 KIE 服务器 swagger 文档支持

注意

下表列出了的一些进程自动化管理器控制器属性已标记为必需。在 Business Central 中创建或删除 KIE 服务器容器时,设置这些属性。如果您在没有与 Business Central 交互的情况下单独使用 KIE 服务器,则不需要设置必要的属性。

Expand
表 20.2. 进程自动化管理器控制器所需的系统属性
属性默认描述

org.kie.server.id

字符串

N/A

要分配给服务器的任意 ID。如果在 Business Central 之外配置了无头进程自动化管理器控制器,则这是服务器连接到无头进程自动化管理器控制器来获取 KIE 容器配置的 ID。如果没有提供,则会自动生成 ID。

org.kie.server.user

字符串

kieserver

在托管模式下运行时,用于从 Process Automation Manager 控制器连接 KIE 服务器的用户名。在 Business Central 系统属性中设置此属性。在使用流程自动化管理器控制器时设置此属性。

org.kie.server.pwd

字符串

kieserver1!

用于从 Process Automation Manager 控制器与 KIE 服务器连接的密码,需要在受管模式下运行时。在 Business Central 系统属性中设置此属性。在使用流程自动化管理器控制器时设置此属性。

org.kie.server.token

字符串

N/A

属性,允许您在 Process Automation Manager 控制器和 KIE 服务器(而不是基本用户名和密码身份验证)之间使用基于令牌的身份验证。Process Automation Manager 控制器会在请求标头中发送令牌作为参数。服务器需要长期提供的访问令牌,因为令牌没有刷新。

org.kie.server.location

URL

N/A

Process Automation Manager 控制器用来调用这个服务器的 KIE 服务器实例的 URL,例如 http://localhost:8230/kie-server/services/rest/server。在使用进程自动化管理器控制器时,需要设置此属性。

org.kie.server.controller

逗号分隔列表

N/A

进程自动化管理器控制器 REST 端点的以逗号分隔的 URL 列表,例如 http://localhost:8080/business-central/rest/controller。在使用进程自动化管理器控制器时,需要设置此属性。

org.kie.server.controller.user

字符串

kieserver

用于连接 Process Automation Manager 控制器 REST API 的用户名。在使用进程自动化管理器控制器时,需要设置此属性。

org.kie.server.controller.pwd

字符串

kieserver1!

连接到 Process Automation Manager 控制器 REST API 的密码。在使用进程自动化管理器控制器时,需要设置此属性。

org.kie.server.controller.token

字符串

N/A

属性允许您在 KIE 服务器和流程自动化管理器控制器之间使用基于令牌的身份验证,而不是基本用户名和密码身份验证。服务器在请求标头中将令牌作为参数发送。服务器需要长期提供的访问令牌,因为令牌没有刷新。

org.kie.server.controller.connect

Long

10000

在服务器启动时,重复尝试将 KIE 服务器连接到 Process Automation Manager 控制器之间的等待时间(毫秒)。

Expand
表 20.3. 持久性系统属性
属性默认描述

org.kie.server.persistence.ds

字符串

N/A

数据源 JNDI 名称。在启用 BPM 支持时设置此属性。

org.kie.server.persistence.tm

字符串

N/A

Hibernate 属性的事务管理器平台。在启用 BPM 支持时设置此属性。

org.kie.server.persistence.dialect

字符串

N/A

使用 Hibernate 电源。在启用 BPM 支持时设置此属性。

org.kie.server.persistence.schema

字符串

N/A

要使用的数据库架构。

Expand
表 20.4. executor 系统属性
属性默认描述

org.kie.executor.interval

整数

0

Red Hat Process Automation Manager executor 完成了一个作业的时间,它在 org.kie.executor.timeunit 属性中指定的一个时间窗内启动一个新作业。

org.kie.executor.timeunit

java.util.concurrent.TimeUnit constant

指定 org.kie.executor.interval 属性的时间范围。

org.kie.executor.pool.size

整数

1

Red Hat Process Automation Manager 执行程序使用的线程数量。

org.kie.executor.retry.count

整数

3

在失败的作业上重试 Red Hat Process Automation Manager 执行程序尝试的数量。

org.kie.executor.jms.queue

字符串

队列/KIE.SERVER.EXECUTOR

KIE 服务器的作业执行器 JMS 队列.

org.kie.executor.jms.jobHeader

true,false

false

如果设置为 true,则 JMS 标头中的请求标识符包含为 jobId 属性。

org.kie.executor.disabled

true,false

false

如果设置为 true,则禁用 KIE 服务器执行器。

Expand
表 20.5. 人工任务系统属性
属性默认描述

org.jbpm.ht.callback

mvel

ldap

db

jaas

props

custom

jaas

指定要使用的用户组回调实现的属性:

  • MV EL : Default;主要用于测试。
  • LDAP : LDAP; 需要 jbpm.usergroup.callback.properties 文件中的其他配置。
  • db: Database;需要 jbpm.usergroup.callback.properties 文件中的其他配置。
  • JAAS:Jackstack;委派至容器,以获取有关用户数据的信息。
  • props :简单属性文件; 需要额外文件来保留所有信息(用户和组)。
  • Custom :自定义实施;指定 org.jbpm.ht.custom.callback 属性中类的完全限定名称。

org.jbpm.ht.custom.callback

完全限定名称

N/A

如果 org.jbpm.ht.callback 属性设置为 custom,则 UserGroupCallback 接口的自定义实现。

org.jbpm.task.cleanup.enabled

true,false

true

启用任务清理作业监听程序,在进程实例完成后删除任务。

org.jbpm.task.bam.enabled

true,false

true

启用任务 BAM 模块来存储任务相关信息。

org.jbpm.ht.admin.user

字符串

Administrator

可以访问 KIE 服务器中的所有任务的用户。

org.jbpm.ht.admin.group

字符串

管理员

用户必须属于的组才能查看 KIE 服务器中的所有任务。

Expand
表 20.6. 加载密钥存储的系统属性
属性默认描述

kie.keystore.keyStoreURL

URL

N/A

URL 用于加载 Java Cryptography Extension KeyStore(JCEKS)。例如,file:///home/kie/keystores/keystore.jceks.

kie.keystore.keyStorePwd

字符串

N/A

密码用于 JCEKS。

kie.keystore.key.server.alias

字符串

N/A

存储密码的 REST 服务的密钥名称。

kie.keystore.key.server.pwd

字符串

N/A

REST 服务别名的密码。

kie.keystore.key.ctrl.alias

字符串

N/A

默认 REST 进程自动化管理器控制器的密钥别名。

kie.keystore.key.ctrl.pwd

字符串

N/A

默认 REST 进程自动化管理器控制器的别名密码。

Expand
表 20.7. 重试提交事务的系统属性
属性默认描述

org.kie.optlock.retries

整数

5

此属性描述了进程引擎永久重试事务的次数。

org.kie.optlock.delay

整数

50

第一次重试前的延迟时间(以毫秒为单位)。

org.kie.optlock.delayFactor

整数

4

每次后续重试增加延迟时间的倍数。使用默认值时,进程引擎在第一个重试前等待 50 毫秒,在第二个重试前等待 200 毫秒,即第三个重试前 800 毫秒,以此类推。

Expand
表 20.8. 其他系统属性
属性默认描述

kie.maven.settings.custom

路径

N/A

Maven 配置的自定义 settings.xml 文件的位置。

kie.server.jms.queues.response

字符串

队列/KIE.SERVER.RESPONSE

JMS 的响应队列 JNDI 名称。

org.drools.server.filter.classes

true,false

false

当设置为 true 时,CRI KIE 服务器扩展接受由 XmlRootElementRemotable 注解标注的自定义类。

org.kie.server.bypass.auth.user

true,false

false

通过这个属性,您可以绕过经过身份验证的用户以获取与任务相关的操作,如查询。

org.jbpm.rule.task.firelimit

整数

10000

此属性指定执行规则的最大数量,以避免规则在无限循环中运行,并使服务器完全无响应。

org.jbpm.ejb.timer.local.cache

true,false

true

此属性关闭 EJB 计时器本地缓存。

org.kie.server.domain

字符串

N/A

用于使用 JMS 验证用户身份的 JAAS LoginContext 域。

org.kie.server.repo

路径

.

存储 KIE 服务器状态文件的位置。

org.kie.server.sync.deploy

true,false

false

指定 KIE 服务器保存部署的属性,直到 Process Automation Manager 控制器提供容器部署配置为止。此属性仅影响在受管模式下运行的服务器。可用的选项如下:

* false :与进程自动化管理器控制器的连接是异步的。应用程序启动,连接到流程自动化管理器控制器,并成功部署容器。即使容器可用前,应用程序也会接受请求。* true :服务器应用程序的部署加入与主部署相关的流程自动化管理器控制器连接线程,并等待其完成。这个选项可能会导致在更多应用程序位于同一服务器上时潜在的死锁。在一个服务器实例中只使用一个应用。

org.kie.server.startup.strategy

ControllerBasedStartupStrategy,LocalContainersStartupStrategy

ControllerBasedStartupStrategy

KIE 服务器的启动策略,用于控制部署的 KIE 容器以及部署它们的顺序。

org.kie.server.mgmt.api.disabled

true,false

false

当设置为 true 时,禁用 KIE 服务器管理 API。

org.kie.server.xstream.enabled.packages

Java 软件包,如 org.kie.example。您还可以指定通配符表达式,如 org.kie.example.*

N/A

一个属性,用于指定允许使用 XStream 进行总结的附加软件包。

org.kie.store.services.class

字符串

org.drools.persistence.jpa.KnowledgeStoreServiceImpl

实施 KieStoreServices 的类的完全限定名称,负责引导 KieSession 实例。

org.kie.server.strict.id.format

true,false

false

使用 JSON 总结时,如果属性设置为 true,它始终会以正确的 JSON 格式返回响应。例如,如果原始响应仅包含一个数字,则响应将以 JSON 格式嵌套。例如,{"value" : 1}

org.kie.server.json.customObjectDeserializerCNFEBehavior

忽略、 警告但除外

IGNORE

虽然使用 JSON unmarshalling 时,如果没有找到有效负载中的类,但可使用此属性来更改此行为,如下所示:

  • 如果属性设置为 IGNORE,则有效负载将转换为 HashMap
  • 如果属性设置为 WARN,则有效负载将转换为 HashMap 并记录警告
  • 如果属性设为 EXCEPTION,则 KIE 服务器会抛出异常

org.kie.server.strict.jaxb.format

true,false

false

当此属性的值设置为 true 时,KIE 服务器在 REST API 有效负载中验证数据类型。例如,如果数据字段具有数字数据类型并包含数字以外的内容,您将收到错误。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat