Nirvana Installation

Starting the Realm Server

Starting the Nirvana Realm server depends on the installation operating system.

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

This will set up your environment so that you can communicate with your Realm server.