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