Manage Learn to apply best practices and optimize your operations.

Troubleshooting Browser Login Problems

A user tries to login via IE or Netscape to a Domino server and is getting a
login error. Creating custom error messages is a very simple way to get more
information and assist in troubleshooting.
Create a database called Custom Error Messages (httperror.nsf). Make Default
access reader. Create 2 forms, one called authorerror and one called

The authorerror form will come up when the Database ACL is stopping an
authenticated user from getting in. Make sure that it indicates so.

The authenerror form will come up when a user is not authenticated with the
server. Make sure that it indicates so.

Make sure that you have created a Domino Configuration database DOMCFG.nsf in
the \data directory on the server.

In the Domino Config, create a Mapping Error Messages entry and fill it in
similar to below:

Error Message and Response Mapping
Site Information
Server type: Virtual Server

IP Address:
Comment: TCINET Custom Errors
Authentication Failure
Target Database file name: httperror.nsf
Target Form name: Authenerror
Authorization Failure
Target Database file name: httperror.nsf
Target Form name: Authorerror
General Error Message
Target Database:
Target Form:
Delete Document Response
Target Database:
Target Form:

Save and restart the HTTP service.

For an IE user, after 3 attempts to login, they will get the appropriate error

For a Netscape user, have them hit cancel when they get the Authorization
Failed, Retry? window.

Depending on the error, you will know whether to check their HTTP Password/User
Name or the ACL of the database they are attempting to access.

Please note, this doesn't work when Session Authentication is enabled.

Dig Deeper on Domino Resources - Part 5

Start the conversation

Send me notifications when other members comment.

Please create a username to comment.




  • iSeries tutorials's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...