エラーステータスコードとエラーページとの対応づけは，次のファイルで定義します。

• 簡易構築定義ファイル
  論理Webサーバ（web-server）の<configuration>タグ内に，worker.<ワーカ名>.delegate_error_codeパラメタで，エラーページに対応づけたいエラーステータスコードを設定します。
  
• httpsd.conf
  ErrorDocumentディレクティブで，エラーステータスコードと，対応するエラーページのファイル名を対応づけます。
  　
  

(a)　エラーステータスコード設定時の注意事項

簡易構築定義ファイルでエラーステータスコードを指定する場合の注意事項を次に示します。

• エラーステータスコードは，ワーカ単位で指定します。
• エラーステータスコードを指定できるワーカのタイプは，「ajp13」だけです。ワーカのタイプが「lb」（ラウンドロビンに基づく負荷分散をするときの設定），および「post_size_lb」（POSTデータサイズに基づく振り分けをするとの設定）の場合，指定した内容は無視されます。
• 指定できるエラーステータスコードは，次の表のとおりです。これ以外のエラーステータスコードにエラーページを対応づけることはできません。
  

  表7-7　エラーページと対応づけできるエラーステータスコード

  エラーステータスコード	説明句
  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で指定する必要があります。
  

エラーページのカスタマイズの例を次に示します。

簡易構築定義ファイルの例

： <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ディレクティブの詳細については，マニュアル「Hitachi Web Server」を参照してください。

• Servlet 2.3仕様に対応したWebアプリケーションでは，サーブレットの仕様で規定されているweb.xmlの<error-page>タグによるカスタムエラー機能を使用している場合，Webコンテナは<error-page>タグに記述されているページへのアクセス結果をステータスコードとして返却します。このため，<error-page>タグに記述されているページへのアクセスでエラーが発生しない場合には，この機能は動作しません。
• エラーページの生成を委任するエラーステータスコードが簡易構築定義ファイルだけに定義されている（httpsd.confのErrorDocumentディレクティブを定義していない）場合，そのエラーステータスコードのエラーが発生したときに返却されるエラーページは，Hitachi Web Serverが自動生成したページになります。