Configuring the Internet Cluster Manager (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.

About this task

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.

Procedure

  1. From the IBM® 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 fields in the following tables and save the Server document.
    Table 1. Basics tab

    Field

    Description

    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.
    Table 2. Configuration tab

    Field

    Description

    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.
    Table 3. ICM HTTP Port tab

    Field

    Description

    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.

Results

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.