第 21 章 KIE 服务器系统属性


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

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

org.drools.server.ext.disabled

truefalse

false

如果设置为 true,请禁用业务逻辑管理(BRM)支持(例如,规则支持)。

org.jbpm.server.ext.disabled

truefalse

false

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

org.jbpm.ui.server.ext.disabled

truefalse

false

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

org.jbpm.case.server.ext.disabled

truefalse

false

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

org.optaplanner.server.ext.disabled

truefalse

false

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

org.kie.prometheus.server.ext.disabled

truefalse

true

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

org.kie.scenariosimulation.server.ext.disabled

truefalse

true

如果设置为 true,请禁用 Test 场景服务器扩展。

org.kie.dmn.server.ext.disabled

truefalse

false

如果设置为 true,请禁用 KIE 服务器 DMN 支持。

org.kie.swagger.server.ext.disabled

truefalse

false

如果设置为 true,请禁用 KIE Server swagger 文档支持

注意

下表中列出的一些 Process Automation Manager 控制器属性被标记为必需。在 Business Central 中创建或删除 KIE 服务器容器时,设置这些属性。如果您在没有与 Business Central 交互的情况下单独使用 KIE 服务器,则不需要设置所需的属性。

表 21.2. Process Automation Manager 控制器所需的系统属性
属性默认描述

org.kie.server.id

字符串

N/A

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

org.kie.server.user

字符串

kieserver

在以受管模式运行时,从 Process Automation Manager 控制器与 KIE 服务器连接的用户名需要。在 Business Central 系统属性中设置此属性。在使用 Process Automation Manager 控制器时设置此属性。

org.kie.server.pwd

字符串

kieserver1!

在以受管模式运行时,从 Process Automation Manager 控制器连接到 KIE 服务器的密码。在 Business Central 系统属性中设置此属性。在使用 Process Automation Manager 控制器时设置此属性。

org.kie.server.token

字符串

不适用

一个属性,允许您在 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。使用 Process Automation Manager 控制器时需要设置此属性。

org.kie.server.controller

以逗号分隔的列表

N/A

Process Automation Manager 控制器 REST 端点的以逗号分隔的 URL 列表,例如 http://localhost:8080/business-central/rest/controller。使用 Process Automation Manager 控制器时需要设置此属性。

org.kie.server.controller.user

字符串

kieserver

连接到 Process Automation Manager 控制器 REST API 的用户名。使用 Process Automation Manager 控制器时需要设置此属性。

org.kie.server.controller.pwd

字符串

kieserver1!

连接到 Process Automation Manager 控制器 REST API 的密码。使用 Process Automation Manager 控制器时需要设置此属性。

org.kie.server.controller.token

字符串

不适用

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

org.kie.server.controller.connect

Long

10000

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

表 21.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 dialect。在启用 BPM 支持时设置此属性。

org.kie.server.persistence.schema

字符串

N/A

要使用的数据库架构。

表 21.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

SECONDS

指定 org.kie.executor.interval 属性的时间单元。

org.kie.executor.pool.size

整数

1

Red Hat Process Automation Manager executor 使用的线程数量。

org.kie.executor.retry.count

整数

3

在失败的作业中重试 Red Hat Process Automation Manager executor 尝试重试的次数。

org.kie.executor.jms.queue

字符串

queue/KIE.SERVER.EXECUTOR

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

org.kie.executor.disabled

truefalse

false

如果设置为 true,请禁用 KIE Server executor。

表 21.5. 人类任务系统属性
属性默认描述

org.jbpm.ht.callback

MVEL

ldap

db

JAAS

props

custom

JAAS

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

  • M VEL:默认;主要用于测试。
  • LDAP : LDAP;需要在 jbpm.usergroup.callback.properties 文件中进行额外的配置。
  • db: Database; 需要 jbpm.usergroup.callback.properties 文件中的其他配置。
  • JAAS :HHH;委派给容器以获取有关用户数据的信息。
  • props :一个简单的属性文件;需要额外的文件来保留所有信息(用户和组)。
  • 自定义 :自定义实现;在 org.jbpm.ht.custom.callback 属性中指定类的完全限定域名。

org.jbpm.ht.custom.callback

完全限定名称

N/A

在将 org.jbpm.ht.callback 属性设置为 custom 时,UserGroup 回调 接口的自定义实现。

org.jbpm.task.cleanup.enabled

truefalse

true

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

org.jbpm.task.bam.enabled

truefalse

true

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

org.jbpm.ht.admin.user

字符串

Administrator

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

org.jbpm.ht.admin.group

字符串

管理员

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

表 21.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 Process Automation Manager 控制器的密钥别名。

kie.keystore.key.ctrl.pwd

字符串

N/A

默认 REST Process Automation Manager 控制器的别名密码。

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

org.kie.optlock.retries

整数

5

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

org.kie.optlock.delay

整数

50

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

org.kie.optlock.delayFactor

整数

4

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

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

kie.maven.settings.custom

路径

N/A

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

kie.server.jms.queues.response

字符串

queue/KIE.SERVER.RESPONSE

JMS 的响应队列 JNDI 名称。

org.drools.server.filter.classes

truefalse

false

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

org.kie.server.bypass.auth.user

truefalse

false

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

org.jbpm.rule.task.firelimit

整数

10000

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

org.jbpm.ejb.timer.local.cache

truefalse

true

此属性关闭 EJB Timers 本地缓存。

org.kie.server.domain

字符串

N/A

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

org.kie.server.repo

路径

.

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

org.kie.server.sync.deploy

truefalse

false

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

ACTIVE false :与 Process Automation Manager 控制器的连接是异步的。应用程序启动,连接到 Process Automation Manager 控制器,并成功后部署容器。即使容器可用前,应用程序也接受请求。ACTIVE true :服务器应用程序的部署会加入 Process Automation Manager 控制器连接线程,并带有主部署并等待其完成。如果更多应用程序位于同一服务器上,这个选项可能会导致潜在的死锁。在一个服务器实例中使用一个应用程序。

org.kie.server.startup.strategy

ControllerBasedStartupStrategy,LocalContainersStartupStrategy

ControllerBasedStartupStrategy

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

org.kie.server.mgmt.api.disabled

truefalse

false

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

org.kie.server.xstream.enabled.packages

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

N/A

指定使用 XStream 进行 marshalling 的允许列表的额外软件包的属性。

org.kie.store.services.class

字符串

org.drools.persistence.jpa.KnowledgeStoreServiceImpl

实施 KieStoreServices 的类的完全限定名称,它们负责 bootstrap KieSession 实例。

org.kie.server.strict.id.format

truefalse

false

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

org.kie.server.strict.jaxb.format

truefalse

false

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

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.