第4章 インストール
これで基本的な設定は終了し、IBM WebSphere Application Server は Red Hat JBoss BRMS をデプロイするように設定されます。これから、先に展開したデプロイ可能な WAR ファイルをアップロードできます。
前述のように、IBM WebSphere Application Server の Red Hat JBoss BRMS ZIP ファイルには、Business Central と Realtime Decision Server の両方のデプロイ可能な WAR ファイルが含まれます。
4.1. Business Central のインストール
Business Central は web アーカイブとしてアップロードされ、 http://TARGET_SERVER:PORT/business-central からアクセスできます。Business Central WAR を WebSphere アプリケーションとしてインストールしてデプロイメントを開始します。
メインメニューで Applications → Application Types → WebSphere Enterprise Applications に移動します。
これにより、システムのすべての既存アプリケーションが表示され、新規のインストールが可能になります。
- Install をクリックしてインストールプロセスを開始します。
Business Central WAR ファイル (
business-central.war) をローカルファイルからアップロードします。詳細は、「Red Hat JBoss BRMS for IBM WebSphere Application Server の展開」 を参照してください。図4.1 アプリケーションインストールウィザードの準備

Next をクリックします。このプロセスには時間がかかる場合があります。
重要以下のようなエラーメッセージが表示される場合があります。
EAR ファイルは破損しているか、または未完成である場合があります。アプリケーションが現行バージョンの WebSphere(R) Application Server の互換性のある Java(TM) プラットフォーム、Enterprise Edition (Java EE) レベルにあることを確認してください。 java.lang.NullPointerException
その場合、コマンドラインで
ulimit -nを実行します。結果が1024の場合、オープンファイル記述子の数を増やします。推奨値は 100 000 です。- Fast Path ラジオボタンを選択してから Next をクリックします。
-
Application Name を、Select Installation Options 手順の
business-centralに変更し、Next をクリックします。 - Map Modules to Servers の手順で、要件に応じて Business Central モジュールをサーバーにマップします。
- Map Virtual Hosts for Web Modules の手順では、デフォルト値をそのままにして Next をクリックします。
-
次の手順では、コンテキストのルートを
business-centralに設定します。 - Metadata for Modules 手順では、デフォルト値をそのままにして Next をクリックします。
- Summary ページで、Finish をクリックし、Business Central をインストールします。このプロセスには時間がかかる場合があります。このプロセスの終わりに変更をマスター設定に保存します。
WebSphere Enterprise Applications ページに戻ります。ここには、business-central が新規アプリケーションとして一覧表示されます。ただし、これはこの時点では停止された状態になります。アプリケーションを起動する前に、グループをロールにマップし、クラスローディングを設定し、Bouncy Castle Crypto API を有効にする必要があります。
グループとロールのマッピング
-
business-centralアプリケーションをクリックしてアプリケーション設定ページを開きます。 - 左側の Detail Properties の見出しにある Security Role to User/Group Mapping をクリックします。
-
adminロールを選択し、上部にある Map Groups… をクリックします。 adminグループを検索 (または単に Search ボタンをクリック) して、これを Available 一覧から Selected 一覧に移動します。OK をクリックします。このマッピングにより、先に作成した管理者ユーザーに Business Central アプリケーションへのアクセスが付与されます。
-
analystロールについても同じ手順に従い、設定を保存してください。
Business Central にアクセスできる他のグループまたはユーザーがある場合、同じ手順を使用してそれらを admin または analyst ロールにマップします。
Realtime Decision Server もインストールしている場合には、このユーザーに kie-server ロールへのアクセスを付与します。さらに、REST API を使用する場合には、該当する REST API ロールをマップします。API ロールについての詳細は、『Red Hat JBoss BPM Suite Development Guide』の「Remote API」の章を参照してください。
クロスローディングの設定
以下の手順に従って、クロスローディングの設定が正しいことを確認します。
- メインメニューで Applications → Application Types → WebSphere Enterprise Applications に移動します。
-
business-centralをクリックします。 - 左側の Detail Properties の見出しにある Class Loading and Update Detection をクリックします。
以下のオプションにチェックを付けます。
- Class Loader Order: まず、ローカルクラスローダーでのクロスローディングが行われます (親が最後になります)
- WAR Class Loader Policy: アプリケーションの単一クラスローダー
図4.2 クロスローディングの設定

- OK をクリックし、変更をマスター設定に保存し、IBM WebSphere Application Server を再起動します。
Bouncy Castle Crypto API の有効化
Business Central での Git SSH リポジトリーのクローンおよび kie-config-cli を有効にするには、Bouncy Castle Crypto API が設定されている必要があります。以下の手順に従って API を有効にします。
-
org.apache.sshd.registerBouncyCastleプロパティーをtrueに、org.uberfire.domainプロパティーをWSLoginに設定します。カスタムプロパティーの設定方法についての詳細は、「カスタム JVM プロパティーの追加」 を参照してください。 適切なバージョンの Bouncy Castle を使用して、Business Central から参照される共有ライブラリーとして Bouncy Castle API を設定します。
- 左側のメインメニューで、Environment → Shared Libraries に移動し、適切なスコープを選択してから New… をクリックして新規ライブラリーを作成します。
ライブラリー名を指定し、クラスパスをBouncy Castle ライブラリー (
bcprov-jdk16-1.46.jar) に設定します。OK をクリックして設定を保存します。注記bcprov-jdk16-1.46.jarパッケージについての詳細は、「Maven Repository — Bouncy Castle Provider」ページを参照してください。-
Applications → Application Types → WebSphere Enterprise Applications に移動し、
business-centralをクリックします。 左側の References の見出しにある Shared Library References をクリックして、web モジュールを選択し、Reference Shared Libraries をクリックしてから直前の手順で作成された Bouncy Castle ライブラリーを Available から Selected の一覧に移動します。
図4.3 共有ライブラリーのマッピング

- OK をクリックして設定を保存します。
You have now successfully installed Business Central on IBM WebSphere Application Server.
アプリケーションを起動するには、Applications → Application Types → WebSphere Enterprise Applications ページに戻り、business-central チェックボックスを選択してから Start をクリックします。
アプリケーションにアクセスするには、web ブラウザーで http://TARGET_SERVER:PORT/business-central に移動します。
4.2. Realtime Decision Server のインストール
Realtime Decision Server は web アプリケーションアーカイブファイル (kie-server.war) として配布され、Red Hat JBoss BRMS 6.4.0 Deployable for WebSphere 8.5 ダウンロードにあります。
「ユーザーおよびグループの作成」 で説明されている手順に従って Realtime Decision Server で必要な kie-server ロールを作成していることが想定されます。まだこれを実行していない場合は、本書のそれぞれのセクションを参照してください。
左側のメインメニューで、Applications → Application Types → WebSphere Enterprise Applications に移動します。
これにより、システムのすべての既存アプリケーションが表示され、新規のインストールが可能になります。
- Install をクリックしてインストールプロセスを開始します。
-
Realtime Decision Server WAR ファイル (
kie-server.war) をローカルファイルシステムからアップロードします。 Fast Path ラジオボタンを選択してから Next をクリックします。
Install New Application ウィザードが開きます。
-
最初の手順で Application Name を
kie-serverに変更し、Next をクリックします。 - 次の手順で、要件に合わせて Realtime Decision Server モジュールをサーバーにマップし、Next をクリックします。
-
In the Bind Listeners for Message-Driven Beans step, select the Activation Specification radio button for both the beans. Enter
jms/activation/KIE.SERVER.EXECUTORas Target Resource JNDI Name for the KieExecutorMDB bean, andjms/activation/KIE.SERVER.REQUESTfor the KieServerMDB bean. -
次の手順で、リソースの参照を実際のリソースにマップします。先に作成した
KIE.SERVER.REQUEST接続ファクトリーの JNDI 名jms/conn/KIE.SERVER.REQUESTを入力します。 - Map Virtual Hosts for Web Modules の手順では、デフォルト値をそのままにして Next をクリックします。
-
次の画面で、コンテキストのルートを
kie-serverに設定します。 - Metadata for Modules 手順では、デフォルト値をそのままにして Next をクリックします。
- Finish をクリックして Realtime Decision Server をインストールします。このプロセスの終わりに変更をマスター設定に保存します。
クロスローディングの設定
以下の手順に従って、クロスローディングの設定が正しいことを確認します。
-
Applications → Application Types → WebSphere Enterprise Applications に移動し、
kie-serverをクリックします。 - 左側の Detail Properties の見出しにある Class Loading and Update Detection をクリックします。
- プロパティーで、Class Loader Order を Classes loaded with local class loader first (parent last) に、WAR Class Loader Policy を Single class loader for application に変更します。
- 変更をマスター設定に保存します。
グループとロールのマッピング
kie-server ロールをユーザーまたはグループにすでにマップしている場合は、この手順を無視してください。そうでない場合は、以下を実行します。
-
新規にインストールされた
kie-serverアプリケーションのメイン設定ページに戻ります (Applications → Application Types → WebSphere Enterprise Applications)。左側の Detail Properties 見出しにある Security Role to User/Group Mapping をクリックします。 -
kie-serverロールを選択し、Map Groups… をクリックして次の画面でkie-serverグループを検索します (または単に Search ボタンをクリックします)。 - これを Available 一覧から Selected 一覧に移動します。OK をクリックします。
このマッピングにより、先に作成した管理者ユーザーに Realtime Decision Server へのアクセスが付与されます。
変更を保存して、kie-server アプリケーションを起動できます。
http://TARGET_SERVER:PORT/kie-server/services/rest/server で GET 要求を送信し、Realtime Decision Server REST API が機能するかどうかを確認します。