This is archived documentation for an older version of Nirvana (v3.1). Please refer to documentation for the latest version if required.

Nirvana Installation

Overview

Nirvana is made up of a server component and a client API used by applications to communicate with the server. The server, known as the Realm Server, maintains all the information regarding the Channels, Queues, P2P services and the security around these. The Realm Server supports direct connections using normal TCP/IP sockets, Secure Socket Layer (SSL) while also supporting HTTP directly with no additional processes or web server infrastructure required. By directly supporting HTTP the process of configuring a Realm Server for the Internet is greatly simplified..

Nirvana is highly portable - written in 100 % pure Java. It therefore requires a copy of the Java Development Kit (JDK) or Java Runtime Environment (JRE) to be installed. The minimum version of the required JDK and JRE is 1.2 and the recommended release is 1.4.2_06. Please refer to the web site for up to date JRE recommendations, http://www.my-Channels.com/

In order to make the installation of Nirvana a pain free experience we provide our users with a set of options. Installers can run in either GUI or console mode in order to enable it to be run on nearly all systems without the requirement of having some sort of graphical display to perform the task. In addition to that, installers can include a Java Runtime Environment (JRE) or not which significantly affects the size of your download but ensures compatibility and normal operation of the product.

The installers can be downloaded directly from the web site http://www.my-Channels.com/. There are currently eight installer options:

• Win32 environment install.exe . (with or without a JRE)
• Linux environment install.bin . (with or without a JRE)
• Solaris environment install.bin . (with or without a JRE)
• Generic Unix environment install.bin . (without a JRE)
• Personal Java environments pjava.zip. This is a zipped image of the Nirvana install.

This installation guide contains information on the following sections:

Pre-Installation

Installation

Post-Installation

Command Prompts

Personal Java Installation

Server Memory Modes

Client Deployment

Starting the Realm Server

Stopping the Realm Server

JMS Configuration