JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Configuring Oracle Java CAPS JBI Components for GlassFish Clustering     Java CAPS Documentation
search filter icon
search icon

Document Information

Configuring Oracle Java CAPS JBI Components for Clustering

JBI Component Clustering Overview

Clustering Overview

Component Support for Clustering

Load Balancing and Failover

Clustering Setup Summary

Creating a GlassFish Cluster

To Create a GlassFish Cluster

Adding a Java CAPS JBI Component to a Cluster

To Add a Shared Library to a Cluster

To Add a Java CAPS JBI Component to a Cluster

Modifying Server Properties for Java CAPS JBI Components in a Cluster

To Modify Runtime Properties for a Component in a Cluster

To Create Application Configurations and Variables for a Component in a Cluster

To View the Descriptor for a Component in a Cluster

To Set Logging Properties for a Component in a Cluster

To Monitor a Component in a Cluster

Configuring the BPEL Service Engine for Clustering

Setting Up the BPEL Database

To Set Up the BPEL Database

Adding the BPEL Service Engine to the Cluster

To Add the BPEL Service Engine to the Cluster

Debugging a Business Process Deployed in a Cluster

To Debug a Business Process Deployed in a Cluster

Configuring the IEP Service Engine for Clustering

Setting Up the IEP Database

To Set Up the IEP Database

Adding the IEP Service Engine to the Cluster

To Add the IEP Service Engine to the Cluster

Configuring the XSLT Service Engine for Clustering

To Add the XSLT Service Engine to the Cluster

Configuring the Java EE Service Engine for Clustering

To Enable the Java EE Service Engine on the Cluster

Configuring the Data Mashup Service Engine for Clustering

To Add the Data Mashup Service Engine to the Cluster

Configuring the Database Binding Component for Clustering

Creating the Clustering Database for the Database Binding Component

To Create the Clustering Database for the Database Binding Component

Adding the Database Binding Component to the Cluster

To Add the Database Binding Component to the Cluster

Configuring the File Binding Component for Clustering

Adding the File Binding Component to the Cluster

To Add the File Binding Component to the Cluster

Configuring the File BC WSDL File for Clustering

To Configure the File BC WSDL File for Clustering

Configuring the FTP Binding Component for Clustering

Adding the FTP Binding Component to the Cluster

To Add the FTP Binding Component to the Cluster

Configuring the FTP BC WSDL for Clustering

To Configure the FTP BC WSDL for Clustering

Configuring the HTTP Binding Component for Clustering

Enabling the HTTP Binding Component on the Cluster

To Enable the HTTP Binding Component on the Cluster

Configuring the HTTP BC Port Numbers for Clustering

To Configure the HTTP BC Port Numbers for Clustering

Configuring the JMS Binding Component for Clustering

To Add the JMS Binding Component to the Cluster

Configuring the LDAP Binding Component for Clustering

To Add the LDAP Binding Component to the Cluster

Configuring the Scheduler Binding Component for Clustering

To Add the Scheduler Binding Component to the Cluster

Deploying a Service Assembly to a Cluster

To Deploy a Service Assembly to a Cluster

Configuring Components for Standalone High Availability and Failover

Configuring the BPEL Service Engine for Multiple Standalone Instances

To Configure the BPEL Service Engine for Multiple Standalone Instances

Configuring the IEP Service Engine for Multiple Standalone Instances

To Configure the IEP Service Engine for Multiple Standalone Instances

JBI Component Clustering Overview

Java CAPS JBI components rely on the clustering capabilities of GlassFish Enterprise Server (ES) for clustering and high-availability. In addition, most components can be configured for different levels of load-balancing and failover. This document describes how JBI components use the clustering capabilities of GlassFish, but does provide detailed information about GlassFish clustering. A section is provided on basic cluster setup. For detailed information about high availability and clustering in GlassFish, see the Sun GlassFish Enterprise Server v2.1.1 High Availability Administration Guide.

The following topics provide overview information about clustering, Java CAPS clustering, and the steps required to set up a cluster for Java CAPS JBI components.

Clustering Overview

A cluster is a collection of application server instances that can distribute processing among clustered application instances. This provides optimal performance and scalability, along with high availability and failover capabilities for reliability. Implementing Java CAPS JBI applications in a clustered environment ensures continuous processing even when there is a hardware or software failure.

The instances in a cluster share the same set of Java CAPS JBI applications, resources, and configuration information, and can be implemented on one server or can extend over multiple servers. A clustered instance belongs to only one cluster, through there can be multiple clusters on a domain. All settings for a cluster are defined in a single configuration file named cluster_name-config.

In a cluster configuration for Java CAPS JBI components, each component is added to a GlassFish cluster and any Service Assemblies (SA) are deployed to the cluster. Adding a component to a cluster adds the component to all instances of the cluster. Similarly, deploying an SA to a cluster deploys it to all the cluster instances.

Component Support for Clustering

All Java CAPS JBI components are supported in a clustered environment. Some components work inherently in a clustered environment and some require special configuration, notably in the areas of load balancing and failover. Stateful Java CAPS service engines (SEs), such as BPEL SE and IEP SE, use a persistence database to track cluster instances and distribute work. Other components, such as the Scheduler BC, Data Mashup SE, and LDAP BC, work inherently in a clustered environment without needing to know about the different instances.

The BPEL SE and IEP SE provide additional support for clustering at a component level for backwards compatibility. This means that multiple SE instances can be deployed on one GlassFish server in a non-clustered environment. This allows for persistence, high-availability, and failover without using a GlassFish server cluster for all components.

Load Balancing and Failover

Load balancing and failover functions depend on the individual components in the cluster. For example, load balancing is not applicable to Service Engines (SE), and is protocol specific for some of the Binding Components (BC). For example, the HTTP Load Balancer is required for SOAP transactions, while the File BC, JMS BC, and FTP BC all have built-in load balancing.

GlassFish provides additional support for high availability, load balancing, and failover with the HTTP Load Balancer plug-in. The HTTP Load Balancer distributes incoming HTTP and HTTPS transactions among the instances in a cluster and also fails over requests to another server instance if the original server instance becomes unavailable. The HTTP BC in Java CAPS does not have its own load balancing capabilities, making the HTTP Load Balancer plug-in a useful tool when implementing the HTTP BC in a clustered environment. For more information, see Configuring HTTP Load Balancing in Sun GlassFish Enterprise Server v2.1.1 High Availability Administration Guide.

Load balancing and failover for the JMS BC is provided through a JMS broker cluster. For more information, see Java Message Service Load Balancing and Failover in Sun GlassFish Enterprise Server v2.1.1 High Availability Administration Guide.

Clustering Setup Summary

Below are the general steps for setting up clustering for Java CAPS JBI components. Each step is described in detail in later topics. Note that all setup and configuration tasks are performed using command line functions or the GlassFish Admin Console. NetBeans cannot be used for clustering setup because it does not support or recognize GlassFish clustering.

  1. Create a GlassFish cluster, as described in Creating a GlassFish Cluster.

  2. Add any necessary libraries to the cluster, as described in To Add a Shared Library to a Cluster.

  3. Add the Service Engines and Binding Components to the cluster, as described in To Add a Java CAPS JBI Component to a Cluster.

  4. Make any necessary configuration changes to the Service Engines and Binding Components. This is described in individual sections for each component.

  5. Deploy the Service Assembly to the cluster, as described in Deploying a Service Assembly to a Cluster.

Instructions for standalone (component-level) clustering are provided in the following topics: