Stopping the Realm Server
The method you use to stop the Universal Messaging realm server depends on the installation operating system.
For Windows operating systems, you can use the Start menu shortcut called Stop Universal Messaging Realm Server.
For Linux/Solaris/Generic UNIX operating systems, stopping the realm server can be done using the softlink inside the Server directory:
$ cd <Software_AG_directory>/UniversalMessaging/links/Server/<InstanceName>/
$ ./Stop\ Universal\ Messaging\ Realm\ Server
where <Software_AG_directory> is the product installation directory, and <InstanceName> is the name of the realm server instance.
Alternatively, for all operating systems, if you started the realm server by using the command nserver, use the following procedure in another console window to stop the realm server:
1. Open a console window
2. Go to the server/<InstanceName>/bin directory
3. Run the command nstopserver
If the realm server is running as a Windows service or UNIX daemon, you can stop it by using the nserverdaemon script that is located in the server/<InstanceName>/bin directory. This script offers various options, as follows:
nserverdaemon --stop | Stop the realm server if it is running as a service/daemon. |
nserverdaemon --remove | Uninstall the realm server as a service/daemon. |
Note: On Windows, the options for nserverdaemon are preceded by a double hyphen "--". On UNIX systems, the double hyphens should be omitted. Also on Windows, there is a script unregisterService.bat that has the same effect as nserverdaemon --remove.
There as several ways of starting and stopping the realm server, and each way uses its own internal mechanisms. It's therefore important to always use the matching start/stop combination, such as:
nserver / nstopserver
nserverdaemon --start / nserverdaemon --stop
StartUniversalMessagingRealmServer / StopUniversalMessagingRealmServer
Command Central start / stop
The shutdown sequence
At this point the server will try and close down all client links and resources and P2P services. This may take some time to perform a graceful shutdown 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 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 then log the shutdown within the server log and can be confirmed as complete by the following entries:
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Realm Server shutdown sequence started
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Removed all logger listeners
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Disabling client requests
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Stopping Realm status updates
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Stopping Interface Manager
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Closing all accept handlers
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Closing all sessions with connected clients
[Tue Apr 08 09:26:58 BST 2014],Shutdown: Stopping Cluster management
[Tue Apr 08 09:26:58 BST 2014],Cluster> Cluster Agent restoring client request table
[Tue Apr 08 09:26:58 BST 2014],Cluster> Cluster Agent finished restoring client request table
[Tue Apr 08 09:26:58 BST 2014],--------- Log File Closed ---------