How to configure DOLS in a cluster environment such as ICM

From Notes Help

To set up DOLS on clustered servers

Before using DOLS on a clustered Domino 6 server, make sure that:

  • The Domino server is either a Domino Utility Server or Domino Enterprise Server.
  • All servers in the cluster run the same release of Domino with DOLS
  • Clustered server management is running to handle both failover of replication and HTTP
  • Internet Cluster Manager is running
  • Subscription directories must have the same name on every clustered server.  For example, if a subscription is under dataWebmail user7CD5957CB669AE2285256BDF00567AD8, this name cannot be different on a different server in the cluster


How to configure ICM

You configure the ICM by making entries in the Internet Cluster Manager section of the Server document. You can also set up a separate IP address for the ICM. You can then start the ICM.

You can configure the ICM settings on one server and have more than one ICM access these settings. This lets ICMs on different servers share a common configuration. You should include the ICM configuration information on every Web server in the cluster, not just the server on which you run the ICM. You do this because each Web server uses its own Server document to determine how to generate URLs that refer to the ICM. The Web server obtains the host name of the ICM from the Server document. The Web server then uses that host name to generate URLs that reference the ICM.

To configure the ICM

1. From the Domino Administrator or the Web Administrator, click the Configuration tab.

2. In the Tasks pane, expand Server and click All Server Documents.

3. Do one of the following:

  • In the Results pane of the Domino Administrator, select the Server document for the server on which you want to run the ICM. Then click Edit Server.
  • In the Results pane of the Web Administrator, open the Server document for the server on which you want to run the ICM. Then click Edit Server.
4. Click the Server Tasks - Internet Cluster Manager tab.

5. Complete the following fields:

Section Field name Description
Basics Cluster name The name of the cluster the ICM will service. If this field is blank, which is the default, Domino uses the name of the cluster that contains this server.
ICM Notes port

The name of the Domino port the ICM will use to communicate with HTTP clients. If this field is blank, which is the default, the ICM can use any Domino TCP/IP port to communicate with HTTP clients. Enter a port name only if you want to restrict ICM communication to one specific port.
ICM SSL keyfile The name of the SSL key file that contains certificates to identify the ICM when communicating with HTTP clients. If this field is blank, the ICM uses the key file specified on the Ports - Internet Ports tab of the Server document.
Allow users to browse databases in the cluster over HTTP Lets HTTP clients view a list of the databases in a cluster.

When you enable this field, users can enter http://icmhostname/?OpenServer as the URL to access. Entering this URL displays a list of databases on the servers in the cluster associated with the ICM named in icmhostname.

Configuration Get configuration from Lets you specify a different Server document from which to get configuration information. This field lets multiple ICMs share the same configuration.
Obtain ICM configuration from This field appears when you select "another server document" in the field "Get configuration from." Enter the name of the server whose Server document contains the configuration you want to use.
ICM hostname The fully qualified name of the host that clients should use to communicate with the ICM. This can be the registered DNS name or the IP address.

The Domino Web server uses this field to create URLs that reference the ICM. If this field is blank, the Web server will not be able to generate URLs that refer to the ICM.

ICM HTTP Port Settings TCP/IP port number Enter the port number for the ICM to use.

If you are running the ICM on the same server as the Web server, you must avoid address and port conflicts. If you do not give the ICM its own IP address, be sure the port number the ICM uses is different from any of the other port numbers you use on the server.

TCP/IP port status To enable HTTP communication with the ICM, choose enabled. To disable HTTP communication with the ICM, choose Disabled.
SSL port number Enter the port number to use for SSL.

If you are running the ICM on the same server as the Web server and you do not give the ICM its own IP address, be sure the SSL port number is different from any of the other port numbers you use on the server.

SSL port status To enable HTTPS communication with the ICM, choose enabled. To disable HTTPS communication with the ICM, choose Disabled.

6. Click save & Close to save the Server document.

When the ICM starts, it looks at the Server document on the server on which it is running to find the ICM cluster name and its network address. It then obtains the host name and port settings from the same Server document or from the Server document specified in the field "Obtain ICM configuration from."

If you run the ICM on the same system as a Domino Web server, you must avoid IP address or port number conflicts. The best approach is to assign the ICM its own IP address. You can also have the ICM share an IP address with the Web server if you specify different port numbers for the ICM and the other protocols on the Web server.