Interstage Application Server チューニングガイド
目次 索引 前ページ次ページ
付録A CORBAサービスの動作環境ファイル

A.1 config

概要

　configファイルは、CORBAサービスの各種動作環境に関する定義が格納されたファイルです。

ファイル名

　Linuxサーバ(インストールパスはデフォルト)：
　　/etc/opt/FJSVod/config
　Windows(R)クライアント(インストールパスはデフォルト)：
　　C:\INTERSTAGE\ODWIN\etc\config

ファイル内情報

形式：

　configは、以下の形式で値を設定します。

　パラメタ名 = 設定値

　半角のシャープ(#)を行の先頭に指定した場合は、その行はコメントとして扱われます。また、空行は解析時に無視されます。

　# コメント

記述例：

# comment
period_receive_timeout = 72

パラメタ：

　以下の動作環境について、パラメタ設定値を変更することができます。

◆ホスト情報に関する動作環境

パラメタ名

初期値

意味

備考

省略値

指定範囲

IIOP_hostname

-

マシンにIPアドレス(またはホスト名)が複数設定されている場合に、CORBAサーバアプリケーションで使用するIPアドレスを限定した運用を行う場合に設定します。
IPアドレス(またはホスト名)を設定すると、サーバアプリケーションのオブジェクトリファレンスの生成時には、ここで設定したIPアドレスが組み込まれ、クライアントからの接続時に使用されます。また、CORBAサービスは指定されたIPアドレスのみでバインドを行います。
本パラメタが省略された場合は全てのIPアドレスに対してバインドが行われます。ただし、IPv4/IPv6のどちらの(または両方の)IPアドレスをバインドするかどうかはIP-versionパラメタの設定に依存します。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注1)(注2)

-

-

IIOP_port

8002

CORBAサービスが使用するポート番号。
初期値(8002)以外を指定する場合は必ず指定してください。

(注3)

-

-

(注1)
　例えばLANカードが複数装着されたマシンにおいて、1つのLANカードからのみ接続要求を受け付けることができます。

　ホスト名が指定された場合はIP-versionの値に従って名前解決が行われます。
　IP-versionがv4-dualの場合はIPv4での名前解決が優先的に行われます。
　IP-versionがv6の場合はIPv6での名前解決が優先的に行われます。

(注2)
　必要の無い限り本パラメタを設定しないでください。注1に記述されているような特殊用途以外では設定する必要はありません。誤ったホスト名を設定するとInterstageの起動が失敗します。
　また、“localhost”を設定すると“127.0.0.1”（IPv4環境の場合）のみでバインドが行われ、他ホストからのリクエストが受け付けられなくなりますので“localhost”と設定しないで下さい。“127.0.0.1”（IPv4環境の場合）のIPアドレスで定義されているホスト名を設定した場合も同様に他ホストからのリクエストが受け付けられなくなります。LinuxではOSインストール直後の状態では自ホスト名に対するIPアドレスが127.0.0.1に設定されており、自ホスト名をIIOP_hostnameに設定すると他ホストからの接続を受け付けることができなくなります。

(注3)
　この値が無効になると/etc/servicesの設定値が有効になります。

◆ネットワーク環境に関する動作環境

パラメタ名

初期値

意味

備考

省略値

指定範囲

con_accept

all

クライアントからの接続受付けを自ホストに制限する場合に“localhost”を指定。
“localhost”を指定すると、自ホストからの接続のみを受け付け、他ホストからの接続を受け付けません。“all”を指定すると、すべてのマシンからの接続を受け付けます。
システムセキュリティなどの理由で、他ホストからの接続要求を許可しない場合に“localhost”に指定してください。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。

all

all, localhost

IP-version

v4-dual

運用するIPバージョンを設定します。

  • v4：IPv4のみを利用してCORBAアプリケーションを運用します(IPv6は使用しません)。
  • v4-dual：IPv4及びIPv6を利用してCORBAアプリケーションを運用します。
    サーバとして動作する際はIPv4及びIPv6の両方を受け付けます。
    クライアントとしての動作する際にIPv4を優先的に利用します。
  • v6：IPv4及びIPv6環境で、CORBAアプリケーションを運用します。
    サーバとして動作する際はIPv4及びIPv6の両方を受け付けます。
    クライアントとしての動作する際にIPv6を優先的に利用します。

IPv6に対応していない環境で“v4-dual”もしくは“v6”を指定した場合、“v4”が設定されます。

　

v4-dual

v4, v4-dual, v6

read_interval_timeout

30

ソケットに対する読み込みの待機時間。
この時間を超えても読み込みできない状態が持続する場合、アプリケーションにシステム例外(COMM_FAILURE)が通知されます。
この値が実際の時間(秒)となります。0を設定した場合、時間監視をしません。

このパラメタによる監視は電文の受信処理が始まってから開始されます。例えば、リプライの受信待ちの状態においてパケットが一つも届かなければread_interval_timeoutによる監視は行いません。この場合はperiod_receive_timeoutによる監視が行われます。パケットが一つでも届くと電文の受信処理を開始するためread_interval_timeoutによる監視が行われます。

　

30

0〜100000000

write_interval_timeout

30

ソケットに対する書き込みの待機時間。
この時間を超えて書き込みできない状態が持続する場合、アプリケーションにシステム例外(COMM_FAILURE)が通知されます。
この値が実際の時間(秒)となります。0を設定した場合、時間監視をしません。

このパラメタによる監視は電文の送信処理が始まってから開始されます。

　

30

0〜100000000

tcp_nodelay

no

TCP_NODELAY機能を有効にするか無効にするかを設定します。“yes”を指定した場合は電文送信時においてNagleアルゴリズムを無効にします。“no”を指定した場合はNagleアルゴリズムは有効となります。
Nagleアルゴリズムが有効の場合、送信データのバッファリングを行うためネットワーク使用効率が上がります。Nagleアルゴリズムを無効にした場合、送信データのバッファリングを行わないためネットワーク使用効率が下がり通信全体の性能が下がる可能性がありますが、データの送受信に発生するタイムラグが減少し、応答性能が向上する場合があります。

　

no

yes, no

◆アプリケーション資源に関する動作環境（プロセス/スレッド多重度、使用コネクション数など）

これらのパラメタに実際に指定可能な値はOSの資源によって制限されます。

パラメタ名

初期値

意味

備考

省略値

指定範囲

max_exec_instance

512(注6)

サーバアプリケーションのリクエスト実行用スレッド(またはプロセス)の最大数。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注1) (注2)

256

16〜1000000

max_IIOP_local_init_con

256

クライアントアプリケーションが使用するサーバホストへのコネクションの最大値。

ポイント参照

256

1〜1000000

max_IIOP_local_init_requests

4096

クライアントアプリケーションが同時に送信できるリクエスト数の最大値。

　

4096

1〜1000000

max_IIOP_resp_con

8(注6)

クライアントアプリケーションと確立できる接続の最大値。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。
ポイント参照
(注2)

8

1〜500000

limit_of_max_IIOP_resp_con

0

max_IIOP_resp_conの自動拡張の最大値。0を指定すると以下の値が設定されます。
max_IIOP_resp_con*1.3（小数部分切り捨て）

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注2) (注4)

0

0〜1000000

max_IIOP_resp_con_extend_number

0

max_IIOP_resp_conの自動拡張の拡張数。0を指定すると以下の値が設定されます。
(limit_of_max_IIOP_resp_con　- max_IIOP_resp_con) / max_IIOP_resp_con（小数部分切り上げ）

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注4) (注5)

0

0〜1000000

max_IIOP_resp_requests

128(注6)

サーバホストにおいて同時に受信できるリクエスト数の最大値。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。
(注2) (注7)

128

1〜500000

limit_of_max_IIOP_resp_requests

0

max_IIOP_resp_requestsの自動拡張の最大値。0を指定すると以下の値が設定されます。
max_IIOP_resp_requests*1.3（小数部分切り捨て）

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注2) (注4) (注7)

0

0〜1000000

max_IIOP_resp_requests_extend_number

0

max_IIOP_resp_requestsの自動拡張の拡張数。0を指定すると以下の値が設定されます。
(limit_of_max_IIOP_resp_requests　- max_IIOP_resp_requests) / max_IIOP_resp_requests（小数部分切り上げ）

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注4) (注5)

0

0〜1000000

max_processes

20(注6)

最大プロセス数。(起動クライアント+サーバ数)

サーバ機能のみ有効。
(注2) (注3)

16

1〜1000000

max_impl_rep_entries

512

インプリメンテーションリポジトリの最大登録数。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。

256

100〜1000000

number_of_common_buffer

0

CORBAサービスのキュー制御で使用するデフォルトバッファのバッファ数を指定します。
ワークユニット運用されているCORBAアプリケーションでワークユニット定義の“Buffer Number:通信バッファ数”を指定しているCORBAアプリケーションを除く、CORBAサービスの通信で使用します。
サーバマシン上で同時に処理される最大リクエスト数を指定してください。
0を指定すると、以下の値が設定されます。
max_IIOP_resp_requests*0.2（小数部分切り捨て）

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。
(注2)

0

0〜500000
(注7)

limit_of_number_of_common_buffer

0

number_of_common_bufferの自動拡張の最大値。0を指定すると以下の値が設定されます。
limit_of_max_IIOP_resp_requests

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注2) (注4)

0

0〜1000000
(注7)

number_of_common_buffer_extend_number

0

number_of_common_bufferの自動拡張の拡張数。0を指定すると以下の値が設定されます。
(limit_of_number_of_common_buffer　- number_of_common_buffer) / number_of_common_buffer（小数部分切り上げ）

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは指定不可。
(注4) (注5)

0

0〜1000000

(注1)
　設定値の目安：
　　登録アプリケーション数(*1)×スレッド最大多重度(*2)＋64
　　＋接続クライアント数(*3)

　　*1) OD_impl_instコマンドで登録したアプリケーション数
　　*2) OD_impl_instコマンドで指定するthr_conc_maximum値
　　*3) isgendefコマンドのscale-valueに対応した接続クライアント数。

(注2)
　サーバ機能では、本パラメタの設定値および実際の消費量をodprtcurparamコマンドにより確認することができます。

　初期値より増加させる場合、システム資源（共用メモリなど）のチューニングが必要です。詳細については、“CORBAサービスのシステム環境の設定”を参照してください。

　bashまたはボーンシェルの場合はulimitコマンドを、Cシェルの場合はlimitコマンドを使用して、ファイルディスクリプタ数を“max_IIOP_resp_con値＋max_processes値”だけ拡張してからCORBAサービスおよびCORBAアプリケーションを起動してください。

(注3)
　CORBAサービスのプロセス(CORBAサービス、ネーミングサービス、インタフェースリポジトリサーバ、インタフェースリポジトリキャッシュサーバ)も含みます。見積もりを行う場合、Interstageのサービスの使用分(20)にアプリケーション使用分を加算してください。
　CORBAサービスのコマンドも含みます。コマンドを同時に複数起動する場合は、その数を加算してください。

(注4)
自動拡張について

自動拡張を行うパラメタについてはlimit_of_[パラメタ名]というパラメタと[パラメタ名]_extend_numberというパラメタが存在します。例えば、max_IIOP_resp_conというパラメタについてはlimit_of_max_IIOP_resp_con・max_IIOP_resp_con_extend_numberが存在します。

そして、各パラメタは初期値を[パラメタ名]、最大値をlimit_of_[パラメタ名]として、[パラメタ名]_extend_number分割で必要に応じて拡張を行います。

以下に例を示します。

例：

max_IIOP_resp_con = 100
limit_of_max_IIOP_resp_con = 140
max_IIOP_resp_con_extend_number = 2

上記のパラメタの場合、max_IIOP_resp_conは初期値を100として、120、140と最大2回の拡張を行います。

なお、isconfig.xmlファイルの定義項目AutoConfigurationModeにMANUALを指定した場合、自動拡張に関するパラメタは無視され拡張は行いません。isconfig.xmlについての詳細に関しては“Interstage Application Server 運用ガイド”を参照してください。

(注5)
一度の拡張処理で増加できるサイズは初期値のサイズに制限されます。
一度の拡張サイズが初期値のサイズを超える拡張を行う設定がされた場合、拡張数は0が設定された場合と同様の値に補正されます。
また、自動拡張の最大値と初期値との差分よりも拡張数が大きい場合は、拡張数は自動拡張の最大値と初期値との差分の値に補正されます。

例：

max_IIOP_resp_con = 100
limit_of_max_IIOP_resp_con = 300
max_IIOP_resp_con_extend_number = 1

上記のパラメタの場合、max_IIOP_resp_con_extend_numberは2に補正されます。

(注6)
以下の場合は初期値が異なります。

初期値は以下のように変更されています。

パラメタ名

初期値

max_IIOP_resp_con

512

max_IIOP_resp_requests

2048

max_processes

512

max_exec_instance

16384

(注7)
　
　number_of_common_bufferとlimit_of_number_of_common_bufferの設定可能な値はSolaris 9ではシステムパラメタのsemvmx値、Solaris 10では65535が最大値になります。
　
　number_of_common_bufferとlimit_of_number_of_common_bufferの設定可能な値はSEMVMXのOS実装値(32767)が最大値になります。

　なお、number_of_common_bufferとlimit_of_number_of_common_bufferの設定を省略した場合は、max_IIOP_resp_requestsとlimit_of_max_IIOP_resp_requestsの値から求まる各パラメタの値が設定可能な最大値を超過しないか確認をお願いします。

　max_IIOP_local_init_con、max_IIOP_resp_conについて

　CORBAサービスは、サーバアプリケーションが動作しているマシンごとに1つのコネクションを使用します。

　max_IIOP_local_init_conは各アプリケーションが使用するサーバホストへのコネクション数の最大値を指定します。
max_IIOP_resp_conは、各ホストで使用するアプリケーション間のコネクション数を指定します。

　原則として、アプリケーション間のコネクションはクライアントアプリケーションのプロセス単位に生成されます。例えば、クライアントアプリケーションから1つのサーバアプリケーションに複数のリクエストが同時に発行されても、コネクション数は1になります。
　SSL連携機能を使用する場合、SSL接続のコネクションとSSL接続でないコネクションは別コネクションとして数える必要があります。例えば、クライアントアプリケーションから、１つのサーバマシンにSSL接続のコネクションとSSL接続でないコネクションを使用した場合、コネクション数は2になります。

　なお、以下の場合にはコネクションを使用するので必要に応じて加算する必要があります。

　以下に、各パラメタのコネクション数のカウント方法を示します。

max_IIOP_local_init_con:

　クライアントアプリケーションが動作しているホスト上で、クライアントアプリケーション（プロセス単位）からサーバアプリケーション（ホスト単位）へのコネクション数の最大値を指定します。
　　設定値の目安（インタフェースリポジトリ動作時）：
　　　max_IIOP_local_init_con = [１つのクライアントアプリケーションが接続するサーバホスト数の最大値]と256のうちの最大値

　　設定値の目安（インタフェースリポジトリ動作時、SSL連携機能を使用）：
　　　max_IIOP_local_init_con = [１つのクライアントアプリケーションが接続するサーバホスト数の最大値×2]と256のうちの最大値

max_IIOP_resp_con:

　サーバアプリケーションが動作しているホスト上で、接続するクライアントアプリケーションのプロセス数の合計を指定します。同一ホスト上でクライアントアプリケーションとサーバアプリケーションが接続する場合も、そのコネクション数を加算する必要があります。

　　設定値の目安（インタフェースリポジトリ動作時）：
　　　max_IIOP_resp_con = 接続するクライアントアプリケーションのプロセス数 ＋ 2

　　設定値の目安（インタフェースリポジトリ動作時、SSL連携機能を使用）：
　　　max_IIOP_resp_con = ( 接続するクライアントアプリケーションのプロセス数 × 2 ) ＋ 2

max_IIOP_local_init_requests、max_IIOP_resp_requestsについて

　CORBAサービスでは、クライアントアプリケーションが同時に送信するリクエスト数に応じてmax_IIOP_local_init_requestsを設定する必要があります。また、サーバアプリケーションが同時に受信するリクエスト数に応じてmax_IIOP_resp_requestsを設定する必要があります。

max_IIOP_local_init_requests:

クライアントアプリケーションが同時に送信できるリクエスト数の最大値を指定します。下の図ではクライアントアプリケーション1が5個のリクエストを同時に送信し、アプリケーション2が1個のリクエストを同時に送信しています。このため、max_IIOP_local_init_requestsは5以上の値を設定する必要があります。

ただし、算出された値が4096以下の場合は初期値の4096のままで問題ありません。この例では4096に満たないのでmax_IIOP_local_init_requestsはデフォルトの4096から変更の必要はありません。

max_IIOP_resp_requests:

CORBAサーバアプリケーションが同時に受信できるリクエスト数の最大値を指定します。

それぞれのクライアントマシンから発行されたリクエストがサーバマシンに到達し、CORBAサーバアプリケーションで同時に処理される数になるので、個々のクライアントマシンから同時に発行されるリクエストの合計値を見積もる必要があります。

下の図ではそれぞれのクライアントマシンから発行されたリクエストが同時に9個サーバマシンに到達しているので、max_IIOP_resp_requestsには9以上を設定する必要があります。

◆タイムアウト監視に関する動作環境

パラメタ名

初期値

意味

備考

省略値

指定範囲

period_client_idle_con_timeout

0

クライアントにおける、無通信状態（サーバへのリクエスト送信なし）の監視時間（リクエスト返信完了後のコネクション維持時間）。
この時間を超えてもサーバへのリクエスト送信がない場合、次回リクエスト送信時に、サーバとのコネクションの切断・再接続を行います。
この値に5を乗じた値が実際の時間(秒)となります。0を設定すると無通信監視を行いません。

　

0

0〜20000000

period_idle_con_timeout

120 (600秒)

サーバにおける、無通信状態（クライアントからのリクエスト送信なし）の監視時間（リクエスト返信完了後のコネクション維持時間）。
この時間を超えてもクライアントからのリクエスト送信がない場合、クライアントとのコネクションを切断し、リクエスト処理に使用したメモリ資源を解放します。
この値に5を乗じた値が実際の時間(秒)となります。0を設定すると無通信監視を行いません。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。

1 (5秒)

0〜20000000

period_receive_timeout

72 (360秒)

クライアントにおける、リクエスト送信から返信までの待機時間。この時間を超えてもサーバからの返信がない場合、クライアントにタイムアウトが通知されます。
この値に5を乗じた値が実際の時間(秒)となります。

　

72 (360秒)

0〜20000000

period_server_timeout

120 (600秒) (注1)

Persistentタイプ以外のサーバアプリケーションとその他のアプリケーションで意味が異なります。
Persistentタイプ以外のサーバアプリケーションにおいてはアプリケーション起動からCORBA_ORB_initメソッド完了までの監視時間となります。この時間以内にCORBA_ORB_initメソッドが完了しないとクライアントにシステム例外(NO_IMPLEMENT)が通知されます。
クライアントアプリケーションとPersistentタイプのサーバアプリケーションにおいてはCORBA_ORB_initメソッド発行からCORBA_ORB_initメソッド完了までの監視時間となります。
この値に5を乗じた値が実際の時間(秒)となります（0は指定できません）。

サーバ機能のみ有効。
Interstage Application Server Web-J Editionでは初期値から変更しないでください。

120 (600秒)

1〜20000000

(注1)
　初期値より減少させた場合は、インタフェースリポジトリの起動に失敗することがあります。


　タイムアウト時間は、連携するアプリケーションに適用されるタイムアウト時間を考慮して設定する必要があります。詳細は“OLTPサーバ運用ガイド”（Interstage Application Server Enterprise Editionで提供）の“CORBAアプリケーションのタイマ監視”、または“J2EEユーザーズガイド”の“ワークユニットの設計”−“タイマ監視”−“CORBAアプリケーションのタイマ監視”を参照してください。

◆セキュリティ機能に関する動作環境（アプリケーション間通信）

パラメタ名

初期値

意味

備考

省略値

指定範囲

http_proxy

proxy_host

HTTPプロキシサーバのホスト名。

Interstage Application Server Web-J Editionでは初期値から変更しないでください。
(注1)

null (値は設定されません)

-

http_proxy_port

8080

HTTPプロキシサーバのポート番号。

Interstage Application Server Web-J Editionでは初期値から変更しないでください。
(注1)

0

-

http_proxy_use

no

HTTPプロキシサーバの使用を指定(yes:使用する、no:使用しない)。

Interstage Application Server Web-J Editionでは初期値から変更しないでください。
(注1)

no

yes, no

UNO_IIOP_ssl_use

no

SSL連携の有効/無効を選択(yes:有効、no:無効)。

(注2)

no

yes, no

UNO_IIOP_ssl_port

4433

SSL連携で使用するポート番号。UNO_IIOP_ssl_useが“yes”の場合に有効です。

　

4433

-

(注1)
　プレインストール型ランタイム(Portable-ORB以外の実行環境)でHTTPプロキシサーバを経由してHTTPトンネリングを使用する場合に指定します。http_proxy、http_proxy_portは、“http_proxy_use=yes”のときに有効であり、Webブラウザで使用しているHTTPプロキシサーバのホスト名とポート番号を指定します。

(注2)
　SSL接続のコネクションとSSL接続でないコネクションは別コネクションとして数える必要があります。max_IIOP_resp_con、max_IIOP_local_init_conパラメタを見積もる際には注意してください。

◆セキュリティ機能に関する動作環境（資源保護）

パラメタ名

初期値

意味

備考

省略値

指定範囲

iss_use

no

資源保護機能の有効/無効を指定。“yes”を指定すると、CORBAアプリケーションはiss_uidのユーザID(またはroot)のみが起動可能となります。

(注1)

no

yes, no

iss_uid

root

資源保護機能有効時（iss_use=yes指定）のアプリケーション動作のユーザIDを指定。

(注2) (注3)

root

-

iss_gid

-

資源保護機能有効時（iss_use=yes指定）のアプリケーション動作のグループIDを指定。

　

iss_uidのプライマリグループID

-

(注1)
　資源保護機能を有効（iss_use=yes）に設定する場合には、Interstage (CORBAサービス)の環境設定前後で手順が異なります。詳細は“セキュリティシステム運用ガイド”の“セキュリティの強化（Interstage資源の保護）”を参照してください。
　Interstage Application Server Web-J Editionでは、iss_use=yesを指定した場合、すでに以下のファイルが生成（動的生成）されていたら、ファイルの権限属性を変更してください。

動的生成ファイル

　/var/opt/FJSVod 配下
　　.log_pipe
　　.share
　　.named_pipe
　　log
　　log.old
　　pid

権限属性手順

　# chown 特定ユーザID <動的生成ファイル>
　# chmod 0644 <動的生成ファイル>

(注2)
　すでにシステムにユーザ登録されているユーザを指定してください。なお、ここで指定するユーザの実効グループは、Interstageを起動したスーパユーザの実効グループと一致させる必要があります。

(注3)
　CORBAアプリケーションの実行は、iss_uidに指定したユーザまたは“root”に限定され、他の一般ユーザは実行できなくなりますので、アプリケーションの実行ユーザに注意してください（“リファレンスマニュアル（コマンド編）”の“OD_impl_inst”を参照）。

◆コード変換機能に関する動作環境

パラメタ名

初期値

意味

備考

省略値

指定範囲

undefined_char_conversion

single

未定義文字をコード変換した場合の動作を設定します。
“single”(デフォルト)を指定した場合、全ての未定義文字は半角のアンダースコアに変換します。(注1)
“multi”を指定した場合、半角の未定義文字は半角のアンダースコアに変換し、全角の未定義文字は全角のアンダースコアに変換します。
“fail”を指定した場合、未定義文字の変換を行うとアプリケーションにシステム例外DATA_CONVERSIONを通知します。

(注2)

single

single, multi, fail

(注1)
文字コードがUNICODEの場合は、“multi”を指定した場合と同様に全角の未定義文字は全角のアンダースコアに変換します。

(注2)
クライアントおよびサーバの両方で設定してください。コード変換機能の詳細については“OLTPサーバ運用ガイド”の“コード変換”を参照してください。

◆保守機能に関する動作環境

パラメタ名

初期値

意味

備考

省略値

指定範囲

access_log_policy

start
(初期値を推奨)

CORBAサービス起動時のアクセスログの採取／非採取の状態。
(start:起動時からログ採取する、standby:ログ採取しない)

サーバ機能のみ有効
(注1)

start

start, standby

access_log_size

3000000

アクセスログファイルの最大サイズ。(バイト単位)

サーバ機能のみ有効
(注1)

3000000

1〜2147483647
（longの最大値）

access_log_level

send_stex:
recv_stex:
send_userex:
recv_userex:
close_resp_info

アクセスログ採取レベルのキーワードを連結して指定(区切り文字はコロン(“:”)、空白は指定不可)。
“all”を指定すると、すべての採取レベルを指定したものとみなされます。

サーバ機能のみ有効
(注1) (注2)

send_stex:
recv_stex:
send_userex:
recv_userex:
close_resp_info

-

error_log_policy

start
(初期値を推奨)

CORBAサービス起動時のエラーログの採取／非採取の状態。
(start:起動時からログ採取する、standby:ログ採取しない)

(注1)

start

start, standby

error_log_size

3000000

エラーログファイルの最大サイズ。(バイト単位)

(注1)

3000000

1〜2147483647
（longの最大値）

info_log_policy

start
(初期値を推奨)

CORBAサービス起動時のインフォメーションログの採取／非採取の状態。
(start:起動時からログ採取する、standby:ログ採取しない)

(注1)

start

start, standby

info_log_size

3000000

インフォメーションログファイルの最大サイズ。(バイト単位)

(注1)

2000000

1〜2147483647
（longの最大値）

logging

no

内部ログの採取を指定。(yes:採取する、no:採取しない)

(注3)

no

yes, no

log_file_size

10000000

内部ログのファイルサイズの上限値。(バイト単位)
“logging = yes”とする場合、本パラメタは省略しないでください。

(注3)

-1

4096〜2147483647
（longの最大値）

process_log_policy

start
(初期値を推奨)

CORBAサービス起動時のプロセスログの採取／非採取の状態。
(start:起動時からログ採取する、standby:ログ採取しない)

(注1)

start

start, standby

process_log_size

3000000

プロセスログファイルの最大サイズ。(バイト単位)

(注1)

2000000

1〜2147483647
（longの最大値）

log_file_path

-

ログファイルの出力先を絶対パスで指定します。本パラメタで指定したパスには、以下のログファイルが出力されます。

  • アクセスログ
  • エラーログ
  • インフォメーションログ
  • プロセスログ
  • 内部ログ

本パラメタで指定したパスが存在しなかった場合、CORBAサービスの起動に失敗します。
128バイトより長いパスは指定できません。128バイトより長いパスを指定した場合、無効となります。
また、空白および“=”を含むパスは指定できません。空白または“=”を含むパスを指定した場合、その直前までが有効となります。


“\”と“/”は区別されず、共にフォルダの区切りとして使用されます。

(注1) (注3) (注4)

-

-

snap_size

40000

スナップショットサイズの上限値。(バイト単位)

サーバ機能のみ有効

40000

1024〜2147483647
（longの最大値）
(注5)

snap_use

yes

スナップショットの採取を指定。(yes:採取する、no:採取しない)

サーバ機能のみ有効

yes

yes, no

trace_file_synch_level

stop

トレースファイルへの出力タイミングを指定。複数指定可能（セパレータは“&"）。

  • none：odformtraceコマンド実行時のみ出力。
  • exit：アプリケーション正常終了時、終了したアプリケーションのトレース情報を出力。
  • vanish：アプリケーション異常終了時、終了したアプリケーションのトレース情報を出力。
  • stop：CORBAサービス終了時、すべてのアプリケーションのトレース情報を出力。
  • loop：メモリ上に採取されたトレース情報のサイズがtrace_size_per_processを超えた場合に出力。

サーバ機能のみ有効

stop

-

trace_size_per_process

10000

プロセスごとのトレース情報サイズの最大値(バイト単位)。

サーバ機能のみ有効

10000

1024〜100000000
(注5)

trace_size_of_daemon

0

CORBAサービスのデーモンプロセスに対するトレース情報サイズの最大値(バイト単位)。0を指定すると以下の値が設定されます。なお、計算結果が100000000を超えた場合は100000000が設定されます。trace_size_per_processよりも小さな値を設定した場合は、trace_size_per_processの値に補正されます。

trace_size_per_process * 32

0

0, 1024〜100000000

trace_use

yes
(初期値を推奨)

トレース情報の採取を指定(yes:採取する、no:採取しない)。

サーバ機能のみ有効

yes

yes, no

(注1)
　アクセスログ・プロセスログ・エラーログ・インフォメーションログは、“log_file_path”で指定したパスに採取されます。“log_file_path”を指定しなかった場合は、以下のパスに採取されます。
　また、ディスク領域として、以下のログファイルサイズの合計分が必要となります。

ログファイル格納パス

　/var/opt/FJSVod 配下

ログファイル名とファイルサイズ

ログ名

ログファイル名

ログファイルサイズ

アクセスログ

accesslog
accesslog.old

access_log_size×2

プロセスログ
(サーバ用ライブラリ(ODSV.DLL, libOM.so)をリンクしている場合)

proclog
proclog.old

process_log_size×2

プロセスログ
(クライアント用ライブラリ(ODWIN.DLL)をリンクしている場合)

proclogcl
proclogcl.old

process_log_size×2

エラーログ
(サーバ用ライブラリ(ODSV.DLL, libOM.so)をリンクしている場合)

errlog
errlog.old

error_log_size×2

エラーログ
(クライアント用ライブラリ(ODWIN.DLL)をリンクしている場合)

errlogcl
errlogcl.old

error_log_size×2

インフォメーションログ

infolog
infolog.old

info_log_size×2


　以下のログファイルを採取するためには、ログファイル格納パスに、管理者権限グループに対する書き込みのアクセス許可が必要です。

　また、以下のログファイルを採取するためには、ログファイル格納パスに、クライアントアプリケーションを実行するユーザが所属しているグループに対する書き込みのアクセス許可が必要です。

　上記のアクセス許可がない場合はログファイルの出力に失敗しますが、この際、特にエラーメッセージなどが表示されない場合があります。このため、ログファイルを採取する際には、運用前にログファイル格納パスのアクセス許可が正しく設定されているか確認してください。

(注2)
　access_log_level（アクセスログ採取レベル）に指定可能なキーワードは、“トラブルシューティング集”の“障害調査資料の採取”−“CORBAサービスのログ情報の採取”を参照してください。

(注3)
　“logging=yes”を指定した場合、内部ログファイルへの出力処理に時間を要するため、CORBAサービスの性能が劣化し、CORBAアプリケーションのレスポンス性能が低下します。また、インタフェースリポジトリやネーミングサービスの起動に時間がかかります。
　なお、インタフェースリポジトリおよびネーミングサービスの起動に1分以上かかった場合、Interstageの起動に失敗しますので注意してください。“logging=yes”を指定してInterstageの起動に失敗した場合は、“トラブルシューティング集”の“Interstageの起動/停止時の異常”を参照して対処を実施してください。

　“logging=yes”を指定した場合、内部ログは“log_file_path”で指定したパスに採取されます。“log_file_path”を指定しなかった場合は、以下のパスに出力されます。ファイル名は“log_file_path”の指定にかかわらず共通です。

　プレインストール型Javaライブラリ使用時は、上記に加えて、以下のファイルに出力されます。“log_file_path”の値は影響しません。

(注4)
　マルチシステムを使用する場合、デフォルトシステムとマルチシステムで同じ値を指定しないでください。ログファイルが正常に出力されない場合があります。

(注5)
　Interstage Application Server Web-J Editionでは、初期値より大きい値は指定しないでください。

◆旧バーションの互換に関する動作環境

パラメタ名

初期値

意味

備考

省略値

指定範囲

msg_output_compatible

no

od10924、od10926、od11101の各メッセージについて、システムログに出力するメッセージIDを“&”で連結して指定します。“od10924”を指定するとod10924メッセージを、“od10926”を指定するとod10926メッセージを、“od11101”を指定するとod11101メッセージをシステムログに出力します。“od10924&od10926&od11101”を指定すると3つのメッセージすべてをシステムログに出力します。“no”を指定すると、システムログへの出力は抑止されます。

　

no

od10924,od10926,od11101,no
目次 索引 前ページ次ページ
Copyright 20078 FUJITSU LIMITED