Fusion Middleware Documentation
Advanced Search


Administering HTTP Session Management with Oracle Coherence*Web
Close Window

Table of Contents

Show All | Collapse

1 Introduction to Coherence*Web

This chapter describes the advantages of using Coherence*Web for managing session state in clustered environments. It lists the containers that can use Coherence*Web and provides an installation and deployment roadmap. More detailed information on installation, deployment, and features are provided in following chapters.

This chapter contains the following sections:

1.1 Understanding Coherence*Web

Coherence*Web is an HTTP session management module dedicated to managing session state in clustered environments. Built on top of Oracle Coherence (Coherence), Coherence*Web:

1.2 Supported Web Containers

To install the Coherence*Web session management module on Oracle WebLogic Server 9.2.1, 9.2.3, 10.3.1, and later, you can use the Coherence*Web Service Provider Interface (SPI)-based installation. For instructions on installing the Management Module on WebLogic Server 10.3.4, see Oracle Coherence User's Guide for Oracle Coherence*Web.

For WebLogic Server 12c (12.1.2), Coherence*Web is integrated with the product. No installation is necessary. For more information, see Chapter 2, "Using Coherence*Web with WebLogic Server."

For third-party application servers and a few legacy versions of Oracle WebLogic Server (9.2.1, 9.2.3, 10.3, 10.3.1), Coherence*Web provides a generic installer, the WebInstaller, that transparently instruments your Web applications. Chapter 4, "Using Coherence*Web on Other Application Servers," describes how to use the WebInstaller to install Coherence*Web on these servers.

Table 1-1 summarizes the Web containers supported by the Coherence*Web session management module. It also provides links to the information required to install Coherence*Web. Notice that all of the Web containers (except Oracle WebLogic Server 10.3.4) share the same general installation instructions. A few, such as Caucho Resin, and WebLogic 10.n, require extra, container-specific steps that you must complete before starting the general installation instructions.

Note:

The value in the Server Type Alias column is used only by the Coherence*Web WebInstaller installation. The value is passed to the WebInstaller through the -server command-line option.

Table 1-1 Web Containers which can use Coherence*Web

Application Server Server Type Alias See this Installation Section

Apache Tomcat 5.5.n

Tomcat/5.5.x

"General Instructions for Installing Coherence*Web Session Management Module" and "Enabling Sticky Sessions for Apache Tomcat Servers"

Apache Tomcat 6.0.n

Tomcat/6.0.x

"General Instructions for Installing Coherence*Web Session Management Module" and "Enabling Sticky Sessions for Apache Tomcat Servers"

Apache Tomcat 7.n

Tomcat/7.x

"General Instructions for Installing Coherence*Web Session Management Module" and "Enabling Sticky Sessions for Apache Tomcat Servers"

This feature was added as part of a patch release. For information about which features were added in a patch, see Release Notes for Oracle Coherence.

Caucho Resin 3.1.n

Resin/3.1.x

"Installing on Caucho Resin 3.1.n"

IBM WebSphere 5.n

WebSphere/5.x

"General Instructions for Installing Coherence*Web Session Management Module"

IBM WebSphere 6.n

WebSphere/6.x

"General Instructions for Installing Coherence*Web Session Management Module"

IBM WebSphere 7.n

WebSphere/7.x

"General Instructions for Installing Coherence*Web Session Management Module" and "Decoding URL Session IDs for IBM WebSphere 7.n Servers"

IBM WebSphere 8.n

WebSphere/8.x

"General Instructions for Installing Coherence*Web Session Management Module"

IBM WebSphere 8.5

WebSphere/8.x

"General Instructions for Installing Coherence*Web Session Management Module"

JBoss Application Server

Generic or Jetty/5.1.x

"General Instructions for Installing Coherence*Web Session Management Module"

Jetty 5.1.n

Jetty/5.1.x

"General Instructions for Installing Coherence*Web Session Management Module"

Jetty 6.1.n

Generic

"General Instructions for Installing Coherence*Web Session Management Module"

Oracle GlassFish 3.n

N/A

Chapter 3, "Using Coherence*Web with GlassFish Server"

Oracle OC4J 10.1.2.n

Oracle/10.1.2.x

"General Instructions for Installing Coherence*Web Session Management Module"

Oracle OC4J 10.1.3.n

Oracle/10.1.3.x

"General Instructions for Installing Coherence*Web Session Management Module"

Oracle WebLogic 9.2 MP1 and 9.2 MP3;
Oracle WebLogic 10.3

WebLogic/9.x

WebLogic/10.x

For WebInstaller and SPI-based installations, see Chapter 2, "Using Coherence*Web with WebLogic Server" and Chapter 4, "Using Coherence*Web on Other Application Servers".

Oracle WebLogic 10.n

WebLogic/10.x

For WebInstaller installations, see "Installing on Oracle WebLogic Server 10.n"

Sun Application Server 8.n

Generic

"General Instructions for Installing Coherence*Web Session Management Module"

Sun GlassFish 2.n

Generic

"General Instructions for Installing Coherence*Web Session Management Module"


1.3 Installation and Deployment Road Map

There are deployment decisions you should make before you configure and deploy Coherence*Web. Coherence*Web is supported on many different application servers. Regardless of which application server you are using, you might have to change some Coherence*Web configuration options to meet your particular requirements, such as packaging considerations, session model, session locking mode, and deployment topology.

1.3.1 Choose Your Cluster Node Isolation

Cluster node isolation refers to the scope of the Coherence nodes that are created within each application server JVM. Several different isolation modes are supported.

For example: you might be deploying multiple applications to the container that require the use of the same cluster (or one Coherence node); you might have multiple Web applications packaged in a single EAR file that use a single cluster; or you might have Web applications that must keep their session data separate and must be deployed to their own individual Coherence cluster. These choices and the deployment descriptors and elements that must be configured are described in "Cluster Node Isolation".

1.3.2 Choose Your Locking Mode

Locking mode refers to the behavior of HTTP sessions when they are accessed concurrently by multiple Web container threads. Coherence*Web offers several different session locking options. For example, you can allow multiple nodes in a cluster to access an HTTP session simultaneously, or allow only one thread at a time to access an HTTP session. You can also allow multiple threads to access the same Web application instance while prohibiting concurrent access by threads in different Web application instances. These choices, and the deployment descriptors and elements that must be configured, are described in "Session Locking Modes".

1.3.3 Choose How to Scope Sessions and Session Attributes

Session and session attribute scoping refers to the fine-grained control over how both session data and session attributes are scoped (or shared) across application boundaries. Coherence*Web supports sharing sessions across Web applications and restricts which session attributes are shared across the application boundaries. These choices, and the deployment descriptors and elements that must be configured, are described in "Session and Session Attribute Scoping".

1.3.4 Choose When to Clean Up Expired HTTP Sessions

Coherence*Web provides a session reaper, which invalidates sessions that have expired. Chapter 7, "Cleaning Up Expired HTTP Sessions," describes the session reaper.

1.3.5 Choose the Installation Method

The installation procedure that you follow depends on your application server. "Supported Web Containers" provides a list of the application servers and the corresponding instructions for installing Coherence*Web.

If you are using a recent release of WebLogic Server (such as 12c (12.1.2)) Coherence and Coherence*Web are installed with the WebLogic Server product. No separate Coherence*Web installation is necessary. See Chapter 2, "Using Coherence*Web with WebLogic Server."

If you are installing Coherence*Web on an older release of WebLogic Server (such as WebLogic Server 11gR1 or earlier), use the native WebLogic Server SPI-based installation procedure described in Coherence User's Guide for Oracle Coherence*Web at this URL:

http://docs.oracle.com/cd/E24290_01/coh.371/e22620/toc.htm

For other application servers, use the generic Java EE WebInstaller described in Chapter 4, "Using Coherence*Web on Other Application Servers."

Note that the installation of Coherence*Web on WebLogic Portal is completely independent of WebLogic Server; that is, you do not have to install Coherence*Web on WebLogic Server to install it on WebLogic Portal. See Chapter 10, "Using Coherence*Web with WebLogic Portal."