Configuring the Domino HTTP server to start, stop, and run the IBM HTTP server

You can use a setting in the NOTES.INI file on the Domino server to determine behavior of the IBM HTTP server running on the same computer.

About this task

When enabled, the HTTPIHSEnabled setting changes the Domino HTTP server to behave as follows:
  • The setting disables the usual ports configured in the Domino Directory (these are most often HTTP port 80 and the HTTPS port 443).
  • The Domino HTTP server connection settings are overridden with settings that maximize the re-use of connections between mod_domino/IBM HTTP Server and the Domino HTTP server.
  • By default, the Domino HTTP server listens on port 9288 for loop back connections from mod_domino/IBM HTTP Server.
  • The Domino HTTP server only accepts connections that originate from the same computer. By default, mod_domino uses the local loop back address of 127.0.0.1 to connect to the Domino HTTP server. Both server processes must run on the same computer.

Procedure

In the NOTES.INI file on the Domino server, add the following parameter:
HTTPIHSEnabled=1

Results

Before the IBM HTTP Server is started by the Domino HTTP server, the following environment variables are set automatically in this configuration; you should not need to modify any of them. These environment variables are specified in the ihs\conf\domino.conf file and are used to specify the values of IBM HTTP Server directives in the domino.conf file.
DOMINO_IHS_ROOT=C:/domino/ihs.
Set to the root directory where the IBM HTTP Server is installed
This setting cannot be changed.
DOMINO_SERVER_NAME=foo.renovations.com.
Set to the fully qualified tcp name of the machine the Domino Server is
installed on.
This setting cannot be changed.
DOMINO_DOCUMENT_ROOT=c:/domino/data/domino/html
Set to the document root where Domino html files are located.
This setting cannot be changed.
DOMINO_DOCUMENT_DIRECTORY=c:/domino/data/domino
Set to the base directory where Domino file system files may reside
This setting cannot be changed.
DOMINO_PORT=9288
Set to the port number that the Domino Web Server listens on for connections
from mod_domino. The default port is 9288.
This setting can be changed by setting the following notes.ini value.
HTTPConnectorPort=port number
DOMINO_MAX_REQUESTLINE=4108
Set to the maximum request line length, this setting is derived from Maximum
URL length: field on the http tab in the name and address book. A fix number
of bytes is added to account for the HTTP method and HTTP protocol strings.
DOMINO_TECH_SUPPORT=c:/domino/data/IBM_TECHNICAL_SUPPORT
Set to the domino technical support directory.
This setting cannot be changed.
DOMINO_RESPONSE_TIMEOUT=300
Set the amount of time in seconds that mod_domino plugin will wait for the
initial response from the Domino HTTP server.
The default is 300 seconds for a non-traveler server. For a traveler server
this setting is set to the Heartbeat Algorithm Maximum Interval: field on
the Lotus Traveler tab in the name and address book.
This setting can be changed by the following notes.ini
HTTPIHSModDominoResponseTimeout=timeout value in seconds
DOMINO_THREADS=120
This value is set to the number of Domino threads multiplied by three (3) for
the optimal threads to connections between mod_domino and the Domino HTTP
server. This is the default for non-traveler servers. For Lotus Traveler
Servers this number is set to the same number of threads as the Domino HTTP
server.
This setting can be changed by the following notes.ini, however the general
recommendation is to leave it alone unless there is a use case that requires a
change.
HTTPIHSThreads=number of IBM HTTP Server threads

What to do next

For serviceability, you can use a NOTES.INI setting to display environment variables that are used in the domino.conf configuration file.

Add the following parameter to the NOTES.INI file:

HTTPIHSDebugStartup=1

Example output:

[06F4:0002-13C4] Set IHS config environment var DOMINO_IHS_ROOT=C:/domino/ihs.
[06F4:0002-13C4] Set IHS config environment var
DOMINO_SERVER_NAME=sales.renovations.com.
[06F4:0002-13C4] Set IHS config environment var
DOMINO_DOCUMENT_ROOT=c:/domino/data/domino/html.
[06F4:0002-13C4] Set IHS config environment var
DOMINO_DOCUMENT_DIRECTORY=c:/domino/data/domino.
[06F4:0002-13C4] Set IHS config environment var DOMINO_PORT=9288.
[06F4:0002-13C4] Set IHS config environment var DOMINO_MAX_REQUESTLINE=4108.
[06F4:0002-13C4] Set IHS config environment var
DOMINO_TECH_SUPPORT=c:/domino/data/IBM_TECHNICAL_SUPPORT.
[06F4:0002-13C4] Set IHS config environment var DOMINO_RESPONSE_TIMEOUT=300.
[06F4:0002-13C4] Set IHS config environment var DOMINO_THREADS=120.