第15章 KIE Server のシステムプロパティー


KIE Server では、以下のシステムプロパティー (ブートストラップスイッチ) を使用してサーバーの動作を設定できます。

表15.1 KIE Server の拡張機能を無効にするシステムプロパティー
プロパティーデフォルト説明

org.drools.server.ext.disabled

truefalse

false

true に設定した場合は、(ルールのサポートなど) Business Rule Management (BRM) のサポートが無効になります。

org.optaplanner.server.ext.disabled

truefalse

false

true に設定した場合は、Red Hat build of OptaPlanner のサポートが無効になります。

org.kie.prometheus.server.ext.disabled

truefalse

true

true に設定した場合は、Prometheus Server 拡張が無効になります。

org.kie.scenariosimulation.server.ext.disabled

truefalse

true

true に設定した場合は、テストシナリオサーバー拡張が無効になります。

org.kie.dmn.server.ext.disabled

truefalse

false

true に設定した場合は、KIE Server DMN サポートが無効になります。

org.kie.swagger.server.ext.disabled

truefalse

false

true に設定した場合は、KIE Server swagger のドキュメントサポートが無効になります。

注記

以下の表に記載した Process Automation Manager コントローラーのプロパティーの中で、必須と印がついているものがあります。Business Central で KIE Server コンテナーを作成または削除する場合は、このプロパティーを設定してください。Business Central との対話なしに KIE Server を別個で使用する場合は、必須のプロパティーを設定する必要はありません。

表15.2 Process Automation Manager コントローラーに必要なシステムプロパティー
プロパティーデフォルト説明

org.kie.server.id

String

該当なし

サーバーに割り当てる任意の ID。ヘッドレス Process Automation Manager コントローラーが Business Central 外に設定されている場合は、この ID を使用して、サーバーはヘッドレス Process Automation Manager コントローラーと接続し、KIE コンテナー設定をフェッチします。指定されていない場合、ID は自動で生成されます。

org.kie.server.user

String

kieserver

管理モードで実行する場合に必要な、Process Automation Manager コントローラーから KIE Server への接続に使用するユーザー名。このプロパティーは、Business Central のシステムプロパティーで設定します。Process Automation Manager コントローラーを使用する場合は、このプロパティーを設定します。

org.kie.server.pwd

String

kieserver1!

管理モードで実行する場合に必要な、Process Automation Manager コントローラーから KIE Server への接続に使用するパスワード。このプロパティーは、Business Central のシステムプロパティーで設定します。Process Automation Manager コントローラーを使用する場合は、このプロパティーを設定します。

org.kie.server.token

String

該当なし

このプロパティーにより、Process Automation Manager コントローラーと KIE Server 間の認証に、ユーザー名/パスワードを使用する Basic 認証ではなく、トークンベースの認証を使用できます。Process Automation Manager コントローラーは、要求ヘッダーのパラメーターとしてトークンを送信します。トークンは更新されないため、サーバーには有効期限の長いアクセストークンが必要です。

org.kie.server.location

URL

該当なし

Process Automation Manager コントローラーがこのサーバーでコールバックするのに使用する KIE Server インスタンスの URL (例: http://localhost:8230/kie-server/services/rest/server)。Process Automation Manager コントローラーを使用する場合は、このプロパティーの設定が必須です。

org.kie.server.controller

コンマ区切りのリスト

該当なし

Process Automation Manager コントローラー REST エンドポイントへの URL のコンマ区切りリスト (例: http://localhost:8080/business-central/rest/controller)。Process Automation Manager コントローラーを使用する場合は、このプロパティーの設定が必須です。

org.kie.server.controller.user

String

kieserver

Process Automation Manager コントローラー REST API に接続するユーザー名。Process Automation Manager コントローラーを使用する場合は、このプロパティーの設定が必須です。

org.kie.server.controller.pwd

String

kieserver1!

Process Automation Manager コントローラー REST API に接続するためのパスワード。Process Automation Manager コントローラーを使用する場合は、このプロパティーの設定が必須です。

org.kie.server.controller.token

String

該当なし

このプロパティーにより、Process Automation Manager コントローラーと KIE Server との間の認証に、ユーザー名/パスワードを使用する Basic 認証ではなく、トークンベースの認証を使用できます。このサーバーは、要求ヘッダーのパラメーターとしてトークンを送信します。トークンは更新されないため、サーバーには有効期限の長いアクセストークンが必要です。

org.kie.server.controller.connect

Long

10000

サーバーの起動時に KIE Server を Process Automation Manager コントローラーに接続することを試み、次に試行するまでの待機時間 (ミリ秒)。

表15.3 キーストアを読み込むためのシステムプロパティー
プロパティーデフォルト説明

kie.keystore.keyStoreURL

URL

該当なし

Java Cryptography Extension KeyStore (JCEKS) の読み込みに使用する URL。例: file:///home/kie/keystores/keystore.jceks

kie.keystore.keyStorePwd

String

該当なし

JCEKS に使用するパスワード

kie.keystore.key.server.alias

String

該当なし

パスワードの保存先となる REST サービスのキーのエイリアス名

kie.keystore.key.server.pwd

String

該当なし

REST サービスのエイリアスのパスワード

kie.keystore.key.ctrl.alias

String

該当なし

デフォルトの REST Process Automation Manager コントローラー用のキーのエイリアス。

kie.keystore.key.ctrl.pwd

String

該当なし

デフォルトの REST Process Automation Manager コントローラー用のエイリアスのパスワード。

表15.4 トランザクションのコミットを再試行するシステムプロパティー
プロパティーデフォルト説明

org.kie.optlock.retries

Integer

5

このプロパティーでは、完全に失敗となる前に、プロセスエンジンがトランザクションを再試行する回数を記述します。

org.kie.optlock.delay

Integer

50

最初の再試行までの時間 (ミリ秒単位)。

org.kie.optlock.delayFactor

Integer

4

後続の再試行ごとに遅延時間を長くする乗数。デフォルト値の場合には、プロセスエンジンは、1 回目の再試行まで 50 ミリ秒、2 番目の再試行まで 200 ミリ秒、3 番目の再試行まで 800 ミリ秒待機します。

表15.5 その他のシステムプロパティー
プロパティーデフォルト説明

kie.maven.settings.custom

パス

該当なし

Maven 設定のカスタム settings.xml ファイルの場所。

kie.server.jms.queues.response

String

queue/KIE.SERVER.RESPONSE

JMS に対する応答キューの JNDI 名。

org.drools.server.filter.classes

truefalse

false

true に設定した場合に、Drools KIE Server の拡張機能が受け入れるのは XmlRootElement または Remotable のアノテーションが付いたカスタムクラスのみです。

org.kie.server.domain

String

該当なし

JMS を使用する場合にユーザーの認証に使う JAAS LoginContext ドメイン。

org.kie.server.repo

パス

.

KIE Server の状態ファイルが保存される場所

org.kie.server.sync.deploy

truefalse

false

KIE Server に対して、Process Automation Manager コントローラーがコンテナーのデプロイメント設定を提供するまでデプロイメントを保持するように指示します。このプロパティーは、管理モードで実行するサーバーのみが対象です。以下のオプションが利用できます。

* false: Process Automation Manager コントローラーへの接続は非同期です。アプリケーションが起動して、Process Automation Manager コントローラーに接続し、成功すると、コンテナーをデプロイします。アプリケーションはコンテナーが利用可能になる前でもリクエストを受け付けます。* true: サーバーアプリケーションのデプロイメントは、Process Automation Manager コントローラーの接続スレッドと、メインのデプロイメントを結合し、完了するまで待機します。このオプションを使用すると、複数のアプリケーションが同じサーバー上にある場合に、デッドロックになる可能性があります。1 台のサーバーで使用するアプリケーションは 1 つだけにしてください。

org.kie.server.startup.strategy

ControllerBasedStartupStrategyLocalContainersStartupStrategy

ControllerBasedStartupStrategy

デプロイした KIE コンテナーの制御に使用する KIE Server の起動ストラテジー、およびデプロイする順番

org.kie.server.mgmt.api.disabled

truefalse

false

true に設定した場合は、KIE Server 管理 API が無効になります。

org.kie.server.xstream.enabled.packages

org.kie.example などの Java パッケージ。org.kie.example.* のようにワイルドカード表現を指定することも可能です。

該当なし

XStream を使用してマーシャリングするための許可リストに追加パッケージを指定するプロパティー

org.kie.store.services.class

String

org.drools.persistence.jpa.KnowledgeStoreServiceImpl

KieSession インスタンスのブートストラップを行う KieStoreServices を実装する完全修飾クラス名

org.kie.server.strict.id.format

truefalse

false

JSON のマーシャリングを使用する際に、プロパティーが true に設定されている場合は、適切な JSON 形式で応答を常に返します。たとえば、元の応答に含まれる数値が 1 つだけの場合、応答は JSON 形式でラップされます。たとえば、{"value" : 1} です。

org.kie.server.json.customObjectDeserializerCNFEBehavior

IGNOREWARNEXCEPTION

IGNORE

JSON アンマーシャリングを使用しているときに、ペイロード内のクラスが見つからない場合、このプロパティーを使用して次のように動作を変更できます。

  • プロパティーが IGNORE に設定されている場合、ペイロードは HashMap に変換されます
  • プロパティーが WARN に設定されている場合、ペイロードは HashMap に変換され、警告がログに記録されます
  • プロパティーが EXCEPTION に設定されている場合、KIE サーバーは例外を出力します

org.kie.server.strict.jaxb.format

truefalse

false

このプロパティーの値を true に設定すると、KIE Server は REST API ペイロードのデータのタイプを検証します。たとえば、データフィールドに数字のデータタイプが指定されている場合に、数字以外が含まれているとエラーが発生します。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.