| ドキュメントのダウンロード | サイトマップ | 用語集 | |
|
|||
| bea ホーム | 製品 | dev2dev | support | askBEA |
|
|
|
|||||||
 |
| e-docs > Tuxedo > Jolt > BEA Jolt システムの設定 |
|
Jolt
|
BEA Jolt システムの設定
この章では、BEA Jolt の設定方法を説明します。Jolt を既に使用したことがある場合は簡易設定をご覧ください。それ以外の節では、さらに詳しい内容を説明しています。この章は、BEA Jolt のインストール先のオペレーティング・システムやワークステーション・プラットフォームでの作業を経験したことのあるシステム管理者またはアプリケーション開発者を対象としています。
ここでは、次の内容について説明します。
簡易設定
BEA Jolt および BEA Tuxedo を既に使用したことがある場合は、この簡易設定で説明する、BEA Jolt のコンフィギュレーション方法に関するガイドラインを参照してください。Jolt を初めて使用する場合は、Jolt に関する背景情報を読んでから設定を始めてください。
簡易設定では、Jolt サーバ・リスナ (JSL) を BEA Tuxedo に設定するために必要な次の手順を説明します。
UBBCONFIG ファイルを編集する
注記 MAXWSCLIENTS が設定されていないと、JSL は起動しません。
Jolt リポジトリを設定する
Groups セクションの設定
Servers セクションの設定
BEA Jolt リポジトリ・サーバ (JREPSVR) には、リポジトリにアクセスしたり、リポジトリを編集するためのサービスが格納されています。JREPSVR インスタンスが複数ある場合は、共有ファイルにより、リポジトリの情報が共有されます。UBBCONFIG ファイルの SERVERS セクションには、JREPSVR を指定してください。
BEA Tuxedo およびリポジトリ・エディタを使用するサービスを初期化する
BEA Tuxedo および BEA Jolt を使用する BEA Tuxedo サービスを定義し、クライアントが Jolt サービスを利用できるようにします。
リポジトリ・エディタを使用する
リポジトリ・エディタを起動する前に、必要な BEA Jolt ソフトウェアがすべてインストールされているかどうかを確認してください。
注記 JREPSVR と JSL が実行されていないと、リポジトリ・エディタは使用できません。
リポジトリ・エディタを使用するには、次の手順に従います。
Java Applet Viewer を使用してリポジトリ・エディタを起動する
appletviewer full-pathname/RE.html
Web ブラウザを使用してリポジトリ・エディタを起動する
次のいずれかの方法を使用して、Web ブラウザからリポジトリ・エディタを起動してください。
ローカル・ファイルからリポジトリ・エディタを起動する場合
Web サーバからリポジトリ・エディタを起動する場合
http://www.server/URL path/RE.html
リポジトリ・エディタにログオンする
Jolt リポジトリ・エディタを起動したら、以下の手順に従ってログオンします。
注記 ログオンする前に、BEA Jolt リポジトリ・エディタの [Logon] ウィンドウが表示されている必要があります。この画面が表示されたことを確認してから以下の手順に進んでください。
次のリポジトリ・エディタの [Logon] ウィンドウの説明,では、このウィンドウにあるフィールドとボタンについて説明します。
リポジトリ・エディタの [Logon] ウィンドウの説明
表 3-1 リポジトリ・エディタの [Logon] ウィンドウの説明
リポジトリ・エディタを終了する パッケージ、サービス、およびパラメータの追加、編集、テスト、削除が完了したらリポジトリ・エディタを終了します。終了する前に、BEA Jolt リポジトリ・エディタを終了する前の [Logon] ウィンドウに示すようなウィンドウが表示されます。 図 3-2 BEA Jolt リポジトリ・エディタを終了する前の [Logon] ウィンドウ
使用できるのは、[Packages]、[Services]、および [Log Off] のみです。文字入力フィールドは利用できません。 リポジトリ・エディタを終了するには、以下の手順に従います。
.
イベント・サブスクリプション用に BEA Tuxedo の TMUSREVT サーバを設定する
Jolt のイベント・サブスクリプション機能では、BEA Tuxedo サービスまたは別の BEA Tuxedo クライアントからイベント通知を受信します。BEA Tuxedo の TMUSREVT サーバを設定し、アプリケーションの UBBCONFIG ファイルを編集してください。次のUBBCONFIG ファイル内の TMUSREVT パラメータ,は、UBBCONFIG ファイル内の TMUSREVT パラメータを示しています。
コード リスト3-1 UBBCONFIG ファイル内の TMUSREVT パラメータ UBBCONFIG ファイルの SERVERS セクションで、SRVGRP と SRVID を指定してください。 Jolt リレーを設定する UNIX の場合 システム・プロンプトで次のコマンドを入力し、UNIX での JRLY プロセスを開始します。 コンフィギュレーション・ファイルが存在しないか開けない場合、JRLY は標準エラーにメッセージを書き込み、起動時のエラーをエラー・ログに記録してから終了します。 UNIX および Windows 2000 の場合
TMUSREVT SRVGRP=EVBGRP1 SRVID=40 GRACE=3600
ENVFILE="/usr/tuxedo/bankapp/TMUSREVT.ENV"
CLOPT="-e tmusrevt.out -o tmusrevt.out -A --
-f /usr/tuxedo/bankapp/tmusrevt.dat"
SEQUENCE=11jrly -f <config_file_path>
コンフィギュレーション・ファイルは、「タグ=値」の形式で記述されています。空白行または「#」で始まる行は無視されます。次の正式なコンフィギュレーション・ファイルの形式,の例を参照してください。
コード リスト3-2 正式なコンフィギュレーション・ファイルの形式
LOGDIR=<LOG_DIRECTORY_PATH>
ACCESS_LOG=<ACCESS_FILE_NAME in LOGDIR>
ERROR_LOG=<ERROR_FILE_NAME in LOGDIR>
LISTEN=<IP:Port combination where JRLY will accept comma-separated connections>
CONNECT=<IP:Port1, IP:Port2...IP:PortN:Port(List of IP:Port combinations associated with JRADs:can be 1...N)>
Windows 2000 のみの場合 (省略可能)
SOCKETTIMEOUT は、JRLY の Windows 2000 サービスが、ネットワーク・アクティビティ (新しい接続、読み込み対象のデータ、クローズされた接続など) を実現するためにソケット接続をブロックする期間を示す時間 (秒単位) を指定します。SOCKETTIMEOUT の値はサービス・コントロール・マネージャ (SCM: Service Control Manager) にも影響します。サービス・コントロール・マネージャは、Windows 2000 サービスの停止を要求する場合には少なくとも SOCKETTIMEOUT で指定した秒数を待つ必要があります。
注記 ディレクトリ名とファイル名の形式は、オペレーティング・システムによって異なります。UNIX システムではスラッシュ (/) を使用します。Windows 2000 システムでは円記号 (¥) を使用します。LOGDIR、ACCESS_LOG、または ERROR_LOG で指定されたファイルを開けない場合、JRLY は stderr にエラー・メッセージを記録してから終了します。
次の表は、ホスト名とポート番号の形式を示しています。
|
ホスト名/ポート番号 |
説明 |
|
//Hostname:Port |
Hostname は文字列で指定し、Port は 10 進数で指定します。 |
|
IP:Port |
IP にはドット区切りの IP アドレスを指定し、Port には 10 進数値を指定します。 |
Jolt リレー・アダプタ (JRAD: Jolt Relay Adapter) を起動する
Jolt リレー・アダプタを設定する
1 つの JRLY に接続できる JRAD プロセスは 1 つだけです。JRAD は、1 つの JSL および関連する JSH とだけ通信するように設定できます。複数の JRAD を 1 つの JSL と通信するように設定することもできます。UBBCONFIG ファイルには、BEA Tuxedo サービス用の CLOPT パラメータを含める必要があります。
Jolt に関する背景情報
この節では、Jolt コンポーネントに関するその他の情報を説明します。
Jolt サーバ
Jolt サーバは、1 つまたは複数のハンドラを扱うリスナです。
Jolt サーバ・リスナ (JSL: Jolt Server Listener)−JSL は、IP/ポートの組み合わせで設定し、クライアントをサポートします。JSL は、Jolt サーバ・ハンドラ (JSH: Jolt Server Handler) と動作して、クライアントが BEA Jolt システムのバックエンドへ接続できるようにします。JSL は BEA Tuxedo サーバとして実行されます。
Jolt サーバ・ハンドラ (JSH: Jolt Server Handler)−Tuxedo サーバ・マシンで実行されるプログラム。リモート・クライアント用のネットワーク接続ポイントを提供します。JSH は、JSLと動作し、クライアントが BEA Jolt システムのバックエンドに接続できるようにします。JSL に対し、最大 32,767 までの JSH を利用できます。詳細については、JSL のコマンド行オプションの -M コマンド行オプションの説明を参照してください。
システム管理者の作業−システム管理者は、BEA Jolt のサーバ・コンポーネントに関して、以下の作業を行う必要があります。
JSL を起動する
UBBCONFIG ファイルにあるすべての管理プロセスとサーバ・プロセスを開始するには、次の手順に従います。
tmloadcf と tmboot については、『BEA Tuxedo アプリケーション実行時の管理』 または 『BEA Tuxedo コマンド・リファレンス』 を参照してください。
JSL をシャットダウンする
Jolt サーバに対してシャットダウンを要求するには、BEA Tuxedo の次のコマンドを入力します。
tmshutdown -y
シャットダウン中には次の制約があります。
JSL を再起動する
BEA Tuxedo は JSL を監視し、障害が発生した場合は JSL を再起動します。BEA Tuxedo がリスナ・プロセスを再起動すると、次のイベントが発生します。
JSL を設定する
JSL は、Jolt から JSH へ接続要求を分散する BEA Tuxedo サーバです。BEA Tuxedo は、JSL と JREPSVR が置かれているホスト・マシンで実行されていなければなりません。
注記 JSH に対する JSL のポートの選択方法は、BEA Tuxedo ワークステーション・リスナ (WSL: Workstation Server Listener) の場合のプロセスとは異なります。JSL ポートを正しく設定する方法については、 3-46 ページの「UBBCONFIG ファイルを作成する」 の「SERVERS セクション」を参照してください。
JSL のコマンド行オプション
サーバ側では、コマンド行からの情報の取得が必要な場合があります。CLOPT パラメータを使用すると、コマンド行オプションを指定して、サーバに設定されたデフォルト値を変更することができます。次の表では、JSL のコマンド行オプションを説明します。
セキュリティ機能と暗号化 認証データと鍵暗号データは、Diffie-Hellman (DH) 方式の鍵暗号機能で暗号化され、Jolt クライアントと JSL/JSH の間で送受信されます。以降のすべての鍵暗号は、RC4 形式で暗号化されます。国際版のパッケージでは、DES 形式の鍵暗号と 128 ビットの暗号化キーを使用します。128 ビットのうち、40 ビットが暗号化され、88 ビットがエクスポーズされます。 128 ビットの暗号化を使ったプログラムは、米国政府の正式な承認なく米国以外の国へ輸出することはできません。社内のイントラネットが米国以外の国にも拡張されており、海外にも社内クライアントがいる場合は、この暗号化を使用することはできません。
Jolt リレー
Jolt リレー (JRLY) と Jolt リレー・アダプタ (JRAD) 間の動作を、通常インターネット・リレーと呼びます。Jolt リレーは、Jolt クライアントから JSL や JSH にメッセージをルーティングします。これにより、JSH と BEA Tuxedo を、(安全性に問題があると見なされている) Web サーバと同じマシンで実行する必要がなくなります。Jolt リレーは、Jolt インターネット・リレーで示すように 2 つのコンポーネントで構成されています。
注記 Jolt リレーは、Jolt クライアントおよび Jolt サーバからは見えません。Jolt サーバは、複数のイントラネット・クライアントに同時に直接接続したり、Jolt リレーを介してインターネット・クライアントに接続できます。
図 3-3 Jolt インターネット・リレー
この図では、ブラウザから Web サーバ・ソフトウェアに接続し、BEA Jolt アプレットをダウンロードする様子を示しています。まず、Jolt のアプレットまたはクライアントは、Web サーバ・マシン上の JRLY に接続します。次に、JRLY は、ファイアウォールを越えて Jolt メッセージを JRAD に転送します。さらに、JRAD はメッセージを JSL または適切な JSH に転送します。 Jolt リレーのフェイルオーバー JRLY のフェイルオーバーには、次の 2 つがあります。
Jolt クライアントから JRLY への接続時に発生するフェイルオーバー
1 つのサーバ・アドレスがセッションで失敗すると、フェイルオーバー機能がはたらきます。この機能により、Jolt クライアントの API は、次に接続可能な (まだ接続されていない) JRLY を API の引数一覧から検索して接続します。Windows 2000 環境でこのフェイルオーバー機能を有効にするには、複数の Windows 2000 JRLY サービスを実行します。Windows 2000 以外の環境では、JRLY プロセスが複数実行されています。各 JRLY (サービスまたはプロセス) には、固有のコンフィギュレーション・ファイルが用意されています。この種のフェイルオーバー処理は、BEA Jolt のクライアント API 機能により行われ、ユーザは Jolt サーバ・アドレス (JSL または JRLY) の一覧を指定することができます。
JRLY から JRAD アダプタへの接続時に発生するフェイルオーバー
各 JRLY のコンフィギュレーション・ファイルには、JRAD アドレスの一覧が用意されています。JRAD が利用できない場合、JRLY は次に利用可能な (接続されていない) JRAD をラウンド・ロビン方式で検索して接続しようとします。2 つの JRLY から同じ JRAD に接続することはできません。これらの条件を利用し、JRAD アドレスの順序を変えて効率的に接続を確立することができます。つまり、予備の JRAD を待機させておき、JRLY から JRAD への最初の接続が切断されたら、予備の JRAD に接続されるようにします。この種のフェイルオーバー処理は、JRLY のみで行われます。
JRLY の起動時に一覧内の JRAD がどれも実行されていない場合、最初の接続は失敗します。Jolt クライアントが JRLY に接続しようとすると、JRLY は、再び JRAD に接続しようとします。
フェイルオーバー機能を有効にするには、UBBCONFIG ファイルで JRAD を設定し、複数の JRAD を起動する必要があります。
Jolt リレーのプロセス
JRLY (フロントエンド・リレー) のプロセスは、JRAD の起動前または起動後のどちらかの時点で始まります。JRLY の起動時に JRAD が利用できない場合、JRLY はクライアントからの要求を受信する時点で JRAD に接続を試みます。クライアントからの要求受信時にも JRAD に接続できない場合、クライアントはアクセスを拒否され、JRLY のエラー・ログ・ファイルに警告メッセージが書き込まれます。
UNIX で JRLY を起動する
システム・プロンプトで次のコマンドを入力し、JRLY プロセスを開始します。
jrly -f config_file_path
コンフィギュレーション・ファイルが存在しないか、または開けない場合、JRLY はエラー・メッセージを出力します。
JRLY を起動できない場合、JRLY は標準エラーにメッセージを書き込み、起動時のエラーをエラー・ログに記録してから終了します。
JRLY コマンド行オプション (Windows 2000)
この節では、JRLY.exe の Windows 2000 バージョンで利用できるコマンド行オプションについて説明します。次のような制限事項があります。
JRLY のコマンド行オプションを次の表で詳しく説明します。
JRLY コマンド行オプション (UNIX)
UNIX 用の JRLY のコマンド行オプションは、次の 1 つだけです。
JRLY コンフィギュレーション・ファイル
コンフィギュレーション・ファイルは、「タグ=値」の形式で記述されています。空白行または「#」で始まる行は無視されます。次のリストは、正式なコンフィギュレーション・ファイルの形式を示しています。
コード リスト3-3 コンフィギュレーション・ファイルの内容
LOGDIR=<LOG_DIRECTORY_PATH>
ACCESS_LOG=<ACCESS_FILE_NAME in LOGDIR>
ERROR_LOG=<ERROR_FILE_NAME in LOGDIR>
LISTEN=<IP:Port combination where JRLY will accept connections>
CONNECT=<IP:Port combination associated with JRAD>
SOCKETTIMEOUT=<Seconds for socket accept()function>
注記 SOCKETTIMEOUT は、リレー Windows 2000 サービスがネットワーク・アクティビティ (新しい接続、読み込み対象のデータ、クローズされた接続など) を実現するために、新しいソケット接続の確立をブロックする期間を示す時間 (秒単位) です。これは、Windows 2000 マシンでのみ有効です。SOCKETTIMEOUT の値は、SCM にも影響します。SCM からサービスの停止が要求されると、SCM は少なくとも SOCKETTIMEOUT で指定した秒数を待つ必要があります。
次のリストは、JRLY のコンフィギュレーション・ファイルの例です。CONNECT で始まる行は、JRAD マシンの IP アドレスとポート番号を指定します。
コード リスト3-4 JRLY コンフィギュレーション・ファイルの例
LOGDIR=/usr/log/relay
ACCESS_LOG=access_log
ERROR_LOG=errorlog
# jrly will listen on port 4444
LISTEN=200.100.10.100:4444
CONNECT=machine1:port1
CONNECT=machine2:port2
SOCKETTIMEOUT=30 //リストの下のテキストを参照
ディレクトリ名とファイル名の形式は、オペレーティング・システムによって異なります。UNIX システムではスラッシュ (/) を使用します。Windows 2000 システムでは円記号 (¥) を使用します。LOGDIR、ACCESS_LOG、またはERROR_LOG で指定されたファイルを開けない場合、JRLY はstderr にエラー・メッセージを記録してから終了します。
次の表は、ホスト名とポート番号の形式を示しています。
Jolt リレー・アダプタ
Jolt リレー・サーバ・アダプタ (バックエンド・リレー) は、BEA Tuxedo システム・サーバです。Jolt リレー・アダプタ (JRAD) の配置場所は、JSL サーバの接続先である BEA Tuxedo のホスト・マシン (シングル・ホスト・モード (SHM)) およびサーバ・グループでなくてもかまいません。
JRAD は、関連する JRLY とは独立して起動できます。JRAD は、起動およびシャットダウンのアクティビティを BEA Tuxedo ログ・ファイルからトラッキングします。
JRAD の設定
1 つの JRLY に接続できる JRAD プロセスは 1 つだけです。JRAD は、1 つの JSL および関連する JSH とだけ通信するように設定できます。複数の JRAD を 1 つの JSL と通信するように設定することもできます。UBBCONFIG ファイルには、BEA Tuxedo サーバ用の CLOPT パラメータを含める必要があります。UBBCONFIG ファイル内の JRAD エントリの例 のコンフィギュレーション・ファイルの例を参照してください。
次の表では、CLOPT パラメータに関する追加情報を示します。
JRAD CLOPT パラメータのアドレスは、次のいずれかの形式で指定できます。
//hostname:port
0x0002pppphhhhhhhh
pppp はポート番号、hhhhhhhh は 16 進数の IP アドレスを示します。
コード リスト3-5 UBBCONFIG ファイル内の JRAD エントリの例
# JRAD host 200.100.100.10 listens at port 2000, connects to JSL port 8000 on the same host
JRAD SRVGRP=JSLGRP SRVID=60
CLOPT="-A -- -l 0x000207D0C864640A -c 0x00021f40C864640A"
ネットワーク・アドレスの設定
Jolt インターネット・リレーを設定するには、ネットワーク接続されたいくつかのコンポーネントを動作させる必要があります。設定を行う前に次の表に示す条件を確認し、情報を書き留め、間違った設定を行わないようにしてください。
Jolt リポジトリ
Jolt リポジトリには、BEA Tuxedo サービスの定義が格納されています。この定義情報により、Jolt クライアントは BEA Tuxedo サービスにアクセスすることができます。インストール時にダウンロードされる Jolt リポジトリのファイル群には、BEA Jolt で内部的に使用されるサービス定義が含まれています。アプリケーション・サービスに定義を追加する方法の詳細については、Jolt リポジトリ・エディタを使うを参照してください。
Jolt リポジトリを設定する
BEA Jolt リポジトリを設定するには、アプリケーションの UBBCONFIG ファイルを編集してください。UBBCONFIG ファイルは、ASCII 形式の BEA Tuxedo コンフィギュレーション・ファイルです。アプリケーションごとに別の UBBCONFIG ファイルを作成してください。ファイル内のエントリの構文については、『BEA Tuxedo コマンド・リファレンス』を参照してください。次のリストは、UBBCONFIG ファイルの一部を示しています。
コード リスト3-6 UBBCONFIG ファイルの例
*GROUPS
JREPGRP GRPNO=94 LMID=SITE1
*SERVERS
JREPSVR SRVGRP=JREPGRP SRVID=98
RESTART=Y GRACE=0 CLOPT="-A -- -W -P /app/jrepository"
JREPSVR SRVGRP=JREPGRP SRVID=97
RESTART=Y RQADDR=JREPQ GRACE=0 CLOPT="-A -- -P /app/jrepository"
JREPSVR SRVGRP=JREPGRP SRVID=96
RESTART=Y RQADDR=JREPQ REPLYQ=Y GRACE=0 CLOPT="-A -- -P /app/jrepository"
注記 UNIX システムで jrepository ファイルのパスを設定する場合は、スラッシュ (/) を使用してください (例: app/repository)。Windows 2000 システムの場合は円記号 (¥) を使用し、ドライブ名を指定してください (例: c:¥app¥repository)。
次の表に従って、UBBCONFIG ファイル内のセクションを変更してください。
GROUPS セクション GROUPS エントリを使用して、BEA Jolt リポジトリを含むグループを設定します。グループ名のパラメータには、アプリケーション側で選択された名前が使用されます。
SERVERS セクション
Jolt リポジトリ・サーバである JREPSVR には、リポジトリにアクセスしたり、リポジトリを編集するためのサービスが格納されています。JREPSVR インスタンスが複数ある場合は、共有ファイルにより、リポジトリの情報が共有されます。UBBCONFIG ファイルの SERVERS セクションには、JREPSVR を指定してください。
リポジトリ・ファイル
リポジトリ・ファイル jrepository は、BEA Jolt で利用可能です。このファイルには bankapp のサービスとリポジトリ・サービスが含まれています。これらのサービスは、リポジトリ・エディタを使って編集したり、テストを行ったり、削除することができます。
注記 BEA Jolt バージョン 1.x からアップグレードする場合、現在のバージョンとの互換性を保つために、バルク・ローダを使って jrepository ファイルを作成し直す必要があります。
BEA Jolt で bankapp アプリケーションのテストを行わない場合も、インストール時に提供される jrepository ファイルから始めてください。bankapp のパッケージまたはサービスが必要でない場合は削除してください。
ファイルのパス名は、-P オプションの引数と一致していなければなりません。
警告: 
リポジトリ・ファイルを手動で変更しないでください。手動で変更すると、リポジトリ・エディタを使用できなくなります。jrepository ファイルの変更はどんなテキスト・エディタでも行うことができますが、BEA Jolt システムでは正当性チェック (ファイルが正しい形式かどうかを確認) は行われません。jrepository ファイルが手動で変更されたかどうかは、実行時までわかりません。その他の情報については、Jolt リポジトリ・エディタを使うを参照してください。
BEA Tuxedo およびリポジトリ・エディタを使用してサービスを初期化する
BEA Tuxedo および BEA Jolt リポジトリ・エディタを使用して次の手順で BEA Tuxedo サービスを定義し、クライアントが Jolt サービスを利用できるようにします。
イベント・サブスクリプション
Jolt のイベント・サブスクリプション機能では、BEA Tuxedo サービスまたは別の BEA Tuxedo クライアントからイベント通知を受信します。
イベント・サブスクリプションを設定する
BEA Tuxedo の TMUSREVT サーバを設定し、アプリケーションの UBBCONFIG ファイルを編集してください。次のリストは、UBBCONFIG ファイル内の TMUSREVT パラメータの内容を示しています。コンフィギュレーション・ファイル内のエントリの構文については、『C 言語を使用した BEA Tuxedo アプリケーションのプログラミング』 を参照してください。
コード リスト3-7 UBBCONFIG ファイル
TMUSREVT SRVGRP=EVBGRP1 SRVID=40 GRACE=3600
ENVFILE="/usr/tuxedo/bankapp/TMUSREVT.ENV"
CLOPT="-e tmusrevt.out -o tmusrevt.out -A --
-f /usr/tuxedo/bankapp/tmusrevt.dat"
SEQUENCE=11
UBBCONFIG ファイルの SERVERS セクションで、SRVGRP パラメータと SRVID パラメータを必要に応じて変更してください。
BEA Tuxedo の FML バッファまたは VIEW バッファをフィルタ処理する
フィルタ処理を行うと、サブスクリプションをカスタマイズできます。BEA Tuxedo のイベント・ブローカ、イベントのサブスクライブ方法、またはフィルタ処理に関する追加情報については、『C 言語を使用した BEA Tuxedo アプリケーションのプログラミング』を参照してください。
BEA Tuxedo の FML バッファまたは VIEW バッファをフィルタ処理するには、BEA Tuxedo の実行時にフィールド定義ファイルが必要です。
注記 STRING バッファをフィルタ処理する場合の条件は特にありません。
バッファ型
FML バッファの例 TMUSREVT.ENV ファイルの FIELDTBLS 変数 は、FML バッファの使用例を示しています。FIELDTBLS 変数と FLDTBLDIR 変数を設定することにより、BEA Tuxedo で FML フィールドの定義テーブルを利用できるようになります。 my.flds ファイルのフィールドをフィルタ処理するには、次の手順に従います。
コード リスト3-8 TMUSREVT.ENV ファイルの FIELDTBLS 変数
FIELDTBLS=Usysflds,bank.flds,credit.flds,event.flds,my.flds
FLDTBLDIR=/usr/tuxedo/me/T6.2/udataobj:/usr/me/bankapp
UBBCONFIG ファイルで ENVFILE="/usr/me/bankapp/TMUSREVT.ENV" と定義されている場合 (UBBCONFIG ファイル を参照)、FIELDTBLS と FLDTBLDIR の定義は、設定されている環境変数の代わりに TMUSREVT.ENV ファイルから取得されます。
ENVFILE="/usr/me/bankapp/TMUSREVT.ENV" の定義を削除すると、FIELDTBLS と FLDTBLDIR の定義は、設定されている環境変数から取得されます。BEA Tuxedo システムを起動する前には、FIELDTBLS と FLDTBLDIR の定義に適切な値が設定されていなければなりません。
イベント・サブスクリプションと BEA Jolt クラス・ライブラリの詳細については、Jolt クラス・ライブラリを使うを参照してください。
BEA Tuxedo に関する背景情報
次の節では、コンフィギュレーションに関する情報を詳しく説明します。BEA Tuxedo について理解している場合でも、Jolt サービス・ハンドラ (JSL: Jolt Service Handler) の設定についてこの節で確認してください。
コンフィギュレーション・ファイル
BEA Tuxedo のコンフィギュレーション・ファイルには、ASCII 形式の UBBCONFIG と、コンパイル済みの TUXCONFIG の 2 種類があります。TUXCONFIG ファイルを作成したら、UBBCONFIG はバックアップとして保存してください。
UBBCONFIG ファイルは、使い慣れたテキスト・エディタを使用して変更することができます。MASTER マシンにログインしているときにアプリケーションが動作しなくなったら、tmloadcf(1) を実行して TUXCONFIG をコンパイルし直します。BEA Tuxedo からは、TUXCONFIG ファイルを上書きしてもよいかどうかを確認するプロンプトが表示されます(-y オプションを指定してコマンドを実行すると、このプロンプトは表示されません)。
UBBCONFIG ファイルを作成する
バイナリ形式のコンフィギュレーション・ファイル、TUXCONFIG には、tmboot(1) の実行時に使用される情報が含まれています。これにより、サーバの起動と BEA Tuxedo システムの掲示板の初期化が順番に行われます。バイナリ形式の TUXCONFIG ファイルを直接作成することはできません。まず、UBBCONFIG ファイルを作成する必要があります。tmloadcf(1) を実行すると、このファイルが解析され、TUXCONFIG に読み込まれます。次に、tmadmin(1) により、コンフィギュレーション・ファイルまたはそのコピーを使ったシステムの監視が行われます。tmshutdown(1) は、アプリケーションのシャットダウン時に必要な情報をコンフィギュレーション・ファイルから参照します。
コンフィギュレーション・ファイルの形式
UBBCONFIG ファイルには、最大 9 つまでのセクションを指定することができます。セクションは、アスタリスク (*) が先頭に付いた行から始まります。アスタリスク (*) の直後にはセクション名が表示されます。使用可能なセクションは、RESOURCES、MACHINES、GROUPS、NETGROUPS、NETWORK、SERVERS、SERVICES、INTERFACES、および ROUTING です。
注記 RESOURCES セクション (使用する場合) と MACHINES セクションは、この順序で最初に指定しなければなりません。GROUPS セクションは、SERVERS セクション、 SERVICES セクション、および ROUTING セクションより前に指定しなければなりません。
JSL を設定するには、UBBCONFIG ファイルを変更する必要があります。BEA Tuxedo の設定に関するさらに詳しい情報については、『BEA Tuxedo アプリケーション実行時の管理』を参照してください。
次のリストは、UBBCONFIG ファイルの一部を示しています。
コード リスト3-9 UBBCONFIG ファイル
*MACHINES
MACH1 LMID=SITE1
MAXWSCLIENTS=40
*GROUPS
JSLGRP GRPNO=95 LMID=SITE1
*SERVERS
JSL SRVGRP=JSLGRP SRVID=30 CLOPT= ﾒ -- -n 0x0002PPPPNNNNNNNN -d
/dev/tcp -m2 -M4 -x10ﾓ
次の表では、Jolt サーバ・グループと Jolt サーバに対して指定できるパラメータを示しています。これら以外のパラメータを指定する必要はありません。
次の表に従って、UBBCONFIG ファイル内のセクションを変更してください。
MACHINES セクション MACHINES セクションでは、物理マシンの論理名を指定します。また、このセクションではマシン固有のパラメータも指定します。MACHINES セクションには、アプリケーションで使用される物理プロセッサごとのエントリが必要です。エントリの形式は次のとおりです。 ADDRESS はプロセッサの物理名です。たとえば、UNIX システムの uname -n コマンドの実行結果として返される値などです。 このパラメータは、ADDRESS のシンボリック名として、ほかのセクションで string_value が使用されることを指定します。この名前にはカンマを指定できません。名前は 30 文字以内で指定します。このパラメータは必須です。コンフィギュレーションで使用されるすべてのマシンには、LMID 行を指定する必要があります。 コンフィギュレーション・ファイルの MACHINES セクションには、MAXWSCLIENTS パラメータを指定する必要があります。これは、プロセッサにおけるアクセサ数を指定する、Jolt クライアントと Workstation クライアント専用のパラメータです。このパラメータには、0 〜 32,768 の範囲の値を指定します。 Jolt サーバと Workstation では、同じ要領で MAXWSCLIENTS が使用されます。たとえば、MAXWSCLIENTS に 200 スロットが設定されると、Jolt と Workstation で使用されるリモート・クライアントの総数が決まります。 コンフィギュレーション・ファイルの MAXWSCLIENTS は必ず指定してください。指定しない場合は、デフォルトで 0 が設定されます。 注記 MAXWSCLIENTS が設定されていないと、JSL は起動しません。 GROUPS セクション このセクションでは、サーバ・グループに関する情報を定義します。サーバ・グループは少なくとも 1 つ定義しなければなりません。サーバ・グループのエントリには、サーバ群およびマシン上のサービス群に対して、論理名を指定します。論理名は、SERVERS セクションの SRVGRP パラメータの値に使用されます。この値により、サーバはグループ内のサーバとして識別されます。SRVGRP は、SERVICES セクションで、グループ内の特定のサービス・インスタンスのオカレンスを識別する場合にも使用されます。GROUPS セクションのその他のパラメータは、このグループを特定のリソース管理インスタンスに関連付けます (社員データベースなど)。GROUPS セクション内にある各行の形式は次のとおりです。 GROUPNAME は、グループの論理名 (string_value) を指定します。グループ名は、GROUPS セクションのグループ名と MACHINES セクションの LMID の中で一意でなければなりません。このグループ名には、アスタリスク (*)、カンマ (,)、またはコロン (:) を指定できません。名前は 30 文字以内で指定します。 Jolt サーバ・リスナ (JSL) を含むグループには、GROUPS エントリを指定する必要があります。次の手順に従って、GROUPS エントリを作成します。
ADDRESS または NAME 必須パラメータ [オプション・パラメータ]
LMID=string_value
MAXWSCLIENTS=number
GROUPNAME必須パラメータ [オプション・パラメータ]
注記 UBBCONFIG ファイルの GROUPS セクションに指定されているすべてのグループに対して、デフォルトでリソース・マネージャが割り当てられないようにしてください。デフォルト値として指定されたリソース・マネージャは、JSL に割り当てられ、tmboot の実行時にエラーが発生します。SERVERS セクションの RESTART、MAXGEN、その他に指定されているデフォルト値は、JSL に対して有効です。
SERVERS セクション
このセクションでは、システムで起動されるサーバの初期状態に関する情報を定義します。常時実行中の状態にあり、受信したサーバ・グループのサービス要求を処理するのがサーバである、という捉え方は、特定のリモート環境には当てはまらない場合があります。ほとんどの環境では、オペレーティング・システムまたはリモート・ゲートウェイは単にサービスの送信を行っています。このような場合は、リモート・プログラムのエントリ・ポイントに対して、SERVER テーブルのエントリではなく SERVICE エントリ・ポイントを指定するだけで十分です。BEA Tuxedo システムのゲートウェイ・サーバは、リモート・ドメインのサービス要求を宣言し、キューに入れます。ホスト固有のリファレンス・ページでは、UBBCONFIG のサーバ・テーブル・エントリが特定の環境に適応しているかどうかを示し、適応している場合は対応するセマンティクスを明記する必要があります。SERVERS セクション内にある各行の形式は次のとおりです。
AOUT必須パラメータ [オプション・パラメータ]
AOUT は、tmboot(1) によって実行されるファイル (string_value) を指定します。tmboot は、サーバ・グループで指定されたマシン上で AOUT を実行します。tmboot はターゲット・マシンで AOUT ファイルを検索するため、AOUT はそのマシンのファイルシステム内になければなりません(AOUT のパスには、ほかのマシン上にあるファイルシステムへの RFS 接続を含めることができます)。サーバの相対パス名が指定されている場合、AOUT の検索は、APPDIR、TUXDIR/bin、/bin、path、の順で行われます。<path> は、マシンの環境設定ファイル (ある場合) の最後の行 (PATH=) に指定されている値です。APPDIR および TUXDIR の値は、TUXCONFIG ファイル内の適切なマシン・エントリから取得されます。
クライアントは、Jolt サーバ・リスナ (JSL) を介して BEA Jolt アプリケーションに接続します。サービスは、Jolt サーバ・ハンドラ (JSH) を介してアクセスされます。JSL は複数のクライアントを扱うことができます。これらのクライアントは 唯一の通信ポイントである JSL を経由して特定のネットワーク・アドレス (JSL コマンド行で指定) のアプリケーションに接続します。JSL は、ハンドラ・プロセスをスケジューリングします。ハンドラ・プロセスは、アプリケーションの管理ドメインの範囲内にあるリモート・ワークステーションで、クライアントの代わりに動作します。ハンドラは、1 つのポートで同時に複数のクライアントを扱うために、多重化スキーマを使用します。
JSL に指定されたネットワーク・アドレスは、JSL および JSL に関連付けられた JSH プロセスの TCP/IP アドレスを決定します。ネットワーク・アドレスにより決定されたポート番号は、JSL が新しい接続を受け付けるポート番号を指定します。JSL に関連付けられた各 JSH は、同じ TCP/IP アドレスで連続するポート番号を使用します。たとえば、JSL の最初のポート番号が 8000 であり、最大 3 つの JSH プロセスがある場合、これらの JSH プロセスは 8001、8002、8003 のポートを使用します。
注記 後続の JSL を誤って設定すると、ポート番号の衝突が発生します。
JSL で使用できるパラメータ
これまでに説明したセクションのパラメータのほか、JSL では次のパラメータを指定することができます。ただし、これらのパラメータを設定すると、アプリケーションにどのような影響が及ぶかを考慮してください。
SVRGRP=string_value
このパラメータは、実行するサーバが含まれるサーバ・グループの名前を指定します。string_value は、*GROUPS セクションのサーバ・グループを示す論理名でなければならず、名前は 30 文字以内で指定します。*GROUPS セクションのエントリと関連付けるということは、LMID が指定されたサーバ・グループ内のマシンで AOUT が実行されることを意味します。また、この関連付けにより、サーバ・グループの GRPNO と、関連するリソース・マネージャがオープンされている場合に受け付けられるパラメータが指定されます。すべてのサーバ・エントリには、サーバ・グループのパラメータが指定されていなければなりません。
SRVID=number
このパラメータには、グループ内の特定のサーバを示す識別子 (1 〜 30,000 の範囲の値) を指定します。このパラメータは、すべてのサーバ・エントリに必要です (サーバ・グループ内のサーバが 1 つの場合も必要) 。複数のサーバのオカレンスを設定する場合は、連続する SRVID を指定しないでください。MAX で指定された数までのサーバ用に、SRVID を残しておいてください。
オプション・パラメータ
SERVERS セクションのオプション・パラメータには、ブート・パラメータとランタイム・パラメータがあります。
ブート・パラメータ
ブート・パラメータは、tmboot によってサーバが実行されるときに使用されるパラメータです。いったん実行されると、サーバはコンフィギュレーション・ファイルからエントリを読み込み、ランタイム・オプションを決定します。正しいエントリが検索されるようにするため、一意なサーバ識別子が使用されます。次のパラメータがブート・パラメータです。
CLOPT=string_value
CLOPT パラメータは、起動時に AOUT に渡すコマンド行オプションの文字列を指定します。『BEA Tuxedo のファイル形式とデータ記述方法』 の servopts(5) ページには、有効なパラメータが一覧表示されています。
開発中のサーバに適用されるオプションもあります。たとえば、-r オプションは、サービス要求が開始または終了するたびに、標準のエラー・ファイルにレコードを書き込むようサーバに指示します。
別のコマンド行オプションを使用して、サーバの標準出力 (stdout) や標準エラー (stderr) を特定のファイルに書き込んだり、サーバの起動時に利用可能なサービスの種類を最初に宣言するように指定できます。
CLOPT パラメータのデフォルト値は -A であり、サーバの起動時に、利用可能なサービスがすべて宣言されることを示します。
CLOPT パラメータには最大 256 文字まで指定できます。パラメータは二重引用符で囲む必要があります。
SEQUENCE=number
このパラメータは、ほかのサーバとの関係において、いつサーバをシャットダウンまたは起動するかを指定します。SEQUENCE が指定されていない場合、サーバはSERVERS セクションで指定された順序で起動し、逆の順序でシャットダウンされます。シーケンス番号が指定されているサーバとそうでないサーバがある場合、シーケンス番号が指定されたサーバが低い番号から順に起動します。次に、シーケンス番号が指定されていないサーバが、コンフィギュレーション・ファイルに表示されている順序で起動します。シーケンス番号には 1 〜 9999 の値を指定します。複数のサーバに同じシーケンス番号が割り当てられると、tmboot の実行時にこれらのサーバが同時に起動します。
MIN=number
MIN パラメータは、tmboot で起動されるサーバのオカレンスの最小数を指定します。RQADDR が指定されており、MIN が 1 より大きい数の場合、サーバは MSSQ (複数サーバ、単一キュー) になります。サーバの識別子は SRVID で指定します。SRVID の最大値は SRVID + (MAX -1) です。サーバのすべてのオカレンスには、同じサーバ・パラメータのほか、同じシーケンス番号が付きます。MIN には 0 〜 1000 までの範囲の値を指定できます。MIN を指定しないと、デフォルトで 1 が設定されます。
MAX=number
MAX パラメータは、起動するサーバのオカレンスの最大数を指定します。tmboot が実行されると、MIN で指定した数のサーバが起動します。次に、tmboot の -i オプションを使用して関連するサーバ識別子を指定し、その他のサーバ (MAX で指定した数まで) を起動します。MAX には 0 〜 1000 の範囲の値を指定できます。MAX を指定しないと、デフォルトで MIN と同じ値かまたは 1 が設定されます。
ランタイム・パラメータ
tmboot によって起動したサーバは、ランタイム・パラメータを使用します。既に説明したとおり、tmboot は、サーバの起動時に MACHINES セクションに対して TUXDIR、APPDIR、およびENVFILE の各パラメータの値を使用します。さらに、サーバの PATH を次のパスに設定します。
path は、ENVFILE ファイルの最後の行 (PATH=) に指定されている値です。次のパラメータはランタイム・パラメータです。
ENVFILE=string_value
ENVFILE パラメータを使用して、サーバの初期化時に、tmboot によって作成された環境に対して値を追加することができます。tmboot の MACHINES ENVFILE で変数を指定した後、オプションとして、SERVERS ENVFILE パラメータで指定されたファイルの変数を設定することもできます。これらのファイルを使用して TUXDIR、APDIR、TUXCONFIG、またはTUSOFFSET を上書きすることはできません。最も良い方法は、アプリケーションを正しく実行するために必要な変数だけをサーバの ENVFILE に設定しておくことです。
サーバ側では、サーバの起動後に ENVFILE ファイルが処理されます。したがって、サーバの実行に必要な実行可能ファイルまたは動的にロードされたファイルを検索するためのパス名を、このファイルに設定することはできません。これらのタスクを実行する必要がある場合は、代わりにマシンの ENVFILE を使用してください。
ENVFILE では、各行を次の形式で指定する必要があります。
VARIABLE の先頭には、下線 (_) または英文字を指定する必要があります。また、下線と英数字だけで構成することもできます。サーバ・グループに属するサーバが別のマシンに移行される場合、ENVFILE はどちらのマシンでも同じ場所になければなりません。
CONV={Y | N}CONV は、サーバが会話型サーバであるかどうかを指定します。会話型サーバが定義されている場合、CONV の値は Y になります。接続は会話型サーバに対してのみ行うことができます。tpacall(3c) または tpcall(3c) を使った rpc 要求は非会話型サーバに対してのみ行うことができます。受け取った要求に対して応答を行うサーバの場合は、CONV=N (デフォルト) を設定するか、またはパラメータを省略します。
RQADDR=string_value
RQADDR は、このサーバの要求キューにシンボリック名を割り当てます。複数のサーバに対して同じシンボリック名を使用し、MSSQ セットを作成します (1 より大きい MIN の値を指定)。MSSQ セットに属するすべてのメンバは、同じサービスのセットを提供し、同じサーバ・グループに属していなければなりません。
RQADDR を指定しないと、このサーバのキュー・アドレスとなる一意なキーが割り当てられます。ただし、キューにシンボリック名が設定されている場合は、キュー・アドレスを引数として使用する tmadmin コマンドを使う方が簡単です。
RQPERM=number
このサーバの要求キューに UNIX 形式でパーミッションを割り当てる場合は、RQPERM パラメータを使用してください。number には、0001 〜 0777 の範囲の値を指定します。パラメータが何も指定されていない場合は、掲示板に設定されたパーミッションの値 (RESOURCES セクションの PERM で指定) が使用されます。そこでもパーミッションが設定されていない場合は、デフォルトの 0666 が指定されます。ただし、この値が設定された状態では、システムにログインしたユーザであれば誰でもアプリケーションを使用できるため、注意が必要です。
REPLYQ={ Y | N }REPLYQ パラメータは、応答キュー (要求キューとは別) を AOUT に対して作成する必要があるかどうかを指定します。N が指定されると、AOUT と同じ LMID に応答キューが作成されます。要求キューを使用するサーバが 1 つの場合、要求キューから応答を取り出す操作は問題なく行われます。しかし、サーバが MSSQ セットのメンバであり、応答メッセージを受信するようにプログラミングされているサービスを含んでいる場合、REPLYQ を Y に設定して、このサーバに対して応答キューが個別に作成されるようにする必要があります。 N に設定されると、応答は MSSQ セット内の全サーバが共有する要求キューに送信されてしまい、応答が要求元のサーバに返されるかどうかは保証されません。
応答を必ず受信するには、常に MSSQ セット内の全サーバに REPLYQ=Y を設定するべきです。MSSQ セット内のサーバでは、同じサービスが提供されなければなりません。つまり、セット内のあるサーバが応答を待機している場合は、セット内のほかのサーバでも応答を待機できます。
RPPERM=number
応答キューにパーミッションを割り当てるには、RPPERM パラメータを使用してください。number は、通常の UNIX 形式 (例: 0600) で指定されます。指定できる値は、0001 〜 0777 までの数値です。RPPERM を指定しない場合は、デフォルトで 0666 が指定されます。このパラメータは、REPLYQ=Y の場合のみ有効です。要求と応答が同じキューから読み出される場合、必要なのは RQPERM のみで、RPPERM は無視されます。
RESTART={ Y | N }RESTART パラメータは、AOUT を再起動できるかどうかを示し、Y または N を指定できます。デフォルトは N です。移行可能なサーバ・グループにサーバが属している場合、RESTART には Y を指定しなければなりません。SIGTERM シグナルを指定して起動したサーバは再起動できません。このサーバはリブートする必要があります。
サーバの再起動に関する方針は、サーバの状態、つまりサーバが開発中であるかどうかによって異なります。アプリケーションがテスト過程の段階では、サーバに繰り返し障害が発生することも考えられます。しかし、アプリケーションがプロダクション段階に進んだら、サーバは、ほとんど障害が発生しない状態でなければなりません。アプリケーションがプロダクション段階に進んだら、サーバの再起動に関してさらに厳しい条件のパラメータを設定することもできます。
RESTART に関連するパラメータ
RCMD=string_value
AOUT が再起動可能な場合、このパラメータは、AOUT が異常終了した場合に実行するコマンドを指定します。最初の空白またはタブまでの文字列には、実行可能な UNIX ファイルの名前 (絶対パス名または APPDIR への相対パス名) を指定します。コマンドの先頭に Shell の変数を設定しないでください。オプションで、コマンド名の後にコマンド行引数を指定することもできます。コマンド行には、サーバの再起動条件を指定する GRPNO と SRVID の 2 つの引数を追加できます。string_value は、サーバの再起動と並行して実行されます。
RCMD パラメータを使用すると、サーバの再起動時に並行して実行されるコマンドを指定することができます。このコマンドは、サーバの PATH のディレクトリにある実行可能な UNIX のシステム・ファイルでなければなりません。たとえば、カスタマイズされたメッセージを userlog に送信し、再起動するサーバにマークを付けるコマンドです。
MAXGEN=number
このパラメータは、AOUT が再起動可能な場合、GRACE で指定された期間内に、最大「number - 1」回まで再起動されることを指定します。指定できる値は 0 より大きく、256 より小さい数値です。この値を指定しないと、デフォルトの 1 (サーバは一度起動できるが、再起動はできない) が設定されます。サーバが再起動可能な場合、MAXGEN には 2 以上の値を指定する必要があります。RESTART に Y を指定しないと、MAXGEN の値は無視されます。
GRACE=number
RESTART が Y の場合、GRACE パラメータを使用して、サーバの再起動を行える期間 (秒単位) を指定することができます。再起動は MAXGEN - 1 回行うことができます。秒数として 0 以上 2,147,483,648 未満 (または 68 年強) の値を指定します。GRACE を指定しない場合は、デフォルトの 86,400 秒 (24 時間) が指定されます。GRACE を 0 に設定すると、すべての制限が解除されます。つまり、サーバの再起動回数が制限されなくなります。
パラメータを入力する
JSL には、BEA Tuxedo のパラメータである RESTART、RQADDR、および REPLYQ を使用できます。ランタイム・パラメータの詳細については、『BEA Tuxedo アプリケーション実行時の管理』を参照してください。パラメータは次の要領で指定してください。
CLOPT= ﾒ-- -n 0x0002PPPPNNNNNNNN -d /dev/tcp -m2 -M4 -x10ﾓ
BEA Jolt オンライン・マニュアルのサンプル・アプリケーション
以下の BEA Jolt 製品の Web ページには、サンプル・コードが用意されています。このサンプル・コードは BEA Jolt を使用して変更することができます。
http://www.bea.com/products/jolt/index.htm
これらのサンプルを使用すると、BEA Jolt の機能を実際に試すことができます。
以下の Java 関連の Web サイトも参照してください。
|
|
|
|
||
 |
|
|
 |
 |
 |
|
||