第 15 章 KIE 服务器系统属性


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

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

org.drools.server.ext.disabled

true,false

false

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

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 文档支持

注意

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

Expand
表 15.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

字符串

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。使用 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

字符串

N/A

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

org.kie.server.controller.connect

Long

10000

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

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

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 控制器的别名密码。

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

org.kie.optlock.retries

整数

5

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

org.kie.optlock.delay

整数

50

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

org.kie.optlock.delayFactor

整数

4

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

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

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.domain

字符串

N/A

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

org.kie.server.repo

路径

.

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

org.kie.server.sync.deploy

true,false

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

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