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. For similar instructions on how to
start the realm server, see the section
Starting the Realm Server.
Note:
Starting and stopping the realm server is also possible using the Command Central interface. Refer to the appropriate section of the Administration Guide for information.
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, as described below in the section
Realm Server behavior while shutting down.
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:
As described above for Windows, the nstopserver script is a non-blocking script.
Realm Server behavior while shutting down
While the realm server is shutting down, it closes down all client links and resources. This may take some time, due to the operating system resources that the realm server uses. The realm server will automatically perform a complete shutdown within 10 seconds if the graceful shutdown has not yet completed, at which point the realm server will perform an immediate shutdown. The realm server will generate a thread dump which will be written to the log file prior to shutdown.
The realm server will log the shutdown in the server log file nirvana.log. A successful shutdown is indicated by entries similar to the following:
Shutdown: Realm Server completed shutdown sequence, process existing normally
... (metadata related to the session that has just terminated) ...
--------- Log File Closed ---------