10.2 サーバ定義ファイルの設定
サーバ定義ファイルは，「c4websv.cfg」というファイル名称で，インストール時に次の場所に格納されます。
- Windowsの場合
<Application Serverのインストールフォルダ>\c4web\conf
- Windows以外の場合
/opt/Cosminexus/c4web/conf
サーバ定義ファイルには，設定できるパラメタをサーバごとに複数ブロック設定できます。
サーバ定義ファイルに設定した内容を反映するには，SOAPアプリケーションを再起動する必要があります。設定した内容は，SOAPアプリケーション再起動後の初回リクエストを受信したときに反映されます。なお，サーバ定義ファイルは，SOAPアプリケーションを停止してから変更してください。SOAPアプリケーションの再起動および停止については，「7.1 SOAPアプリケーションの開始と停止」を参照してください。
次の表に設定するキー名称と値の一覧について示します。
|
設定項目 |
キー名称 |
値 |
デフォルト値 （値省略時の仮定値） |
|---|---|---|---|
|
c4web.logger.<識別子>.log_file_prefix |
任意の文字列を設定します。 「<log_file_prefix>-j2ee-<J2EEサーバのサーバ名>-<log_file_num>.log」がトレースファイルの名称となります。 「<log_file_prefix>-j2ee-<J2EEサーバのサーバ名>-aplog-<log_file_num>.log」がアプリケーションのログ名称となります。 |
識別子値 |
|
|
c4web.common.<識別子>.do_multirefs |
多重参照を有効にするかどうかを設定します。trueまたはfalseを設定します。※1 |
false |
|
|
c4web.common.<識別子>.send_xsi_types |
データ型情報を送信するかどうかを設定します。trueまたはfalseを設定します。※1 |
true |
|
|
c4web.common.<識別子>.ignore_undeclared_elements |
XMLスキーマ（DOCUMENTスタイルのwrapped形式で引数および戻り値をラップした要素を除く）で要素宣言していないXMLインスタンスを含むSOAPメッセージを受信した場合，このXMLインスタンスを無視するかどうかを設定します。trueまたはfalseを設定します。※1 |
false |
|
|
c4web.common.<識別子>.ignore_undeclared_parts |
WSDL（RPCスタイルのwsdl:part要素，およびDOCUMENTスタイルのwrapped形式で引数および戻り値をラップした要素）で宣言していないパラメタを含むSOAPメッセージを受信した場合，このパラメタを無視するかどうかを設定します。trueまたはfalseを設定します。※1 |
false |
|
|
c4web.common.<識別子>.enable_soapheader_check |
SOAPヘッダの子エレメントの名前修飾をチェックするかどうかを指定します。trueまたはfalseを設定します。※1 |
true |
|
|
c4web.common.<識別子>.prf_trace_level |
ALL，NONHANDLERのどちらかを指定します。
性能解析トレースについては，「14.7 性能解析トレース」を参照してください。 |
ALL |
|
|
c4web.common.<識別子>.character_reference |
送信メッセージ中の文字を文字参照形式にエンコードするかどうかを指定します。trueまたはfalseを設定します。※1 |
false |
|
|
c4web.common.<識別子>.send_max_soap_envelope_size |
送信できるSOAPEnvelopeの最大バイト数を設定します。設定値は0〜2,147,483,647の数値を設定します。0を指定した場合は無制限となります。 |
0 |
|
|
c4web.common.<識別子>.receive_max_soap_envelope_size |
受信できるSOAPEnvelopeの最大バイト数を設定します。設定値は0〜2,147,483,647の数値を設定します。0を設定した場合は無制限となります。 |
0 |
|
|
c4web.application.<識別子>.app_maintainsession |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，HTTPセッションを維持するかどうかを設定します。trueまたはfalseを設定します。※1 |
false |
|
|
c4web.application.<識別子>.proxy_host |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，プロキシサーバのホスト名またはIPアドレスを設定します。ホスト名またはIPアドレスを示す文字列を設定します。 |
− |
|
|
c4web.application.<識別子>.non_proxy_hosts |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，プロキシサーバを使用しないホスト名またはIPアドレス群を設定します。ホスト名またはIPアドレスを示す文字列を設定します。複数のホスト名またはIPアドレスを指定する場合「|」で区切って設定します。※2 |
− |
|
|
c4web.application.<識別子>.proxy_port |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，ポート番号を示す文字列を設定します。 |
− |
|
|
c4web.application.<識別子>.proxy_user |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，プロキシサーバの認証ユーザIDを設定します。任意の文字列を設定します。※2 |
− |
|
|
c4web.application.<識別子>.proxy_password |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，認証ユーザIDに対応するパスワードを設定します。任意の文字列を設定します。※2 |
− |
|
|
c4web.application.<識別子>.socket_write_timeout |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，ソケットの書き込みタイムアウト値を秒単位で設定します。0〜86,400の数値を設定します。0を指定した場合はタイムアウト監視をしません。 |
60 |
|
|
c4web.application.<識別子>.socket_read_timeout |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，ソケットの読み込みタイムアウト値を秒単位で設定します。0〜86,400の数値を設定します。0を指定した場合はタイムアウト監視をしません。 |
300 |
|
|
c4web.application.<識別子>.socket_connect_timeout |
ほかのSOAPサーバのサービスメソッドを呼び出す場合に，ソケットの接続タイムアウト値を秒単位で設定します。0〜86,400の範囲で数値を設定します。0を指定した場合はタイムアウト監視をしません。 |
60 |
|
|
c4web.application.<識別子>.dii_temp_directory |
DIIでユーザ定義のデータ型クラスを使用する場合に，WSDL定義から動的に出力されるJavaソースファイルおよびクラスファイルの出力先ディレクトリを，ローカルディレクトリ上の絶対パスで設定します。設定値は1〜128文字の範囲で設定します。なお，ディレクトリ名に指定できる文字は，使用しているOSに依存します。また，ディレクトリ名のパスの区切りには，次の文字を使用してください。
|
<Application Serverのインストールディレクトリ>/c4web/dii/temp |
|
|
c4web.application.<識別子>.dii_wsdl_parse_timeout |
DIIを使用する場合に，WSDL解析およびJavaソース生成のタイムアウト値を秒単位で設定します。0〜3,600の範囲で数値を設定します。0を指定した場合はタイムアウト監視をしません。 |
45 |
|
|
c4web.application.<識別子>.hostname_verification.enable |
ホスト名の検証を有効にするかどうかを設定します。trueまたはfalseを設定します。※1 |
true |
|
|
c4web.server.<識別子>.fault_omit_soapaction |
SOAPAction値がない場合の実行時オプションを設定します。trueまたはfalseを設定します。※1 |
true |
|
|
c4web.attachment.<識別子>.send_max_attachment_count |
送信できる添付データの最大個数を設定します。設定値は0〜2,147,483,647の数値を設定します。0を設定した場合は無制限となります。 |
100 |
|
|
c4web.attachment.<識別子>.receive_max_attachment_count |
受信できる添付データの最大個数を設定します。設定値は0〜2,147,483,647の数値を設定します。0を設定した場合は無制限となります。 |
0 |
|
|
c4web.attachment.<識別子>.send_max_attachment_size |
送信できる各添付データの最大バイト数を設定します。設定値は0〜2,147,483,647の数値を設定します。0を設定した場合は無制限となります。 |
104,857,600 |
|
|
c4web.attachment.<識別子>.receive_max_attachment_size |
受信できる各添付データの最大バイト数を設定します。設定値は0〜2,147,483,647の数値を設定します。0を設定した場合は無制限となります。 |
0 |
|
|
c4web.attachment.<識別子>.attachment_temp_directory |
添付ファイル付きSOAPメッセージを受信したときに生成される退避ファイルの出力先ディレクトリを，ローカルディレクトリ上の絶対パスで設定します。設定値は1〜128文字の範囲で設定します。なお，ディレクトリ名に指定できる文字は，OSに依存します。また，ディレクトリ名のパスの区切りには，次の文字を使用してください。
|
|
- （凡例）
-
−：デフォルト値がないことを示します。
- 注※1
-
true：設定項目を有効にします。
false：設定項目を無効にします。
また，trueおよびfalseは小文字で記述してください。
- 注※2
-
プロキシサーバのホスト名またはIPアドレス（c4web.application.<識別子>.proxy_host）とプロキシサーバのポート番号（c4web.application.<識別子>.proxy_port）のどちらかがnullまたは空文字の場合，設定した値は無視されます。
- 注※3
-
falseの場合，XMLスキーマ（DOCUMENTスタイルのwrapped形式で引数および戻り値をラップした要素を除く）で要素宣言していないXMLインスタンスを含むSOAPメッセージを受信した場合，次のどちらかが発生します。
(a) SOAPサービスで受信した場合，KDCCP0006-EメッセージのSOAPフォルトを返信します。
(b) SOAPクライアントで受信した場合，KDCCP0006-EメッセージのC4Faultが発生します。
trueの場合，上記の受信チェックを行いません。該当するXMLインスタンスを無視します。
- 注※4
-
falseの場合，WSDL（RPCスタイルのwsdl:part要素，およびDOCUMENTスタイルのwrapped形式で引数および戻り値をラップした要素）で宣言していないパラメタを含むSOAPメッセージを受信した場合，次のどちらかが発生することがあります。
(a) SOAPサービスで受信した場合，次のどちらかが発生することがあります。
・不正な値の引数を受け取ります。
・KDCCP0006-EメッセージのSOAPフォルトを返信します。
(b) SOAPクライアントで受信した場合，KDCCP0006-EメッセージのC4Faultが発生することがあります。
trueの場合，上記の受信チェックを行いません。該当するパラメタを無視します。
- 識別子について
-
識別子は，サーバ定義ファイル中から動作中のサーバの情報を取得するためのキーとして使用します。識別子として，サーバにデプロイしたSOAPアプリケーションのコンテキストルートから先頭の「/」を抜いた名称を使用します。コンテキストルートとは，コンテキストのルートパスです。コンテキスト内のWebアプリケーションにアクセスするときにURL上に指定します。例えば，接続先URLが「http://localhost:8080/WebApp1/services/UserInfo」の場合，識別子は「WebApp1」となります。接続先URLが「http://localhost:8080/WebApp1/Service1/services/UserInfo」の場合，識別子は「WebApp1/Service1」となります。なお，サーバ定義ファイル中の識別子の大文字と小文字は区別されます。
- 注意事項
-
ルートコンテキストを使用する場合，サーバ定義ファイルに，次のように識別子を省略した形式で記述する必要があります。
- 通常指定時
c4web.logger.<識別子>.log_file_num=2
- ルートコンテキスト指定機能使用時
c4web.logger.log_file_num=2
なお，トレースファイル，アプリケーションログのプレフィクス（log_file_prefix）を省略した場合，デフォルト値は"ROOT"になります。
- サーバ定義ファイルの例
# TO BE REPLACED: "<cosminexus.home>", # "<proxy-host>","<nonproxy-host1>"," <nonproxy-host2>", # "<proxy-port>","<proxy-user>","<proxy-password>" # define WebApp settings. #c4web.logger.WebApp1.log_file_prefix=WebApp1 #c4web.common.WebApp1.do_multirefs=false #c4web.common.WebApp1.send_xsi_types=true #c4web.common.WebApp1.ignore_undeclared_elements=false #c4web.common.WebApp1.ignore_undeclared_parts=false #c4web.common.WebApp1.enable_soapheader_check=true #c4web.common.WebApp1.prf_trace_level=ALL #c4web.common.WebApp1.character_reference=false #c4web.common.WebApp1.send_max_soap_envelope_size=0 #c4web.common.WebApp1.receive_max_soap_envelope_size=0 #c4web.application.WebApp1.app_maintainsession=false #c4web.application.WebApp1.proxy_host=<proxy-host> #c4web.application.WebApp1.non_proxy_hosts=<nonproxy-host1>|<nonproxy-host2> #c4web.application.WebApp1.proxy_port=<proxy-port> #c4web.application.WebApp1.proxy_user=<proxy-user> #c4web.application.WebApp1.proxy_password=<proxy-password> #c4web.application.WebApp1.socket_write_timeout=60 #c4web.application.WebApp1.socket_read_timeout=300 #c4web.application.WebApp1.socket_connect_timeout=60 #c4web.application.WebApp1.dii_temp_directory=<cosminexus.home>/c4web/dii/temp #c4web.application.WebApp1.dii_wsdl_parse_timeout=45 #c4web.application.WebApp1.hostname_verification.enable=true #c4web.server.WebApp1.fault_omit_soapaction=true #c4web.attachment.WebApp1.attachment_temp_directory=<cosminexus.home>/c4web/attachments #c4web.attachment.WebApp1.send_max_attachment_count=100 #c4web.attachment.WebApp1.receive_max_attachment_count=0 #c4web.attachment.WebApp1.send_max_attachment_size=104857600 #c4web.attachment.WebApp1.receive_max_attachment_size=0 # define other WebApp settings. #c4web.logger.WebApp2.log_file_prefix=WebApp2 #c4web.common.WebApp2.do_multirefs=false #c4web.common.WebApp2.send_xsi_types=true #c4web.common.WebApp2.ignore_undeclared_elements=false #c4web.common.WebApp2.ignore_undeclared_parts=false #c4web.common.WebApp2.enable_soapheader_check=true #c4web.common.WebApp2.prf_trace_level=ALL #c4web.common.WebApp2.character_reference=false #c4web.common.WebApp2.send_max_soap_envelope_size=0 #c4web.common.WebApp2.receive_max_soap_envelope_size=0 #c4web.application.WebApp2.app_maintainsession=false #c4web.application.WebApp2.proxy_host=<proxy-host> #c4web.application.WebApp2.non_proxy_hosts=<nonproxy-host1>|<nonproxy-host2> #c4web.application.WebApp2.proxy_port=<proxy-port> #c4web.application.WebApp2.proxy_user=<proxy-user> #c4web.application.WebApp2.proxy_password=<proxy-password> #c4web.application.WebApp2.socket_write_timeout=60 #c4web.application.WebApp2.socket_read_timeout=300 #c4web.application.WebApp2.socket_connect_timeout=60 #c4web.application.WebApp2.dii_temp_directory=<cosminexus.home>/c4web/dii/temp #c4web.application.WebApp2.dii_wsdl_parse_timeout=45 #c4web.application.WebApp2.hostname_verification.enable=true #c4web.server.WebApp2.fault_omit_soapaction=true #c4web.attachment.WebApp2.attachment_temp_directory=<cosminexus.home>/c4web/attachments #c4web.attachment.WebApp2.send_max_attachment_count=100 #c4web.attachment.WebApp2.receive_max_attachment_count=0 #c4web.attachment.WebApp2.send_max_attachment_size=104857600 #c4web.attachment.WebApp2.receive_max_attachment_size=0
定義ファイル中の<>で囲まれた部分については，利用者の環境に合わせた値に修正する必要があります。なお，<cosminexus.home>は，Windowsの場合，Application Serverインストールフォルダを表しています。Windows以外の場合，/opt/Cosminexusを表しています。