webotx enterprise service bus - nec(japan)3 3.3.3. soap bc.....67 4 1.guiツール...

1

このパートでは、WebOTX Enterprise Service Bus の実行環境上で動作するコンポーネントやサービスアセンブリなどの運用方法

について説明しています。

WebOTX Enterprise Service Bus マニュアル

バージョン： 8.1

版数：第 2 版

リリース： 2009 年 2 月

Copyright (C) 2006 - 2009 NEC Corporation. All rights reserved.

運用 4

2

目次 1. GUIツール................................................................................................................................4

1.1. 統合運用管理ツール（シングルプロセスモード）..................................................................................5 1.1.1. コンポーネントの運用 ...................................................................................................................................5 1.1.2. サービスアセンブリの運用..........................................................................................................................12 1.1.3. 統計情報の管理 ........................................................................................................................................22

1.2. 統合運用管理ツール（マルチプロセスモード） ...................................................................................23 1.2.1. アプリケーショングループ、プロセスグループの操作 ...................................................................................23 1.2.2. サービスアセンブリの運用..........................................................................................................................34 1.2.3. 統計機能 ...................................................................................................................................................39

2. CUIツール ..............................................................................................................................41 2.1. otxadminコマンド............................................................................................................................41

2.1.1. otxadminコマンドの運用 ............................................................................................................................41 2.2. jbiadminコマンドとは ......................................................................................................................51

2.2.1. コマンドの構文 ...........................................................................................................................................51 2.2.2. helpコマンド ...............................................................................................................................................52 2.2.3. 出力とエラー ..............................................................................................................................................52 2.2.4. セキュリティに関する注意事項 ...................................................................................................................53

2.3. jbiadminコマンド.............................................................................................................................54 2.3.1. コンポーネントの運用 .................................................................................................................................54 2.3.2. サービスアセンブリの運用..........................................................................................................................57 2.3.3. 情報表示 ...................................................................................................................................................60 2.3.4. 設定変更 ...................................................................................................................................................62

3. コンフィグレーション.................................................................................................................64 3.1. ドメインに関する設定 ......................................................................................................................64

3.1.1. システム環境変数 ......................................................................................................................................64 3.1.2. JBIフレームワークライフサイクルモジュールの設定 ....................................................................................64

3.2. システムサービスに関する設定 .......................................................................................................64 3.2.1. 管理サービス .............................................................................................................................................65 3.2.2. コンフィグレーションサービス ......................................................................................................................65 3.2.3. 配備サービス .............................................................................................................................................65 3.2.4. インストールサービス .................................................................................................................................65 3.2.5. ログサービス..............................................................................................................................................65 3.2.6. メッセージサービス.....................................................................................................................................66 3.2.7. モニタリングサービス..................................................................................................................................66

3.3. 各コンポーネントに関する設定 ........................................................................................................66 3.3.1. Sequencing SE .........................................................................................................................................67 3.3.2. XSLT SE ...................................................................................................................................................67

3

3.3.3. SOAP BC ..................................................................................................................................................67 3.3.4. JMS BC ....................................................................................................................................................68 3.3.5. File BC......................................................................................................................................................69 3.3.6. JCA BC .....................................................................................................................................................69 3.3.7. RMI BC.....................................................................................................................................................70 3.3.8. CBR SE.....................................................................................................................................................71 3.3.9. CORBA BC ...............................................................................................................................................71 3.3.10. JDBC BC ................................................................................................................................................72 3.3.11. FTP BC ...................................................................................................................................................73 3.3.12. HTTP BC................................................................................................................................................73 3.3.13. UserProcessor SE ..................................................................................................................................74

4. モニタリング............................................................................................................................76 4.1. シーケンシングSE...........................................................................................................................76 4.2. XSLT SE........................................................................................................................................ 77 4.3. SOAP BC ....................................................................................................................................... 78 4.4. JMS BC ......................................................................................................................................... 78 4.5. File BC........................................................................................................................................... 80 4.6. JCA BC.......................................................................................................................................... 80 4.7. RMI BC.......................................................................................................................................... 81 4.8. CBR SE.......................................................................................................................................... 82 4.9. CORBA BC .................................................................................................................................... 83 4.10. JDBC BC ..................................................................................................................................... 83 4.11. FTP BC ........................................................................................................................................ 84 4.12. HTTP BC..................................................................................................................................... 85 4.13. UserProcessor SE ....................................................................................................................... 86

4

1.GUI ツール

本章では、WebOTX ESB 実行環境における運用操作を、WebOTX が提供する GUI ベースのツール

を使用して行う場合について説明します。

WebOTX ESB 製品に対応した GUI ベースのツールとしては『統合運用管理ツール』があります。

本章ではこの『WebOTX 統合運用管理ツール』を使用した運用方法について説明していきます。

5

1.1.統合運用管理ツール（シングルプロセスモード）

『統合運用管理ツール』を使用すると、WebOTX ESB 実行環境内へのコンポーネントのインストール/

アンインストール作業や、開発したサービスアセンブリの配備/配備解除といった運用操作を、GUI イ

ンタフェースを使用して容易に行うことができるようになります。また、WebOTX ESB の実行環境で

動作するコンポーネントやサービスアセンブリなどの管理対象に対するコンフィグレーション情報の

更新やオペレーション実行、統計情報採取などの管理操作をスムーズに行えるようになります。

『統合運用管理ツール』はオプション製品です。ご利用の際は、『WebOTX

Administrator』を別途ご購入下さい。

【図 1a】統合運用管理ツールの全体画面

図のように、WebOTX ESB の実行環境を含むドメインにアクセスすると、画面左側で示されている

管理対象ツリー構成において、「ドメイン（図では domain1）」→「アプリケーションサーバ」ノー

ドの配下に「ESB」ノードが表示されます。さらにその配下には「コンポーネント」、「サービスア

センブリ」、「システムサービス」のノードが表示され、それぞれの配下には実行環境で動作するコ

ンポーネント、サービスアセンブリ、システムサービスを示すノード（管理対象）が表示されます。

また、画面右上部には、管理対象ツリー上の指定したノード（管理対象）が持つ属性情報（あるい

は統計情報）が表示されます。

1.1.1.コンポーネントの運用

ここでは、WebOTX ESB 実行環境へのコンポーネント（バインディングコンポーネント、サービスエ

ンジン、共有ライブラリ）のインストール/アンインストール、およびライフサイクル管理を行うため

の操作について説明します。

インストール

コンポーネント（バインディングコンポーネント、サービスエンジン）のインストールを行うには、

「ESB」→「コンポーネント」ノードを右クリックして表示される操作の一覧から「コンポーネントの

インストール」を選択します。

6

【図 1b】「コンポーネントのインストール」の選択画面

また、共有ライブラリのインストールを行うには、同じく「コンポーネント」ノードを右クリックし

て表示される操作の一覧から「共有ライブラリのインストール」を選択します。

【図 1c】「共有ライブラリのインストール」の選択画面

コンポーネント

「コンポーネントのインストール」を選択して表示される画面において表示される、以下の設定項目

7

を入力します。

ZIP 形式のアーカイブファイル : コンポーネントのインストールファイルに対する絶対パスを指

定します。

【図 1d】「インストールするコンポーネント」の選択画面

共有ライブラリ

「共有ライブラリのインストール」を選択して表示される画面において表示される、以下の設定項目


ZIP 形式のアーカイブファイル : 共有ライブラリのインストールファイルに対する絶対パスを指

定します。

【図 1e】「インストールする共有ライブラリ」の選択画面

アンインストール

コンポーネント（バインディングコンポーネント、サービスエンジン、共有ライブラリ）のアンイン

ストールを行うには、「ESB」→「コンポーネント」ノードを右クリックして表示される操作の一覧か

ら「コンポーネントのアンインストール」を選択します。

8

【図 1f】「コンポーネントのアンインストール」の選択画面

また、共有ライブラリのアンインストールを行うには、同じく「コンポーネント」ノードを右クリッ

クして表示される操作の一覧から「共有ライブラリのアンインストール」を選択します。

【図 1g】「共有ライブラリのアンインストール」の選択画面


コンポーネント（バインディングコンポーネント、サービスエンジン）をアンインストールするには、

9

「ESB」→「コンポーネント」ノードを右クリックして表示される操作の一覧から「コンポーネントの

アンインストール」を選択します。インストールされているコンポーネントの一覧よりアンインスト

ールするコンポーネントを選択してください。

【図 1h】「コンポーネントのアンインストール」の選択画面


共有ライブラリをアンインストールするには、「ESB」→「コンポーネント」ノードを右クリックして

表示される操作の一覧から「共有ライブラリのアンインストール」を選択します。インストールされ

ている共有ライブラリの一覧よりアンインストールするコンポーネントを選択してください。

【図 1i】「共有ライブラリのアンインストール」の選択画面

ライフサイクル管理

コンポーネント（バインディングコンポーネント、サービスエンジン、共有ライブラリ）の起動を行

うには、「ESB」→「コンポーネント」→「起動するコンポーネント名」のノードを右クリックして表

示される操作の一覧から「起動」を選択します。

10

【図 1j】「起動するコンポーネント」の選択画面


うには、「ESB」→「コンポーネント」→「停止するコンポーネント名」のノードを右クリックして表

示される操作の一覧から「停止」を選択します。

【図 1k】「停止するコンポーネント」の選択画面


うには、「ESB」→「コンポーネント」→「シャットダウンするコンポーネント名」のノードを右クリ

ックして表示される操作の一覧から「シャットダウン」を選択します。

11

【図 1l】「シャットダウンするコンポーネント」の選択画面

スタート

コンポーネント（バインディングコンポーネント、サービスエンジン）の起動を行うには、「ESB」→

「コンポーネント」→「起動するコンポーネント名」ノードを右クリックして表示される操作の一覧

から「起動」を選択します。選択したコンポーネントを起動する場合は「実行」をクリックします。

【図 1m】「起動するコンポーネント」の選択画面

ストップ

コンポーネント（バインディングコンポーネント、サービスエンジン）の停止を行うには、「ESB」→

「コンポーネント」→「停止するコンポーネント名」ノードを右クリックして表示される操作の一覧

から「停止」を選択します。選択したコンポーネントを停止する場合は「実行」をクリックします。

【図 1n】「停止するコンポーネント」の選択画面

12

シャットダウン

コンポーネント（バインディングコンポーネント、サービスエンジン）のシャットダウンを行うには、

「ESB」→「コンポーネント」→「シャットダウンするコンポーネント名」ノードを右クリックして表

示される操作の一覧から「シャットダウン」を選択します。選択したコンポーネントを起動する場合

は「実行」をクリックします。

【図 1o】「シャットダウンするコンポーネント」の選択画面

1.1.2.サービスアセンブリの運用

ここでは、WebOTX ESB 実行環境へのサービスアセンブリのインストール/アンインストール、および

ライフサイクル管理を行うための操作について説明します。

配備

サービスアセンブリの配備を行うには、「ESB」→「サービスアセンブリ」ノードを右クリックして表

示される操作の一覧から「サービスアセンブリの配備」を選択します。

【図 2a】「配備するサービスアセンブリ」の選択画面

「サービスアセンブリの配備」を選択して、表示される画面に「ファイルシステム」と「サービスリ

ポジトリ」の二つラジオボタンがあります。

サービスアセンブリファイルの指定 : 「ファイルシステム」とは、ファイルシステムからサービ

スアセンブリファイルを取得します。「サービスリポジトリ」とは、サービスリポジトリからサー

ビスアセンブリファイルを取得します。

13

■ ファイルシステムからサービスアセンブリファイルを取得したい場合、下記の画面に指定し

ます。

画面説明

要素説明

ボタン「参照」クリックすると、「ファイル参照ダイアログ」を開いて、

ファイルを選択できます。

ボタン「次へ(N)」クリックすると、「パラメータ変更」画面に遷移します。

「パラメータ変更」画面は【図2b-4】「配備するサービ

スアセンブリ」のパラメータ変更画面を参照します。

ボタン「配備(D)」ファイルを選択しない場合、

無効化にします。

ファイルを選択した場合、

有効化にし、直接に配備できます。

ボタン「キャンセル(C)」クリックすると、配備中止します。

【図 2b-1】「配備するサービスアセンブリ」のファイルシステムで配備画面

14

■ サービスリポジトリからサービスアセンブリファイルを取得したい場合、「サービスリポジト

リ」ラジオボックスを押します。表示される画面にサービスリポジトリ接続情報を入力してから、「検

索」ボタンを押します。

サービスリポジトリの各フィールドについて説明します。

フィールド名説明

サービス名前サービスリポジトリに格納されたサービスの名前

URL サービスリポジトリの公開したURL

ユーザサービスリポジトリに登録したユーザ

パスワードサービスリポジトリに登録したユーザのパスワード

サービスリポジトリのフィールドの設定例：

URL：HTTP://localhost:80/srep

ユーザ：admin

パスワード：adminadmin

画面説明

要素説明

ボタン「検索」 ①URL、ユーザはいずれか入力しない場合、無効化にします。

②「URL」、「ユーザ」、「パスワード」を入力した後に、「検索」ボ

タンを押すと、【図2b-3】「配備するサービスアセンブリ」のサービ

スアセンブリ検索画面が表示します。

ボタン「前へ(P)」前ページないため、無効化にします。

ボタン「次へ(N)」クリックすると、「パラメータ変更」画面に遷移します。

※：「パラメータ変更」画面は【図2b-4】「配備するサービスアセン

ブリ」のパラメータ変更画面を参照します。

ボタン「配備(D)」サービスアセンブリ名、URL、ユーザはいずれか入力しない場合、

無効化にします。

上記項目を入力した場合、有効化にし、直接に配備できます。

ボタン「キャンセル(C)」クリックすると、配備中止します。

http://localhost/srep

15

【図 2b-2】「配備するサービスアセンブリ」のサービスリポジトリで配備画面

サービスアセンブリ検索：検索条件を設定して、サービスアセンブリを検索します。

画面説明

要素説明

ボタン「検索」クリックすると、検索条件により、サービスアセンブリを検索

します。

条件を満たすサービスアセンブリが検索結果グループに表示さ

れます。

ボタン「OK」初期状態は無効です。

検索結果を一つ選択すると有効になります。

クリックすると、ダイアログを閉じて、配備画面に戻り、選択

したサービスアセンブリを配備画面に表示されます。

ボタン「キャンセル」クリックすると、配備画面に戻ります。

16

【図 2b-3】「配備するサービスアセンブリ」のサービスアセンブリ検索画面

パラメータを変更するには、「パラメータ変更画面」において「FTP-HTTP(サービスアセンブリ)」のよ

うなツリーの「エンドポイント」ノードを押すと、当該エンドポイントの変更可能なパラメータがツ

リー下の属性グループに表示されます。変更可能なパラメータの値を変更して「配備(D)」を押すと、

変更したパラメータを優先させて、サービスアセンブリを配備します。

パラメータを変更する場合、入力値の有効性はご注意ください。

「各コンポーネントの変更できるパラメータ一覧表」を参照します。また、パラメータの変更した値

を無視したい場合、「前へ(P)」を押して、前ページに「配備(D)」ボタンを押すと、サービスアセンブ

リの元の値を保持し、配備します。

17

【図 2b-4】「配備するサービスアセンブリ」のパラメータ変更画面

各コンポーネントの変更できるパラメータ一覧表

Component 要素名備考

入力ファイル格納ディレクトリ ―

出力ファイル格納ディレクトリ ―

処理ディレクトリ ―

File BC

コマンドライン入力必須

ユーザ名入力必須

パスワード入力必須

ホスト入力必須

ポート正整数

インプットのメッセージリポジトリ入力必須

インプットの送信ファイル名 ―

インプットの受信ファイル名 ―

インプットの送信前コマンドのターゲット ―

インプットの送信後コマンドのターゲット ―

インプットの受信前コマンドのターゲット ―

インプットの受信後コマンドのターゲット ―

アウトプットのメッセージリポジトリ入力必須

FTP BC

アウトプットの送信ファイル名 ―

18

アウトプットの受信ファイル名 ―

アウトプットの送信前コマンドのターゲット ―

アウトプットの送信後コマンドのターゲット ―

アウトプットの受信前コマンドのターゲット ―

アウトプットの受信後コマンドのターゲット ―

JCA BC Connection Factory の JNDI 名入力必須

JDBC データソース名 ―

JNDI サーバのアドレス ―

ユーザ名 ―

JDBC BC

パスワード ―

ユーザ名 ― JMS BC

パスワード ―

JNDI サーバのアドレス ―

GSSUP のユーザ名 ―

RMI BC

パスワード ―

外部 HTTP サーバのエンドポイント URL ― HTTP BC

外部に公開するエンドポイント URL ―

CORBA BC 名前サーバのアドレス ―

外部 Web サービスのエンドポイント URL ― SOAP BC

外部に公開するエンドポイント URL ―

配備解除

サービスアセンブリの配備を行うには、「ESB」→「サービスアセンブリ」ノードを右クリックして表

示される操作の一覧から「サービスアセンブリの配備解除」を選択します。

【図 2c】「配備解除するサービスアセンブリ」の選択画面

19

「サービスアセンブリの配備解除」を選択して表示される画面において表示される、以下の設定項目


サービスアセンブリ名 : 配備解除するサービスアセンブリを一覧から選択します。

【図 2d】「配備解除するサービスアセンブリ」の選択画面


サービスアセンブリを起動するには、「ESB」→「サービスアセンブリ」→「起動するサービスアセン

ブリ名」のノードを右クリックして表示される操作の一覧から「起動」を選択します。

20

【図 2e】「起動するサービスアセンブリ」の選択画面

サービスアセンブリの停止を行うには、「ESB」→「サービスアセンブリ」→「停止するサービスアセ

ンブリ名」のノードを右クリックして表示される操作の一覧から「停止」を選択します。

【図 2f】「停止するサービスアセンブリ」の選択画面

サービスアセンブリのシャットダウンを行うには、「ESB」→「サービスアセンブリ」→「シャットダ

ウンするサービスアセンブリ名」のノードを右クリックして表示される操作の一覧から「シャットダ

ウン」を選択します。

21

【図 2g】「シャットダウンするサービスアセンブリ」の選択画面

スタート

サービスアセンブリの開始するには、「ESB」→「コンポーネント」→「開始するサービスアセンブリ

名」ノードを右クリックして表示される操作の一覧から「開始」を選択します。選択したコンポーネ

ントを起動する場合は「実行」をクリックします。

【図 2h】「起動するサービスアセンブリ」の選択画面

ストップ

サービスアセンブリの停止を行うには、「ESB」→「コンポーネント」→「停止するサービスアセンブ

リ名」ノードを右クリックして表示される操作の一覧から「停止」を選択します。選択したコンポー

ネントを起動する場合は「実行」をクリックします。

【図 2i】「停止するサービスアセンブリ」の選択画面

22


サービスアセンブリのシャットダウンを行うには、「ESB」→「コンポーネント」→「シャットダウン

するサービスアセンブリ名」ノードを右クリックして表示される操作の一覧から「シャットダウン」

を選択します。選択したコンポーネントを起動する場合は「実行」をクリックします。

【図 2j】「シャットダウンするサービスアセンブリ」の選択画面

1.1.3.統計情報の管理

WebOTX ESB の実行環境で動作するコンポーネントやサービスアセンブリなどの管理対象に対する統

計情報採取が行えます

【図 3a】統合運用管理ツールの統計情報画面

図のように、WebOTX ESB の実行環境を含むドメインにアクセスすると、画面左側で示されている

管理対象ツリー構成において、「ドメイン（図では domain1）」→「統計情報」ノードの配下に「ESB」

ノードが表示されます。さらにその配下には「コンポーネント」、「サービスユニット」のノードが

表示され、それぞれの配下には実行環境で動作するコンポーネント、サービスユニットを示すノー

ド（モニタリング対象）が表示されます。また、画面右上部には、ツリー上の指定したノード（モ

ニタリング対象）が持つ統計情報が表示されます。

23

1.2.統合運用管理ツール（マルチプロセスモード）

『統合運用管理ツール』を使用すると、WebOTX ESB 実行環境内へのサービスアセンブリの配備/

配備解除といった運用操作を、GUI インタフェースを使用して容易に行うことができるようにな

ります。また、WebOTX ESB の実行環境で動作するコンポーネントやサービスアセンブリなどの

管理対象に対するコンフィグレーション情報の更新やオペレーション実行、統計情報採取などの

管理操作をスムーズに行えるようになります。

『統合運用管理ツール』はオプション製品です。ご利用の際は、『WebOTX

Administrator』を別途ご購入下さい。

1.2.1.アプリケーショングループ、プロセスグループの操作

マルチプロセスモードの場合、ESB は TP システム配下で動作します。TP システムでは、アプリ

ケーショングループ・プロセスグループという単位でプロセスがグルーピングされており、ESB

はプロセスグループの個々のプロセスで動作します。ですから、マルチプロセスモードで ESB を

動作させる場合には事前にアプリケーショングループ・プロセスグループの作成を行っておく必

要があります。

アプリケーショングループ・プロセスグループの詳細については、「提供機能ガイド」を参照して

ください。

この節では、アプリケーショングループ、プロセスグループの操作について説明します。

アプリケーショングループの作成

アプリケーショングループを作成するには次のような操作を行ってください。

(1) TP システムの直下にあるアプリケーショングループノードを選択して右クリックし、「アプリケーシ

ョングループの新規作成」を実行してください。

【図 4a】アプリケーショングループの作成

(2) 次の画面（図 2b）にある基本設定の項目に作成するアプリケーショングループの名前（例：

APG001）を入力してください。

24

【図 4b】アプリケーショングループの作成

(3) 実行に成功すれば（図 4c）、アプリケーショングループノードの直下に新しいアプリケーショング

ループ（例：APG001）が作成されます。起動されていないので、アイコンはピンク（図 4d）になって

います。

【図 4c】アプリケーショングループの作成

【図 4d】アプリケーショングループの作成

25

プロセスグループの作成

プロセスグループを作成するには次のような操作を行ってください。

(1) アプリケーショングループの直下にあるプロセスグループノードを選択して右クリックし、「プ

ロセスグループの新規作成」を実行してください。

【図 4e】プロセスグループの作成

26

(2) 次の画面（図 4f）にある基本設定の項目に作成するプロセスグループの名前（例：PG001）を入力し

てください。モジュールの種類は J2EE を選択してください。

【図 4f】プロセスグループの作成

(3) 実行に成功すれば（図 4g）、プロセスグループノードの直下に新しいプロセスグループ（例：PG001）

が作成されます。起動されていないので、アイコンはピンク（図 4h）になっています。

【図 4g】プロセスグループの作成

27

【図 4h】プロセスグループの作成

プロセスグループの設定

プロセスグループでサービスアセンブリを動作させるために、プロセスグループの起動じに JBI

コンテナを起動させるかどうかの設定を行う必要があります。デフォルトでは、プロセスグルー

プを起動するときに JBI コンテナは起動しません。この設定はプロセスグループが停止している

状態で行う必要があります。

(1) プロセスグループを選択して「ESB」タブを開きます。「ESB JBI コンテナの起動」チェック

ボックスにチェックを入れて更新してください。

【図 4i】プロセスグループの設定

28

【図 4j】プロセスグループの設定

アプリケーショングループの起動

アプリケーショングループを起動するには次のような操作を行ってください。

(1) 起動したいアプリケーショングループを選択して右クリックし、「アプリケーショングループの起動」を

実行してください。起動に成功すれば、アプリケーショングループのアイコンがピンクからグ

リーンに、配下のプロセスグループのアイコンがピンクからグリーンに変わります（図 4m）。

【図 4k】アプリケーショングループの起動

29

【図 4l】アプリケーショングループの起動

【図 4m】アプリケーショングループの起動

アプリケーショングループの停止

アプリケーショングループを起動するには次のような操作を行ってください。

(1) 停止したいアプリケーショングループを選択して右クリックし、「アプリケーショングループの停止」を

実行してください。

30

【図 4n】アプリケーショングループの停止

プロセスグループの起動

プロセスグループを起動するには次のような操作を行ってください。なお、プロセスグループを起動する

ためには、該当プロセスグループの属するアプリケーショングループが起動している必要があり

ます。

(1) 起動したいプロセスグループを選択して右クリックし、「起動」を実行してください。起動に成功すれ

ば、プロセスグループのアイコンがピンクからグリーンに変わります（図 4q）。

【図 4o】プロセスグループの起動

31

【図 4p】プロセスグループの起動

【図 4q】プロセスグループの起動

プロセスグループの停止

プロセスグループを停止するには次のような操作を行ってください。なお、プロセスグループを停止する

ためには、該当プロセスグループの属するアプリケーショングループが起動している必要があり

ます。

(1) 停止したいプロセスグループを選択して右クリックし、「停止」を実行してください。

32

【図 4r】プロセスグループの停止

プロセスグループの削除

プロセスグループを作成するには次のような操作を行ってください。

なお、プロセスグループを削除するには該当プロセスグループの属するアプリケーショングルー

プが停止している必要があります。

(1) プロセスグループを選択して右クリックし、「プロセスグループの削除」を実行してください。

【図 4s】プロセスグループの削除

(2) 削除しようとするプロセスグループを選択してください。該当プロセスグループに配備され

ていたサービスアセンブリも一緒に削除されますので、ご注意ください。

33

【図 4t】プロセスグループの削除

アプリケーショングループの削除

アプリケーショングループを作成するには次のような操作を行ってください。

(1) アプリケーショングループを選択して右クリックし、「アプリケーショングループの削除」を実行し

てください。

【図 4u】アプリケーショングループの削除

34

(2) 削除しようとするアプリケーショングループを選択してください。配下にプロセスグループ

が存在する場合は一緒に削除されます。

【図 4v】アプリケーショングループの削除


プロセスグループの作成・起動が正しく出来たら、サービスアセンブリの操作が出来るようにな

ります。基本的には、マルチプロセスモードでのサービスアセンブリの操作はシングルプロセス

モードでのサービスアセンブリの操作と違いはありません。しかし、配備するときに、配備先を

指定する項目が追加になります。

サービスアセンブリの配備

シングルプロセスモードでの操作と同じ、図 10a に示すように、「ESB」ノードの「サービスアセンブリ」のコ

ンテキストメニューから「サービスアセンブリの配備」を選んで、次の画面（図 5b）で配備先のアプリケーシ

ョングループ名とプロセスグループ名を指定し、「実行」に成功すれば、サービスアセンブリが正しく配備さ

れます（図 5c）。

35

【図 5a】サービスアセンブリの配備

【図 5b】サービスアセンブリの配備

36

【図 5c】サービスアセンブリの配備


サービスアセンブリの起動

マルチプロセスモードのサービスアセンブリの起動はシングルプロセスモードと同じです。サー

ビスアセンブリの配備が完了後、配備されたサービスアセンブリを起動させることができます。

シングルプロセスモードと同じように、ツリーで配備されたサービスアセンブリのコンテキスト

メニューから「起動」項目を選んで、「実行」に成功すれば、サービスアセンブリが起動されます

（図 5e）。サービスアセンブリのアイコンの変更から、サービスアセンブリの実行状態を判断する

ことが出来ます。配備したサービスアセンブリのアイコンにストップマークが付いている場合に

は、サービスアセンブリが停止しているのを表します。

37

【図 5d】サービスアセンブリの起動

【図 5e】サービスアセンブリの起動

サービスアセンブリの停止

シングルプロセスモードと同じく、マルチプロセスモードでサービスアセンブリを停止するには、

図 5f のように、起動状態にあるサービスアセンブリのコンテキストメニューから「停止」を選ん

で、「実行」に成功すれば、該当サービスアセンブリが停止させることができます。

38

【図 5f】サービスアセンブリの停止

【図 5g】サービスアセンブリの停止

39

サービスアセンブリの配備解除

サービスアセンブリを解除するには、ESB の直下にある「サービスアセンブリ」ノードのコンテ

キストメニューから「サービスアセンブリの配備解除」を選んで、「実行」に成功すれば、サービ

スアセンブリの配備が解除されます。

【図 5h】サービスアセンブリの解除

1.2.3.統計機能

『統計情報』ノードの下にある ESB を選んで、ESB のコンポーネントに関する統計情報を監視す

ることができます。各「コンポーネント名」ノードあるいは「モニタサービス」ノードでモニタ

レベルを設定すると、TP システムノード下に ESB の統計ノードが追加されます。

表示される統計情報は該当プロセスグループに属する全部のプロセスの合計になります。

40

【図 6】統計機能

41

2.CUI ツール

2.1.otxadmin コマンド

otxadmin コマンドを使用する方法を説明します。jbiadmin コマンドの記述は login コマンド実行後の

ものです。

2.1.1.otxadmin コマンドの運用

インストール

JBI コンポーネント

install-jbi-component component_ file_path [--echo=true|false]

説明

コマンド install-jbi-component はサービスエンジン、あるいはバインディングコンポーネン

トをインストールします。

オプション

--echo

true を指定すると、標準出力でコマンドライン文が表示されます。既定値は false です。

オペランド

component_ file_path

コンポーネントファイル名.。

--upload オプションが true の場合、ローカルマシン上のインストール可能なファイルへのパ

ス。false の場合はサーバマシンへの絶対パス。

使用例：

例 1: JBI コンポーネントをインストール

soapbinding_rt.jar ファイルにパッケージされた JBI コンポーネントをインストールします。

otxadmin> install-jbi-component soapbinding_rt.jar

Command install-jbi-component executed successfully.

終了ステータス：

0：コマンド実行成功

1：コマンド実行失敗


install-jbi-shared-library library_file_path [--echo=true|false]

説明

コマンド install-jbi-shared-library は JBI 共有ライブラリをインストールします。

オプション

--echo


オペランド

library_file_path

共有ライブラリファイル名。

--upload オプションが true の場合、ローカルマシン上のインストール可能なファイルへのパ

ス。false の場合はサーバマシンへの絶対パス。

使用例：

例 1: JBI 共有ライブラリをインストール

42

wsdlsl.jar ファイルにパッケージされた JBI 共有ライブラリを配備します。

otxadmin> install-jbi-shared-library wsdlsl.jar

Command install-jbi-shared-library executed successfully.






JBI コンポーネントのアンインストールは、コンポーネントを停止、またはシャットダウンして

からアンインストールを行ってください。

uninstall-jbi-component component_name [--echo=true|false]

説明

コマンド uninstall-jbi-component はサービスエンジンあるいはバインディングコンポーネン

トをアンインストールします。

オプション

--echo


オペランド

component_name

JBI コンポーネント名。

使用例：

例 1: JBI コンポーネントをアンインストール

JBI コンポーネント SOAPBinding をアンインストールします。

otxadmin> uninstall-jbi-component SOAPBinding

Command uninstall-jbi-component executed successfully.





共有ライブラリのアンインストールは、削除する共有ライブラリに依存するコンポーネントを

すべてシャットダウンしてから行ってください。

uninstall-jbi-shared-library library_name [--echo=true|false]

説明

コマンド uninstall-jbi-shared-library は JBI 共有ライブラリをアンインストールします。

オプション

--echo


オペランド

library_name

共有ライブラリ名。

使用例：

例 1: JBI 共有ライブラリをアンインストール

JBI 共有ライブラリ WSDLSharedLibrary をアンインストールします。

otxadmin> uninstall-jbi-shared-library WSDLSharedLibrary

Command uninstall-jbi-shared-library executed successfully.


43





スタート

start-jbi-component component_name [--echo=true|false]

説明

コマンド start-jbi-component は指定されたバインディングコンポーネントあるいはサービ

スエンジンを起動します。

オプション

--echo


オペランド

component_name


使用例：

例 1: JBI コンポーネントを起動

JBI コンポーネント FileBinding を起動します。

otxadmin> start-jbi-component FileBinding

Command start-jbi-component executed successfully.




ストップ

stop-jbi-component component_name [--echo=true|false]

説明

コマンド stop-jbi-component は指定されたバインディングコンポーネントあるいはサービス

エンジンを停止します。

オプション

--echo


オペランド

component_name


使用例：

例 1: JBI コンポーネントを停止

JBI コンポーネント FileBinding を停止します。

otxadmin> stop-jbi-component FileBinding

Command stop-jbi-component executed successfully.





shut-down-jbi-component component name [--echo=true|false]

44

説明

コマンド shut-down-jbi-component は指定されたバインディングコンポーネントあるいはサービス

エンジンをシャットダウンします。

オプション

--echo


オペランド

component_name


使用例：

例 1: JBI コンポーネントをシャットダウン

JBI コンポーネント FileBinding をシャットダウンします。

otxadmin> shut-down-jbi-component FileBinding

Command shut-down-jbi-component executed successfully.




サービスアセンブリの運用

配備

配備

deploy-jbi-service-assembly service_assembly_file_path [--echo=true|false] [--view=

terse|normal|verbose] [--modify=true|false]

説明

コマンド deploy-jbi-service-assembly はサービスアセンブリを配備します。

オプション

--echo


--view

出力情報の詳しさを指定します。terse を指定すると簡潔、verbose を指定すると詳細に出力

します。既定値は normal です。

--modify

true の場合、SU のパラメータを変更できます。既定値は false です。

オペランド

service_assembly_file_path

サービスアセンブリファイル名。

--upload オプションが true の場合、ローカルマシン上の配備可能なファイルへのパス。false

の場合はサーバマシンへの絶対パス。

使用例

例 1: SU のパラメータを変更したくない場合のサービスアセンブリを配備

soap2file.zip ファイルにパッケージされたサービスアセンブリを配備します。

otxadmin> deploy-jbi-service-assembly soap2file.zip

サービスアセンブリ soap2file を配備しました。

例 2: SU のパラメータを変更したい場合のサービスアセンブリを配備

jdbcbc_sample_SA.zip ファイルにパッケージされたサービスアセンブリを配備します。

① JBI サービスアセンブリ配備コマンドを実行します。

otxadmin> deploy-jbi-service-assembly --modify=true jdbcbc_sample_SA.zip

下記のようにエンドポインの一覧が表示されます。

45

変更する項目を選択してください：

jdbcbc_sample_SA

|---jdbcbc_sample_SU

1. |---sampleProviderEndpoint

2. |---sampleConsumerEndpoint

(配備を実行: Enter、キャンセル：c)

「説明」

・何も入力しないで Enter キーを押した場合、SA の配備が実行されます。

・有効な数字を入力した場合、「エンドポイント詳細画面」へ行きます。

・無効な数字を入力した場合、同じ画面をもう一度表示します。

② エンドポイント「sampleProviderEndpoint」を表す有効なナンバー「1」を入力すると、下記

のような「エンドポイント詳細画面」が表示されます。変更可能のパラメータには数字が付与

されます。

sampleProviderEndpoint

|---type[JDBCBinding]

|---endpoint-name[sampleProviderEndpoint]

1. |---jndi-name[jdbc/SampleJDBCBC]

(スキップ: Enter)

「説明」

・何も入力しないで Enter キーを押した場合、「エンドポイントリスト画面」に戻ります。

・有効な数字を入力した場合、「エンドポイント情報変更画面」へ行きます。

・無効な数字を入力した場合、同じ画面でもう一度表示します。

③ "1"を入力すると、下記のような「エンドポイント情報変更画面」が出力されて、「jndi-name」

を変更できます。

新しい値を入力してください。(スキップ: Enter)

現在の値: jdbc/SampleJDBCBC

入力 >

「説明」

・何も入力しないで Enter キーを押した場合、値を変更しないで、「エンドポイント詳細画面」

に戻ります。

・有効な値を入力した場合、「エンドポイント詳細画面」に戻り、変更した値を表示します。

・無効な値を入力した場合、エラーメッセージが出て、同じ画面をもう一度表示します。

④ 値の変更を全て終了したら、画面の表示に従って、Enter キーを２度押すことでサービスア

センブリの配備を実行します。

⑤ 配備が成功した場合、下記のようなメッセージが出ます。

サービスアセンブリ jdbcbc_sample_SA を配備しました。




配備解除

配備解除

undeploy-jbi-service-assembly service_assembly_name [--echo=false]

説明

コマンド undeploy-jbi-service-assembly はサービスアセンブリを配備解除します。

オプション

--echo


オペランド

46

service_assembly_name

サービスアセンブリ名

使用例

例 1: サービスアセンブリ SA1 を配備解除

otxadmin> undeploy-jbi-service-assembly SA1

サービスアセンブリ SA1 を配備解除しました。





スタート

start-jbi-service-assembly service_assembly_name [--echo=true|false]

説明

コマンド start-jbi-service-assembly は指定されたサービスアセンブリを起動します。

オプション

--echo


オペランド



使用例

例 1: サービスアセンブリ serviceassembly1 を起動

otxadmin> start-jbi-server-assembly serviceassembly1

サービスアセンブリ serviceassembly1 を起動しました。




ストップ

stop-jbi-service-assembly service_assembly_name [--echo=true|false]

説明

コマンド stop-jbi-service-assembly は指定されたサービスアセンブリを停止します。

オプション

--echo


オペランド



使用例

例 1: サービスアセンブリ SA1 を停止

otxadmin> stop-jbi-server-assembly SA1

サービスアセンブリ SA1 を停止しました。





47

shut-down-jbi-service-assembly service_assembly_name [--echo=true|false]

説明

コマンド shut-down-jbi-service-assembly は指定されたサービスアセンブリをシャットダウ

ンします。

オプション

--echo


オペランド



使用例

例 1: サービスアセンブリ serviceassembly1 をシャットダウン

otxadmin> shut-down-jbi-service-assembly serviceassembly1

サービスアセンブリ serviceassembly1 シャットダウンしました。




情報表示


バインディングコンポーネントの一覧表示

list-jbi-binding-components [--echo=true|false] [--lifecyclestate=shutdown|started|stopped]

[ --view=terse|normal|verbose ]

説明

コマンド list-jbi-binding-components はインストールされたバインディングコンポーネント

を一覧表示します。フィルタが指定されていない場合、全バインディングコンポーネントが表

示されます。

オプション

--echo


--lifecyclestate

一覧表示されるコンポーネントのステータス。指定しない場合は全バインディングコンポー

ネントが表示されます。利用可能な lifecyclestate 値は： o shutdown: shutdown であるバインデ

ィングコンポーネントを表示します。 o started: started であるバインディングコンポーネント

を表示します。 o stopped: stopped であるバインディングコンポーネントを表示します。

--view



使用例：

例 1: バインディングコンポーネントを一覧表示

otxadmin> list-jbi-binding-components

＜表示画面略＞




バインディングコンポーネントの情報の表示

show-jbi-binding-component [--echo=true|false] [--showname binding_component_name]

説明

48

コマンド show-jbi-binding-component はインストールされたバインディングコンポーネント

の情報を取得します。

オプション

--echo


-- showname

一覧表示されたバインディングコンポーネント名。指定しない場合は、全バインディングコ

ンポーネントの情報を表示します。

使用例：

例 1: バインディングコンポーネントの情報表示

otxadmin> show-jbi-binding-component





インストールされたサービスエンジンの一覧表示

list-jbi-service-engines [--echo=true|false] [--lifecyclestate=shutdown|started|stopped]


説明

コマンド list-jbi-service-engines はインストールされたサービスエンジンを一覧表示します。

フィルタが指定されていない場合、全サービスエンジンが表示されます。

オプション

--echo


--lifecyclestate

一覧表示されるサービスエンジンのステータス。指定しない場合は全サービスエンジンが表

示されます。利用可能な lifecyclestate 値は： o shutdown: shutdown であるサービスエンジンを

表示します。 o started: started であるサービスエンジンを表示します。 o stopped: stopped であ

るサービスエンジンを表示します。

--view



使用例：

例 1: サービスエンジンを一覧表示

otxadmin> list-jbi-service-engines





インストールされたサービスエンジンの情報の表示

show-jbi-service-engine [--echo=true|false] [--showname service_engine_name]

説明

コマンド show-jbi-service-engine はインストールされたサービスエンジンの情報を取得しま

す。

オプション

--echo


-- showname

一覧表示されたサービスエンジン名。指定しない場合は、全サービスエンジンの情報を表示

します。

49

使用例：

例 1: サービスエンジンの情報表示

otxadmin> show-jbi-service-engine






インストールされた共有ライブラリの一覧表示

list-jbi-shared-libraries [--echo=true|false] [ --view=terse|normal|verbose ]

説明

コマンド list-jbi-shared-libraries はインストールされた共有ライブラリを一覧表示します。

フィルタが指定されていない場合、全共有ライブラリが表示されます。

オプション

--echo


--view

出力情報の詳しさを指定します。terse を指定すると簡潔、verbose を指定すると詳細に出

力します。既定値は normal です。

使用例：

例 1: 共有ライブラリを一覧表示

otxadmin> list-jbi-shared-libraries





インストールされた共有ライブラリの情報の表示

show-jbi-shared-library [--echo=true|false] [--showname shared_library_name]

説明

コマンド show-jbi-shared-library はインストールされた共有ライブラリの情報を取得します。

オプション

--echo


-- showname

一覧表示された共有ライブラリ名。指定しない場合は、全共有ライブラリの情報を表示しま

す。

使用例：

例 1: 共有ライブラリの情報表示

共有ライブラリ WSDLSharedLibrary の情報を表示します。

otxadmin> show-jbi-shared-library --showname WSDLSharedLibrary

================================

Show Shared Libraries

================================

Name : WSDLSharedLibrary

State : Installed

Description: This is a WSDL shared library.

--------------------------------

コマンド show-jbi-shared-library は正常に実行されました。


50



サービスアセンブリ

配備されたサービスアセンブリの一覧表示

list-jbi-service-assemblies [--echo=true|false] [--componentname component_name]

[--view=terse|normal|verbose]

説明

コマンド list-jbi-service-assemblies は配備されたサービスアセンブリを一覧表示します。

フィルタが指定されていない場合、全サービスアセンブリが表示されます。

オプション

--echo


--componentname

指定のコンポーネントに属するサービスアセンブリを一覧表示します。

--view



使用例：

例 1:コンポーネント HTTPBinding に属するサービスアセンブリを一覧表示

otxadmin> list-jbi-service-assemblies --componentname HTTPBinding

================================

List of Service Assemblies

================================

Name : HTTP_HandlerTest

State: Started

--------------------------------

コマンド list-jbi-service-assemblies は正常に実行されました。




配備されたサービスアセンブリの情報の表示

show-jbi-service-assembly [--echo=true|false] [--showname service_assembly_name]

説明

コマンド show-jbi-service-assembly は配備されたサービスアセンブリの情報を取得しま

す。

オプション

--echo


-- showname

一覧表示されたサービスアセンブリ名。指定しない場合は、全サービスアセンブリの情報

を表示します。

使用例：

例 1: サービスアセンブリの情報表示

otxadmin> show-jbi-service-assembly

================================

Show Service Assemblies

================================

Service Assembly Information

----------------------------


State : Started

Service Units : 2

Description :

51

Service Unit Information

------------------------

Name : consumer_org

State : Started

Deployed On : HTTPBinding

Description :

Name : provider_org

State : Started

Deployed On : HTTPBinding

Description :

--------------------------------

コマンド show-jbi-service-assembly は正常に実行されました。




2.2.jbiadmin コマンドとは

このコマンドは旧互換のために提供されます。運用管理コマンドは otxadmin コマンドに統合されま

した。運用管理コマンド(jbiadmin)は、ESB のエージェント内の MBean に対して要求を実行するため

のコマンドセットを備えています。MBean で提供している全ての操作が、運用管理コマンドで実行

できます。

2.2.1.コマンドの構文

jbiadmin の構文を以下に示します

jbiadmin command -short-option argument --long-option argument operand

コマンド

コマンドとは、実行される操作またはタスクのことです。コマンドには、大文字と小文字の区別が

あります。

オプション

オプションによって、ユーティリティによるコマンドの実行方法を変更できます。アルファベット

の大文字と小文字は区別されます。短形式のオプションの前にはダッシュを 1 つ付けます (-)。長

形式のオプションの前にはダッシュを 2 つ付けます (--)。多くのオプションは、短形式でも長形

式でも使用できます。たとえば、--echo と -e のどちらを使用してもかまいません。オプション

には、必須オプションと省略できるオプションがあります。コマンド構文では、省略できるオプシ

ョンをかっこで囲んで表しています。コマンドの実行時にはすべての必須オプションを指定する必

要があります。指定しないと、エラーメッセージが返され、コマンドは実行されません。

ほとんどのオプションには引数が必要です。たとえば --port には引数 port_number を指定します。

ただし、ブール型のオプションは、機能のオンまたはオフを切り替えるために使用されるため、引

数を必要としません。

ブール型のオプション

ブール型のオプションでは、オンまたはオフを切り替えます。短形式のオプション名を指定すると、

常にデフォルト値の逆の設定になります。

オペランド

オペランドは、空白文字またはタブで区切って指定します。コマンド構文内にどの順番で指定して

もかまいません。オペランドの前に -- を記述すると、オプションとオペランドを区別できます。

その後に続く引数は、ダッシュ (-) で始まるものも含め、すべてオペランドとして扱われます。例

を示します。

> install-component FileBinding.jar

52

構文例

list-shared-libraries [--echo | -e = true|false] [--view | -v = terse|no rmal|verbose] [--componentname =

<name>] [--name | -n = <string>]

省略できるオプションは、かっこで囲まれています。

次に、構文に実際の値を指定した例を示します。この例では、省略できるオプションの一部が指定

されていません。

jbiadmin list-shared-library --user admin --password password –host hostname --port 6212

2.2.2.help コマンド

特定の jbiadmin コマンドのヘルプを表示するには、コマンドプロンプトで --help と入力します。

jbiadmin command --help

ヘルプには、構文、コマンドの説明、構文の説明、使用例、および関連コマンドが表示されます。

コマンド内の任意の位置に--help を指定すると、そのコマンドのヘルプが表示されます。コマンド

は実行されません。

○

2.2.3.出力とエラー

コマンドが正常に実行されると、実行内容を知らせるメッセージが表示されます。コマンドの実行

に失敗すると、エラーメッセージが表示されます。

終了状態の表示

エラーメッセージに加えて、jbiadmin コマンドの終了時には、常に終了状態が返されます。終了状

態は、コマンドの実行が成功した場合は 0、失敗した場合は 1 になります。

UNIX の終了状態

コマンドプロンプトで echo $? と入力することにより、終了状態をチェックできます。

スクリプトでも終了コードを使用できます。たとえば、次のシェルスクリプトは、終了状態を使用

して list-shared-libraries コマンドが成功であるか失敗であるかを示します。

#!/bin/sh

/opt/WebOTX/bin/jbiadmin list-shared-libraries –-user admin –-password adminadmin

if [ $? = 0 ]

then

echo "success"

else

echo "error"

fi

Windows の終了状態

Windows では、独自の .bat スクリプトを使って終了状態をチェックできます。成功するスクリプ

トとその出力、および失敗するスクリプトとその出力を、次に示します。

成功するスクリプト

myscript.bat

53

@echo off

echo Processing Command

call jbiadmin.bat list-shared-libraries --user admin --password password

if not %errorlevel% EQU 0 goto end

echo Command ‘Successful

goto program-end

:end

echo Command Failed

:program-end

出力

================================

List of Shared Libraries

================================

Name : WSDLSharedLibrary

State: Installed

--------------------------------

失敗するスクリプト (componentname 指定なし)

myscript.bat

@echo off

echo Processing Command

call jbiadmin.bat uninstall-component --user admin --password password

if not %errorlevel% EQU 0 goto end

echo Command ‘Successful

goto program-end

:end

echo Command Failed

:program-end

出力

Missing a required parameter

Usage: uninstall-component <component name> [--echo=false]

使用法の表示

引数を指定せずにコマンドを実行すると、コマンドの構文を示すエラーメッセージが表示されま

す。次に例を示します。

> uninstall-component

Missing a required parameter

Usage: uninstall-component <component name> [--echo=false]

2.2.4.セキュリティに関する注意事項

コマンド行からコマンド行インタフェースを実行する場合は、すべてのコマンドにパスワードが必

要になります。マルチモードで実行する場合は、初の環境設定時にパスワードを入力します。マ

ルチモードをいったん終了して、もう一度開始するときは、再び環境設定を行い、パスワードを入

力します。パスワードの設定には、環境コマンドを使います。

54

コマンド行でパスワードを入力しないために、パスワードファイルを設定しておくこともできま

す。有効なユーザ名およびパスワードの認証情報がなければ、コマンドは実行されません。

2.3.jbiadmin コマンド

jbiadmin コマンドの起動方法について説明します。

jbiadmin コマンドは以下にあります。

${INSTANCE_ROOT}/jbi/bin/jbiadmin

jbiadmin コマンドの起動

${INSTANCE_ROOT}/jbi/bin/jbiadmin --user admin_user --password admin_password [ --host

host_name] [--port port_number]

オプション

--user

インスタンスにかかわる管理ユーザ

--password

管理ユーザの管理用パスワード

--host

管理インスタンスを集めているマシンのホスト名

--port

管理ホストと接続する管理ポート番号(既定値：6212)

2.3.1.コンポーネントの運用

インストール


install-component component_jar_filename [--echo=true|false]

説明

引数で指定したコンポーネントのインストールを行います。

オプション

--echo


オペランド

component_jar_filename

コンポーネントファイル名

使用例：

> install-component FileBinding.jar

Installed Component FileBinding





install-shared-library library_jar_filename [--echo=true|false]

説明

引数で指定した共有ライブラリのインストールを行います。

オプション

55

--echo


オペランド

library_jar_filename

共有ライブラリファイル名

使用例：

> install-shared-library WSDLSharedLibrary

Installed Shared Library WSDLSharedLibrary






JBI コンポーネントのアンインストールは、コンポーネントを停止、またはシャットダウンして

からアンインストールを行ってください。

uninstall-component component_name [--echo=true|false]

説明

引数で指定したコンポーネントのアンインストールを行います。

オプション

--echo


オペランド

component_name

コンポーネント名

使用例：

> uninstall-component FileBinding

Uninstalled Component FileBinding





共有ライブラリのアンインストールは、削除する共有ライブラリに依存するコンポーネントを

すべてシャットダウンしてから行ってください。

uninstall-shared-library library_name [--echo=true|false]

説明

引数で指定した共有ライブラリのアンインストールを行います。

オプション

--echo


オペランド

library_name

共有ライブラリ名

使用例：

> uninstall-shared-library WSDLSharedLibrary

Uninstalled Shared Library WSDLSharedLibrary

56






スタート

start-component component_name [--echo=true|false]

説明

引数で指定したコンポーネントを開始します。

オプション

--echo


オペランド

component_name


使用例：

> start-component FileBinding

Started Component FileBinding




ストップ

stop-component component_name [--echo=true|false]

説明

引数で指定したコンポーネントを停止します。

オプション

--echo


オペランド

component_name


使用例：

> stop-component FileBinding

Stopped Component FileBinding





shut-down-component component name [--echo=true|false]

説明

引数で指定したコンポーネントをシャットダウンします。

57

オプション

--echo


オペランド

component_name


使用例：

> shut-down-component FileBinding

Shut Down Component FileBinding





配備

配備

deploy-service-assembly service_assembly_filename [--echo=true|false] [--view=

terse|normal|verbose] [--modify=true|false]

説明

引数で指定したサービスアセンブリを配備します。

オプション

--echo


--view

出力データの粒度を決定します。terse を指定すると簡潔、verbose を指定すると詳細に出力


--modify

true の場合、SU のパラメータを変更できます。既定値は false です。

オペランド

service_assembly_filename

サービスアセンブリファイル名

使用例

例 1: SU のパラメータを変更したくない場合のサービスアセンブリを配備

soap2file.zip ファイルにパッケージされたサービスアセンブリを配備します。

> deploy-service-assembly soap2file.zip

サービスアセンブリ soap2file は成功に配備されました。

例 2: SU のパラメータを変更したい場合のサービスアセンブリを配備

jdbcbc_sample_SA.zip ファイルにパッケージされたサービスアセンブリを配備します。

① サービスアセンブリ配備コマンドを実行します。

deploy-service-assembly --modify=true jdbcbc_sample_SA.zip

下記のようにエンドポインの一覧が表示されます。

変更する項目を選択してください：

jdbcbc_sample_SA

|---jdbcbc_sample_SU

1. |---sampleProviderEndpoint

2. |---sampleConsumerEndpoint

(配備を実行: Enter、キャンセル：c)

「説明」

・何も入力しないで Enter キーを押した場合、SA の配備が実行されます。

58

・有効な数字を入力した場合、「エンドポイント詳細画面」へ行きます。

・無効な数字を入力した場合、同じ画面をもう一度表示します。

② エンドポイント「sampleProviderEndpoint」を表す有効なナンバー「1」を入力すると、下記

のような「エンドポイント詳細画面」が表示されます。変更可能のパラメータには数字が付与

されます。

sampleProviderEndpoint

|---type[JDBCBinding]

|---endpoint-name[sampleProviderEndpoint]

1. |---jndi-name[jdbc/SampleJDBCBC]

(スキップ: Enter)

「説明」

・何も入力しないで Enter キーを押した場合、「エンドポイントリスト画面」に戻ります。

・有効な数字を入力した場合、「エンドポイント情報変更画面」へ行きます。

・無効な数字を入力した場合、同じ画面でもう一度表示します。

③ "1"を入力すると、下記のような「エンドポイント情報変更画面」が出力されて、「jndi-name」

を変更できます。

新しい値を入力してください。(スキップ: Enter)

現在の値: jdbc/SampleJDBCBC

入力 >

「説明」

・何も入力しないで Enter キーを押した場合、値を変更しないで、「エンドポイント詳細画面」

に戻ります。

・有効な値を入力した場合、「エンドポイント詳細画面」に戻り、変更した値を表示します。

・無効な値を入力した場合、エラーメッセージが出て、同じ画面をもう一度表示します。

④ 値の変更を全て終了したら、画面の表示に従って、Enter キーを２度押すことでサービスア

センブリの配備を実行します。

⑤ 配備が成功した場合、下記のようなメッセージが出ます。

サービスアセンブリ jdbcbc_sample_SA を配備しました。




配備解除

配備解除

undeploy-service-assembly service_assembly_name [--echo=false]

説明

引数で指定したサービスアセンブリを配備解除します。

オプション

--echo


オペランド



使用例

> undeploy-service-assembly ServiceAssembly_0427_02_saId

Undeployed Service Assembly ServiceAssembly_0427_02_saId

59





スタート

start-service-assembly service_assembly_name [--echo=true|false]

説明

引数で指定したサービスアセンブリを開始します。

オプション

--echo


オペランド



使用例

> start-service-assembly ServiceAssembly_0427_02_saId

Started Service Assembly ServiceAssembly_0427_02_saId




ストップ

stop-service-assembly service_assembly_name [--echo=true|false]

説明

引数で指定したサービスアセンブリを停止します。

オプション

--echo


オペランド



使用例

> stop-service-assembly ServiceAssembly_0427_02_saId

Stopped Service Assembly ServiceAssembly_0427_02_saId





shut-down-service-assembly service_assembly_name [--echo=true|false]

説明

引数で指定したサービスアセンブリをシャットダウンします。

オプション

--echo


オペランド

60



使用例

> shut-down-service-assembly ServiceAssembly_0427_02_saId

Shut Down Service Assembly ServiceAssembly_0427_02_saId




2.3.3.情報表示


バインディングコンポーネントの一覧表示

list-binding-components [--echo=true|false] [--state=shutdown|started|stopped]


説明

コマンド list-binding-components はインストールされたバインディングコンポーネント

を一覧表示します。フィルタが指定されていない場合、全バインディングコンポーネントが

表示されます。

オプション

--echo


--state

一覧表示されるコンポーネントのステータス。指定しない場合は全バインディングコンポ

ーネントが表示されます。利用可能な state 値は： o shutdown: shutdown であるバインディ

ングコンポーネントを表示します。 o started: started であるバインディングコンポーネント

を表示します。 o stopped: stopped であるバインディングコンポーネントを表示します。

--view



使用例：

例 1: バインディングコンポーネントを一覧表示

全てのバインディングコンポーネントを一覧表示します。

otxadmin> list-binding-components





インストールされたサービスエンジンの一覧表示

list-service-engines [--echo=true|false] [--state=shutdown|started|stopped]


説明

コマンド list-service-engines はインストールされたサービスエンジンを一覧表示します。フィ

ルタが指定されていない場合、全サービスエンジンが表示されます。

オプション

--echo


--state

一覧表示されるサービスエンジンのステータス。指定しない場合は全サービスエンジンが表示

されます。利用可能な state 値は： o shutdown: shutdown であるサービスエンジンを表示します。

61

o started: started であるサービスエンジンを表示します。 o stopped: stopped であるサービスエ

ンジンを表示します。

--view

出力情報の詳しさを指定します。terse を指定すると簡潔、verbose を指定すると詳細に出力し

ます。既定値は normal です。

使用例：

例 1: サービスエンジンを一覧表示

全てのサービスエンジンを一覧表示します。

otxadmin> list-service-engines






インストールされた共有ライブラリの一覧表示

list-shared-libraries [--echo=true|false] [ --view=terse|normal|verbose ]

説明

コマンド list-shared-libraries はインストールされた共有ライブラリを一覧表示します。フ

ィルタが指定されていない場合、全共有ライブラリが表示されます。

オプション

--echo


--view



使用例：

例 1: 共有ライブラリを一覧表示

全ての共有ライブラリを一覧表示します。

otxadmin> list-jbi-shared-libraries





サービスアセンブリ

配備されたサービスアセンブリの一覧表示

list-service-assemblies [--echo=true|false] [--componentname component_name]

[--view=terse|normal|verbose]

説明

コマンド list-service-assemblies は配備されたサービスアセンブリを一覧表示します。フ

ィルタが指定されていない場合、全サービスアセンブリが表示されます。

オプション

--echo


--componentname

指定のコンポーネントに属するサービスアセンブリを一覧表示します。

--view



62

使用例：

例 1: サービスアセンブリを一覧表示

コンポーネント HTTPBinding に属するサービスアセンブリを一覧表示します。

otxadmin> list-service-assemblies --componentname HTTPBinding

================================

List of Service Assemblies

================================


State: Started

--------------------------------

コマンド list-jbi-service-assemblies は正常に実行されました。




2.3.4.設定変更

各コンポーネント共通の設定項目について説明します。各コンポーネント固有の設定については 3

章を参照してください。

モニタレベル

モニタレベルは[OFF,LOW,HIGH]があります。デフォルトでは LOW に設定されています

モニタレベルの変更方法について説明します。モニタレベルの変更は otxadmin set コマンド、モニ

タレベルの確認は otxadmin get コマンドを利用します。set、get コマンドの利用方法は、WebOTX

マニュアルの[運用コマンドリファレンス]-[1.運用管理エージェント運用管理コマンド

(otxadmin)]-[set(get)]を参照してください。以下のコマンドの記述は login コマンドを実行後のもので

す。

モニタレベルの変更方法

モニタレベルの変更方法について説明します。現在のモニタレベルの確認方法は以下のコマン

ドを実行してください以下の例は、FileBinding コンポーネントのモニタレベルの確認方法です。

コンポーネント名は適宜変更してください。

・現在のモニタレベルの確認

get server.jbi.components.FileBinding.MonitoringLevel

server.jbi.components.FileBinding.MonitoringLevel = LOW

・モニタレベルの変更

モニタレベルを LOW から HIGH に変更します。

set server.jbi.components.FileBinding.MonitoringLevel=HIGH

server.jbi.components.FileBinding.MonitoringLevel = HIGH

ログレベル

コンポーネントのログレベルには[ALL,TRACE,DETAIL,DEBUG,CONFIG,INFO,WARN,ERROR,OFF]があ

ります。デフォルトでは CONFIG に設定されています。

ログレベルの変更方法について説明します。モニタレベルの変更は otxadmin set コマンド、モニタ

レベルの確認は otxadmin get コマンドを利用します。set、get コマンドの利用方法は、WebOTX マ

ニュアルの[運用コマンドリファレンス]-[1.運用管理エージェント運用管理コマンド

(otxadmin)]-[set(get)]を参照してください。以下のコマンドの記述は login コマンドを実行後のもので

す。

ログレベルの変更方法

モニタレベルの変更方法について説明します。現在のモニタレベルの確認方法は以下のコマン

ドを実行してください以下の例は、FileBinding コンポーネントのモニタレベルの確認方法です。

コンポーネント名は適宜変更してください。

・現在のログレベルの確認

get server.jbi.components.FileBinding.LogLevel

63

server.jbi.components.FileBinding.LogLevel = DEBUG

・ログレベルの変更

ログレベルを INFO から DEBUG に変更します。

set server.jbi.components.FileBinding.LogLevel=DEBUG

server.jbi.components.FileBinding.LogLevel = DEBUG

64

3.コンフィグレーション

WebOTX ESB に関する設定項目について説明します。

属性値の取得・設定を行なうには次の方法があります。

運用管理ツールより設定

運用管理コマンド(otxadmin)により設定

運用管理ツール、運用管理コマンドの操作方法については、WebOTX マニュアル「運用編運用管

理ツール」を参照してください。

WebOTX 共通のシステム設項目定については、WebOTX マニュアル「運用編（コンフィグレーシ

ョン）」を参照してください。

設定項目に関する詳細は、WebOTX マニュアル「運用編 MO 定義リファレンス」を参照してくだ

さい。

3.1.ドメインに関する設定

システムに関する設定項目について説明します。

3.1.1.システム環境変数

WebOTX ESB では動作環境についての情報を環境変数や Java システムプロパティとして保持し

ています。以下にその一覧を示します。

システムプロパティ名説明既定値

com.nec.webotx.jbi.home JBI フレームワ

ークがインストー

ルされているパ

ス

${com.nec.webotx.installRoot}${file.separator}jbi

com.nec.webotx.jbi.domain.root JBI フレームワ

ークを利用する

ドメインのルート

ディレクトリ

${com.nec.webotx.instanceRoot}

3.1.2.JBI フレームワークライフサイクルモジュールの設定

JBI フレームワークは、ドメインのライフサイクルモジュールの一つとして動作しています。

デフォルトインストール時はドメインが生成されると自動的に JBI フレームワークのライフサイ

クルモジュールが有効になります。JBI フレームワークライフサイクルモジュールの設定により

ドメイン起動時の有効・無効を設定することも可能です。

Dotted-name：server.applications.lifecycle-module.JBIFramework

属性名(attribute-name)

説明既定値

サービス起動設定

(enabled)

ドメイン起動時のサービス起動の可否を指定 true

3.2.システムサービスに関する設定

JBI フレームワークのシステムサービスで提供している属性の設定方法について説明します。属

性は MO の属性として提供しています。

管理サービス

コンフィグレーションサービス

65

配備サービス

インストールサービス

ログサービス

メッセージサービス

モニタリングサービス

Standard/Enterprise 版でマルチプロセスモードを使用する場合には、下記のシステム

サービスに関する設定は全てのプロセスグループに有効になります。

3.2.1.管理サービス

Dotted-name：server.jbi.system-services.AdminService


説明既定値

ログレベル

(LogLevel)

このサービスに対するログのレベルを設定し

ます。

CONFIG

オート機能のポーリング

間隔

(HeartBeatInterval)

オートインストール、オートデプロイのポーリ

ング間隔(秒)を 5～3600 の値で設定します。

5

スプール対象のディレク

トリ

(AutoDeploySpoolDirectory)

オートデプロイのスプール機能の対象となる

ディレクトリ名を設定します。

3.2.2.コンフィグレーションサービス

Dotted-name：server.jbi.system-services.ConfigurationService


説明既定値

ログレベル

(LogLevel)


ます。

CONFIG

3.2.3.配備サービス

Dotted-name：server.jbi.system-services.DeploymentService


説明既定値

ログレベル (LogLevel)


ます。

CONFIG

3.2.4.インストールサービス

Dotted-name：server.jbi.system-services.InstallationService


説明既定値

ログレベル

(LogLevel)


ます。

CONFIG

3.2.5.ログサービス

Dotted-name：server.jbi.system-services.LoggingService


説明既定値

管理サービスログレベル

(AdminServiceLevel)

管理サービスに対するログのレベルを設定し

ます。

CONFIG

コンフィグサービスログ

レベル

(ConfigurationServiceLevel)

コンフィグサービスに対するログのレベルを

設定します。

CONFIG

配備サービスログレベル

(DeploymentServiceLevel)

配備サービスに対するログのレベルを設定し

ます。

CONFIG

66

インストールサービスロ

グレベル

(InstallationServiceLevel)

インストールサービスに対するログのレベル

を設定します。

CONFIG

ログサービスログレベル

(LoggingServiceLevel)

ログサービスに対するログのレベルを設定し

ます。

CONFIG

メッセージサービスログ

レベル

(MessageServiceLevel)

メッセージサービスに対するログのレベルを

設定します。

CONFIG

モニタリングサービスロ

グレベル

(MonitoringServiceLevel)

モニタリングサービスに対するログのレベル


CONFIG

コンポーネント（全体）の

ログレベル

(ComponentLevel)

コンポーネント（全体）のサービスに対するロ

グのレベルを設定します。

CONFIG

3.2.6.メッセージサービス

Dotted-name：server.jbi.system-services.MessageService


説明既定値

ログレベル

(LogLevel)


ます。

INFO

閉塞処理の有効／無効

(MessageBlockingEnable)

メッセージ閉塞を有効とするかどうかを設定

します。

true

閉塞処理の待ち合わせ時

間[0-2147483647]

(MessageBlockWaitTime)

各コンポーネントの閉塞処理待ち合わせ時間

を設定します。0を設定した場合は制限なしと

なります。(単位：秒)

60

3.2.7.モニタリングサービス

Dotted-name：server.jbi.system-services.MonitoringService


説明既定値

ログレベル

(LogLevel)


ます。

INFO

コンポーネント（全体）の

モニタリングレベル

(ComponentLevel)

コンポーネント（全体）のモニタリングレベル


INFO

3.3.各コンポーネントに関する設定

各コンポーネントで提供している属性の設定方法について説明します。属性は MO の属性として

提供しています。

シーケンシング SE

XSLT SE

SOAP BC

JMS BC

File BC

JCA BC

RMI BC

CBR SE

CORBA BC

JDBC BC

FTP BC

HTTP BC

UserProcessor SE

67

Standard/Enterprise 版でマルチプロセスモードを使用する場合には、下記の各コンポ

ーネントに関する設定は全てのプロセスグループにあるコンポーネントに有効にな

ります。

3.3.1.Sequencing SE

Dotted-name：server.jbi.components.SequencingEngine


説明既定値

ログレベル

(LogLevel)

このコンポーネントに対するログのレベルを

設定します。

CONFIG

モニタレベル

(MonitoringLevel)

このコンポーネントに対するモニタレベルを

設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)

メッセージを処理するスレッド数の大値を

設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)

メッセージを処理するスレッド数の小値を

設定します。

2

スレッド解放までの時間

[0-2147483647]

(ReleaseWaitTime)

小スレッド数を超えて生成されたスレッド

が解放されるまでの時間を設定します。（単

位：秒）。

15

3.3.2.XSLT SE

Dotted-name：server.jbi.components.XSLTEngine


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

メモリ上での実行の可否

(ProcessInMemory)

メモリ上での実行の可否を設定します。 true

3.3.3.SOAP BC

Dotted-name：server.jbi.components.SOAPBinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]


設定します。

2

68

(MinThreads)


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

HTTP プロキシ構成の詳細

要求の有無

(HttpProxyRequired)

HTTP プロキシ構成の詳細要求の有無を設定し

ます。

false

HTTP プロキシのホスト名

(HttpProxyHost)

HTTP プロキシのホスト名を指定します。

HTTP プロキシのポート番

号

(HttpProxyPort)

HTTP プロキシのポート番号を設定します。

HTTP プロキシの例外アド

レス

(HttpNonProxyHosts)

ここで設定したアドレスにはHTTPプロキシを

使用しません。複数のアドレスを設定するには

カンマ(,)で区切ります。

HTTP プロキシのユーザ名

(HttpProxyUser)

HTTP プロキシのユーザ名を指定します。

HTTP プロキシのパスワー

ド

(HttpProxyPassword)

HTTP プロキシのパスワードを指定します。

SSL時にHTTPのプロキシ

を使用する

(SSLProxyRequired)

SSL プロキシ構成の詳細要求の有無を指定し

ます。

false

SSL プロキシのホスト名

(SSLProxyHost)

SSL プロキシのホスト名を設定します。

SSL プロキシのポート番

号

(SSLProxyPort)

SSL プロキシのポート番号を設定します。

SSL プロキシの例外アド

レス

(SSLNonProxyHosts)

ここで設定したアドレスには SSL プロキシを



SSL プロキシのユーザ名

(SSLProxyUser)

SSL プロキシのユーザ名を設定します。

SSL プロキシのパスワー

ド

(SSLProxyPassword)

SSL プロキシのパスワードを設定します。

3.3.4.JMS BC

Dotted-name：server.jbi.components.JMSBinding

属性名(attribute-name) 説明既定値

ログレベル

(LogLevel)

このコンポーネントに対するログ

のレベルを設定します。

CONFIG

モニタレベル

(MonitoringLevel)

このコンポーネントに対するモニ

タレベルを設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)

メッセージを処理するスレッド数

の大値を設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)

メッセージを処理するスレッド数

の小値を設定します。

4


[0-2147483647]

(ReleaseThreadWaitTime)

小スレッド数を超えて生成され

たスレッドが解放されるまでの時

間を設定します。（単位：秒）。

15

プロバイダ URL

(ProviderUrl)

JNDI サーバのプロバイダ URL を設

定します。

ポート番号を指定する場合は、以下

のように記述します。

corbaname://localhost:2809

corbaname://localhost

69

共通応答用送信先

(ReceiverDestination)

共通応答用送信先の JMS リソース

に定義した JNDI 名を設定します。

共通応答用送信先を利用する場合、

この送信先に関する物理的送信先

とその JMS リソースはサービスア

センブリを配備する前に必ず作成

しておく必要があります。

jms/JMSBCReplyQueue

共通応答用コネクションファ

クトリ

(ReceiverFactory)

共通応答用コネクションの JMS リ

ソースに定義した JNDI 名を設定し

ます。

共通応答用送信先を利用する場合、

このコネクションファクトリに関

する JMS リソースはサービスアセ

ンブリを配備する前に必ず作成し

ておく必要があります。

jms/JMSBCReplyQueu

eConnectionFactory

共通応答用コネクションのユ

ーザ

(ReceiverConnectionUser)

共通応答用コネクションで使用す

るユーザを設定します。

guest

共通応答用コネクションのパ

スワード

(ReceiverConnectionPassword)

共通応答用コネクションで使用す

るパスワードを設定します。

guest

3.3.5.File BC

Dotted-name：server.jbi.components.FileBinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

3.3.6.JCA BC

Dotted-name：server.jbi.components.JCABinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

70

3.3.7.RMI BC

Dotted-name：server.jbi.components.RMIBinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]




位：秒）。

15

JNDI サーバと接続するた

めの URL

(JndiProviderUrl)

JNDI サーバと接続するための corbaloc /

corbaname URL を設定します。指定を省略した場

合、ドメイン内の JNDI サーバに接続します。

なし

JNDI サーバの Factory ク

ラス名

(JndiContextFactory)

JNDI サーバの Factory クラス名を設定します。

変更する必要はありません。

なし

CORBA のリクエストタイ

ムアウト値

(CorbaRequestTimeout)

CORBA のリクエストタイムアウト値（単位：

秒）を設定します。指定を省略した場合、ドメ

インの Object Broker コンフィグの設定値を使

用します。設定できる値は、0 ～ 2147483 です。

0

CORBA のリファレンスの

キャッシュ有無

(CacheCorbaReference)

CORBA のリファレンスのキャッシュ有無。呼び出

し先の EJB が名前サーバのラウンドロビン機能を

使用する場合には false を設定してください。

true

レルム名

(RealmName)

EJB 呼び出しの認証情報を管理するレルム名を

設定します。デフォルトのレルム以外を使用する

場合に設定してください。

なし

Remote インタフェースクラスのクラスパスへの追加

EJBアプリケーションのRemoteインタフェースクラスをクラスパスに追加するためには、RMI BC

をシャットダウンした状態で、Remote インタフェースクラス、または、Remote インタフェース

クラスを含む jar ファイルを次のいずれかのディレクトリに格納してください。

<INSTANCE_ROOT>/jbi/bindings/RMIBinding/install_root/workspace/classes

<INSTANCE_ROOT>/jbi/bindings/RMIBinding/install_root/workspace/lib

上記のディレクトリに格納されたクラスは、RMI BC をシャットダウン状態から開始した際にクラスパスに

追加されます。

または、サービスユニット作成時に、META-INF フォルダの classes や lib フォルダに、Remote インタフェ

ースクラスや Remote インタフェースクラスを含む jar ファイルを含めてください。

配備された EJB アプリケーションは、次のディレクトリに展開されます。その中に、Remote インタフェース

クラスと Remote インタフェースクラスを含む Client.jar ファイルが含まれています。

<INSTANCE_ROOT>/applications/j2ee-apps/アプリケーション名

71

RMI BC で EJB の認証のために使用するレルムの変更 RMI BC で使用するレルムを変更するためには、RMIBinding MO のレルム属性か Artifact の realm-name

にレルム名を指定してください。または、次のセキュリティサービスのデフォルトレルムの設定を使用する

レルム名に変更してください。

Dotted-name：server.security-service


説明既定値

デフォルトレルム

(default-realm)

デフォルトのレルム名を設定します。 file

ただし、このデフォルトレルムの設定は、EJB コンテナや JMS といった他の機能でも利用されていますの

で、変更にあたっては、ユーザ定義漏れがないようにご注意ください。詳細については、WebOTX のマニ

ュアル「運用編」の「ユーザ管理」を参照してください。

3.3.8.CBR SE

Dotted-name：server.jbi.components.CBREngine

属性名説明

ログレベルこのコンポーネントに対するログのレベルを設定します。（既定

値：CONFIG）

モニタレベルこのコンポーネントに対するモニタレベルを設定します。（既定

値：OFF）

大スレッド数

[1-2147483647] メッセージを処理するスレッド数の大値を設定します。（既定

値：15）

小スレッド数

[1-2147483647] メッセージを処理するスレッド数の小値を設定します。（既定

値：2）


[0-2147483647] 小スレッド数を超えて生成されたスレッドが解放されるまで

の時間を設定します。（単位：秒、既定値：15）。

3.3.9.CORBA BC

Dotted-name：server.jbi.components.CORBABinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]




位：秒）。

15

名前サーバと接続するた

めの URL

(NameServerUrl)

名前サーバと接続するための corbaloc /

corbaname URL を設定します。指定を省略した場

合、ドメイン内の名前サーバに接続します。

なし

72

CORBA のリクエストタイ

ムアウト値

(CorbaRequestTimeout)

CORBA のリクエストタイムアウト値（単位：

秒）を設定します。0 を指定した場合、ドメイン

の Object Broker コンフィグの設定値を使用し

ます。設定できる値は、0 ～ 2147483 です。

0

CORBA のリファレンスの

キャッシュ有無

(CacheCorbaReference)

CORBA のリファレンスをキャッシュするかどうかを

設定します。呼び出し先の CORBA アプリケーショ

ンが名前サーバのラウンドロビン機能を使用する

場合には false を設定してください。

true

スタブクラスのクラスパスへの追加

スタブクラスをクラスパスに追加するためには、CORBA BC をシャットダウンした状態で、スタ

ブクラス、または、スタブクラスを含む jar ファイルを次のいずれかのディレクトリに格納してく

ださい。

<INSTANCE_ROOT>/jbi/bindings/CORBABinding/install_root/workspace/classes

<INSTANCE_ROOT>/jbi/bindings/CORBABinding/install_root/workspace/lib

上記のディレクトリに格納されたクラスは、CORBA BC をシャットダウン状態から開始した際にクラスパス

に追加されます。

または、サービスユニット作成時に、META-INF フォルダの classes や lib フォルダに、スタブク

ラスやスタブクラスを含む jar ファイルを含めてください。

IDL コンパイラを実行して出来たファイルのうち必要となるスタブクラスの詳細は「アプリケーション開発ガ

イド」-「７章 CORBA」-「7.1.4.4. クライアントアプリケーションの作成方法(Java)」を参照してください。

3.3.10.JDBC BC

Dotted-name：server.jbi.components.JDBCBinding


説明既定値

ログレベル

(LogLevel)

このコンポーネントに対するログのレ

ベルを設定します。

CONFIG

モニタレベル

(MonitoringLevel)

このコンポーネントに対するモニタレ

ベルを設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)

メッセージを処理するスレッド数の

大値を設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)

メッセージを処理するスレッド数の

小値を設定します。

2


[0-2147483647]


小スレッド数を超えて生成されたス

レッドが解放されるまでの時間を設定

します。（単位：秒）。

15

JNDI サーバと接続するための

URL ( JndiProviderUrl)

JNDI サーバと接続するための

corbaloc/corbaname URL を設定します。

指定を省略した場合、ドメイン内の JNDI サ

ーバに接続します。

指定なし

JNDI サーバの Factory クラス

名( JndiContextFactory )

JNDI サーバの Factory クラス名を設定しま

す。

指定なし

JDBC データソースのキ

ャッシュ有無

(CacheJDBCDataSource)

JDBC データソースをメッセージ処理毎に

取得するかどうかを設定します。処理毎に

取得する場合は false を設定します。

true

クエリ実行タイムアウト値

[0-2147483647]

(QueryTimeout)

JDBC ドライバが Statement オブジェクト

の実行を待つ時間（単位：秒）を設定しま

す。エンドポイント情報として設定された値

が優先されます。

指定なし

73

データ有無の監視間隔

[0-9223372036854775807]

(PollMilliseconds)

監視対象テーブルの監視間隔（単位：ミリ

秒）を設定します。

10,000

クエリのレコード上限数

[0-2147483647]

(NumberOfRecords)

select 実行時のレコードの取得上限値を

設定します。設定しない場合、抽出したす

べてのレコードを対象とします。

指定なし

JDBC ドライバのクラスパス登録

JDBC BC から SQL を実行するためには、各データベースに接続可能な JDBC ドライバを利用する

必要があります。目的のデータベースに合わせて各ベンダーが提供している JDBC ドライバか、

または、サードパーティにより提供されている JDBC ドライバを準備して、それらの jar ファイル

を<INSTANCE_ROOT>/lib もしくは<INSTANCE_ROOT>/lib/ext ディレクトリ配下に格納して利用し

てください。クラスパスの詳細については、WebOTX のマニュアル「運用編」の「3.運用と操作」の「ドメ

インの運用」の「クラスパスの設定」を参照してください。また、JDBC データソースの定義の詳細について

は、WebOTX のマニュアル「運用編」の「コンフィグレーション」の「JDBC データソースに関する設定」を参

照してください。

3.3.11.FTP BC

Dotted-name：server.jbi.components.FTPBinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

アウトバウンドのスレッ

ド数

アウトバウンドで起動させるスレッド数を指

定します。

10

レスポンスの待機タイム

アウト（ms）

外部アプリのレスポンスを待つタイムアウト

（ms）を指定します。

300000

アーカイブメッセージ保

存期間（日数）

PreReceive と PostReceive のコマンドによりア

ーカイブされたメッセージを保存する期間（日

数）を指定します。0 と設定される場合にロー

テートしません。

10

FTP のプロキシを使う FTP のプロキシを使って FTP サーバへ接続す

るかを指定します。

False

FTP プロキシサーバの

URL

FTP プロキシサーバの URL を指定します。

socks5://localhost:1080 のように指定してくだ

さい。

socks5://

localhost:1080

PASVモードを有効にする FTP サーバとの間でデータを転送する時に、

PASV モードを使うかどうかを指定します。

True

FTP プロキシのユーザ ID FTP プロキシのユーザ ID を指定します。 -

FTP プロキシのパスワー

ド

FTP プロキシのパスワードを指定します。 -

3.3.12.HTTP BC

74

Dotted-name：server.jbi.components.HTTPBinding


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

大スレッド数

[1-2147483647]

(MaxThreads)


設定します。

10

小スレッド数

[1-2147483647]

(MinThreads)


設定します。

2


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

HTTP プロキシ構成の詳細

要求の有無

(HttpProxyRequired)

HTTP プロキシ構成の詳細要求の有無を設定し

ます。

false

HTTP プロキシのホスト名

(HttpProxyHost)

HTTP プロキシのホスト名を指定します。 -

HTTP プロキシのポート番

号

(HttpProxyPort)

HTTP プロキシのポート番号を設定します。 -

HTTP プロキシの例外アド

レス

(HttpNonProxyHosts)

ここで設定したアドレスにはHTTPプロキシを



-

HTTP プロキシのユーザ名

(HttpProxyUser)

HTTP プロキシのユーザ名を指定します。 -

HTTP プロキシのパスワー

ド

(HttpProxyPassword)

HTTP プロキシのパスワードを指定します。 -

SSL プロキシ構成の詳細

要求の有無

(SSLProxyRequired)

SSL プロキシ構成の詳細要求の有無を指定し

ます。

false

SSL プロキシのホスト名

(SSLProxyHost)

SSL プロキシのホスト名を設定します。 -

SSL プロキシのポート番

号

(SSLProxyPort)

SSL プロキシのポート番号を設定します。 -

SSL プロキシの例外アド

レス

(SSLNonProxyHosts)

ここで設定したアドレスには SSL プロキシを



-

SSL プロキシのユーザ名

(SSLProxyUser)

SSL プロキシのユーザ名を設定します。 -

SSL プロキシのパスワー

ド

(SSLProxyPassword)

SSL プロキシのパスワードを設定します。 -

3.3.13.UserProcessor SE

Dotted-name：server.jbi.components.UserProcessorEngine


説明既定値

ログレベル

(LogLevel)


設定します。

CONFIG

モニタレベル

(MonitoringLevel)


設定します。

OFF

75

大スレッド数

[1-2147483647]

(MessagePoolMax)


設定します。

10

小スレッド数

[1-2147483647]

(MessagePoolMin)


設定します。

2


[0-2147483647]

(ReleaseWaitTime)



位：秒）。

15

76

4.モニタリング

本章では、WebOTX ESB にて採取可能なパフォーマンス情報について説明します。

モニタリング設定はモジュール単位で設定することができます。以下にモニタリングを提供して

いるモジュールの一覧を示します。運用管理ツール、otxadmin コマンドでモニタリングレベルを

設定することができます。設定方法は、2.2.3 節を参照してください。

モジュール既定値説明

FileBinding OFF File BC に関する統計情報

OFF もしくは LOW もしくは HIGH を設定する

JCABinding OFF JCA BC 関する統計情報


JMSBinding OFF JMS BC に関する統計情報


RMIBinding OFF RMI BC に関する統計情報


SOAPBinding OFF SOAP BC に関する統計情報


SequencingEngine OFF シーケンシング SE に関する統計情報


XSLTEngine OFF XSLT SE に関する統計情報


CORBABinding OFF CORBA BC に関する統計情報


JDBCBinding OFF JDBC BC に関する統計情報


UserProcessorEngine OFF UserProcessor SE に関する統計情報


なお、以降の説明文中で示されている記号の意味は次の通りです。

<SERVICE_UNIT> : (任意の)サービスユニット名

<ENDPOINT> : (任意の)エンドポイント名

4.1.シーケンシング SE

Sequencing SE Component Statistics Information Dotted-name：server.jbi.components.SequencingEngine

名称型概要モニタレベル

CallCount-Count long メッセージを処理した回数の現在

値（回） LOW, HIGH

FailedCallCount-Count long メッセージ処理中にエラーが発生

した回数の現在値(回) LOW, HIGH

MessageNow-Current long 処理中メッセージ数の現在値(回) LOW, HIGH

Sequencing SE Endpoint Statistics Information Dotted-name：server.jbi.components.SequencingEngine.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>


77

MessageIn-Count long 入力メッセージの累積数の現在値

(回) HIGH

MessageInRate-Count long 秒あたりに処理した入力メッセー

ジの現在値（回/秒） HIGH

MessageOut-Count long 出力メッセージの累積数の現在値

(回) HIGH

MessageOutRate-Count long 秒あたりに処理した出力メッセー


MessageByteIn-Count long 入力メッセージの累積バイト数の

現在値（byte) HIGH

MessageByteInRate-Count long

１秒あたりに処理した入力メッセ

ージのバイト数の現在値（byte／

秒）

HIGH

MessageByteOut-Count long 出力メッセージの累積バイト数の

現在値(byte) HIGH

MessageByteOutRate-Count long 秒あたりに処理した出力メッセー

ジのバイト数の現在値(byte/秒) HIGH

MessageSucceeded-Count long 処理に成功したメッセージ累積数

の現在値(回) HIGH

MessageFailed-Count long 処理に失敗したメッセージ累積数


MessageFailedRate-Count long 失敗したメッセージの比率の現在

値(％) HIGH

4.2.XSLT SE

XLST SE Component Statistics Information Dotted-name：server.jbi.components.XLSTEngine






MessageNow-Count long 処理中メッセージ数の現在値(回) LOW, HIGH

MessageByteNow-Count long 処理中メッセージのバイト数の現

在値(byte) LOW, HIGH

XSLT SE Endpoint Statistics Information Dotted-name：server.jbi.components.XSLTEngine.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH





MessageByteInRate-Count long 秒あたりに処理した入力メッセー




MessageByteOutRate-Count long 秒あたりに処理した出力メッセー HIGH

78

ジのバイト数の現在値(byte/秒)






値(％) HIGH

4.3.SOAP BC

SOAP BC Component Statistics Information Dotted-name：server.jbi.components.SOAPBinding






MaxCallTime-Count long メッセージ処理時間の大値(ミリ

秒) LOW, HIGH

MinCallTime-Count long メッセージ処理時間の小値(ミリ

秒) LOW, HIGH

TotalCallTime-Count long メッセージ処理時間の合計(ミリ秒) LOW, HIGH

SOAP BC Endpoint Statistics Information Dotted-name：server.jbi.components.SOAPBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH
















値(％) HIGH

4.4.JMS BC

JMS BC Component Statistics Information Dotted-name：server.jbi.components.JMSBinding


79

Message-Count long メッセージ受付累積数の現在値 LOW, HIGH

MessageNow-Count long 処理中メッセージ数の現在値 LOW, HIGH

MessagePeak-Count long メッセージピーク数の現在値 LOW, HIGH

MessageComplete-Count long メッセージ完了数の現在値 LOW, HIGH

MessageLost-Count long ロストしたメッセージ数の現在

値 LOW, HIGH

MessageTimeout-Count long タイムアウトしたメッセージ数

の現在値 LOW, HIGH

MessageFailed-Count Long メッセージ処理中にエラーが発

生した回数の現在値 LOW, HIGH

MessagesIn-Count long Inbound メッセージ受付累積数


MessagesInNow-Count long 処理中 Inbound メッセージ数の

現在値 LOW, HIGH

MessagesInPeak-Count long Inbound メッセージピーク数の

現在値 LOW, HIGH

MessagesInComplete-Count long Inbound メッセージ完了数の現

在値 LOW, HIGH

MessagesInLost-Count long ロストした Inbound メッセージ

数の現在値 LOW, HIGH

MessagesInTimeout-Count long タイムアウトした Inbound メッ

セージ数の現在値 LOW, HIGH

MessageInFailed-Count Long メッセージ処理中に Inbound エ

ラーが発生した回数の現在値 LOW, HIGH

MessagesOut-Count long Outbound メッセージ受付累積

数の現在値 LOW, HIGH

MessagesOutNow-Count long 処理中 Outbound メッセージ数


MessagesOutPeak-Count long Outbound メッセージピーク数


MessagesOutComplete-Count long Outbound メッセージ完了数の

現在値 LOW, HIGH

MessagesOutLost-Count long ロストした Outbound メッセー

ジ数の現在値 LOW, HIGH

MessagesOutTimeout-Count long タイムアウトした Outbound メ

ッセージ数の現在値 LOW, HIGH

JMS BC Endpoint Statistics Information Dotted-name：server.jbi.components.JMSBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH









MessageByteOutRate-Count long 秒あたりに処理した入力メッセー HIGH

80

ジのバイト数の現在値(byte/秒)






値(％) HIGH

4.5.File BC

File BC Component Statistics Information Dotted-name：server.jbi.components.FileBinding









File BC Endpoint Statistics Information Dotted-name：server.jbi.components.FileBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH









MessageByteOutRate-Count long 秒あたりに処理した入力メッセー







値(％) HIGH

4.6.JCA BC

JCA BC Component Statistics Information Dotted-name：server.jbi.components.JCABinding




81






JCA BC Endpoint Statistics Information Dotted-name：server.jbi.components.JCABinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH
















値(％) HIGH

4.7.RMI BC

RMI BC Component Statistics Information Dotted-name：server.jbi.components.RMIBinding









RMI BC Endpoint Statistics Information Dotted-name：server.jbi.components.RMIBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH



82


(回) HIGH
















値(％) HIGH

これらの統計情報は、RMI BC のモニタリングレベルが LOW または HIGH の場合に収集されます。

モニタリングレベルのデフォルト値は OFF ですので、統計情報を採取する場合は、モニタリング

レベルを変更してください。

4.8.CBR SE

CBR SE Component Statistics Information Dotted-name：server.jbi.components.CBREngine


CallCount long メッセージを処理した回数の現在値（回） LOW, HIGH

FailedCallCount long メッセージ処理中にエラーが発生した回数

の現在値(回) LOW, HIGH

AverageCallTime long メッセージ処理時間の平均値（ミリ秒） LOW, HIGH

MaxCallTime long メッセージ処理時間の大値 LOW, HIGH

MinCallTime long メッセージ処理時間の小値（ミリ秒） LOW, HIGH

CBR SE Endpoint Statistics Information Dotted-name：server.jbi.components.CBREngine.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH









83








値(％) HIGH

4.9.CORBA BC

CORBA BC Component Statistics Information Dotted-name：server.jbi.components.CORBABinding









CORBA BC Endpoint Statistics Information Dotted-name：server.jbi.components.CORBABinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH
















値(％) HIGH

これらの統計情報は、CORBA BC のモニタリングレベルが LOW または HIGH の場合に収集されま

す。モニタリングレベルのデフォルト値は OFF ですので、統計情報を採取する場合は、モニタリ

ングレベルを変更してください。

4.10.JDBC BC

84

JDBC BC Component Statistics Information Dotted-name：server.jbi.components.JDBCBinding









JDBC BC Endpoint Statistics Information Dotted-name：server.jbi.components.JDBCBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH
















値(％) HIGH

これらの統計情報は、JDBC BC のモニタリングレベルが LOW または HIGH の場合に収集されます。



4.11.FTP BC

FTP BC Component Statistics Information Dotted-name：server.jbi.components.FTPBinding


CallCount long メッセージを処理した回数の現在


FailedCallCount long メッセージ処理中にエラーが発生





85

FTP BC Endpoint Statistics Information Dotted-name：server.jbi.components.FTPBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH
















値(％) HIGH

これらの統計情報は、FTP BC のモニタリングレベルが LOW または HIGH の場合に収集されます。



4.12.HTTP BC

HTTP BC Component Statistics Information Dotted-name：server.jbi.components.HTTPBinding






MaxCallTime-Count long メッセージ処理時間の大値(ミリ

秒) LOW, HIGH

MinCallTime-Count long メッセージ処理時間の小値(ミリ

秒) LOW, HIGH

TotalCallTime-Count long メッセージ処理時間の合計(ミリ秒) LOW, HIGH

HTTP BC Endpoint Statistics Information Dotted-name：server.jbi.components.HTTPBinding.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH

MessageOutRate-Count long 秒あたりに処理した出力メッセー HIGH

86

ジの現在値（回/秒）














値(％) HIGH

4.13.UserProcessor SE

UserProcessor SE Component Statistics Information Dotted-name：server.jbi.components.UserProcessorEngine









UserProcessor SE Endpoint Statistics Information Dotted-name：server.jbi.components.UserProcessorEngine.service-units.<SERVICE_UNIT>.endpoints.<ENDPOINT>



(回) HIGH




(回) HIGH
















値(％) HIGH

webotx enterprise service bus - nec(japan)3 3.3.3. soap bc.....67 4 1.guiツール...

Documents