Nirvana Enterprise Manager - Cluster Channel Administration

Introduction

This section describes the process of creating channels on a Nirvana Realm cluster. Channels are the logical rendezvous point for data that is published and subscribed. Each channel that is created consists of a physical object within each Nirvana realm within the cluster as well as it's logical reference within each realm's namespace.

Creating channels using the Enterprise Manager creates the physical object within each cluster realm. Once created, references to the cluster channels can be obtained using the Nirvana Client and Admin APIs, as you would with normal channels that are not cluster wide channels. Clustered channels can also be monitored and managed using the Enterprise Manager.

When you connect to a Nirvana realm in the Enterprise Manager, all channels, queues and services found within each realm's namespace are displayed in a tree structure under each realm node. Each cluster node also displays the member realms that make up the cluster.

Creating Cluster Channels

To create new cluster channels, you must first create a cluster if one does not already exist.

Secondly, in order to create a cluster channel, you must select the cluster node from the namespace tree where the channel will be created. For example, if there is a cluster called productioncluster, which contains 3 realms called 'productionmaster', 'productionslave1' and 'productionslave2' and you want to create a channel called /eur/rates within that cluster of realms, you would need to first of all click on the cluster node called 'productioncluster'. Then, by right-clicking on cluster node a pop-up menu will be displayed that shows a number of menu items (as shown in the image below).

By clickinig on the menu item 'Create Cluster Channel', you will be prompted with a dialog box that allows you to enter the details of the cluster channel you wish to create. Cluster channels have exactly the same set of attributes assigned to them as normal channels when they are created.

The create channel dialog for cluster channels allows you to input values for each of these attributes. The only difference is that the channel will be created across all of the realms within the cluster and the same state will be maintaned between all instances of that channel by the cluster realms. This means, for example, that if an event is published to a clustered channel it becomes available on all clusters simultaneously.

In order to create a cluster channel called '/eur/rates' with a message/event TTL of 7 the following settings would be configured:

Clicking on the 'OK' button will create the channel /eur/rates across all realms within the cluster 'productioncluster' and render the channel object in the namespace tree of the Enterprise Manager. The image below shows how the namespace tree looks after the cluster channel has been created, fully expanded.

As you can see from the image above, each realm node now contains the the channel node in its namespace tree under a folder (which we call a container node) called /eur. The icon used for a cluster channel is different to that of normal channel and is denoted by the multiple containers, whereas the normal channel icon shows a single container.