CSP Gateway Configuration Guide - InterSystems Documentation

Atypical Configurations for UNIX®, Linux, and Mac OS X
2. Enter the following command to start the NSD:
./CSPnsd
Before retiring to the background, the NSD displays a banner indicating its running configuration. It shows the TCP port
number dedicated to this service, which is, by default, port number 7038.
You can suppress all startup messages for this command using the -s qualifier. For example, to start the NSD from a script
invoked at system boot, use:
/opt/cspgateway/csp/CSPnsd –s
Other common startup options:
• Display help information.
./CSPnsd -h
• Pause the operation of the NSD. This command sends a stop signal (SIGSTOP) to the NSD process.
./CSPnsd -pause
• Continue the operation of the NSD (after a pause). This command sends a continue signal (SIGCONT) to the NSD
process.
./CSPnsd -cont
To close down the NSD, enter:
./CSPnsd -stop
Alternatively:
kill –TERM `cat /opt/cspgateway/csp/CSPnsd.pid`
These commands close down the NSD in an orderly manner – it gracefully terminates all open connections to Caché and
releases all its system resources before terminating. Do not use the kill –9 command to terminate the NSD.
All errors are reported in the Event Log (CSP.log). This file is created and maintained in the NSD home directory (such as
/opt/cspgateway/csp). The configuration file CSP.ini also resides in this directory.
B.1.3.1 Starting the NSD on Alternative TCP Port
By default, the NSD listens for incoming requests on TCP port 7038. You can override this by starting the service as follows,
where port_no is the TCP port number of your choice.
./CSPnsd [port_no]
Or:
./CSPnsd -p=[port_no]
On startup, the NSD creates the following file:
/opt/cspgateway/csp/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 module 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
122 CSP Gateway Configuration Guide