はじめに
ODM(Operational Decision Manager)というIBM製品があります。これはアプリケーションに含まれる"ビジネス・ルール"を外出しにして容易に開発/管理を行う仕組みを提供してくれるものです。
このシリーズではODMを試してみたときのログを記載していきます。
まずはODM概要の整理と、Linux上に各サーバーを立てる想定でインストールするところまで。
関連記事
IBM Operational Decision Manager メモ - (1) 概要、Linuxへのインストール
IBM Operational Decision Manager メモ - (2) ルール開発から実行までの流れ
IBM Operational Decision Manager メモ - (3) Decision Center利用の流れ
IBM Operational Decision Manager メモ - (4) Linux上での環境セットアップ
IBM Operational Decision Manager メモ - (5) z/OS上での環境セットアップ
IBM Operational Decision Manager メモ - (6) z/OS上でのルール呼び出し
IBM Operational Decision Manager メモ - (7) zODM環境補足
ODMの概要/用語の整理
参考:
Decision automation for business agility
Rule Execution Server architecture
"Decision"(意思決定) とか言われると今一つピンと来ない感じがしますが、これはよくある例で言うと、例えば、ローン審査を行う業務において申請者の様々な条件(年齢、職業、現時点での借入金額、etc...)を元にローン可否を判断する、とか、保険料算定業務において申込内容(保険商品、付帯特約、保険対象の各種条件、etc...)を元に保険料を算出する、といったように、条件に応じたなんらかの業務上の判断をすることを指しています。
"Decision automation"(意思決定の自動化)というと何か大仰な表現な気がしますが、これは上のような判断を自動化するということで、大昔からローン判定やら保険料算定というのはアプリケーション中のif文とかcase文の塊として実装され、それにより自動化は行われてきた訳です。ですのでこの概念自体は特別目新しいものではありません。
ただ、業務によってはその条件分岐が非常に複雑になるものがあり、ソースコード中にif文やcase文を駆使して実装すると可読性が悪く、管理やメンテナンスが煩雑になってしまう場合があります。
ODMでは、そのような意思決定に関わるロジック(≒if文の塊)を外出しにして、その意思決定ロジックに特化した開発/実行/管理のための仕組みを提供しています。この、抽出された意思決定ロジック(≒if文の塊)は"ビジネス・ルール"と呼ばれたりします。
ODMを用いて"ビジネス・ルール"を外出しにすることで、以下のようなメリットを得られることが期待されます。
- ビジネス・ルールの可視化: ODMの開発ツールを使用すると、プログラミング言語ではなくGUIベースのツールなどを使って"ビジネス・ルール"の開発が可能です。例えば表形式で条件を設定していくことが出来るので、直感的に分かりやすいインターフェースでルールを表現することができます。それにより条件の抜け/漏れなども防ぐことに繋がります。
- メンテナンス容易性: プログラミング言語での開発ではなくGUIベース、あるいは自然言語ベースでルールを設定することができるため、いわゆる"開発者"ではなくても、業務寄りのユーザーがメンテナンス(一部の条件を変更するなど)を容易に行えるようになります。また、複数のロジックから共通的に使用されるルールを一元的に管理することができます。
- ライフサイクルの迅速化: ビジネス・ルールに特化したメンテナンスの仕組みが提供されるため、ビジネス・ルールの部分のみを変更からリリースまでを迅速に行うことができます。(従来型のケースでは、アプリケーションのレベルで、変更、再コンパイル、テスト、リリースのサイクルを回す必要がある)
このようなことを実現するために、ODMでは主に以下の様な3つの主要コンポーネントが提供されています。
- Rule Desginer: ビジネス・ルール開発ツール(Eclipseベース)
- RES(Rule Execution Server): ビジネス・ルールの稼働環境(Javaベース)
- Decision Center: ビジネス・ルール管理用サーバー(Javaベース)
Rule DesignerとRule Execution Serverは合わせてDecision ServerとかDecision Server Rulesと呼ばれるようです。(Decision ServerとかDecision Centerとかパッと見まぎらわしいので注意してください。この辺のネーミングセンスがイマイチですなぁ...。)
【ODM利用イメージ】
基本的な流れは以下の様な感じです。
(1) ルール開発
Rule Designerでビジネス・ルールを開発/テストし、Decision Centerと同期します。
(2) ルール管理
出来上がったビジネス・ルールを適切な実行環境(Rule Execution Server)にデプロイします。
リリース後のビジネスルールのメンテナンス(編集、テスト、シミュレーション、再デプロイなど)も行えます。
(Decision Centerを介さずに、Rule DesignerからRESに対して直接デプロイすることも可能です)
(3) 業務アプリケーション開発
ビジネス・ルールがRule Execution Serverにデプロイされると、それを業務アプリから利用できる状態になるので、そのビジネス・ルールを利用する業務アプリを作成します。
これはアプリの形態、言語等によってそれぞれの方法で実施されます(Liberty上のWebアプリ、BAW上のワークフロー、ホストCICSのCOBOLアプリケーションなど)。
(4) 業務アプリケーションの使用
エンドユーザーが業務アプリケーションを使用すると、内部的にはODM上で管理されているビジネス・ルールが呼び出されて判断が行われるということになります。
環境構築
簡易テスト用ということで、今回はPC上にODMの環境を作っていきます。
Windows10 のVirtualBox上にRHELを立てて、そこにODMサーバー環境を作っていきます。Rule Designer部分はWindows側に構築します。構築したい環境のイメージは以下の通りです。
RHEL V8.5
ODM V8.11
Db2 V11.5.4
Windows10
Eclipse 4.16(2020-06R)
RES, Decision Center はJavaアプリとして実装されており、LibertyやWAS、JBossなどのJEEサーバー上で稼働させることができます(RESはJEEではなくスタンドアローンのJavaアプリとしても稼働させることが可能)。
また、RES, Decision Centerでは各オブジェクト管理のためにデータベースを使うことになります。Db2, Oracle, H2, Derby, MySQLなど利用可能です。
ここでは、RES, Decision CenterのランタイムとしてはLibertyを使用し、データベースにはDb2を使用する想定とします(いずれもODMに付属のもの)。
開発環境のEclipseはWindows上に構築、ルール管理/稼働用のサーバーはLinux上に構築する、というイメージです。
参考: IBM Operational Decision Manager 8.11 - Detailed System Requirements
まずは、上のような構成を行うにあたって必要な各種S/Wをインストールしていきます。
各コンポーネントのインストール on Linux
参考: Installing product components
Javaのインストール
※最初IBM Semeru Runtime V11を使おうとしたのだが、ODMのインストール時にうまく認識されなかったので後からV8を入れなおした。
参考:IBM Semeru Runtime 11のインストール
IBM Semeru Runtimeの11の最新を使用することにします。
IBM Semeru Runtime Downloads
上のサイトからLinux版(x64)のrpmをダウンロードします。
[root@Test13 /Inst_Image/JavaSemer11]# ls -la
合計 166144
drwxr-xr-x. 2 root root 66 1月 12 16:20 .
drwxr-xr-x. 4 root root 39 1月 12 16:20 ..
-rwxr-x---. 1 root root 170128588 1月 12 16:20 ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64.rpm
[root@Test13 /Inst_Image/JavaSemer11]# yum install ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64.rpm
サブスクリプション管理リポジトリーを更新しています。
コンシューマー識別子を読み込めません
このシステムは、エンタイトルメントサーバーに登録されていません。subscription-manager で登録できます。
メタデータの期限切れの最終確認: 1:39:00 時間前の 2022年01月12日 14時42分40秒 に実施しました。
依存関係が解決しました。
==========================================================================================================================
パッケージ アーキテクチャー バージョン リポジトリー サイズ
==========================================================================================================================
インストール:
ibm-semeru-open-11-jdk x86_64 11.0.13.8_0.29.0-1 @commandline 162 M
トランザクションの概要
==========================================================================================================================
インストール 1 パッケージ
合計サイズ: 162 M
インストール後のサイズ: 325 M
これでよろしいですか? [y/N]: y
パッケージのダウンロード:
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
scriptletの実行中: ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64 1/1
準備 : 1/1
インストール中 : ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64 1/1
scriptletの実行中: ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64 1/1
[/usr/lib/tmpfiles.d/pesign.conf:1] Line references path below legacy directory /var/run/, updating /var/run/pesign → /run/pesign; please update the tmpfiles.d/ drop-in file accordingly.
検証 : ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64 1/1
インストール済みの製品が更新されています。
インストール済み:
ibm-semeru-open-11-jdk-11.0.13.8_0.29.0-1.x86_64
完了しました!
/usr/lib/jvm/ibm-semeru-open-11-jdk/以下にインストールされます。
確認
[root@Test13 ~]# ls -la /usr/lib/jvm/ibm-semeru-open-11-jdk/
合計 32
drwxr-xr-x. 9 root root 107 1月 12 16:22 .
drwxr-xr-x. 4 root root 213 1月 12 16:21 ..
drwxr-xr-x. 2 root root 4096 1月 12 16:21 bin
drwxr-xr-x. 4 root root 112 1月 12 16:21 conf
drwxr-xr-x. 3 root root 150 1月 12 16:21 include
drwxr-xr-x. 2 root root 8192 1月 12 16:21 jmods
drwxr-xr-x. 74 root root 4096 1月 12 16:21 legal
drwxr-xr-x. 7 root root 4096 1月 12 16:22 lib
drwxr-xr-x. 4 root root 47 1月 12 16:22 man
-rw-r--r--. 1 root root 1637 10月 22 14:53 release
[root@Test13 ~]# /usr/lib/jvm/ibm-semeru-open-11-jdk/bin/java --version
openjdk 11.0.13 2021-10-19
IBM Semeru Runtime Open Edition 11.0.13.0 (build 11.0.13+8)
Eclipse OpenJ9 VM 11.0.13.0 (build openj9-0.29.0, JRE 11 Linux amd64-64-Bit Compressed References 20211022_282 (JIT enabled, AOT enabled)
OpenJ9 - e1e72c497
OMR - 299b6a2d2
JCL - 2d83aa3b76 based on jdk-11.0.13+8)
デフォルトだとOpenJDKが有効になっていたので、alternativesコマンドで使用するJavaを切り替えます。
[root@Test13 ~]# alternatives --config java
2 プログラムがあり 'java' を提供します。
選択 コマンド
-----------------------------------------------
*+ 1 java-1.8.0-openjdk.x86_64 (/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.302.b08-3.el8.x86_64/jre/bin/java)
2 /usr/lib/jvm/ibm-semeru-open-11-jdk/bin/java
Enter を押して現在の選択 [+] を保持するか、選択番号を入力します:2
[root@Test13 ~]# java --version
openjdk 11.0.13 2021-10-19
IBM Semeru Runtime Open Edition 11.0.13.0 (build 11.0.13+8)
Eclipse OpenJ9 VM 11.0.13.0 (build openj9-0.29.0, JRE 11 Linux amd64-64-Bit Compressed References 20211022_282 (JIT enabled, AOT enabled)
OpenJ9 - e1e72c497
OMR - 299b6a2d2
JCL - 2d83aa3b76 based on jdk-11.0.13+8)
IBM Semeru Runtimeの8の最新を使用することにします。
IBM Semeru Runtime Downloads
上のサイトからLinux版(x64)のrpmをダウンロードします。
[root@Test13 /Inst_Image/JavaSemeru8]# ls -la
合計 91556
drwxr-xr-x. 2 root root 69 1月 12 17:31 .
drwxr-xr-x. 5 root root 59 1月 12 17:30 ..
-rwxr-x---. 1 root root 93752272 1月 12 17:31 ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64.rpm
[root@Test13 /Inst_Image/JavaSemeru8]#
[root@Test13 /Inst_Image/JavaSemeru8]# yum install ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64.rpm
サブスクリプション管理リポジトリーを更新しています。
コンシューマー識別子を読み込めません
このシステムは、エンタイトルメントサーバーに登録されていません。subscription-manager で登録できます。
メタデータの期限切れの最終確認: 2:49:45 時間前の 2022年01月12日 14時42分40秒 に実施しました。
依存関係が解決しました。
==========================================================================================================================================================================
パッケージ アーキテクチャー バージョン リポジトリー サイズ
==========================================================================================================================================================================
インストール:
ibm-semeru-open-8-jdk x86_64 1.8.0.312.b07_0.29.0-1 @commandline 89 M
トランザクションの概要
==========================================================================================================================================================================
インストール 1 パッケージ
合計サイズ: 89 M
インストール後のサイズ: 220 M
これでよろしいですか? [y/N]: y
パッケージのダウンロード:
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
scriptletの実行中: ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64 1/1
準備 : 1/1
インストール中 : ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64 1/1
scriptletの実行中: ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64 1/1
[/usr/lib/tmpfiles.d/pesign.conf:1] Line references path below legacy directory /var/run/, updating /var/run/pesign → /run/pesign; please update the tmpfiles.d/ drop-in file accordingly.
検証 : ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64 1/1
インストール済みの製品が更新されています。
インストール済み:
ibm-semeru-open-8-jdk-1.8.0.312.b07_0.29.0-1.x86_64
完了しました!
/usr/lib/jvm/ibm-semeru-open-8-jdk/以下にインストールされます。
確認
[root@Test13 ~]# ls -la /usr/lib/jvm/ibm-semeru-open-8-jdk/
合計 53368
drwxr-xr-x. 8 root root 248 1月 12 17:32 .
drwxr-xr-x. 5 root root 231 1月 12 17:32 ..
-rw-r--r--. 1 root root 1522 10月 22 14:30 ASSEMBLY_EXCEPTION
-rw-r--r--. 1 root root 19650 10月 22 14:30 LICENSE
-rw-r--r--. 1 root root 157063 10月 22 14:30 THIRD_PARTY_README
drwxr-xr-x. 2 root root 4096 1月 12 17:32 bin
-rw-r--r--. 1 root root 17300 10月 22 14:30 epl-2.0.html
drwxr-xr-x. 3 root root 150 1月 12 17:32 include
drwxr-xr-x. 4 root root 95 1月 12 17:32 jre
drwxr-xr-x. 3 root root 143 1月 12 17:32 lib
drwxr-xr-x. 4 root root 47 1月 12 17:32 man
-rw-r--r--. 1 root root 33947 10月 22 14:30 openj9-notices
-rw-r--r--. 1 root root 6384 10月 22 14:30 openj9-openjdk-notices
-rw-r--r--. 1 root root 491 10月 22 14:30 release
drwxr-xr-x. 10 root root 151 1月 12 17:32 sample
-rw-r--r--. 1 root root 54386066 10月 22 14:30 src.zip
[root@Test13 ~]# /usr/lib/jvm/ibm-semeru-open-8-jdk/bin/java -version
openjdk version "1.8.0_312"
IBM Semeru Runtime Open Edition (build 1.8.0_312-b07)
Eclipse OpenJ9 VM (build openj9-0.29.0, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20211022_234 (JIT enabled, AOT enabled)
OpenJ9 - e1e72c497
OMR - 299b6a2d2
JCL - 8860d39588 based on jdk8u312-b07)
alternativesコマンドで使用するJavaを切り替えます。
[root@Test13 ~]# alternatives --config java
3 プログラムがあり 'java' を提供します。
選択 コマンド
-----------------------------------------------
* 1 java-1.8.0-openjdk.x86_64 (/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.302.b08-3.el8.x86_64/jre/bin/java)
+ 2 /usr/lib/jvm/ibm-semeru-open-11-jdk/bin/java
3 /usr/lib/jvm/ibm-semeru-open-8-jdk/bin/java
Enter を押して現在の選択 [+] を保持するか、選択番号を入力します:3
[root@Test13 ~]# java -version
openjdk version "1.8.0_312"
IBM Semeru Runtime Open Edition (build 1.8.0_312-b07)
Eclipse OpenJ9 VM (build openj9-0.29.0, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20211022_234 (JIT enabled, AOT enabled)
OpenJ9 - e1e72c497
OMR - 299b6a2d2
JCL - 8860d39588 based on jdk8u312-b07)
Libertyのインストール
disk1/WLP/以下にzipで提供されているので、それを適当なディレクトリに展開します。
ここでは、/opt/IBM以下に配置することにします。
[root@Test13 /Inst_Image/ODM811/disk1/WLP]# unzip wlp-base-embeddable-21.0.0.9.zip
Archive: wlp-base-embeddable-21.0.0.9.zip
creating: wlp/
creating: wlp/bin/
creating: wlp/bin/jaxb/
creating: wlp/bin/jaxb/tools/
...
[root@Test13 /Inst_Image/ODM811/disk1/WLP]# mv wlp /opt/IBM/
[root@Test13 /Inst_Image/ODM811/disk1/WLP]# ls -la /opt/IBM/wlp
合計 92
drwxr-xr-x. 8 root root 140 8月 25 04:09 .
drwxr-xr-x. 4 root root 44 1月 12 17:51 ..
-rw-r--r--. 1 root root 857 8月 25 04:09 CHANGES.TXT
-rw-r--r--. 1 root root 293 8月 25 04:09 Copyright.txt
-rw-r--r--. 1 root root 12410 8月 25 04:09 README.TXT
drwxr-xr-x. 6 root root 4096 8月 25 04:09 bin
drwxr-xr-x. 3 root root 74 8月 25 04:09 clients
drwxr-xr-x. 4 root root 28 8月 25 04:09 dev
drwxr-xr-x. 7 root root 49152 8月 25 04:09 lib
drwxr-xr-x. 4 root root 36 8月 25 04:09 templates
drwxr-xr-x. 4 root root 35 8月 25 04:09 usr
Installation Managerのインストール
ODM関連のコンポーネントは、Installation Managerというツールを使ってインストールすることになるので、まずはそのInstallation Managerをインストールする必要があります。
この辺はマニュアルにきちんと手順が書いてなさそう。不親切...。
disk1/IM/agent.installer.linux.gtk.x86_64_1.9.1006.20210614_1906.zipを解凍してinstallを実行すると、Installation Managerのインストーラーが起動します(X-Serverが必要)
Installation Managerのバージョン1.9.1.6を選択して次へ
ライセンスを読み同意して次へ
そのまま次へ
内容を確認してインストール
これでインストール完了。"Installation Managerの再起動"をクリックするとInstallation Managerが起動します。
※Installation Managerはデフォルトで/opt/IBM/InstallationManagerにインストールされます。手動で起動したい場合は、/opt/IBM/InstallationManager/eclipse/IBMIM を実行します。
Decision Server Rules / Decision Centerのインストール
DicisionServerRules、および、Decision Centerのインストール・イメージを以下のようなディレクトリに展開している状態。
[root@Test13 /Inst_Image/ODM811]# ls disk1/DecisionServerRules/
Offerings atoc native plugins repository.config repository.xml
[root@Test13 /Inst_Image/ODM811]# ls disk2/DC/
Offerings atoc native plugins repository.config repository.xml
Installation Managerのメニューからファイル - 設定を選択
リポジトリーの追加をクリック
参照ボタンから、.../disk1/DecisionServerRules/repository.configを選択してOK
これでDecisionServerRules用のリポジトリが追加されます。
同様に、DecisionCenter用のリポジトリも追加してOK
Installation Managerのトップからインストールを選択
Decision Center、および、Decision Server Rulesを選択して次へ
ライセンスを確認して同意し、次へ
そのまま次へ
そのまま次へ
そのまま次へ
以下のようにフィーチャーを選択して次へ
最初、以下のようにJava(JDK)の場所としてIBM Semeru Runtime 11のディレクトリを示したら警告マークがついた。
仕方無いので IBM Semeru Runtime 8をインストールし直してそのパスを指定したら警告マークが外れた。
Liberty Serverのロケーションに、Libertyを展開したディレクトリを指定
ライセンス使用状況は適宜選択して次へ
内容を確認してインストール
インストール完了。
/opt/IBM/ODM8110以下に
[root@Test13 ~]# ls -la /opt/IBM/ODM8110/
合計 4
drwxr-xr-x. 10 root root 146 1月 12 18:06 .
drwxr-xr-x. 6 root root 78 1月 12 18:05 ..
drwxr-xr-x. 4 root root 61 1月 12 18:05 buildcommand
drwxr-xr-x. 8 root root 103 1月 12 18:05 executionserver
drwxr-xr-x. 5 root root 99 1月 12 18:05 gettingstarted
drwxr-xr-x. 5 root root 4096 1月 12 18:05 images
drwxr-xr-x. 4 root root 47 1月 12 18:06 license
drwxr-xr-x. 10 root root 117 1月 12 18:05 shared
drwxr-xr-x. 4 root root 38 1月 12 18:05 studio
drwxr-xr-x. 8 root root 133 1月 12 18:05 teamserver
Db2のインストール
参考: Db2 セットアップ・ウィザードによる Db2 サーバーのインストール (Linuxおよび UNIX)
セットアップウィザードを使用してDb2をインストールします。(要XServer)
[root@Test13 /Inst_Image/ODM811/server_dec]# ./db2setup
新規インストール
DB2バージョン11.5.4.0 Server Editionを選択
カスタムを選択し、"インスタンスを作成する"、"IBMの条項に同意する"にチェックして次へ
適宜フィーチャー選択
ここでは"基本アプリケーション開発ツール"を追加でチェックしています。
言語の選択をして次へ
そのまま次へ
"単一パーティションインスタンス"を選択して次へ
作成するインスタンスの設定をして次へ
fencedユーザーの設定をして次へ
インスタンス通信の設定をして次へ
そのまま次へ
完了
インスタンスが作成されるので稼働確認
[root@Test13 ~]# su - db2inst1
[db2inst1@Test13 ~]$ db2start
01/21/2022 16:05:19 0 0 SQL1063N DB2START の処理が正常に終了しました。
SQL1063N DB2START の処理が正常に終了しました。
[db2inst1@Test13 ~]$ db2 list db directory
SQL1031N 指定されたファイル・システムには、データベース
・ディレクトリーが 見つかりません。 SQLSTATE=58031
[db2inst1@Test13 ~]$ netstat -an | grep 5000
tcp6 0 0 :::50000 :::* LISTEN
各コンポーネントのインストール on Windows
Eclipseのインストール
Installing components locally
上の記述にならって、Eclipse 4.16(2020-06R)をダウンロードする。
こちらからWindows 64bit版をダウンロード。
https://www.eclipse.org/downloads/packages/release/2020-06/r
ダウンロードしたzipを展開
Rule Designerのインストール
事前にWindowsにもInstallation Managerをインストール。ODMに付いているWindows版のインストーラー(install.exe)を使えばよく基本Linuxと同じなので詳細は割愛。
Installation Managerを起動し、Linuxの時と同様にファイル-設定からリポジトリを追加します。今回はDecisionServerRulesのリポジトリのみ追加。
で、インストールに進みます。
Decision Server Rulesを選択して次へ
ライセンスに同意して次へ
適宜変更して次へ
そのまま次へ
以下のように選択して次へ
Javaのパスを指定
Eclipseのパスを指定
適宜選択して次へ
内容を確認してインストール
インストール完了
確認
Sample Serverの作成/起動
インストールの確認用にサンプルのサーバーを構成/起動するantスクリプトが用意されているので、そちらを実行してみます。
参考: Starting the sample server
<InstallDir>/shared/bin/startserver.shを実行します。
startserver.sh実行ログ
[root@Test13 /opt/IBM/ODM8110/shared/bin]# ./startserver.sh
/usr/bin/which: no xterm in (/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:/opt/IBM/wlp/bin:/opt/IBM/ODM8110/shared/tools/ant/bin/)
Buildfile: /opt/IBM/ODM8110/shared/bin/build.xml
startserver:
start.server:
checkForValidWLPHOME:
abortIfUnrecognizedWLPHOME:
checkIfWeCanWriteToODMHOME:
[touch] Creating /tmp/testwrite.txt
[copy] Copying 1 file to /opt/IBM/ODM8110/shared/samplesServer/wlp
[delete] Deleting: /opt/IBM/ODM8110/shared/samplesServer/wlp/testwrite.txt
abortIfAccessDeniedToODMHOME:
checkIfIsInstallingDC:
checkIfIsInstallingDS:
checkIfSamplesServerExists:
checkIfUpgrading:
abortIfUpgrading:
checkIfPortAlreadyInUse:
abortIfPortAlreadyInUse:
checkIfDCAppsDeployed:
checkIfDSAppsDeployed:
checkIfIsInstallingDS:
checkIfIsInstallingDC:
checkIfOneOfferingIsAlreadyDeployed:
abortIfOneOfferingIsAlreadydeployed:
checkIfSamplesServerExists:
createSamplesServerIfNeeded:
[samples.echo] 1 25, 2022 5:49:12 午後 com.ibm.rules.sampleserver.Log info
[samples.echo] 情報: GBRPS0038I: /opt/IBM/wlp/usr/servers/odm81100 に専用プロファイルを作成中
[samples.echo] GBRPS0038I: /opt/IBM/wlp/usr/servers/odm81100 に専用プロファイルを作成中
[wlp:server] CWWKM2001I: server.config.dir は /opt/IBM/wlp/usr/servers/odm81100 です。
[wlp:server] CWWKM2001I: server.output.dir は /opt/IBM/wlp/usr/servers/odm81100 です。
[wlp:server] CWWKM2001I: Invoke command は [/opt/IBM/wlp/bin/server, create, odm81100] です。
[wlp:server]
[wlp:server] サーバー odm81100 が作成されました。
checkIfWeCanWriteToWlpDir:
[copy] Copying 1 file to /opt/IBM/wlp/usr/servers/odm81100
[delete] Deleting: /opt/IBM/wlp/usr/servers/odm81100/testwrite.txt
abortIfAccessDeniedToWlpDir:
[mkdir] Created dir: /opt/IBM/wlp/usr/servers/odm81100/data
[copy] Copying 1 file to /opt/IBM/wlp/usr/servers/odm81100
[copy] Copying 1 file to /opt/IBM/wlp/usr/servers/odm81100
[mkdir] Created dir: /opt/IBM/wlp/usr/servers/odm81100/lib
[copy] Copying 2 files to /opt/IBM/wlp/usr/servers/odm81100/lib
checkIfDSInstalled:
checkIfDSAppsDeployed:
copyDSArtifactsIfNeeded:
copyDSArtifacts:
[copy] Copying 4 files to /opt/IBM/wlp/usr/servers/odm81100/apps
unzipDSdatabase:
[unzip] Expanding: /opt/IBM/ODM8110/shared/data/h2/resdb-backup.zip into /opt/IBM/wlp/usr/servers/odm81100/data/h2
checkIfDCInstalled:
checkIfDCAppsDeployed:
copyDCArtifactsIfNeeded:
copyDCArtifacts:
[copy] Copying 4 files to /opt/IBM/wlp/usr/servers/odm81100/apps
unzipDCdatabase:
[unzip] Expanding: /opt/IBM/ODM8110/shared/data/h2/rtsdb-backup.zip into /opt/IBM/wlp/usr/servers/odm81100/data/h2
[unzip] Expanding: /opt/IBM/ODM8110/shared/data/h2/rtsdb-serverextendedbrm-backup.zip into /opt/IBM/wlp/usr/servers/odm81100/data/h2
try.start:
[wlp:server] CWWKM2001I: server.config.dir は /opt/IBM/wlp/usr/servers/odm81100 です。
[wlp:server] CWWKM2001I: server.output.dir は /opt/IBM/wlp/usr/servers/odm81100 です。
[wlp:server] CWWKM2001I: Invoke command は [/opt/IBM/wlp/bin/server, start, odm81100] です。
[wlp:server]
[wlp:server] サーバー odm81100 を始動中です。
[wlp:server] サーバー odm81100 がプロセス ID 44504 で始動しました。
[wlp:server] Waiting up to 30 seconds for server confirmation: CWWKF0011I to be found in /opt/IBM/wlp/usr/servers/odm81100/logs/messages.log
[wlp:server] CWWKM2010I: /opt/IBM/wlp/usr/servers/odm81100/logs/messages.log で CWWKF0011I を検索中です。 この検索は、30 秒後にタイムアウトになります。
[wlp:server] CWWKM2015I: 一致番号: 1 は [22/01/25 17:49:54:856 JST] 00000029 com.ibm.ws.kernel.feature.internal.FeatureManager A CWWKF0011I: odm81100 サーバーは、Smarter Planet に対応する準備ができました。odm81100 サーバーは 37.079 秒で始動しました。 です。
wait.for.server.start:
checkIfDSInstalled:
wait.for.decisionserverIfExist:
checkIfDCInstalled:
wait.for.decisioncenterIfExist:
checkIfDCBuildAvailable:
checkIfDCAppsDeployed:
checkIfSetSamplesSettings:
update.decisioncenter.servers:
set-samples-settings:
[set-samples-settings] [serverURL] 'http://localhost:9090/decisioncenter'
[set-samples-settings] [datasourceName] 'jdbc/ilogDataSource'
[set-samples-settings] [username] 'rtsAdmin'
[set-samples-settings] [password] '********'
[set-samples-settings] 1 25, 2022 5:50:08 午後 com.ibm.rules.decisioncenter.remoting.internal.RemoteSessionHttpExecutorBuilder log
[set-samples-settings] 情報: {"url":"http://localhost:9090/decisioncenter","datasource":"jdbc/ilogDataSource","username":"rtsAdmin","message":"Sign in successfully","date":"2022/01/25 17:50:08"}
[set-samples-settings] 1 25, 2022 5:50:13 午後 com.ibm.rules.decisioncenter.remoting.internal.RemoteSessionHttpExecutorBuilder log
[set-samples-settings] 情報: {"url":"http://localhost:9090/decisioncenter","datasource":"jdbc/ilogDataSource","username":"rtsAdmin","message":"Sign out successfully","date":"2022/01/25 17:50:13"}
set-samples-settings:
[set-samples-settings] [serverURL] 'http://localhost:9090/decisioncenter'
[set-samples-settings] [datasourceName] 'jdbc/ilogDataSource'
[set-samples-settings] [username] 'rtsAdmin'
[set-samples-settings] [password] '********'
[set-samples-settings] 1 25, 2022 5:50:15 午後 com.ibm.rules.decisioncenter.remoting.internal.RemoteSessionHttpExecutorBuilder log
[set-samples-settings] 情報: {"url":"http://localhost:9090/decisioncenter","datasource":"jdbc/ilogDataSource","username":"rtsAdmin","message":"Sign in successfully","date":"2022/01/25 17:50:15"}
[set-samples-settings] 1 25, 2022 5:50:18 午後 com.ibm.rules.decisioncenter.remoting.internal.RemoteSessionHttpExecutorBuilder log
[set-samples-settings] 情報: {"url":"http://localhost:9090/decisioncenter","datasource":"jdbc/ilogDataSource","username":"rtsAdmin","message":"Sign out successfully","date":"2022/01/25 17:50:18"}
delete.new.installation.files:
[delete] Deleting: /opt/IBM/ODM8110/shared/data/ds_just_installed
[delete] Deleting: /opt/IBM/ODM8110/shared/data/dc_just_installed
[samples.echo] 1 25, 2022 5:50:19 午後 com.ibm.rules.sampleserver.Log info
[samples.echo] 情報: GBRPS0029I: start.server が完了しました。
[samples.echo] GBRPS0029I: start.server が完了しました。
BUILD SUCCESSFUL
Total time: 1 minute 11 seconds
これで"odm81100"という名前のLibertyサーバーが作成されて、そこにRESとDecision Center用のアプリがデプロイされることになります。データベースとしてはDb2ではなくJavaベースのH2が使われます(※H2はインストール作業などは不要です)。ちなみにH2は開発目的では使用できますが、本番環境での使用はサポートされていません。
参考: Samples environment
sample server
A WebSphere® Liberty server instance that uses the H2 database. It contains preconfigured versions of the Rule Execution Server console, and the Decision Center web applications. They include populated databases and predefined users.
Note: H2 database is for development only, and not for production purposes.
サンプルとして作成される構成は以下の様なイメージとなります。
生成されたLibertyのディレクトリ階層(workareaは除く)
[root@Test13 /opt/IBM/wlp/usr/servers/odm81100]# tree . -I workarea --charset C
.
|-- apps
| |-- DecisionRunner.war
| |-- DecisionService.war
| |-- decisioncenter-api.war
| |-- decisioncenter.war
| |-- decisionmodel.war
| |-- miniloan-server.war
| `-- res.war
|-- data
| `-- h2
| |-- resdb.mv.db
| |-- rtsdb-serverextendedbrm.mv.db
| |-- rtsdb-serverextendedbrm.trace.db
| |-- rtsdb.mv.db
| `-- rtsdb.trace.db
|-- dropins
|-- jvm.options
|-- lib
| |-- h2.jar
| `-- wlp-anttasks.jar
|-- logs
| |-- console.log
| |-- ffdc
| | |-- exception_summary_22.01.25_18.00.17.0.log
| | |-- ffdc_22.01.25_18.00.17.0.log
| | |-- ffdc_22.01.25_18.00.20.0.log
| | |-- ffdc_22.01.25_18.00.20.1.log
| | `-- ffdc_22.01.25_18.00.20.2.log
| |-- messages.log
| `-- state
| `-- plugin-cfg.xml
|-- res-console0.log
|-- resources
| `-- security
| |-- key.p12
| `-- ltpa.keys
|-- server.env
|-- server.xml
`-- tranlog
|-- partnerlog
| |-- DO NOT DELETE LOG FILES
| |-- log1
| `-- log2
`-- tranlog
|-- DO NOT DELETE LOG FILES
|-- log1
`-- log2
13 directories, 34 files
生成されたLibertyのserver.xml
/opt/IBM/wlp/usr/servers/odm81100/server.xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- Licensed Materials - Property of IBM -->
<!-- 5725-B69 5655-Y17 5655-Y31 -->
<!-- Copyright IBM Corp. 1987, 2021. All Rights Reserved -->
<!-- US Government Users Restricted Rights - Use, duplication or -->
<!-- disclosure restricted by GSA ADP Schedule Contract with -->
<!-- IBM Corp. -->
<server description="ODM Sample Server">
<!-- Enable features -->
<featureManager>
<feature>servlet-3.1</feature>
<feature>jsp-2.3</feature>
<feature>jdbc-4.1</feature>
<feature>appSecurity-2.0</feature>
<feature>jaxrs-2.0</feature>
<feature>jndi-1.0</feature>
<feature>ssl-1.0</feature>
<!-- For Decision Runner -->
<feature>concurrent-1.0</feature>
<!-- For secure JMX connection -->
<feature>restConnector-2.0</feature>
<feature>localConnector-1.0</feature>
<!-- For json parsing used in miniloan-server -->
<feature>jsonp-1.0</feature>
<feature>ldapRegistry-3.0</feature>
</featureManager>
<webAppSecurity includePathInWASReqURL="true"/>
<webContainer deferServletLoad="false" enableDefaultIsElIgnoredInTag="true" enableJspMappingOverride="true"/>
<applicationMonitor updateTrigger="mbean"/>
<httpSession
securityIntegrationEnabled="false"
idReuse="true"
useContextRootAsCookiePath="true"
invalidateOnUnauthorizedSessionRequestException="true" />
<!-- To access this server from a remote client add a host attribute to
the following element, e.g. host="*" -->
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9090"
httpsPort="9443" />
<!-- Automatically expand WAR files and EAR files -->
<!-- <applicationManager autoExpand="true"/> -->
<library id="H2Lib" filesetRef="H2Fileset" />
<fileset id="H2Fileset"
dir="${server.config.dir}/lib"
includes="h2.jar" />
<!-- RES data source -->
<dataSource id="jdbc/resdatasource"
isolationLevel="TRANSACTION_READ_COMMITTED"
jndiName="jdbc/resdatasource"
type="javax.sql.ConnectionPoolDataSource">
<jdbcDriver javax.sql.ConnectionPoolDataSource="org.h2.jdbcx.JdbcDataSource"
javax.sql.DataSource="org.h2.jdbcx.JdbcDataSource"
javax.sql.XADataSource="org.h2.jdbcx.JdbcDataSource"
libraryRef="H2Lib"/>
<properties URL="jdbc:h2:${server.config.dir}/data/h2/resdb;MODE=HSQLDB;auto_server=true"
createDatabase="create"
user="ilog"
password="ilog"/>
</dataSource>
<!-- Decision center -->
<dataSource id="jdbc/ilogDataSource"
isolationLevel="TRANSACTION_READ_COMMITTED"
jndiName="jdbc/ilogDataSource"
type="javax.sql.ConnectionPoolDataSource">
<jdbcDriver javax.sql.ConnectionPoolDataSource="org.h2.jdbcx.JdbcDataSource"
javax.sql.DataSource="org.h2.jdbcx.JdbcDataSource"
javax.sql.XADataSource="org.h2.jdbcx.JdbcDataSource"
libraryRef="H2Lib"/>
<properties URL="jdbc:h2:${server.config.dir}/data/h2/rtsdb;MODE=HSQLDB;LOCK_TIMEOUT=20000;auto_server=true"
createDatabase="create"
user="ilog"
password="ilog"/>
</dataSource>
<dataSource id="jdbc/serverextendedbrm"
isolationLevel="TRANSACTION_READ_COMMITTED"
jndiName="jdbc/serverextendedbrm"
type="javax.sql.ConnectionPoolDataSource">
<jdbcDriver javax.sql.ConnectionPoolDataSource="org.h2.jdbcx.JdbcDataSource"
javax.sql.DataSource="org.h2.jdbcx.JdbcDataSource"
javax.sql.XADataSource="org.h2.jdbcx.JdbcDataSource"
libraryRef="H2Lib"/>
<properties URL="jdbc:h2:${server.config.dir}/data/h2/rtsdb-serverextendedbrm;MODE=HSQLDB;LOCK_TIMEOUT=20000;auto_server=true"
createDatabase="create"
user="ilog"
password="ilog"/>
</dataSource>
<!-- Web application security -->
<basicRegistry id="basic" realm="customRealm">
<user name="odmAdmin" password="odmAdmin" />
<user name="resAdmin" password="resAdmin" />
<user name="resDeploy" password="resDeploy" />
<user name="resMonitor" password="resMonitor" />
<group name="resAdministrators">
<member name="resAdmin" />
<member name="odmAdmin" />
</group>
<group name="resDeployers">
<member name="resAdmin" />
<member name="resDeploy" />
<member name="odmAdmin" />
</group>
<group name="resMonitors">
<member name="resAdmin" />
<member name="resDeploy" />
<member name="resMonitor" />
<member name="odmAdmin" />
</group>
<user name="rtsAdmin" password="rtsAdmin" />
<user name="rtsConfig" password="rtsConfig" />
<user name="rtsUser1" password="rtsUser1" />
<user name="Bea" password="Bea" />
<user name="Paul" password="Paul" />
<user name="rmtuser" password="rmtuser" />
<group name="AdminGroup">
<member name="rtsAdmin" />
<member name="odmAdmin" />
<member name="Paul" />
</group>
<group name="InstallGroup">
<member name="rtsAdmin" />
<member name="odmAdmin" />
</group>
<group name="ConfigGroup">
<member name="rtsConfig" />
</group>
</basicRegistry>
<!-- RES console -->
<application type="war" id="res" name="res"
location="${server.config.dir}/apps/res.war">
<application-bnd>
<security-role name="resAdministrators">
<group name="resAdministrators" />
</security-role>
<security-role name="resDeployers">
<group name="resDeployers" />
</security-role>
<security-role name="resMonitors">
<group name="resMonitors" />
</security-role>
</application-bnd>
</application>
<!-- Business console -->
<application type="war" id="decisioncenter" name="decisioncenter"
location="${server.config.dir}/apps/decisioncenter.war">
<classloader delegation="parentLast" />
<application-bnd>
<security-role name="rtsAdministrator">
<group name="AdminGroup" />
</security-role>
<security-role name="rtsInstaller">
<group name="InstallGroup" />
</security-role>
<security-role name="rtsConfigManager">
<group name="ConfigGroup" />
</security-role>
<security-role name="rtsUser">
<special-subject type="ALL_AUTHENTICATED_USERS" />
</security-role>
</application-bnd>
</application>
<!-- DC REST API -->
<application type="war" id="decisioncenter-api" name="decisioncenter-api"
location="${server.config.dir}/apps/decisioncenter-api.war">
<classloader delegation="parentLast" />
<application-bnd>
<security-role name="rtsAdministrator">
<group name="AdminGroup" />
</security-role>
<security-role name="rtsInstaller">
<group name="InstallGroup" />
</security-role>
<security-role name="rtsConfigManager">
<group name="ConfigGroup" />
</security-role>
<security-role name="rtsUser">
<special-subject type="ALL_AUTHENTICATED_USERS" />
</security-role>
</application-bnd>
</application>
<!-- Decision Modeling -->
<application type="war" id="decisionmodel" name="decisionmodel"
location="${server.config.dir}/apps/decisionmodel.war">
<classloader delegation="parentLast" />
<application-bnd>
<security-role name="rtsAdministrator">
<group name="AdminGroup" />
</security-role>
<security-role name="rtsInstaller">
<group name="InstallGroup" />
</security-role>
<security-role name="rtsConfigManager">
<group name="ConfigGroup" />
</security-role>
<security-role name="rtsUser">
<special-subject type="ALL_AUTHENTICATED_USERS" />
</security-role>
</application-bnd>
</application>
<!-- Managed executor service for Decision Runner -->
<managedExecutorService jndiName="concurrent/drExecutorService" />
<!-- Decision Runner -->
<application type="war" id="DecisionRunner" name="DecisionRunner"
location="${server.config.dir}/apps/DecisionRunner.war">
<application-bnd>
<security-role name="resAdministrators">
<group name="resAdministrators" />
</security-role>
<security-role name="resDeployers">
<group name="resDeployers" />
</security-role>
</application-bnd>
</application>
<!-- HTDS -->
<application type="war" id="DecisionService" name="DecisionService"
location="${server.config.dir}/apps/DecisionService.war">
</application>
<!-- JEE rule session sample -->
<application type="war" id="rulesession" name="rulesession"
location="${server.config.dir}/apps/miniloan-rest.war">
</application>
<!-- Loan Validation Service application -->
<application type="war" id="loan-server" name="loan-server"
location="${server.config.dir}/apps/loan-server.war">
</application>
<application type="war" id="dcclient" name="dcclient"
location="${server.config.dir}/apps/dcclient.war">
<application-bnd>
<security-role name="rtsUser">
<group name="rtsUser" />
</security-role>
</application-bnd>
</application>
<application type="war" id="miniloan-server" name="miniloan-server"
location="${server.config.dir}/apps/miniloan-server.war">
<application-bnd>
<security-role name="resAdministrators">
<group name="resAdministrators" />
</security-role>
</application-bnd>
</application>
<keyStore id="defaultKeyStore" password="odmAdmin" />
<administrator-role> <group>resAdministrators</group> </administrator-role>
<logging traceFileName="stdout"
traceFormat="BASIC"
traceSpecification="*=info:org.apache.solr.*=warning:com.ibm.rules.decisioncenter.webhooks.notification.*=warning"
consoleLogLevel="INFO"/>
</server>
http用のポート:9090, https用のポート:9443 でListenすることになりますので、firewallを使用している場合は必要に応じて穴をあけておきます。
Sample Server上のRESへのアクセス
ブラウザからRESにアクセスしてみます。
htttp://xxx:9090/resにアクセスし、resAdmin/resAdminでサインインします。
ログインできました。
Sample Server上のDecision Centerへのアクセス
ブラウザからDecision Centerにアクセスしてみます。
htttp://xxx:9090/decisioncenterにアクセスし、rtsAdmin/rtsAdminでサインインします。
ログインできました。
OKそうです。
Sample Serverの停止
参考: Stopping the sample server
<InstallDir>/shared/bin/stopserver.shで停止しておきます。
[root@Test13 ~]# /opt/IBM/ODM8110/shared/bin/stopserver.sh
/usr/bin/which: no xterm in (/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:/opt/IBM/wlp/bin:/opt/IBM/ODM8110/shared/tools/ant/bin/)
Buildfile: /opt/IBM/ODM8110/shared/bin/build.xml
stopserver:
stop.server:
try.stop:
[wlp:server] CWWKM2001I: server.config.dir は /opt/IBM/wlp/usr/servers/odm81100 です。
[wlp:server] CWWKM2001I: server.output.dir は /opt/IBM/wlp/usr/servers/odm81100 です。
[wlp:server] CWWKM2001I: Invoke command は [/opt/IBM/wlp/bin/server, stop, odm81100] です。
[wlp:server]
[wlp:server] サーバー odm81100 を停止中です。
[wlp:server] サーバー odm81100 は停止しました。
BUILD SUCCESSFUL
Total time: 7 seconds