HCLSoftware Business Partner
Domino Consulting Services
CRUCIAL Notes Tools
+1 212-599-2048

Domino Consulting Services
CRUCIAL Notes Tools
Domino administration
Notes development

Facebook Twitter YouTube
Chat now       
.
ProductsDownloadsNewsAbout usContact


Need a Domino Consultant? Call NotesMail +1 212-599-2048 - HCLSoftware Business Partner

CONFIGURING

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 HCL Domino® Administrator, click theConfiguration tab.

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

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

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
    FieldDescription
    Cluster nameThe 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® portThe 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 TLS keyfileThe name of the TLS 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 HTTPLets 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
    FieldDescription
    Get configuration fromLets you specify a different Server document from which to get configuration information. This field lets multiple ICMs share the same configuration.
    Obtain ICM configuration fromThis 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 hostnameThe 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
    FieldDescription
    TCP/IP port numberEnter 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 statusTo enable HTTP communication with the ICM, choose enabled. To disable HTTP communication with the ICM, choose Disabled.
    TLS port numberEnter the port number to use for TLS.

    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 TLS port number is different from any of the other port numbers you use on the server.

    TLS port statusTo 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.

Related concepts
Failover and workload balancing
Security in a cluster
Using an IP sprayer with Domino for HTTP and POP3 failover

Related tasks
Setting up a separate IP address for the Internet Cluster Manager (ICM)
Starting the Internet Cluster Manager (ICM)
Managing and monitoring the Internet Cluster Manager (ICM)
Setting up cluster failover for IMAP

Related reference
Using an IP sprayer with Domino for LDAP failover