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 receives 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 the Configurations tab and select the configuration from the configuration list.

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

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

4. Click New 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.

Using CLI

To customize 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).