MACROMEDIA COLDFUSION 4.5-ADMINISTRING COLDFUSION..., Manual

Page: 94 / 350

72 Administering ColdFusion Server
To install the network listener module as a service:
1. Run the listener with the following special command line argument:
cfdist.exe -sINSTALL
2. If installation was successful, it should now appear on your Services list under the
name ColdFusion NetListener. If it doesn’t show up, look in the module’s log file,
distributed.log in the log subdirectory of your ColdFusion installation, for
information about why the install failed.
Note
Once you’ve installed the module as an NT service you cannot move the
executable file unless you uninstall and reinstall it in its new location.
Once installed as a service, you can start, stop, pause or continue the listener’s
operation as you would any NT service. You can start or stop the listener independent
of any of the other ColdFusion services although, of course, the listener must be
running to receive remote network requests. Note that when starting the service (from
the NT Services Control Panel applet), you will need to specify -p switch and possibly
the -k switch in the Startup Parameters box in the Services applet.
Please refer to the list of command line options below.
To uninstall the listener
Invoke
cfdist.exe
with the
-sREMOVE
command line option. Notice of successful
removal will be written to the listener log.
Installing the module on UNIX
On UNIX, the listener module consists of a single executable file, in this case named
simply
cfdist
. It is not necessary to perform any special installation step on UNIX.
To start the listener as a daemon:
Type the executable’s name (without the -i switch) and the process will start. Because
it’s running as a daemon, the command will return immediately having launched the
process in the background. You will probably use at least the -p switch when starting
the daemon.
Please refer to the list of command line options below.
To stop the daemon process:
You need to kill it by its process ID. Use the
ps
command to get the PID and then kill
the process as demonstrated below.
ps -deaf | grep cfdist | grep -v grep
It returns the PID in a string something like:
ckintzin 980 1 0 15:48:12 ? 0:00 cfdist
The first number is the PID. Use it in the kill command to stop the process:
kill -INT 980