次のようにキーを指定します。
<キー名称> = <値>
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥isapi_redirect.conf
Microsoft IIS用リダイレクタの動作パラメタを定義します。
指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合,動作は保証されません。なお,複数のキーを指定した場合,最後に指定した値が有効になります。
キー名称 | 内容 | デフォルト値 |
---|---|---|
connection_sharing | ワーカ間でコネクションを共有するかどうかを指定します。
| true |
connect_timeout | リクエスト送信時のWebコンテナに対するコネクション確立のタイムアウト値を0~3600の整数(単位:秒)で指定します。 数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。 タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,TCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。 | 30 |
filter_priority | リダイレクタをISAPIフィルタとして登録する際の,優先順序を指定します。 指定できる文字列を次に示します。
| high |
gateway_host | ゲートウェイのホスト名またはIPアドレスを指定します。 Hostヘッダのないリクエストをwelcomeファイルなどにリダイレクトする場合,Locationヘッダに指定するURLのホスト名部分が指定値になります。 | なし |
gateway_https_scheme | クライアントからのリクエストのスキームがhttpsであり,かつSSLアクセラレータなどを介すことでWebサーバへのスキームがhttpとなる場合に,trueを指定します。 trueを指定した場合,Webサーバへのリクエストのスキームがhttpsであるとみなされます。falseを指定した場合は,何も実行されません。 | false |
gateway_port | ゲートウェイのポート番号を指定します。Hostヘッダのないリクエストに対して,welcomeファイルなどにリダイレクトするとき,Locationヘッダに指定するURLのポート番号部分が指定値になります。このパラメタを指定した場合は,gateway_hostも必ず指定してください。 gateway_hostを指定してこのパラメタを省略した場合,httpによるアクセスの場合は80,httpsによるアクセスの場合は443が使用されます。 | なし |
log_file_dir | ログファイルの出力先ディレクトリを指定します。
log_file_prefixとtrace_log_file_prefixに同じ値を指定した場合は,このキーにtrace_log_file_dirとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 | logs |
log_file_num | リダイレクタ用ログファイルの最大数を指定します。この数を超えると古いログファイルは上書きされます。 1~64の整数値を指定します。 | 5 |
log_file_prefix | ログファイル名のプリフィックスです。実際のログファイル名は,このキーの指定値に<通番>.logが付けられたものになります。 log_file_dirとtrace_log_file_dirに同じ値を指定した場合は,このキーにtrace_log_file_prefixとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 | isapi_redirect |
log_file_size | リダイレクタ用ログファイルの一つ当たりのサイズをバイト単位で指定します。 4096~16777216の整数値を指定します。 | 4194304 |
log_level | リダイレクタ用ログファイルの出力レベルを指定します。指定するログレベルを一つだけ指定します。 debug,info,errorを指定できます。 | error |
prf_id | PRFデーモン起動時にPRF識別子に指定した文字列を指定します。 | なし |
receive_client_timeout | クライアントからPOSTデータを受信するときのタイムアウト時間を秒単位で指定します。 60~3600の整数値を60(秒)の倍数で指定します。 指定された値が60の倍数になっていない場合は,60の倍数に切り上げた値がタイムアウト時間になります。 | 300 |
request_retry_count | リクエスト送信時のWebコンテナに対するコネクション確立,およびリクエスト送信のリトライ回数を,1~16の整数(単位:回)で指定します。 リトライ回数には,初回のコネクション確立およびリクエスト送信処理も含まれます。 タイムアウトが発生した場合,リトライするケースは次のとおりです。
リトライ回数に,範囲外の値や,整数値でない値などの異常値を設定した場合,デフォルト値が設定されます。 | 3 |
send_timeout | リクエスト送信のタイムアウト値を0~3600の整数(単位:秒)で指定します。 数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。 タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,TCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。 | 100 |
trace_log | リダイレクタの保守用トレースログを出力するかどうかを指定します。出力する場合はtrueを,出力しない場合はfalseを指定します。 | true |
trace_log_file_dir | 保守用トレースログファイルの出力先ディレクトリを指定します。
log_file_prefixとtrace_log_file_prefixに同じ値を指定した場合は,このキーにlog_file_dirとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 | logs |
trace_log_file_num | 保守用トレースログファイルの最大数を指定します。この数を超えると古いログファイルは上書きされます。 1~64の整数値を指定します。 | 4 |
trace_log_file_prefix | 保守用トレースログファイル名のプリフィックスを指定します。実際のログファイル名は,このキーの指定値に<通番>.logが付加されたものになります。 log_file_dirとtrace_log_file_dirに同じ値を指定した場合は,このキーにlog_file_prefixとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 | iis_rd_trace |
trace_log_file_size | 保守用トレースログファイルの一つ当たりのサイズをバイト単位で指定します。 4096~16777216の整数値を指定します。 | 16777216 |
worker_file | ワーカ定義ファイルの位置とファイル名を指定します。
| workers.properties |
worker_mount_file | マッピング定義ファイルの位置とファイル名を指定します。
| uriworkermap.properties |
gateway_host=hostA
gateway_https_scheme=true
gateway_port=443
log_level=error
log_file_size=4194304
log_file_num=5
log_file_dir=logs
log_file_prefix=isapi_redirect
prf_id=prfid
trace_log=true
trace_log_file_size=16777216
trace_log_file_num=4
trace_log_file_dir=logs
trace_log_file_prefix=iis_rd_trace
receive_client_timeout=300
worker_file=workers.properties
worker_mount_file=uriworkermap.properties