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:
[marvin@Terracotta.com]$ cd /home//Universal Messaging/links/Server/Universal Messaging
[marvin@Terracotta.com]$ nohup Start_Universal Messaging_Realm_Server &
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.
[Mon Apr 07 10:59:11 BST 2014], Copyright © PCB Systems Limited. All rights reserved
[Mon Apr 07 10:59:11 BST 2014],Startup: Processing local environment and setting Realm Server parameters accordly
[Mon Apr 07 10:59:11 BST 2014],Startup: Support for Version older clients enabled
[Mon Apr 07 10:59:12 BST 2014],Startup: Setting log level to 2
[Mon Apr 07 10:59:13 BST 2014],Startup: Finalising Realm startup
[Mon Apr 07 10:59:13 BST 2014],Startup: Server enabling NIO communications
[Mon Apr 07 10:59:14 BST 2014],Startup: Setting Server mode to Large Memory Mode
[Mon Apr 07 10:59:15 BST 2014],Startup: Realm restarted for realm1
[Mon Apr 07 10:59:15 BST 2014],Startup: Scanning local network adaptors and configuring network settings
[Mon Apr 07 10:59:15 BST 2014],Startup: Starting Realm Server Security Controller
[Mon Apr 07 10:59:15 BST 2014],Startup: Scheduling cluster cryptograhic initialisation
[Mon Apr 07 10:59:15 BST 2014],Startup: Starting validating Realm Configuration
[Mon Apr 07 10:59:15 BST 2014],Realm Validation: Resolved hostname nirvanahost to /nirvanahost for realm realm3
[Mon Apr 07 10:59:15 BST 2014],Realm Validation: Resolved hostname nirvanahost to /nirvanahost for realm realm2
[Mon Apr 07 10:59:15 BST 2014],Startup: Using SHA1withRSA, name SHA1withRSA Provider = SunRsaSign
[Mon Apr 07 10:59:15 BST 2014],Realm Validation: Resolved hostname nirvanahost to /nirvanahost for realm realm1
[Mon Apr 07 10:59:15 BST 2014],Startup: Finished validating Realm Configuration
[Mon Apr 07 10:59:15 BST 2014],Startup: Reloading all Channels/Queues and starting management tasks
[Mon Apr 07 10:59:15 BST 2014],Startup: Using DH for shared secret generation, Provider = SunJCE
[Mon Apr 07 10:59:16 BST 2014],Startup: Reloading Realm Public and Private RSA Key
[Mon Apr 07 10:59:16 BST 2014],Startup: Using JMS Style fanout engine for persistentTopic
[Mon Apr 07 10:59:16 BST 2014],Startup: Completed Realm Public and Private RSA Key
[Mon Apr 07 10:59:16 BST 2014],Startup: Cluster cryptograhic initialisation, complete
[Mon Apr 07 10:59:16 BST 2014],Startup: Starting Transaction Manager
[Mon Apr 07 10:59:16 BST 2014],Startup: Loading Realm Server configuration settings
[Mon Apr 07 10:59:16 BST 2014],Starting inter-realm read thread:realm5
[Mon Apr 07 10:59:17 BST 2014],Starting inter-realm read thread:realm3
[Mon Apr 07 10:59:17 BST 2014],Starting inter-realm read thread:realm2
[Mon Apr 07 10:59:17 BST 2014],Reloading Delayed publishing channel
[Mon Apr 07 10:59:17 BST 2014],Reloaded Delayed publishing channel, reloaded 0 items
[Mon Apr 07 10:59:17 BST 2014],fConfigManager: Config group TransactionManager registered itself with config manager.
[Mon Apr 07 10:59:17 BST 2014],nPlugins: Registered and loaded JMX Management sub-system
[Mon Apr 07 10:59:18 BST 2014],nPlugins: Registered com.pcbsys.nirvana.server.plugins.nUniversal MessagingXMLPlugin
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Name : Universal Messaging XML Plugin Desc : Allows the Universal Messaging servers namespace to be walked and data returned in XML
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Ignoring com.pcbsys.nirvana.server.plugins.nWebExpress Unable to load class : javax/servlet/ServletContext
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Ignoring com.pcbsys.nirvana.server.plugins.nServletPlugin Unable to load class : javax/servlet/ServletContext
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Registered com.pcbsys.nirvana.server.plugins.nChangePasswordPlugin
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Name : Change Password Plugin Desc : Allows changing passwords of existing users on a user file
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Registered com.pcbsys.nirvana.server.plugins.nRealmStatusPlugin
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Name : Realm Status Plugin Desc : Displays Realm Server status in an HTML page
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Ignoring com.pcbsys.nirvana.server.plugins.nUniversal MessagingSOAPPlugin Unable to load class : org/apache/axis/AxisFault
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Registered com.pcbsys.nirvana.server.plugins.nFilePlugin
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Name : File Plugin Desc : Handles web requests for files
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Registered com.pcbsys.nirvana.server.plugins.nProxy
[Mon Apr 07 10:59:19 BST 2014],nPlugins: Name : Proxy Pass through Plugin Desc : Handles web requests for files
[Mon Apr 07 10:59:19 BST 2014],fConfigManager: Config group ProxyForward registered itself with config manager.
[Mon Apr 07 10:59:19 BST 2014],fConfigManager: Config group RecoveryDaemon registered itself with config manager.
[Mon Apr 07 10:59:19 BST 2014],Startup: Initialising all inter-realm connections
[Mon Apr 07 10:59:19 BST 2014],Startup: Registering Namespace Agent to monitor realm additions/deletions into the namespace
[Mon Apr 07 10:59:19 BST 2014],Startup: Starting Cluster management
[Mon Apr 07 10:59:19 BST 2014],Cluster> Cluster Agent revectoring client request table
[Mon Apr 07 10:59:19 BST 2014],Cluster> Cluster Agent finished revectoring client request table
[Mon Apr 07 10:59:20 BST 2014],Cluster> Cluster State Engine being initialised
[Mon Apr 07 10:59:20 BST 2014],Cluster> Setting initial state to InitState
[Mon Apr 07 10:59:20 BST 2014],Cluster> Waiting for Cluster quorum
[Mon Apr 07 10:59:20 BST 2014],Cluster> Changing state from InitState to OfflineState
[Mon Apr 07 10:59:20 BST 2014],Cluster> Cluster State Engine initialisation complete
[Mon Apr 07 10:59:20 BST 2014],Cluster> Using Cluster event id based master selection algorithm
[Mon Apr 07 10:59:20 BST 2014],Startup: Recovering any dead event links
[Mon Apr 07 10:59:20 BST 2014],Startup: Recovering any uncommitted events from Queues
[Mon Apr 07 10:59:20 BST 2014],Startup: Recovering any uncommitted events from clustered Queues
[Mon Apr 07 10:59:20 BST 2014],Reloading Delayed publishing channel
[Mon Apr 07 10:59:21 BST 2014],Reloaded Delayed publishing channel, reloaded 0 items
[Mon Apr 07 10:59:21 BST 2014],Startup: Starting Interface Manager
[Mon Apr 07 10:59:22 BST 2014],Startup: Loading Driver for nsp://nirvanahost:9500
[Mon Apr 07 10:59:22 BST 2014],Starting Socket driver with NIO support
[Mon Apr 07 10:59:22 BST 2014],Cluster> Detected potential master realm1 is off line, waiting for node to rejoin cluster in 60000ms
[Mon Apr 07 10:59:22 BST 2014],Startup: Registering join conneciton monitor
[Mon Apr 07 10:59:22 BST 2014],Startup: Processing remote joins
[Mon Apr 07 10:59:22 BST 2014],Startup: Processing joins
[Mon Apr 07 10:59:22 BST 2014],Startup: Starting realm server scheduler entries
[Mon Apr 07 10:59:22 BST 2014],================================================
[Mon Apr 07 10:59:22 BST 2014], Copyright © PCB Systems Limited. All rights reserved
[Mon Apr 07 10:59:22 BST 2014],Start date = Mon Apr 07 10:59:22 BST 2014
[Mon Apr 07 10:59:22 BST 2014],
[Mon Apr 07 10:59:22 BST 2014],Realm Server Details :
[Mon Apr 07 10:59:22 BST 2014], Realm Server name = realm1
[Mon Apr 07 10:59:22 BST 2014], Realm Server version = $Name: $ - $Revision: 1.3 $
[Mon Apr 07 10:59:22 BST 2014], Build Number = BUILD_4_0_5000
[Mon Apr 07 10:59:22 BST 2014], Build Date = 12-Feb-1964
[Mon Apr 07 10:59:22 BST 2014], Data Directory = C:\\nirvana4\\realm1\\server\\realm1\data
[Mon Apr 07 10:59:22 BST 2014], Realm(s) Reloaded = 4
[Mon Apr 07 10:59:22 BST 2014], Channels Reloaded = 11
[Mon Apr 07 10:59:22 BST 2014], Queues Reloaded = 1
[Mon Apr 07 10:59:22 BST 2014], Interfaces Reloaded = 1
[Mon Apr 07 10:59:22 BST 2014],
[Mon Apr 07 10:59:22 BST 2014],Operating System Environment :
[Mon Apr 07 10:59:22 BST 2014], OS Name = Windows XP
[Mon Apr 07 10:59:22 BST 2014], OS Version = 5.1
[Mon Apr 07 10:59:22 BST 2014], OS Architecture = x86
[Mon Apr 07 10:59:22 BST 2014],
[Mon Apr 07 10:59:22 BST 2014],Java Environment :
[Mon Apr 07 10:59:22 BST 2014], Java Vendor = Sun Microsystems Inc.
[Mon Apr 07 10:59:22 BST 2014], Java Vendor URL = http://Java.sun.com/
[Mon Apr 07 10:59:22 BST 2014], Java Version = 1.5.0_14
[Mon Apr 07 10:59:22 BST 2014], Memory Allocation = 512 MB
[Mon Apr 07 10:59:22 BST 2014], Memory Warning = 435 MB
[Mon Apr 07 10:59:22 BST 2014], Memory Emergency = 481 MB
[Mon Apr 07 10:59:22 BST 2014], Clock Adjustment = 0ms
[Mon Apr 07 10:59:22 BST 2014], Nanosecond delay = Supported
[Mon Apr 07 10:59:22 BST 2014], Time Zone = Greenwich Mean Time
[Mon Apr 07 10:59:22 BST 2014], Security Provider 0 = SUN version 1.5
[Mon Apr 07 10:59:22 BST 2014], Security Provider 1 = SunRsaSign version 1.5
[Mon Apr 07 10:59:22 BST 2014], Security Provider 2 = SunJSSE version 1.5
[Mon Apr 07 10:59:22 BST 2014], Security Provider 3 = SunJCE version 1.5
[Mon Apr 07 10:59:22 BST 2014], Security Provider 4 = SunJGSS version 1.0
[Mon Apr 07 10:59:22 BST 2014], Security Provider 5 = SunSASL version 1.5
[Mon Apr 07 10:59:22 BST 2014], Security Provider 6 = Terracotta version 1.0
[Mon Apr 07 10:59:22 BST 2014],================================================
[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:
[marvin@Terracotta.com]$ cd /home//Universal Messaging/links/Client/Universal Messaging
[marvin@Terracotta.com]$ . ./Command_Prompt
This will set up your environment so that you can communicate with your Realm server.