Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義)
次のようにキーを指定します。
<キー名称> <値>
リダイレクタの動作を定義します。
キー名称 | 内容 | デフォルト値 |
---|---|---|
JkConnectTimeout | リクエスト送信時のWebコンテナに対するコネクション確立のタイムアウト値を,0〜3600の整数(単位:秒)で指定します。 数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。 タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,TCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。 |
30 |
JkGatewayHost | ゲートウェイのホスト名またはIPアドレスを指定します。 Hostヘッダのないリクエストに対してwelcomeファイルなどへリダイレクトする場合,Locationヘッダに指定するURLのホスト名部分が指定値になります。 |
なし |
JkGatewayHttpsScheme | クライアントからのリクエストのスキームがhttpsであり,かつSSLアクセラレータなどを介すことでWebサーバへのスキームがhttpとなる場合に,Onを指定します。 Onを指定した場合,Webサーバへのリクエストのスキームがhttpsであるとみなされます。Offを指定した場合,何も実行されません。 |
Off |
JkGatewayPort | ゲートウェイのポート番号を指定します。Hostヘッダのないリクエストをwelcomeファイルなどにリダイレクトする場合,Locationヘッダに指定するURLのポート番号部分が指定値となります。 このパラメタを指定した場合は,必ずJkGatewayHostも指定してください。 JkGatewayHostを指定してこのパラメタを省略した場合,httpによるアクセスであれば80,httpsによるアクセスであれば443が使用されます。 |
なし |
JkLogFileDir | ログファイルの出力先ディレクトリを指定します。Windowsの場合,相対パスまたは絶対パスで指定してください。UNIXの場合,絶対パスで指定してください。
JkLogFilePrefixとJkTraceLogFilePrefixに同じ値を指定した場合は,このキーにJkTraceLogFileDirとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
|
JkLogFileNum | リダイレクタ用ログファイルの最大数を指定します。この値を超えると古いログファイルは上書きされます。次の範囲の整数値を指定してください。
|
5 |
JkLogFilePrefix | ログファイル名のプリフィックスです。実際のログファイル名は,指定値に<通番>.logが付加されたものとなります。 JkLogFileDirとJkTraceLogFileDirに同じ値を指定した場合は,このキーにJkTraceLogFilePrefixとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
hws_redirect |
JkLogFileSize | リダイレクタ用ログファイルの一つ当たりのサイズ(バイト)を指定します。次の範囲の整数値を指定してください。
|
4194304 |
JkLogLevel | リダイレクタ用ログファイルの出力レベルを指定します。指定するログレベルを一つだけ指定します。debug,info,error(デフォルト値),およびemergを指定できます。なお,emergは,Windowsの場合だけ指定できる値です。 これら以外の値を指定した場合は,errorが指定されたものとして動作します。 |
error |
JkModulePriority | Hitachi Web Serverへリダイレクタ以外の外部モジュールを登録する場合に,ほかの外部モジュールに対するリダイレクタの実行順位を指定します。 指定できる値を次に示します。
|
FIRST |
JkOptions | リクエストURLのURLデコードを行うかどうかを指定します。なお,このキーはUNIX用です。
|
ForwardURICompatUnparsed |
JkPrfId | PRFデーモン起動時にPRF識別子に指定した文字列を指定します。 | なし |
JkRequestRetryCount | リクエスト送信時のWebコンテナに対するコネクション確立,およびリクエスト送信のリトライ回数を,1〜16の整数(単位:回)で指定します。 リトライ回数には,初回のコネクション確立およびリクエスト送信処理も含まれます。 タイムアウトが発生した場合,リトライするケースは次のとおりです。
リトライ回数に,範囲外の値や,整数値でない値などの異常値を設定した場合,デフォルト値が設定されます。 |
3 |
JkSendTimeout | リクエスト送信のタイムアウト値を0〜3600の整数(単位:秒)で指定します。 数値以外の文字列や範囲外の数値を指定した場合は,メッセージを出力し,デフォルト値を使用します。 タイムアウト値に0,またはTCPの持つデータ送信の再送タイマより長い時間を設定した場合,TCPの持つタイムアウト値になります。その場合,不正なタイムアウト値が指定されたことを示すメッセージは出力されません。 |
100 |
JkTraceLog | リダイレクタの保守用トレースログを出力するかどうかを指定します。出力する場合はOn(デフォルト値)を,出力しない場合はOffを指定します。 | On |
JkTraceLogFileDir | 保守用トレースログファイルの出力先ディレクトリを指定します。Windowsの場合,相対パスまたは絶対パスで指定してください。UNIXの場合,絶対パスで指定してください。
|
|
JkTraceLogFileNum | 保守用トレースログファイルの最大数を整数値で指定します。
|
4 |
JkTraceLogFilePrefix | 保守用トレースログファイル名のプリフィックスを指定します。実際のログファイル名は,このキーの指定値に<通番>.logが付加されたものとなります。 JkLogFileDirとJkTraceLogFileDirに同じ値を指定した場合は,このキーにJkLogFilePrefixとは異なる値を指定する必要があります。同じ値が指定された場合,リダイレクタは動作しません。 |
hws_rd_trace |
JkTraceLogFileSize | 保守用トレースログファイルの一つ当たりのサイズを整数値(単位:バイト)で指定します。
|
16777216 |
JkTranslateBackcompat | 05-05以前のバージョンの互換用のキーです。 Hitachi Web ServerへのリクエストがWebコンテナに転送させるURLパターンであった場合,リダイレクタよりあとに実行されるモジュールのtranslate_handler関数がHitachi Web Serverから呼び出されるようにするかどうかを指定します。 Onを指定した場合,リダイレクタの次に実行されるモジュールのtranslate_handler関数が呼び出されます。 Offを指定した場合,リダイレクタよりあとに実行されるモジュールのtranslate_handler関数は呼び出されません。 |
Off |
JkWorkersFile | ワーカ定義ファイルのファイル名を指定します。Windowsの場合,相対パスまたは絶対パスで指定してください。UNIXの場合,絶対パスで指定してください。
|
|
LoadModule jk_module "C:\Program Files\Hitachi\Cosminexus\CC\web\redirector\mod_jk.dll"※ JkGatewayHost hostA JkGatewayHttpsScheme On JkGatewayPort 443 JkLogLevel error JkLogFileSize 4194304 JkLogFileNum 5 JkLogFileDir logs JkLogFilePrefix hws_redirect JkPrfId prfid JkTraceLog On JkTraceLogFileSize 16777216 JkTraceLogFileNum 4 JkTraceLogFileDir logs JkTraceLogFilePrefix hws_rd_trace JkTranslateBackcompat Off JkWorkersFile workers.properties JkMount /examples/* worker1
LoadModule jk_module /opt/Cosminexus/CC/web/redirector/mod_jk.so JkWorkersFile /opt/Cosminexus/CC/web/redirector/workers.properties JkLogLevel error JkLogFileSize 4194304 JkLogFileNum 5 JkLogFileDir /opt/Cosminexus/CC/web/redirector/logs JkLogFilePrefix hws_redirect JkTraceLog On JkTraceLogFileSize 16777216 JkTraceLogFileNum 4 JkTraceLogFileDir /opt/Cosminexus/CC/web/redirector/logs JkTraceLogFilePrefix hws_rd_trace JkMount /examples/* worker1
All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.