IBM Support

Custom error page setting in httpd.cnf for non-NSF resources no longer works

Technote (FAQ)


Question

The Domino Web Server Configuration database (domcfg.nsf) allows you to define custom error pages for *.NSF resources. However, these custom error pages are not served if the request is for a non-NSF resources, such as a nonexistent HTML file.

Therefore, you made a customization to the httpd.cnf file to provide an error page for non-NSF resources, but find that this no longer works in Domino 6 or later.


Answer

This issue has been reported to Quality Engineering as SPR# MKIN6JMMZQ and fixed in Domino 6.5.6 and Domino 7.0.2. Refer to the Upgrade Central site for details on upgrading Notes/Domino.

As indicated in the fix list entry, you use the following entry in the notes.ini to provide this functionality:

    HTTPMultiErrorPage=/error.html

Excerpt from the Lotus Notes and Domino Release fix list (available at http://www.ibm.com/developerworks/lotus ):
    SPR# MKIN6JMMZQ - Customer reported that their custom error pages were not being served up in ND6. In R5, they had added the following to their httpd.cnf file: ErrorPage multi /error.html. This would cause the contents of error.html to be served up if a bogus filesystem URL was received (http://server/doesnotexist.txt). This no longer works in ND6. The fix submitted for this SPR requires the use of the following notes.ini: HTTPMultiErrorPage=/error.html. This regression was introduced in 6.0.

This fix introduces a change that can affect what pages are seen as active by applications such as Web crawlers. With this fix, the HTTP header for a request to a nonexistent non-NSF resource contains a 200 OK response code because the error page is served successfully. Normally, you expect the HTTP header to show 404 for File not found because the HTML file requested does not exist on the server. Because of the 200 status code, Web crawlers might index the page as active, instead of as a broken link. This issue has been reported to Quality Engineering as SPR# PPET6SKPE3 and fixed in Domino 6.5.6 and Domino 7.0.3.

Excerpt from the Lotus Notes and Domino Release 7.0.3 fix list (available at http://www.ibm.com/developerworks/lotus ):

    SPR# PPET6SKPE3 - Custom non-Domino http error pages now respond with an error code 404 (File not found).

Document information

More support for: Lotus End of Support Products
Lotus Domino

Software version: 6.0, 6.5, 7.0

Operating system(s): AIX, IBM i, Linux, Solaris, Windows, z/OS

Reference #: 1230036

Modified date: 19 October 2007