Sun Java System Web Server 7.0 Update 3 Administrator's Guide

Customizing Error Responses

You can specify a custom error response that sends a detailed message to clients when they encounter errors from your virtual server. You can specify a file to send or a CGI program to run.

For example, you can change the way the server behaves when it gets an error for a specific directory. If a client tries to connect to a part of your server protected by access control, you might return an error file with information on how to get an account.

Before you can enable a custom error response, you must create the HTML file to send or the CGI program to run in response to an error.

To add a custom error page, follow these steps:

  1. Click Configurations tab and select the configuration from the configuration list.

  2. Click Virtual Servers sub tab and select the virtual server from the virtual server list.

  3. Click Content Handling sub tab and Error Pages sub tab.

  4. Click New button to add a custom error page.

    For each error code you want to change, specify the absolute path to the file or CGI that contains the error response.

  5. Click OK to return to the error pages list.


Note –

Using CLI

For customizing error pages through CLI, execute the following command.


wadm> set-error-page --user=admin --password-file=admin.pwd --host=serverhost 
--port=8989 --config=config1 --vs=config1_vs_1 --code=500 
--error-page=/server-error-uri-new 

See CLI Reference, set-error-page(1).