サーバ定義ファイルは,「c4websv.cfg」というファイル名称で,インストール時に次の場所に格納されます。
<Cosminexusのインストールフォルダ>¥c4web¥conf
/opt/Cosminexus/c4web/conf
サーバ定義ファイルには,設定できるパラメタをサーバごとに複数ブロック設定できます。
サーバ定義ファイルに設定した内容を反映するには,SOAPアプリケーションを再起動する必要があります。設定した内容は,SOAPアプリケーション再起動後の初回リクエストを受信したときに反映されます。なお,サーバ定義ファイルは,SOAPアプリケーションを停止してから変更してください。SOAPアプリケーションの再起動および停止については,「7.1 SOAPアプリケーションの開始と停止」を参照してください。
次の表に設定するキー名称と値の一覧について示します。
表10-1 サーバ定義ファイルの設定項目
設定項目 | キー名称 | 値 | デフォルト値 (値省略時の仮定値) |
---|---|---|---|
トレースファイル,アプリケーションログのプレフィクス | c4web.logger.<識別子>.log_file_prefix | 任意の文字列を設定します。 「<log_file_prefix>-<サーバ名>-<log_file_num>.log」がトレースファイルの名称となります。 「<log_file_prefix>-<サーバ名>-aplog-<log_file_num>.log」がアプリケーションのログ名称となります。 | 識別子値 |
多重参照(実行時オプション) | c4web.common.<識別子>.do_multirefs | 多重参照を有効にするかどうかを設定します。trueまたはfalseを設定します。※1 | false |
データ型定義(実行時オプション) | c4web.common.<識別子>.send_xsi_types | データ型情報を送信するかどうかを設定します。trueまたはfalseを設定します。※1 | true |
SOAPヘッダの名前修飾チェックオプション(実行時オプション) | c4web.common.<識別子>.enable_soapheader_check | SOAPヘッダの子エレメントの名前修飾をチェックするかどうかを指定します。trueまたはfalseを設定します。※1 | true |
性能解析トレース出力オプション | c4web.common.<識別子>.prf_trace_level | ALL,NONHANDLERのどちらかを指定します。
| ALL |
文字参照形式オプション | c4web.common.<識別子>.character_reference | 送信メッセージ中の文字を文字参照形式にエンコードするかどうかを指定します。trueまたはfalseを設定します。※1 | false |
送信できるSOAPEnvelopeの最大バイト数 | c4web.common.<識別子>.send_max_soap_envelope_size | 送信できるSOAPEnvelopeの最大バイト数を設定します。設定値は0~2,147,483,647の数値を設定します。0を指定した場合は無制限となります。 | 0 |
受信できるSOAPEnvelopeの最大バイト数 | c4web.common.<識別子>.receive_max_soap_envelope_size | 受信できるSOAPEnvelopeの最大バイト数を設定します。設定値は0~2,147,483,647の数値を設定します。0を設定した場合は無制限となります。 | 0 |
HTTPセッションの維持(実行時オプション) | c4web.application.<識別子>.app_maintainsession | ほかのSOAPサーバのサービスメソッドを呼び出す場合に,HTTPセッションを維持するかどうかを設定します。trueまたはfalseを設定します。※1 | false |
プロキシサーバのホスト名またはIPアドレス(実行時オプション) | c4web.application.<識別子>.proxy_host | ほかのSOAPサーバのサービスメソッドを呼び出す場合に,プロキシサーバのホスト名またはIPアドレスを設定します。ホスト名またはIPアドレスを示す文字列を設定します。 | - |
プロキシサーバを使用しないホスト名またはIPアドレス群(実行時オプション) | c4web.application.<識別子>.non_proxy_hosts | ほかのSOAPサーバのサービスメソッドを呼び出す場合に,プロキシサーバを使用しないホスト名またはIPアドレス群を設定します。ホスト名またはIPアドレスを示す文字列を設定します。複数のホスト名またはIPアドレスを指定する場合「|」で区切って設定します。※2 | - |
プロキシサーバのポート番号(実行時オプション) | c4web.application.<識別子>.proxy_port | ほかのSOAPサーバのサービスメソッドを呼び出す場合に,ポート番号を示す文字列を設定します。 | - |
プロキシサーバの認証ユーザID(実行時オプション) | c4web.application.<識別子>.proxy_user | ほかのSOAPサーバのサービスメソッドを呼び出す場合に,プロキシサーバの認証ユーザIDを設定します。任意の文字列を設定します。※2 | - |
プロキシサーバの認証ユーザIDに対応するパスワード(実行時オプション) | 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 |
Javaソースファイルおよびクラスファイルの出力ディレクトリ | c4web.application.<識別子>.dii_temp_directory | DIIでユーザ定義のデータ型クラスを使用する場合に,WSDL定義から動的に出力されるJavaソースファイルおよびクラスファイルの出力先ディレクトリを,ローカルディレクトリ上の絶対パスで設定します。設定値は1~128文字の範囲で設定します。なお,ディレクトリ名に指定できる文字は,使用しているOSに依存します。また,ディレクトリ名のパスの区切りには,次の文字を使用してください。
| <Cosminexusのインストールディレクトリ>/c4web/dii/temp |
WSDL解析およびJavaソース生成のタイムアウト値 | c4web.application.<識別子>.dii_wsdl_parse_timeout | DIIを使用する場合に,WSDL解析およびJavaソース生成のタイムアウト値を秒単位で設定します。0~3,600の範囲で数値を設定します。0を指定した場合はタイムアウト監視をしません。 | 45 |
SOAPAction値の扱い(実行時オプション) | 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.logger.<識別子>.log_file_num=2
c4web.logger.log_file_num=2
# TO BE REPLACED: "<cosminexus.home>","<proxy-host>","<nonproxy-host1>"," <nonproxy-host2>",
# "<proxy-port>","<proxy-user>","<proxy-password>"
#-----------------------------------------------------------
# The following options are used to the standard mode.
#-----------------------------------------------------------
# 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.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.server.WebApp1.fault_omit_soapaction=true
#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.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.server.WebApp2.fault_omit_soapaction=true
#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