5.8.3 実行環境での設定（Smart Composer機能を使用する場合）
ここでは，エラーページのカスタマイズの設定について説明します。
(1) 設定方法
エラーステータスコードとエラーページとの対応づけは，次のファイルで定義します。
-
簡易構築定義ファイル
論理Webサーバ（web-server）の<configuration>タグ内に，worker.<ワーカ名>.delegate_error_codeパラメタで，エラーページに対応づけたいエラーステータスコードを設定します。
簡易構築定義ファイルおよびパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3 簡易構築定義ファイル」を参照してください。
-
httpsd.conf
ErrorDocumentディレクティブで，エラーステータスコードと，対応するエラーページのファイル名を対応づけます。
httpsd.conf（HTTP Server定義ファイル）については，マニュアル「HTTP Server」を参照してください。
(a) エラーステータスコード設定時の注意事項
簡易構築定義ファイルでエラーステータスコードを指定する場合の注意事項を次に示します。
-
エラーステータスコードは，ワーカ単位で指定します。
-
エラーステータスコードを指定できるワーカのタイプは，「ajp13」だけです。ワーカのタイプが「lb」（ラウンドロビンに基づく負荷分散をするときの設定），および「post_size_lb」（POSTデータサイズに基づく振り分けをするときの設定）の場合，指定した内容は無視されます。
-
指定できるエラーステータスコードは，次の表のとおりです。これ以外のエラーステータスコードにエラーページを対応づけることはできません。
表5‒19 エラーページと対応づけできるエラーステータスコード エラーステータスコード
説明句
400
Bad Request
401
Unauthorized
402
Payment Required
403
Forbidden
404
Not Found
405
Method Not Allowed
406
Not Acceptable
407
Proxy Authentication Required
408
Request Time-out
409
Conflict
410
Gone
411
Length Required
412
Precondition Failed
413
Request Entity Too Large
414
Request-URI Too Long
415
Unsupported Media Type
416
Requested Range Not Satisfiable
417
Expectation Failed
422
Unprocessible Entity
423
Locked
424
Failed Dependency
500
Internal Server Error
501
Not Implemented
502
Bad Gateway
503
Service Unavailable
504
Gateway Time-out
505
HTTP Version not supported
507
Insufficient Storage
510
Not Extended
(b) ErrorDocumentディレクティブ指定時の注意事項
httpsd.confでErrorDocumentディレクティブを指定する場合の注意事項を次に示します。
-
ErrorDocumentディレクティブにローカルURLを使用する場合には，リダイレクタがWebコンテナに転送しないURLを指定する必要があります。
-
ルートコンテキストの使用時など，リダイレクタの設定で「/*」というURLパターンをワーカにマッピングしている場合，すべてのリクエストがWebコンテナに転送されます。そのため，ErrorDocumentディレクティブには，Webコンテナ上のリソースを，完全URLを使用して設定してください。
ルートコンテキストを使用する場合で，エラーステータスコード404発生時に，Webコンテナ上のルートコンテキスト配下のerror404.jspを表示させるための設定例を次に示します。hostAは，Webサーバ稼働ホストです。
- （例）
-
ErrorDocument 404 http://hostA/error404.jsp
また，このときWebコンテナが停止している場合には，リダイレクタはエラーステータスコード500のエラーを返します。このため，Webコンテナが停止している際のエラーページをカスタマイズするには，ErrorDocumentディレクティブで，エラーステータスコード500に対して別のWebサーバのリソースを，完全URLで指定する必要があります。
(2) 設定例
エラーページのカスタマイズの例を次に示します。
- 簡易構築定義ファイルの例
： <param> <param-name>worker.list</param-name> <param-value>worker1</param-value> </param> <param> <param-name>worker.worker1.type</param-name> <param-value>ajp13</param-value> </param> <param> <param-name>worker.worker1.host</param-name> <param-value>host1</param-value> </param> <param> <param-name>worker.worker1.delegate_error_code</param-name> <param-value>404</param-value> </param> ：
worker.<ワーカ名>.delegate_error_codeパラメタに，エラーステータスコード「404（Not Found）」を定義しています。
- httpsd.confの例
# httpsd.confの記述# # ： ErrorDocument 404 /missing.html
エラーステータスコードと，対応するエラーページのファイル名を対応づけます。エラーステータスコード「404（Not Found）」のエラーが発生した場合に，missing.htmlファイルを表示するようになります。
ErrorDocumentディレクティブの詳細については，マニュアル「HTTP Server」を参照してください。