Stopping the Realm Server

This section describes how to stop the Universal Messaging realm server by using the command prompt of your operating system or by using operating system shortcuts.

Stopping the Server on Windows

For Windows operating systems, the installation procedure for Universal Messaging installs a Start Menu entry called Stop Servers > Stop Universal Messaging Realm Server > Stop <InstanceName>, where <InstanceName> is the name of the realm server. Select this entry to stop the realm server.

Alternatively, you can open a command prompt, then set the working directory to the bin directory of your selected realm server, then enter the command nstopserver.bat.

Note: The nstopserver.bat command is a non-blocking command, which means it initiates a realm server shutdown and will exit, without waiting for the realm server process to terminate. To ensure that the realm server process has terminated, check the server log file.

Stopping the Server on UNIX

For UNIX-based operating systems, stop the realm server by opening a command prompt, then set the working directory to the bin directory of your selected realm server and run the script nstopserver.

Note: The nstopserver script is a non-blocking script.

Behavior of the Server During Shutdown

While the realm server is shutting down, it closes all client links and resources while shutting down. This process may take some time due to the operating system resources that the server uses. The server automatically performs a complete shutdown within 40 seconds if the graceful shutdown has not finished yet. The server performs an immediate shutdown. The realm server generates a thread dump and writes it to the nirvana.log file before shutdown.

However, you can use the nserverdaemon stop command on UNIX systems to shut down the server gracefully. In this case, the server waits for all processes to terminate before shutting down.

In the nirvana.log file, you can see a message that the shutdown sequence is completed and the shutdown time of the server in milliseconds, for example:

Shutdown: Realm Server completed shutdown sequence, process exiting normally in 1293 ms 

... (metadata related to the session that has just terminated) ...

--------- Log File Closed ---------