CSP Gateway Configuration Guide - InterSystems Documentation

Operating the Network Service Daemon (NSD)
On startup, the NSD creates the following file:
CSPnsd.ini
Typically, this file contains the following lines:
[SYSTEM]
Ip_Address=127.0.0.1
TCP_Port=7038
In this context, the clients are the CSP modules contained within, or dynamically linked to, the Web server and/or the CSP
CGI modules invoked by the server. It is, therefore, essential that this file is not deleted or moved. It is also important that
the Web server processes can read this file. Set the privileges accordingly, bearing in mind the Windows user under which
your Web server is operating. The NSD clients attempt to find this file in a location contained within the Windows PATH
variable. For example:
\Windows
The CSPnsd.ini file must be moved to this location before starting the Web server
Clearly, storing the NSD port number in the CSPnsd.ini file is inappropriate for situations in which multiple instances of
the NSD are running. For Apache servers, there is a much better mechanism for communicating the TCP port number of
the NSD to its clients.
Set the following environment variables in the Apache configuration to indicate the address and port of the target NSD
installation. The values specified in these environment variables take precedence over any values found in the CSPnsd.ini
file.
CSP_NSD_NAME — This is the IP address of the NSD. Only use this parameter if the NSD is operating on a remote computer.
CSP_NSD_PORT — This is the TCP port of the NSD.
Example 1:
Distribute the load for two Apache virtual hosts (say, 123.123.1.1 and 123.123.1.2) between two independent NSD installations
(listening on TCP port 7038 and 7039).
Add the following directives to the Apache configuration (httpd.conf):
ServerName 123.123.1.1
SetEnv MGW_NSD_PORT 7038
ServerName 123.123.1.2
SetEnv MGW_NSD_PORT 7039
Example 2:
Distribute the load for two CSP applications (say, /csp1 and /csp2) between two independent NSD installations (listening
on TCP port 7038 and 7039).
1. Add the following directives to the Apache configuration (httpd.conf):
SetEnv MGW_NSD_PORT 7038
SetEnv MGW_NSD_PORT 7039
2. Restart Apache after making changes to its configuration.
In cases where multiple instances of the NSD are running, it is recommended that the separate instances be installed in
separate directories, each maintaining its own copy of the configuration and log files (CSP.ini and CSP.log). The CSP Web
Gateway Management page for each instance can easily be accessed by using the NSD internal HTTP server. For example:
CSP Gateway Configuration Guide 101