15.3. サーブレット/HTTP 設定

グローバル設定オプション

デフォルトのセッションタイムアウト

JBoss EAP 6.4 から利用できます。Web コンテナーのデフォルトセッションタイムアウト。

管理 CLI 属性： default-session-timeout

デフォルトの仮想サーバー

Web コンテナーのデフォルト仮想サーバー。

管理 CLI 属性： default-virtual-server

インスタンス ID

ロードバランシングのシナリオでセッションアフィニティーを有効にするのに使用される ID。識別子はクラスター内のすべての JBoss EAP サーバーで一意である必要があり、生成されたセッション識別子に追加されます。これにより、フロントエンドプロキシーは特定のセッションを同じ JBoss EAP インスタンスに転送できます。インスタンス ID はデフォルトとして設定されていません。

管理 CLI 属性： instance-id

ネイティブ

ネイティブ初期化リスナーを Web コンテナーに追加します。

管理 CLI 属性： ネイティブ値： true または falseデフォルト： true

JSP 設定オプション

チェック間隔

バックグラウンドスレッドを使用して JSP 更新を確認する間隔（秒単位）。デフォルト： 0 （ 無効 ）

管理 CLI 属性： check-interval

開発

true の場合、開発モード が有効化されます。これにより、より詳細なデバッグ情報が生成されます。デフォルト: false。

管理 CLI 属性： 開発

無効

true の場合は、Java ServerPages(JSP)コンテナーが無効になります。JSP を使用しない場合は便利です。デフォルトは false です。

管理 CLI 属性： 無効

ソースの追加表示

true の場合、ランタイムエラーが発生すると JSP ソースフラグメントが表示されます。デフォルト： true

管理 CLI 属性： display-source-fragment

SMAP のダンプ

true の場合、JSR 045 SMAP データはファイルに書き込まれます。デフォルト: false

管理 CLI 属性： dump-smap

文字列を Char アレイとして生成

true の場合、文字列定数は char 配列として生成されます。デフォルト: false

管理 CLI 属性： generate-strings-as-char-arrays

Bean の無効なクラス属性の使用時のエラー

true の場合、useBean で不適切なクラスが使用される場合にエラーの出力を有効にします。デフォルト: false

管理 CLI 属性： error-on-use-bean-invalid-class-attribute

Java Encoding

Java ソースに使用されるエンコーディングを指定します。デフォルト： UTF8

管理 CLI 属性： java-encoding

生成されているままにする

true の場合、生成されたサーブレットを保持します。デフォルト： true

管理 CLI 属性： keep-generated

マップされたファイル

true の場合、デバッグを容易にするために、入力行ごとに 1 つの印刷ステートメントを使用して静的コンテンツが生成されます。デフォルト： true

管理 CLI 属性： true

変更テスト間隔

更新の 2 つのテストの最小時間（秒単位）。デフォルト： 4

管理 CLI 属性： modification-test-interval

Fail での再コンパイル

true の場合、リクエストごとに失敗した JSP コンパイルが再試行されます。デフォルト: false。

管理 CLI 属性： recompile-on-fail

スクラッチディレクトリー

別のワークディレクトリーの場所を指定します。

管理 CLI 属性： scratch-dir

SMAP

true の場合、JSR 045 SMAP が有効になります。デフォルト: true

管理 CLI 属性： smap

ソース仮想マシン

ソースファイルと互換性のある Java Development Kit バージョン。デフォルト： 1.5

管理 CLI 属性： source-vm

タグプール

true の場合、タグプーリングは有効になります。デフォルト: true

管理 CLI 属性： tag-pooling

ターゲット仮想マシン

クラスファイルと互換性のある Java Development Kit バージョン。デフォルト： 1.5

管理 CLI 属性： target-vm

トリミング領域

生成されたサーブレットから一部の領域をトリミングします。デフォルト: false。

管理 CLI 属性： trim-spaces

x Powered By

true の場合、JSP エンジンは x-powered-by HTTP ヘッダーを使用してアドバタイズされます。デフォルト： true

管理 CLI 属性： x-powered-by

デフォルトのコネクター属性

bytes Sent

コネクターによって送信されるバイト数。

管理 CLI 属性： bytesSent

プロキシーポート

リダイレクトの送信時に使用されるポート。

管理 CLI 属性： proxy-port

Secure

コネクターによって送受信されたコンテンツがユーザーパースペクティブからセキュア化されるかどうかを示します。デフォルト: false。

管理 CLI 属性： secure

仮想サーバー

このコネクターからアクセス可能な仮想サーバーの一覧。デフォルト： すべての仮想サーバーを許可します。

管理 CLI 属性： virtual-server

エラー数

コネクターによるリクエストの処理時に発生するエラーの数。

管理 CLI 属性： errorCount

最大時間

要求の処理に費やされた最大時間。

管理 CLI 属性： maxTime

ソケットバインディング

コネクターがバインドされる名前付きソケットバインディング。ソケットバインディングは、ソケット名とネットワークポート間のマッピングです。ソケットバインディングは各スタンドアロンサーバーまたは管理対象ドメインのソケットバインディンググループで設定されます。ソケットバインディンググループはサーバーグループに適用されます。

管理 CLI 属性： socket-binding

Scheme

Web コネクタースキーム（HTTP や HTTPS など）。

管理 CLI 属性： scheme

名前

コネクターの一意の名前。

管理 CLI 属性： name

最大 POST サイズ

コンテナーで解析できる POST リクエストの最大サイズ（バイト単位）。デフォルト： 2097152

管理 CLI 属性： max-post-size

リクエスト数

コネクターによって処理されるリクエストの数。

管理 CLI 属性： requestCount

プロキシー名

リダイレクトの送信時に使用されるホスト名。デフォルト： null

管理 CLI 属性： proxy-name

有効

コネクターが起動時に開始されるかどうかを定義します。デフォルト: true

管理 CLI 属性： enabled

プロトコル

AJP または HTTP のいずれかを使用する Web コネクタープロトコル。それぞれのプロトコルについて API を指定し、使用する実装を判別するためにサーバーに残すか、または完全修飾クラス名を指定できます。

管理 CLI 属性： protocol

HTTP

API オプション： HTTP/1.1 または HTTP/1.0

クライアントが HTTP/1.1 に対応していない場合、コネクターは最初の応答で HTTP/1.1 を返し、HTTP/1.0 にフォールバックします。

完全修飾コネクター名 オプション：

• jio: org.apache.coyote.http11.Http11Protocol
• NIO2: org.apache.coyote.http11.Http11NioProtocol
• APR: org.apache.coyote.http11.Http11AprProtocol

AJP

API オプション： AJP/1.3

完全修飾コネクター名 オプション：

• jio: org.apache.coyote.ajp.AjpProtocol
• APR: org.apache.coyote.ajp.AjpAprProtocol

注記

APR では、ネイティブコンポーネントパッケージをインストールして有効にしておく必要があります。詳細な手順は、JBoss EAP 『『インストールガイド』 』を参照してください。

ルックアップの有効化

Servlet API の DNS ルックアップを有効にします。

管理 CLI 属性： enable-lookups

エグゼキューター (Executor)

このコネクターの処理スレッドに使用されるエグゼキューターの名前。定義されていない場合は、デフォルトで内部プールを使用します。

管理 CLI 属性： executor

処理時間

コネクターによって使用される処理時間（ミリ秒単位）。

管理 CLI 属性： processingTime

プロキシーバインディング

リダイレクトの送信時に使用されるホストおよびポートを定義するソケットバインディング。デフォルト： null

管理 CLI 属性： proxy-binding

Redirect Port

セキュアなコネクターへリダイレクトするためのポート。デフォルト： 443

同時に設定されている場合に redirect-binding に遅延します。

管理 CLI 属性： redirect-port

受信バイト数

コネクター（POST データ）によって受信されるバイト数。

管理 CLI 属性： bytesReceived

リダイレクトバインディング

リダイレクトバインディングは動作においてポートをリダイレクトするのと似ていますが、ポート番号の代わりにソケットバインディング名 を 指定する必要があります。redirect-binding オプションでは、事前定義されたソケットバインディング（https、AJP など）をリダイレクト用に特定のポートに使用できるようにするため、設定の柔軟性が高くなります。redirect-port オプションと同じ結果が提供されます。

同時に設定されている場合は、リダイレクトポート よりも優先されます。

管理 CLI 属性： redirect-binding

最大接続

パフォーマンスを最適化してコネクターが処理できる同時接続の最大数。デフォルト値は、使用されるコネクターによって異なります。

管理 CLI 属性： max-connections

最大保存後サイズ

特定の認証スキーム時に保存される POST リクエストの最大サイズ（バイト単位）。デフォルトは 4096 です。

管理 CLI 属性： max-save-post-size

仮想サーバーオプション

アクセスログ

アクセスログ情報をログに記録する方法を記述する要素。

管理 CLI 属性： access-log

• access-log 属性を追加するには、以下の管理 CLI コマンドを入力します。

  /subsystem=web/virtual-server=default-host/configuration=access-log:add()

  Copy to Clipboard Toggle word wrap
• access-log 属性には複数の子属性があります。これらの子とそれらの設定オプションを一覧表示するには、以下の管理 CLI コマンドを入力します。

  /subsystem=web/virtual-server=default-host/configuration=access-log:read-resource-description()

  Copy to Clipboard Toggle word wrap

  pattern

  リクエストおよび応答からのさまざまな情報フィールドを特定するフォーマットレイアウト、または標準形式を選択する common または combined という単語を指定します。pattern 属性の値は、フォーマットトークンで構成されます。指定されない場合は、デフォルトの common が使用されます。

  rotate

  ouput をローテーションする必要がある場合にバルブに指示します。指定されていない場合は、デフォルトの true が使用されます。

  プレフィックス

  ログファイルの名前を作成するために使用されるプレフィックスを定義します。指定されていない場合は、デフォルトの access_log が使用されます。

  拡張

  AccessLogValve の代わりに ExtendedAccessLogValve を使用します。指定されていない場合は、デフォルトの false が使用されます。

  resolve-hosts

  ホスト名を解決するかどうかをバルブに指示します。指定されていない場合は、デフォルトの false が使用されます。resolve-host のコネクターの ルックアップ が有効になっていない限り、このオプションは動作しません。これは、resolve-host を true に設定すると有効にできます。

Alias

この仮想サーバーでサポートされるホスト名の一覧。管理コンソールでは、1 行あたり 1 つのホスト名を使用します。

管理 CLI 属性： エイリアス

デフォルトの Web モジュール

Web アプリケーションがこの仮想サーバーのルートノードにデプロイされるモジュールで、HTTP リクエストにディレクトリーが指定されていない場合に表示されます。デフォルト： ROOT.war

管理 CLI 属性： default-web-module

Welcome ルートの有効化

この要素は、バンドルされた welcome ディレクトリーがルート Web コンテキストとして使用されるかどうかを定義します。デフォルト: false

管理 CLI 属性： enable-welcome-root

名前

表示目的の仮想サーバーの一意な名前。

管理 CLI 属性： name

rewrite

リライトバルブが仮想ホストに対応するリクエストと実行する必要があるものを記述する要素。rewrite は、処理前にリクエストが書き換えられる方法を記述します。RewriteValve を virtual-server で定義される仮想ホストに追加します。

flag

RewriteRule は、1 つ以上のフラグでその動作を変更できます。フラグはルールの最後に角括弧に含まれており、複数のフラグはコンマで区切ります。

pattern

pattern は、リクエストの URL に適用される perl と互換性のある正規表現です。

置換

書き換えルールの置き換えは、パターンが一致した元の URL に置換（または置換）される文字列です。

管理 CLI 属性： rewrite

SSO

この仮想サーバーの SSO 設定。デフォルト（http の場合）: true

管理 CLI 属性： sso

• SSO 設定を追加するには、以下の管理 CLI コマンドを入力します。

  /subsystem=web/virtual-server=default-host/configuration=sso:add()

  Copy to Clipboard Toggle word wrap
• SSO 属性には複数の子属性があります。これらの子とそれらの設定オプションを一覧表示するには、以下の管理 CLI コマンドを入力します。

  /subsystem=web/virtual-server=default-host/configuration=sso:read-resource-description()

  Copy to Clipboard Toggle word wrap

  http-only

  cookie http-only フラグが設定されます。

  cache-container

  指定されたクラスター化されたキャッシュコンテナーを使用してクラスター化された SSO を有効にします。

  reauthenticate

  SSO の使用時にレルムと再認証を有効にします。

  domain

  使用されるクッキードメイン。

  cache-name

  キャッシュコンテナーで使用するキャッシュの名前。