JP1/Base 運用ガイド

[目次][用語][索引][前へ][次へ]

6.4.2　イベントサーバ設定ファイル（conf）の詳細

イベントサーバ設定ファイル（conf）の詳細について説明します。

＜この項の構成＞
(1)　格納先ディレクトリ
(2)　パラメーター一覧
(3)　パラメーターの説明
(4)　設定例

(1)　格納先ディレクトリ

イベントサーバ設定ファイルの格納先ディレクトリを次に示します。

Windowsの場合
イベントサーバインデックスで指定したフォルダ\conf
デフォルトのイベントサーバインデックスでは，インストール先フォルダ\conf\event\servers\default\confとなっています。

UNIXの場合
イベントサーバインデックスで指定したディレクトリ/conf
デフォルトのイベントサーバインデックスでは，/etc/opt/jp1base/conf/event/servers/default/confとなっています。

(2)　パラメーター一覧

イベントサーバ設定は，次に示すパラメーターの集まりです。

パラメーター名 内　容
ports JP1イベント受信用IPアドレスとポート番号を指定する。
client-bind JP1イベント送信用IPアドレスを指定する（複数LAN接続機能用パラメーター）。
users JP1イベントを取得できるユーザー名を指定する。
eventids 取得できるイベントIDを指定する。
alt-userid WindowsおよびJavaのプログラムで仮定するユーザーIDまたはグループIDを指定する。
forward-limit JP1イベント転送失敗時のリトライ期限を指定する。
after-error 他サーバ転送のエラー後の転送抑止時間を指定する。
expire イベントデータベース内のJP1イベントの保管期限を指定する。
db-size イベントデータベースの容量を指定する。
buffnum バージョン5以前の製品であるJP1/SESまたはJP1/AJSの関数などで取得するための保存JP1イベント数を指定する。
include ses-conf バージョン5以前の製品であるJP1/SESの環境定義ファイルを取り込むことを指定する。
include ajs-conf バージョン5以前の製品であるJP1/AJSの環境定義ファイルを取り込むことを指定する。
options オプションのフラグを指定する。
remote-server 他イベントサーバへの接続方法を指定する。
error-size イベントサービスエラーログファイル（error.*）の容量を指定する。
trace-size イベント転送トレースログファイル（trace.*）の容量を指定する。
evtlog-size イベントサービストレースログファイル（imevterr.*）の容量を指定する。
fwderr-size イベントサービス転送エラーログファイル（fwderr.*）の容量を指定する。
log-keep ログファイル（error.*，trace.*，imevterr.*，fwderr.*）の数を指定する。
log-level ログ（syslog，イベントログ，error.*，trace.*）の出力レベルを指定する（JP1/Base 06-51の場合だけ指定する）。
forward-timeout JP1イベント転送のタイムアウト時間を指定する。
retry-interval 転送失敗時のリトライ間隔を指定する。
repetition-noncheck-server 重複登録チェックを抑止するイベントサーバ名を指定する。
restart 再起動回数，リトライ間隔およびリセット時間を指定する。

JP1イベントの転送のリトライに関連するパラメーターは，forward-limit，after-error，retry-intervalです。デフォルトでは，JP1イベントの転送に失敗すると，3,600秒の間600秒の間隔で転送をリトライします。

クラスタ運用の場合，JP1イベントの転送中に転送元ホストまたは転送先ホストがフェールオーバーすると，そのJP1イベントの転送は失敗します。確実にJP1イベントを転送するために，必ず転送をリトライするように設定してください。

JP1イベントの転送のリトライに関連するパラメーターの相関関係を次の図に示します。

図6-1　リトライ関連のパラメーターの相関関係

[図データ]

なお，転送抑止期間を除いたリトライ間隔内で，次のJP1イベントの転送が発生した場合には，その時点でリトライが行われます。

JP1イベントの転送のリトライ中にイベントサービスの再起動またはリロードが行なわれた場合，転送されなかったJP1イベントはリトライ期限内であればイベントサービスの起動時に再送されます。

(3)　パラメーターの説明

イベントサーバ設定の各パラメーターを説明します。

(a)　ports　アドレス　転送用ポート指定　AP用ポート指定

このイベントサーバが，他プログラムからの接続を受け入れるために使用するIPアドレスとポート番号を指定します。なお，このパラメーターでの指定は，バージョン5以前の製品であるJP1/SESまたはJP1/AJSが稼働するホストからのイベント受信には適用されません。

アドレス
使用するIPアドレスを次に示すどれかの形式で指定します。
portsパラメーターを省略すると，ホスト名として，イベントサーバ名が指定されたものと仮定します。
  • 0.0.0.0
    IPアドレスを特に限定しないで，システムに任せることを指定します。
    システムを物理ホストだけで運用する場合は，この値を指定してください。
  • IPアドレス
    ピリオドで区切った10進数（例: 172.16.50.50）で指定します。また，IPアドレスを指定する場合は，複数指定できます。IPアドレスの複数指定は，主にネットワークを分離した環境でイベントサービスを運用するときに利用します。ネットワークを分離した環境での運用については，「11.3　ネットワークを分離した環境での運用」を参照してください。IPアドレスを複数指定する場合は，IPアドレスを:（半角コロン）で区切って指定します（例: 172.16.50.50:172.16.50.51:172.16.50.52）。IPアドレスは，最大で4指定できます。
  • ホスト名
    システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

転送用ポート指定
他サーバからのJP1イベント転送を受け付けるためのポート番号を次に示すどちらかの形式で指定します。
  • ポート番号
    ポート番号を，10進数で指定します。
  • サービス名
    システムのservicesファイルで定義されている，tcpのサービス名を指定します。
    通常は，サービス名としてjp1imevtを指定してください。portsパラメーターを省略すると，この値を仮定します。

AP用ポート指定
JP1イベントを発行または取得するアプリケーションからの要求を受け付けるためのポート番号を次に示すどちらかの形式で指定します。
  • ポート番号
    ポート番号を，10進数で指定します。
  • サービス名
    システムのservicesファイルで定義されている，tcpのサービス名を指定します。通常は，サービス名としてjp1imevtapiを指定してください。portsパラメーターを省略すると，この値を仮定します。

(b)　client-bind　アドレス

このイベントサーバが，他プログラムにJP1イベントを送信するために使用するIPアドレスを指定します。このパラメーターは，ネットワークを分離した環境でイベントサービスを運用するときに利用します。通常は，このパラメーターを指定する必要はありません。このパラメーターを省略すると，portsパラメーターに指定されたアドレスの形式でJP1イベントを送信します。ネットワークを分離した環境での運用については，「11.3　ネットワークを分離した環境での運用」を参照してください。また，このパラメーターでの指定は，バージョン5以前の製品であるJP1/SESまたはJP1/AJSが稼働するホストへのイベント送信には適用されません。

アドレス
使用するIPアドレスを次に示すどちらかの形式で指定します。
  • 0.0.0.0
    IPアドレスを特に限定しないで，システムに任せてイベント送信します。複数LAN対応の通信設定をする場合，通常はこの値を指定してください。
  • IPアドレス
    ピリオドで区切った10進数で指定します。指定したIPアドレスを利用してイベント送信します。

(c)　users　{　*　|　ユーザー名　}　…

JP1イベントを取得できるユーザー名を指定します。

このパラメーターは複数指定でき，すべての指定の和が，JP1イベントを取得できるユーザーとなります。このパラメーターを一つも指定しないと，どのユーザーもJP1イベントを取得できません。

なお，include ses-confパラメーター，またはinclude ajs-confパラメーターに指定するファイル内でユーザー名が設定されていない場合は，このパラメーターにユーザー名を指定する必要があります。

*
すべてのユーザーがJP1イベントを取得できるようになります。
ただし，バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブを使用した場合を除きます。

ユーザー名
システムで規定されるユーザー名を指定します。指定されたユーザー名を持つユーザーが，JP1イベントを取得できます。
バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブを使用してJP1イベントを取得する場合には，ユーザー名の指定が必要です。
なお，自ホスト名と同じイベントサーバ名でイベントサーバを起動する際には，UNIXの場合は，ユーザー名として必ずスーパーユーザー名（通常は「root」）および「adm」を指定してください。Windowsの場合は，「system」および「SYSTEM」を指定してください。指定しなかった場合，イベントサーバが起動しません。

(d)　eventids　{　*　|　基本コード　|　基本コード:拡張コード　}

プログラムで取得できるイベントIDを指定します。ここで指定されないイベントIDのJP1イベントは，発行されてもエラーにはなりませんが，取得できません。

このパラメーターは複数指定でき，すべての指定の和が，取得できるJP1イベントとなります。このパラメーターを一つも指定しないと，JP1イベントを取得できません。

*
すべてのJP1イベントを取得できるようになります。
ただし，バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブを使用して取得または発行した場合を除きます。これらの場合は，次に示す二つの形式のどちらかでイベントIDが指定されていなければなりません。

基本コード
イベントIDの基本コードを，1〜8桁の16進数で指定します。拡張コードには，0が仮定されます。

基本コード:拡張コード
イベントIDの基本コードと拡張コードを，それぞれ1〜8桁の16進数で，コロンで区切って指定します。

(e)　alt-userid　代用ユーザーID　代用グループID

WindowsおよびJavaの実行環境は，数値形式のユーザーID・グループIDの概念を持たないため，代わりにイベントデータ中に設定する値を指定します。

代用ユーザーIDおよび代用グループIDは，-1〜65,535の10進数で指定します。省略すると，どちらも-1を仮定します。

(f)　forward-limit　リトライ期限

JP1イベントの転送に失敗した場合の，リトライを繰り返す期限を秒単位で指定します。転送設定ファイルの指定によるJP1イベントの転送は，転送に成功するか，ここに指定された時間が過ぎるまで，retry-intervalパラメーターで指定した間隔で繰り返されます。

値は，0〜86,400の10進数で指定します。省略した場合は，0（リトライしない）を仮定します。なお，このパラメーターを設定する場合は，retry-intervalパラメーターで指定するリトライ間隔よりも大きい値を指定してください。

(g)　after-error　エラー後の転送抑止時間

ある他サーバへのJP1イベント転送が失敗した後，そのサーバへのJP1イベント転送を抑止する時間を秒単位で指定します。したがって，指定された時間内は，JP1イベントはそのサーバへ転送されず，エラーとして扱われます。

値は0〜2,147,483,647の10進数で指定します。retry-intervalパラメーターよりも小さい値を指定してください。このパラメーターを省略すると，30秒を仮定します。

(h)　expire　イベント保管期限

発行されたJP1イベントを，イベントデータベースに保管しておく時間を秒単位で指定します。JP1イベントはJP1イベントの発行後，指定された時間内はイベントデータベース中に保管され，JP1/IM - Viewなどから参照できます。ただし，イベントデータベースの容量がdb-sizeパラメーターで指定した値に達した場合は，保管期限に達していなくても削除されることがあります。

値は0〜2,147,483,647の10進数で指定します。このパラメーターを省略すると，31,536,000秒，つまり365日が仮定されます。

(i)　db-size　イベントデータベースの容量

イベントデータベースの容量（バイト数）を指定します。指定された容量に達すると， JP1イベント保管期限に達していなくても，古いJP1イベントが削除されることがあります。イベントサービスでは，指定された容量の最大約2倍のディスク容量を使用します。

値は0〜2,147,483,647の10進数で指定します。このパラメーターを省略すると，容量は2,147,483,647バイトが仮定されます。

保存する日数分のイベントデータベースの容量の計算式を次に示します。ファイルサイズを指定する際に参考にしてください。

　
[{a × (b + 64) + (c × 64)}×ｄ]/2 （バイト）
　

a：1日当たりに登録されるイベント※の総数。

b：イベント1件当たりの平均サイズ。サイズは実測で測定してください。

c：1日当たりに転送されるイベントの総数。

d：保存する日数。

注※　1日当たりに登録されるイベントとは，自ホスト上で発生するイベント，他ホストから受信するJP1/SESイベントおよびJP1イベント，転送されるイベントのことを指します。

(j)　buffnum　SESイベント数

バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブでJP1イベントを取得するために保存しておくJP1イベント数を指定します。この値を超えたJP1イベントが登録されると，古いJP1イベントから順に削除され，削除されたJP1イベントは，取得できなくなります。値は，UNIXの場合は2,500〜10,000，Windowsの場合は64〜2,048の10進数で指定します。省略すると，UNIXの場合は2,500，Windowsの場合は1,024を仮定します。

(k)　include　ses-conf　ファイル名

バージョン5以前の製品であるJP1/SESの環境定義ファイルから，バッファー数（BUFFNUM），ユーザー名（USER），イベントID（EVIDxxxx）の指定を取り込むことを指定します。取り込んだバッファー数の指定は，イベントサーバ設定ファイル自体に記述されたbuffnumパラメーターの指定よりも優先します。また，ユーザー名およびイベントIDの指定は，イベントサーバ設定ファイルでの指定と取り込んだ指定の和となります。

ファイル名はフルパスで指定します。この指定はUNIX版のJP1/Baseだけで有効になり，Windows版のJP1/Baseでは無効になります。

(l)　include　ajs-conf

バージョン5以前の製品であるJP1/AJS - EEの設定ダイアログボックスで指定した，最大イベント数，UNIXユーザーID，UNIXグループID，ユーザー名，およびイベントIDの指定を取り込むことを指定します。取り込んだ最大イベント数，UNIXユーザーID，UNIXグループIDの指定は，イベントサーバ設定ファイル自体に記述されたbuffnumパラメーター，alt-useridパラメーターの指定よりも優先します。また，ユーザー名およびイベントIDの指定は，イベントサーバ設定ファイルでの指定と取り込んだ指定の和となります。

この指定はWindows版のJP1/Baseだけで有効になり，UNIX版のJP1/Baseでは無効になります。

(m)　options　[no-sync | sync]　[remote-receive]　[conv-off]　[v5-unused]　[KAJP1037-hntroff]　[KAJP1037-syslogoff]

オプションのフラグを指定します。このパラメーターは，複数に分けて指定できます。

no-sync
JP1イベントのデータベースへの書き込みの，システムによるバッファリングを許します。このフラグを指定すると，JP1イベント発行の性能向上が期待できますが，システムが何らかの障害で停止した場合に，発行済みJP1イベントが消失することがあります。クラスタ運用をする場合は，信頼性の向上を目的とするため，指定しないでください。

sync
このフラグを指定すると，発行されたJP1イベントをそのつど確実にディスクに書き込みます。システムの再起動後も確実に取得できます。ただし，JP1イベントが発行されるたびにディスクに書き込むため，JP1イベント発行の性能が劣化する場合があります。no-syncフラグ，syncフラグのどちらも指定しない場合，ディスクへの書き込みが定期的（10秒）となるため，発行済みJP1イベントが消失することがあります。

remote-receive
他ホストで稼働しているプログラムからの，ネットワークを介してのJP1イベント取得を許します。
ほかのホストに接続したJP1/IM - ViewのGUIから，このホストのJP1イベントを検索する場合，およびバージョン5以前の製品であるJP1/AOM - EEの情報を参照する場合は，このフラグの指定が必要です。

conv-off
バージョン5以前の製品であるJP1/SES，JP1/AJSとの互換性のために用意されているJP1/SES互換用イベント取得関数の利用を抑止します。このフラグを指定すると，JP1イベントのJP1/SES互換用イベント取得関数への受け渡しが抑止され，転送されてきたJP1イベントの受信，および転送の性能向上が見込まれます。ただし，このフラグを指定すると，JP1/SES互換用イベント取得関数はJP1イベントを取得できなくなります。また，JP1/AJS2のJP1/AJS互換コマンドajsevgetも同様にJP1イベントを取得できなくなります。なお，JP1/SES互換用イベント取得関数，およびajsevgetコマンド以外は，このフラグの影響を受けません。このフラグ指定時のイベント受信可否を次の表に示します。
受信イベント 受信機能 イベントの受信（検知）
JP1イベント JP1/SES互換用イベント取得関数
ajsevgetコマンド		 検知しない
JP1/SES形式のイベント JP1/SES互換用イベント取得関数
ajsevgetコマンド		 検知される

v5-unused
バージョン5以前の製品であるJP1/SES，JP1/AJSとの互換性のために用意されているすべての機能の利用を抑止します。このフラグを指定するとJP1/SES，JP1/AJSの互換プロセスを起動しません。このため，JP1/OJEなどJP1/SESのプロトコルを利用している製品と，イベントの送受信ができなくなります。
このフラグの影響を受けるパラメーターを次の表に示します。

イベントサーバインデックスファイル（index）のパラメーター
パラメーター v5-unused未設定時 v5-unused設定時
server イベントサーバ名に@を指定すると，DNSに対応し，また，DNS環境でもJP1/SES互換機能を利用できるイベントサーバとなります。 イベントサーバ名に@を指定すると，DNSに対応したイベントサーバとなります。

イベントサーバ設定ファイル（conf）のパラメーター
パラメーター v5-unused未設定時 v5-unused設定時
users *を指定すると，すべてのユーザーからJP1イベントを取得できるようになります。ただし，バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブを使用してJP1イベントを取得する場合には，ユーザー名の指定が必要です。 ユーザー名の指定は不要です。
eventids *を指定すると，すべてのJP1イベントを取得できるようになります。ただし，バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブを使用して取得または発行する場合，イベントIDが指定されていなければなりません。 *を指定すると，すべてのJP1イベントを取得できるようになります。
buffnum バージョン5以前の製品であるJP1/SESおよびJP1/AJSの関数，コマンド，またはジョブでJP1イベントを取得するために保存しておくJP1イベント数を指定します。 このパラメーターは無視されます。
include ses-conf バージョン5以前の製品であるJP1/SESの環境定義ファイルから，バッファー数（BUFFNUM），ユーザー名（USER），イベントID（EVIDxxxx）の指定を取り込むことを指定します。 このパラメーターは無視されます。
include ajs-conf バージョン5以前の製品であるJP1/AJS - EEの設定ダイアログボックスで指定した，最大イベント数，UNIXユーザーID，UNIXグループID，ユーザー名，およびイベントIDの指定を取り込むことを指定します。 このパラメーターは無視されます。
options conv-offを指定するとバージョン5以前の製品であるJP1/SES，JP1/AJSとの互換性のために用意されているJP1/SES互換用イベント取得関数の利用を抑止します。 v5-unusedはconv-offで有効になる機能を含んでいます。指定してもエラーにはなりませんが，指定する必要はありません。
remote-server 通信タイプにsesを指定するとバージョン5以前の製品であるJP1/SESのプロトコルでJP1イベントを送受信します。 通信タイプにsesが指定されたイベントサーバへの転送は常に失敗します。

注意事項
この設定はバージョン8以降のJP1/Baseのデフォルトの設定となります。

KAJP1037-hntroff
KAJP1037-E（イベント転送失敗）メッセージの統合トレースログへの出力を抑止します。

KAJP1037-syslogoff
KAJP1037-E（イベント転送失敗）メッセージのsyslog（UNIX）およびイベントログ（Windows）への出力を抑止します。

注意事項
KAJP1037-hntroff，KAJP1037-syslogoffを設定しても，転送エラーを通知するKAJP1017-Eは統合トレースログおよびsyslog（UNIX），イベントログ（Windows）に出力されます。転送エラーはKAJP1017-Eで監視してください。
KAJP1037-Eメッセージは，イベントサービス転送エラーログ（fwderr.*）でも確認することができます。

(n)　remote-server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

他サーバへイベントを転送する際の接続方法を指定します。このパラメーターには，異なるイベントサーバ名を複数指定できます。

イベントサーバ名
定義するイベントサーバ名を，次に示すどちらかの形式で指定します。
  • イベントサーバ名
    個別のイベントサーバ名を，255バイト以内で指定します。
  • *
    個別に指定されなかったイベントサーバ名に対する省略値を指定します。
    この指定がない場合は，個別に指定されていないイベントサーバに対してはイベントを転送できません。

通信タイプ
指定したイベントサーバへの接続の方法を指定します。
  • keep-alive
    JP1イベントの転送の必要が発生したら，転送元からTCP/IPのコネクションを張って送信します。 JP1イベント送信後，イベントサーバの終了時までコネクションは保存され再利用します。

注意事項
ファイアウォールで無通信時にコネクションを切断する設定を行っている場合，または一時的な通信障害が発生した場合は，コネクション切断後の最初のJP1イベントの転送が失敗するおそれがあります。
  • close
    JP1イベントの転送の必要が発生したら，転送元からTCP/IPのコネクションを張って送信します。送信後は3秒後にコネクションを切断します。
  • ses
    バージョン5以前の製品であるJP1/SESのプロトコルでJP1イベントを送信します。JP1/SESのプロトコル（SESプロトコル）を利用しているJP1/OJEなど，JP1/BaseがないシステムにJP1イベントを送信する場合，この指定が必要です。バージョン5以前の製品であるJP1/SESのプロトコルの詳細については，「6.8　従来のイベントサーバとの互換性」を参照してください。
    なお，コネクションはJP1イベント送信後も保存されます。通信タイプにsesを指定した場合，パラメーター（remote-server）にアドレス，およびポート指定を指定しても無視されます。

アドレス
使用するIPアドレスを次に示すどちらかの形式で指定します。対象とするイベントサーバの，イベントサーバ設定ファイルに記述されたportsパラメーターの指定と一致させてください。
省略すると，ホスト名としてイベントサーバ名を仮定します。
  • IPアドレス
    ピリオドで区切った10進数（例: 172.16.50.50）で指定します。
  • ホスト名
    システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

ポート指定
使用するポート番号を次に示すどちらかの形式で指定します。対象とするイベントサーバの，イベントサーバ設定ファイルに記述されたportsパラメーターの指定と一致させてください。
省略すると，自イベントサーバの転送用ポートと同じ値を仮定します。
  • ポート番号
    ポート番号を，10進数で指定します。
  • サービス名
    システムのservicesファイルで定義されている，tcpのサービス名を指定します。

(o)　error-size　ファイルサイズ

イベントサービスエラーログファイル（error.*）の最大容量（バイト数）を指定します。指定したサイズを超えると，イベントサービスエラーログファイルは， 先頭から上書きされます。

値は，65,536〜2,147,483,647までの10進数で指定します。省略すると，500,000バイトを仮定します。

保存する日数分のイベントサービスエラーログファイルの容量の計算式を次に示します。ファイルサイズを指定する際に参考にしてください。

　
ａ + (ｂ × ｃ) × d （バイト）
　

a：基本部1キロバイト。

b：エラーのメッセージの平均サイズ（約120バイト）。

c：1日当たりのエラーの発生回数。

d：保存する日数。

(p)　trace-size　ファイルサイズ

イベント転送トレースログファイル（trace.*）の最大容量（バイト数）を指定します。指定したサイズを超えると，イベント転送トレースログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する日数分のイベント転送トレースログファイルの容量の計算式を次に示します。ファイルサイズを指定する際には，ログの出力量および1日当たりのイベント取得件数も考慮に入れて設定してください。

　
a + (b + c + d) × e （バイト）
　

a：基本部1キロバイト。

b：イベント1件登録時のログの出力量 × 1日当たりのイベント登録件数

c：イベント1件取得時のログの出力量 × 1日当たりのイベント取得件数

d：イベント1件転送時のログの出力量 × 1日当たりのイベント転送件数

e：保存する日数。

ログの出力量はイベントサービスの動作によって異なりますが，参考値としてのログの出力量を次に示します。

出力されるログの量(バイト)
イベント1件登録時 イベント1件取得時※1 イベント1件転送時※2（失敗時・イベント転送リトライ設定あり）
約150※3 約150※3 約1,500

注※1　イベント取得とは，他アプリケーションによるJP1イベントの取得を含みます。参考値は，10件登録されているイベントデータベースの10件目のJP1イベント取得時のログ出力量となっています。また，イベントデータベースに登録されているJP1イベントの件数と，検索するJP1イベントの登録位置によって出力される量は変わります。

注※2　JP1イベント転送時にログ出力が最大になるのは，JP1イベントの転送に失敗し，リトライする場合です。

注※3　API設定ファイルで，通信タイプをcloseに設定した場合のログの量です。


イベント取得件数は，ユーザーアプリケーションやJP1シリーズのプログラムからイベント取得関数を使用してイベントを取得する件数です。JP1シリーズのプログラムの1日当たりのイベント取得件数は，次の計算式で求めた値を目安にしてください。

　
イベント取得回数※1 × イベントデータベースに登録されているイベント数 + 1日当たりのイベント登録件数※2
　

注※1　JP1/IMから，下記の回数の合計分だけイベントデータベースに対してイベントを取得します。
  • JP1/IM - Viewの起動の回数
  • JP1/IM - Viewのイベント検索の回数

注※2　JP1/AJS2のイベント受信ジョブが実行登録されている場合，JP1/AJS2は，新たにイベントデータベースに登録されたイベントを取得します。なお，イベント受信ジョブが複数登録されていても，JP1/AJS2は登録されたイベントに対して1回だけイベントを取得します。

(q)　evtlog-size　ファイルサイズ

イベントサービストレースログファイル（imevterr.*）の最大容量（バイト数）を指定します。指定したサイズを超えると，イベントサービストレースログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する日数分のイベントサービストレースログの容量の計算式を次に示します。ファイルサイズを指定する際には，ログの出力量および1日当たりのイベント取得件数も考慮に入れて設定してください。

　
a + (b + c + d) × e （バイト）
　

a：基本部1キロバイト。

b：イベント1件登録時のログの出力量 × 1日当たりのイベント登録件数

c：イベント1件取得時のログの出力量 × 1日当たりのイベント取得件数

d：イベント1件転送時のログの出力量 × 1日当たりのイベント転送件数

e：保存する日数。

ログの出力量はイベントサービスの動作によって異なりますが，参考値としてのログの出力量を次に示します。なお，イベントサービストレースログファイルは，log-levelパラメーターで設定されたログレベルに影響されません。

出力されるログの量（バイト）
イベント1件登録時 イベント1件取得時※1 イベント1件転送時※2（失敗時・イベント転送リトライ設定有り）
約3,000 約7,000 約3,000

注※1　イベント取得とは，他アプリケーションによるJP1イベントの取得を含みます。参考値は，10件登録されているイベントデータベースの10件目のJP1イベント取得時のログ出力量となっています。また，イベントデータベースに登録されているJP1イベントの件数と，検索するJP1イベントの登録位置によって出力される量は変わります。

注※2　JP1イベント転送時にログ出力が最大になるのは，JP1イベントの転送に失敗し，リトライする場合です。


イベント取得件数は，ユーザーアプリケーションやJP1シリーズのプログラムからイベント取得関数を使用してイベントを取得する件数です。JP1シリーズのプログラムの1日当たりのイベント取得件数は，次の計算式で求めた値を目安にしてください。

　
イベント取得回数※1 × イベントデータベースに登録されているイベント数 + 1日当たりのイベント登録件数※2
　

注※1　JP1/IMから，下記の回数の合計分だけイベントデータベースに対してイベントを取得します。
  • JP1/IM - Viewの起動の回数
  • JP1/IM - Viewのイベント検索の回数

注※2　JP1/AJS2のイベント受信ジョブが実行登録されている場合，JP1/AJS2は，新たにイベントデータベースに登録されたイベントを取得します。なお，イベント受信ジョブが複数登録されていても，JP1/AJS2は登録されたイベントに対して1回だけイベントを取得します。

(r)　log-keep　ログファイルの個数

イベントサービスエラーログファイル，イベント転送トレースログファイル，およびイベントサービストレースログファイルを最大で幾つ作成するかを指定します。ログファイルは，イベントサービスの起動時に作成されます。イベントサービスの起動時に，指定した数以上のファイルがある場合は，最も古いファイルから削除されます。

値は，0〜50の10進数で指定します。省略すると，5を仮定します。0を指定するとログを保存しません。

(s)　log-level　レベル

06-51以前のJP1/Baseでは，syslog，イベントログ，イベントサービスエラーログファイル，およびイベント転送トレースログファイルへのログの出力レベルを指定できます。

値は，1〜10の10進数で指定します。省略すると，1を仮定します。通常は，値を1にしてご利用ください。なお，2以上の値を設定した場合は，障害発生時や障害から回復した場合などの詳細なログが出力されるようになります。

06-71以降のJP1/Baseでは，値に関係なく詳細なログが出力されるため，設定する必要はありません。

(t)　forward-timeout　待ち時間

JP1イベントを転送する場合に，転送先からの応答を待つ時間を秒単位で指定します。指定した時間内に応答がなかった場合は，転送失敗と見なします。

値は，10〜600の10進数で指定します。省略すると，90秒を仮定します。

(u)　retry-interval　転送リトライ間隔

JP1イベントの転送失敗時にリトライを行う間隔を秒単位で指定します。

値は，60〜2,147,483,647の10進数で指定します。after-errorパラメーターよりも大きい値を指定してください。このパラメーターを省略すると，600秒を仮定します。

(v)　repetition-noncheck-server　{　*　|　イベントサーバ名　}　…

重複登録チェックを抑止するイベントサーバ名を指定します。

JP1/SESのプロトコルで発生したイベントを複数経路から転送する場合にイベントのロストを防ぐために使用します。

重複登録チェックとは，JP1イベントの転送を受信する際にそのJP1イベントがすでに登録されているかどうかをチェックする処理のことを指します。重複と判断されるのは，JP1イベントの発行元イベントサーバ名，発行元イベントDB内通し番号，登録時刻が一致する場合です。

このパラメーターは複数指定でき，すべての指定の和が，重複登録チェックを抑止するイベントサーバとなります。このパラメーターを一つも指定しないと，すべての転送元イベントサーバからのJP1イベントの重複登録チェックを行います。

*
すべての転送元イベントサーバからの重複登録チェックが抑止されます。

イベントサーバ名
重複登録チェックを抑止するイベントサーバ名を個別に指定します。イベントサーバ名は大文字・小文字を区別します。

(w)　restart　再起動回数　リトライ間隔　リセット時間

物理ホストのイベントサービスのプロセスが異常終了した場合に，再起動するための設定として，再起動回数，再起動のリトライ間隔および再起動回数のリセット時間を指定します。リセット時間で指定した期間内にプロセスが異常終了した回数が，再起動回数以下であれば，プロセスは再起動されます。再起動されると，回復したときにメッセージ（KAJP1072-I）を出力します。このメッセージはJP1イベント（イベントID：00003D04）としても通知されます。したがって，運用時にこのJP1イベントを監視すると，イベントサービスのプロセスが再起動されたことを検知できます。この指定はUNIX版のJP1/Baseだけで有効になり，Windows版のJP1/Baseでは無効になります。このパラメーターを省略した場合，イベントサービスのプロセスが異常終了しても，再起動されないため，イベントサービスは停止します。

なお，イベントサービスの再起動中は，転送元ホストから転送されるJP1イベントを受け付けられません。転送元ホストでJP1イベント転送のリトライを設定している場合は転送がリトライされますが，リトライ期間を過ぎると転送失敗となります。このような転送失敗を防ぐために，再起動回数ｘリトライ間隔の値は，転送元ホストのconfで指定するJP1イベント転送のリトライ期限（forward-limitパラメーター）の値より小さくなるよう設定してください。

再起動回数
再起動の試行回数を指定します。推奨値は4です。値は，0〜99の10進数で指定します。0を指定した場合，再起動されません。-1以下の値を指定した場合，0を仮定します。100以上の値を指定した場合，99を仮定します。

リトライ間隔
イベントサービスのプロセスが異常終了してから再起動をするまでの間隔を秒単位で指定します。再起動に失敗した場合は，指定した間隔後に再起動します。推奨値は15です。値は，0〜3,600の10進数で指定します。-1以下の値を指定した場合，0を仮定します。3,601以上の値が指定された場合，3,600を仮定します。

リセット時間
再起動によってプロセスが起動してから，何秒後に再起動回数をリセットするかを秒単位で指定します。プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。リセット時間の推奨値は，3,600秒です。値は，3,600〜2,147,483,647の10進数で指定します。3,599以下の値を指定した場合，3,600秒が仮定されます。2,147,483,648以上の値を指定した場合，2,147,483,647秒を仮定します。

推奨値である，再起動回数に4回，リトライ間隔に15秒，リセット時間に3,600秒を設定した場合の動作を次の図に示します。

図6-2　イベントサービスのプロセスが異常終了した場合の動作例

[図データ]

図の例では，再起動後，再起動回数のリセット時間で指定した3,600秒以内に異常終了しなかった場合，3,600秒の時点で再起動回数がリセットされます。次回異常終了したときには1回目からカウントされます。一方，再起動後，3,600秒以内に異常終了した場合は，再起動回数を引き継ぎます。再起動回数が指定した回数に達すると，次回異常終了時には再起動しません。

注意事項
  • restartパラメーターの設定によって再起動できるイベントサービスのプロセスは，jevstatコマンドで確認できるプロセスIDのjevserviceプロセスの子プロセスだけです。
  • 親プロセスが異常終了した場合，イベントサービスは停止します。
  • 再起動回数は，子プロセスごとにカウントされます。

jevserviceプロセスの子プロセスには，次の6種類があります。

表6-1　イベントサービスのプロセス構成

親プロセス 子プロセス 概　要
jevservice jevservice（LogTrc） syslogまたは統合トレースログなどへ記録されるメッセージを出力します。
jevservice（DBMngr） イベントデータベースを管理します。
jevservice（SESEmu） SES互換機能です。optionsパラメーターにv5-unusedフラグを設定している場合は起動しません。
jevservice（EvtAPI） JP1イベントの登録要求または取得要求を受け付けます。
jevservice（FwdRcv） 転送されてきたJP1イベントを受信します。
jevservice（FwdMgr） JP1イベントを転送します。

(x)　fwderr-size　ファイルサイズ

イベントサービス転送エラーログファイル（fwderr.*）の最大容量（バイト数）を指定します。指定したサイズを超えると，イベントサービスエラーログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する転送失敗イベント数分の転送エラーログ容量の計算式を次に示します。

 
保存する転送失敗イベント数×（ 150 ＋ イベントサーバ名長 ＋送信先イベントサーバ名長）

送信先イベントサーバが複数ある場合，送信先イベントサーバ名長は，送信先イベントサーバの中で最も長い送信先イベントサーバ名長とします。

(4)　設定例

イベントサーバ設定ファイルの設定例を次に示します。

[図データ]

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.