Installing The Module On Unix - MACROMEDIA COLDFUSION 4.5-ADMINISTRING COLDFUSION SERVER Manual

72
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
information about why the install failed.
Note
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
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
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
the process as demonstrated below.
ps -deaf
It returns the PID in a string something like:
ckintzin
The first number is the PID. Use it in the kill command to stop the process:
kill -INT 980
in the log subdirectory of your ColdFusion installation, for
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.
with the
-sREMOVE
. It is not necessary to perform any special installation step on UNIX.
| grep cfdist | grep -v grep
980 1 0 15:48:12 ?
Administering ColdFusion Server
command line option. Notice of successful
command to get the PID and then kill
ps
0:00 cfdist