Manage Learn to apply best practices and optimize your operations.

Domino clusters for Internet traffic

Chuck Connell describes how to use the Internet Cluster Manager to bring clustered Domino servers to Web users.

Chuck Connell

View member feedback to this tip.

In last month's tip, I talked about Domino server clusters and described how they can greatly increase overall system reliability with little effort.

Domino clusters do have one significant drawback, however. They only work with the Notes client software. The clustering technology depends on the Notes client to maintain a cache of server cluster information, which Notes uses if a cluster member is unavailable.

What if you want to use a Domino cluster for Web service? With standard clustering, you are out of luck. Fortunately, Domino contains another feature that fills this hole. Internet Cluster Manager (ICM) is a piece of software that brings the benefits of clustered Domino servers to Web users. This tip contains an overview of ICM and provides some pointers for its use.

ICM is a Domino server task that is supplied as part of the Domino product, but is not enabled by default. ICM's job is to serve as a gatekeeper and redirection agent for Web traffic into a cluster. So browser requests from users first enter ICM, which redirects the requests to members of a Domino server cluster. If a member of a cluster stops working, ICM is aware of cluster membership and directs user traffic to another (running) cluster member. So the first step to setting up ICM is to set up a Domino cluster. ICM (logically) sits on top of a valid Domino cluster.

Server topologyv

There are many possible topologies for a set of servers that form a Domino cluster and run the ICM task, including the following:

  1. ICM can run directly on one of the machines in a Domino cluster.
  2. ICM can run on more than one machine in a Domino cluster.
  3. ICM can run on a single server that is not part of the Domino cluster.
  4. ICM can run on multiple servers that are not part of the Domino cluster.
If you can afford the hardware and license fees, I recommend choice #4. The reason is that the primary goal of Domino clustering is reliability. Placing ICM on one of the clustered servers (#1) defeats this purpose. If that member of the cluster fails, ICM is also offline, making the entire cluster offline to Web users. If ICM runs on a single, separate ICM server (#3), it still presents a single point of failure. The clustered servers are redundant, but the ICM server has no fail over.

ICM can run on both/all members of a Domino cluster. This provides redundancy for ICM as well as the Domino Web servers. The problem with this topology (#2) is its complexity. Each computer is acting as both an ICM server and as a clustered Web server; ICM is pointing to itself. The two uses of the same server require multiple IP addresses (or IP ports) for the same machine. Administration of the servers becomes more complex, since each machine is functioning in two logically separate ways. This is an officially supported configuration, but I recommend against it.

Choice #4 provides high reliability for both the underlying Web servers and the ICM task that is managing user traffic to the cluster. Administration and troubleshooting is also simpler in this configuration.


The ICM configuration is defined in the Internet Cluster Manager section of the Server document. The detailed field settings for this feature are explained in Domino 6 Administrator Help / Contents / Clusters / Clustering Domino Servers That Run Internet Protocols / Configuring the ICM. Fill in the fields of the server document as explained.

You should treat one of the server's ICM settings as the "master," and then use the Get Configuration From option to copy these settings to the other three servers in the topology. Note that the clustered servers need the ICM information also, even though they will not be running the ICM software directly.

Starting ICM

After setting the ICM configurations above, you can start the Domino ICM task on the ICM servers. For testing, you can start this task by typing LOAD ICM at the Domino server console. For general use, edit the NOTES.INI file on the ICM servers and add ICM to the line that begins with ServerTasks=.


For full details about Internet Cluster Manager, see Domino 6 Administrator Help / Contents / Clusters.

Chuck Connell is president of CHC-3 Consulting, which helps organizations with all aspects of Domino and Notes.


I think it would be nice to dig into the issues of failure...

What happens if the Web server fails? According to the Domino Administrator the user gets an error and will have to reactive a URL to the ICM. Is that really what it does? If so, I believe it is rather too simple.

Next, what happens if the ICM fails? Well, I can figure out what happens if the ICM fails if there is only one, but if there are more than one, will one of the others take over the request from the user? If the user will have to type in a URL manually (i.e., they need to know another address!) then it is also rather limited.

I hope you will make a follow up to the article covering these issues.

-- John D. If you would like to follow up on this tip with more in-depth scenarios as described in John's post, please submit your tip to

Do you have comments of your own? Let us know.

Dig Deeper on Lotus Notes Domino Clustering

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 ...