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 Realm 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 will initiate 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 Realm Server on UNIX-Based Systems
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, then 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 10 seconds if the graceful shutdown has not finished yet. At this point, the server performs an immediate shutdown. The realm server generates a thread dump and writes it to the nirvana.log file prior to 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 log file, you should 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 ---------