Shutting down the TIBCO Patterns Server

The TIBCO Patterns server can be shut down in three ways:

•

An authorized client may connect and issue the svrshutdown command.

•

UNIX only: You may send the signal SIGTERM to the server. The UNIX kill command sends SIGTERM by default.

•

Windows only: if TIBCO Patterns is run as a Windows Service, all the standard service-control tools can be used.

•

If TIBCO Patterns is run interactively in debug mode (-d option), it can be stopped using standard keyboard interrupts (for example, control-C).

•

Windows only: the taskkill.exe command can be used to do an immediate, unclean shutdown.

•

If TIBCO Hawk is enabled, the TIBCO Hawk administrator can shut down the server through TIBCO Hawk interface.

•

The NSC sample program provides a svrshutdown command that can be used to shut down the server and wait for the shutdown to complete.

When a shutdown is initiated, the server first stops accepting new commands, then waits for all currently running commands to complete, frees all data, removes the PID file if one was created (see -r option), and then exits. Long running commands check for a termination request and exit early, but the shutdown process may take a considerable amount of time, especially if the server has very large tables.

If a shutdown is taking too long or appears to be hung, sending the TIBCO Patterns server a SIGTERM signal during the shutdown process forces the server to do an immediate, unclean shutdown. This is not recommended as it may not properly clean up all client socket connections, potentially causing problems in the client processes, and may not clean up the PID file (see -r option).

It is recommended that the -r option be used when starting the TIBCO Patterns server. As the PID file is removed as the last step in the shutdown process, it can be used as a flag for when the shutdown is complete. If you attempt to start a new TIBCO Patterns server before the first server has completed shutdown the start of the new server may fail. The NSC sample program svrshutdown command can take advantage of the PID file to both wait for the server to complete shutdown, and, if it is taking too long, force shutdown with a SIGTERM signal. This is the recommended shutdown procedure.