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

 

 

Share this page with others:
Tell Your Tweets Facebook It! Add to Delicious Reddit! Digg It! Stumble Upon Add to Your Faves Mixx it
Follow Us:
Keep up with my-Channels on Twitter Become a fan on Facebook LinkedIn Profile Recent Highlights RSS Feed