Universal Messaging 9.7 | Installation Guide | Starting the Realm Server
 
Starting the Realm Server
Starting the Universal Messaging Realm server depends on the installation operating system.
For win32 operating systems, the installer installs a shortcut called Start Universal Messaging Realm Server. Furthermore, the server command prompt can be used to open a console window and the server can be started by typing nserver.
Alternatively you can register the Realm as an NT service and control operation through the service control panel.
For Linux/Solaris/Generic Unix operating systems, starting the Realm can be done using the softlink inside the Server directory:

$ cd ~/terracotta/universalmessaging_<version>/links/Server/umserver/
$ nohup ./Start\ Universal\ Messaging\ Realm\ Server &
where <version> is the product version number.
For the personal Java installation simply click the server link in the pjbin or the evbin, depending on the Personal Java JRE of your choice.
At this point the server should have started and is now ready for operation. To confirm this it is easy to check the Realm Server log file and ensure there are no errors being reported. Check the log file for a completion message such as the following:
[Mon Apr 07 10:59:22 BST 2014],Startup: Realm Server Startup sequence completed
As the Realm Server starts up it reports the current log level settings, currently set to 1000000 characters and a log level of 4. The log level was set during the installation, a level of 0 reports every action the server does and can roll log files every minute on a busy realm.
The Realm Server then reports the JRE environment and the currently installed security providers. These are important if running SSL and cause the majority of configuration problems. After this the server then reloads all the configuration parameters, channels and topics and then is ready to accept connections.
If there are any problems binding to a port or creating an SSL instance these exceptions are reported into the Realm Server log file with as much detail as the server can produce.
To test that the Realm Server is up and ready to accept connections a simple test is to request information about the realm itself. To do this you need to open a client command prompt, and then issue the command ngetrealms.
To open a client command prompt on a Win32 installation, click on the Command Prompt shortcut in your Start Menu.
To open a client command prompt on a Linux/Solaris/Generic Unix installation, open a console and source the Command Prompt script as follows:
$ cd ~/terracotta/universalmessaging_<version>/links/Client/umserver
$ ./Java\ Examples\ Command\ Prompt
where <version> is the product version number.
This will set up your environment so that you can communicate with your Realm server.

Copyright © 2013-2015 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.