13.2.1 isapi_redirect.conf(Microsoft IIS用リダイレクタ動作定義ファイル)
- 〈この項の構成〉
(1) 形式
次のようにキーを指定します。
<キー名称> = <値>
- 指定方法
-
-
改行までが値になります。
-
#で始まる行はコメントとみなされます。
-
値が存在しない行を定義した場合,その行は無視されます。キー名称として定義されていないパラメタを定義しても無視されます。
-
「キー名称=値」として1023文字までが有効となります。超えた部分は切り捨てられます。
-
(2) ファイルの格納先
<Application Serverのインストールディレクトリ>\CC\web\redirector\isapi_redirect.conf
(3) 機能
Microsoft IIS用リダイレクタの動作パラメタを定義します。
(4) 指定できるキー
指定できるキーとデフォルト値を次に示します。このキーに不正な値を指定した場合,動作は保証されません。なお,複数のキーを指定した場合,最後に指定した値が有効になります。
キー名称 |
内容 |
デフォルト値 |
---|---|---|
ワーカ間でコネクションを共有するかどうかを指定します。
|
true |
|
リクエスト送信時のWebコンテナに対するコネクション確立のタイムアウト値を0〜3600の整数(単位:秒)で指定します。 数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。 タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,TCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。 |
30 |
|
リダイレクタをISAPIフィルタとして登録する際の,優先順序を指定します。 指定できる文字列を次に示します。
|
high |
|
ゲートウェイのホスト名またはIPアドレスを指定します。 Hostヘッダのないリクエストをwelcomeファイルなどにリダイレクトする場合,Locationヘッダに指定するURLのホスト名部分が指定値になります。 |
なし |
|
クライアントからのリクエストのスキームがhttpsであり,かつSSLアクセラレータなどを介すことでWebサーバへのスキームがhttpとなる場合に,trueを指定します。 trueを指定した場合,Webサーバへのリクエストのスキームがhttpsであるとみなされます。falseを指定した場合は,何も実行されません。 |
false |
|
ゲートウェイのポート番号を指定します。Hostヘッダのないリクエストに対して,welcomeファイルなどにリダイレクトするとき,Locationヘッダに指定するURLのポート番号部分が指定値になります。このパラメタを指定した場合は,gateway_hostも必ず指定してください。 gateway_hostを指定してこのパラメタを省略した場合,httpによるアクセスの場合は80,httpsによるアクセスの場合は443が使用されます。 |
なし |
|
ログファイルの出力先ディレクトリを指定します。
なお,出力先として指定したディレクトリのアクセス権にUsersグループに対する書き込み権限を設定する必要があります。アクセス権を設定していない場合,ログファイルが出力されません。 log_file_prefixとtrace_log_file_prefixに同じ値を指定した場合は,このキーにtrace_log_file_dirとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
logs |
|
リダイレクタ用ログファイルの最大数を指定します。この数を超えると古いログファイルは上書きされます。 1〜64の整数値を指定します。 |
5 |
|
ログファイル名のプリフィックスです。実際のログファイル名は,このキーの指定値に<通番>.logが付けられたものになります。 log_file_dirとtrace_log_file_dirに同じ値を指定した場合は,このキーにtrace_log_file_prefixとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
isapi_redirect |
|
リダイレクタ用ログファイルの一つ当たりのサイズをバイト単位で指定します。 4096〜16777216の整数値を指定します。 |
4194304 |
|
リダイレクタ用ログファイルの出力レベルを指定します。指定するログレベルを一つだけ指定します。 debug,info,errorを指定できます。 |
error |
|
PRFデーモン起動時にPRF識別子に指定した文字列を指定します。 |
PRF_ID |
|
クライアントからPOSTデータを受信するときのタイムアウト時間を秒単位で指定します。 60〜3600の整数値を60(秒)の倍数で指定します。 指定された値が60の倍数になっていない場合は,60の倍数に切り上げた値がタイムアウト時間になります。 |
300 |
|
リクエスト送信時のWebコンテナに対するコネクション確立,およびリクエスト送信のリトライ回数を,1〜16の整数(単位:回)で指定します。 リトライ回数には,初回のコネクション確立およびリクエスト送信処理も含まれます。 タイムアウトが発生した場合,リトライするケースは次のとおりです。
上記処理以降の,リクエストボディの送信時にタイムアウトが発生した場合は,リトライは行いません。 リトライ回数に,範囲外の値や,整数値でない値などの異常値を設定した場合,デフォルト値が設定されます。 |
3 |
|
リクエスト送信のタイムアウト値を0〜3600の整数(単位:秒)で指定します。 数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。 タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,TCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。 |
100 |
|
リダイレクタの保守用トレースログを出力するかどうかを指定します。出力する場合はtrueを,出力しない場合はfalseを指定します。 |
true |
|
保守用トレースログファイルの出力先ディレクトリを指定します。
なお,出力先として指定したディレクトリのアクセス権にUsersグループに対する書き込み権限を設定する必要があります※。アクセス権を設定していない場合,ログファイルが出力されません。 log_file_prefixとtrace_log_file_prefixに同じ値を指定した場合は,このキーにlog_file_dirとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
logs |
|
保守用トレースログファイルの最大数を指定します。この数を超えると古いログファイルは上書きされます。 1〜64の整数値を指定します。 |
4 |
|
保守用トレースログファイル名のプリフィックスを指定します。実際のログファイル名は,このキーの指定値に<通番>.logが付加されたものになります。 log_file_dirとtrace_log_file_dirに同じ値を指定した場合は,このキーにlog_file_prefixとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
iis_rd_trace |
|
保守用トレースログファイルの一つ当たりのサイズをバイト単位で指定します。 4096〜16777216の整数値を指定します。 |
16777216 |
|
ワーカ定義ファイルの位置とファイル名を指定します。
|
workers.properties |
|
マッピング定義ファイルの位置とファイル名を指定します。
|
uriworkermap.properties |
(5) 記述例
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
(6) 注意事項
このファイルを編集してリダイレクタのユーザ定義を変更した場合,Webサーバを再起動する必要があります。変更した定義は,Webサーバを再起動したあとに反映されます。