D Oracle Coherence*Web Extension for OVAB

Coherence*Web provides extensions for Oracle Virtual Assembly Builder, a tool for virtualizing installed Oracle components, modifying those components, and then deploying them into your own environment.Using Oracle Virtual Assembly Builder, you capture the configuration of existing software components in artifacts called software appliances. Appliances can then be grouped, and their relationships defined into artifacts called software assemblies which provide a blueprint describing a complete multi-tier application topology.

The Oracle Coherence*Web introspection extension for Coherence*Web extends the functionality of the WebLogic Server Introspector. It examines the configuration of Coherence cache clusters and servers configured as part of a WebLogic domain.

This appendix includes the following sections:

• Versions Supported
  The Coherence*Web Extension for OVAB works with Oracle WebLogic Server 11gR1 version 11.1.1.4.0, which includes Coherence 3.6.
• Coherence*Web Introspection Parameters
  Coherence*Web requires no additional OVAB introspection parameters beyond those needed by Oracle WebLogic Server.
• Reference System Prerequisites
  Coherence*Web requires no additional OVAB prerequisites beyond those defined by Oracle WebLogic Server.
• Requirements
  Oracle Coherence*Web has OVAB requirements in addition to the WebLogic Server OVAB requirements.
• Resulting Artifact Type
  For each Coherence cluster that is defined in an introspected WebLogic domain, the OVAB plug-in extension creates a new appliance within the atomic Oracle WebLogic Server assembly.
• Wiring
  Coherence cluster appliances do not use OVAB wiring.
• Wiring Properties
  The Coherence*Web Extension for OVAB does not include any wiring properties.
• Coherence*Web Appliance Properties
  Each Oracle Coherence*Web cluster appliance includes system and user properties that define a Coherence configuration.
• Supported Template Types
  The Coherence*Web Extension for OVAB supports the Oracle Enterprise Linux (OEL) template type.

Versions Supported

The Coherence*Web Extension for OVAB works with Oracle WebLogic Server 11gR1 version 11.1.1.4.0, which includes Coherence 3.6.

Coherence*Web Introspection Parameters

Coherence*Web requires no additional OVAB introspection parameters beyond those needed by Oracle WebLogic Server.See Using the Introspection Plug-in for Oracle Virtual Assembly Builder in Administering Server Environments for Oracle WebLogic Server.

Reference System Prerequisites

Coherence*Web requires no additional OVAB prerequisites beyond those defined by Oracle WebLogic Server.See Using the Introspection Plug-in for Oracle Virtual Assembly Builder in Administering Server Environments for Oracle WebLogic Server.

Requirements

Oracle Coherence*Web has OVAB requirements in addition to the WebLogic Server OVAB requirements.See Using the Introspection Plug-in for Oracle Virtual Assembly Builder in Administering Server Environments for Oracle WebLogic Server.

This section includes the following topics:

• Deployment Model Requirement
  
• Requirement to Manually Update Custom Cluster Configuration Files
  

Deployment Model Requirement

The plug-in extension requires you to use an out-of-process deployment model for Oracle Coherence*Web, in which storage-enabled cache servers are executed as separate processes rather than running within Oracle WebLogic Server. See Out-of-Process Topology.

Requirement to Manually Update Custom Cluster Configuration Files

The plug-in extension examines Oracle Coherence*Web configuration defined through the WebLogic Server Administration Console and WebLogic Server MBeans (including WLST). It does not examine or modify custom cluster configuration files such as tangosol-coherence-override.xml. Custom cluster configuration files are passed through to the deployed environment, but no configuration changes are made to those files to reflect the deployed environment.

After deployment, ensure that you make appropriate manual configuration changes to any custom cluster configuration files.

Resulting Artifact Type

For each Coherence cluster that is defined in an introspected WebLogic domain, the OVAB plug-in extension creates a new appliance within the atomic Oracle WebLogic Server assembly.

Wiring

Coherence cluster appliances do not use OVAB wiring. Each cluster appliance has a fixed, pre-defined connection to the domain Administration Server, which is used at rehydration time to modify the cluster's configuration.

Wiring Properties

The Coherence*Web Extension for OVAB does not include any wiring properties.

Coherence*Web Appliance Properties

Each Oracle Coherence*Web cluster appliance includes system and user properties that define a Coherence configuration.

Table D-1 describes Oracle Coherence*Web cluster appliance system properties:

Table D-1 Oracle Coherence*Web Appliance System Properties

Name	Type	Req'd	Default	Description
cache-servers	String	false	none	A list of the cache servers that are part of the cluster.
targets	String	false	none	A list of WebLogic Server Managed Servers that are part of the cluster.
<cacheserver>.node-manager-type	String	false	none	For each cache server in the above list, there is a property indicating the Node Manager type.
well-known-addresses	String	false	none	A list of well-known-addresses defined for the cluster. If no well-known-address are defined for this cluster (meaning it uses multicast), then this property will not be present.
<wellknownaddress>.server	String	false	none	For each of the well-known-addresses in the above list, there is a property indicating which cache server the well known address maps to (based on matching listen address and port information).

Table D-2 describes Oracle Coherence*Web cluster appliance user properties:

Table D-2 Oracle Coherence*Web Appliance User Properties

Name	Type	Req'd	Default	Description
<cacheserver>.node-manager-port	String	false	none	For each of the cache servers in the cluster, the Node Manager port is listed and may be modified by the user.
<cacheserver>.unicast-listen-port	String	false	none	For each of the cache servers in the cluster, the unicast listen port of that server is listed and may be modified by the user.
multicast-listen-address	String	false	none	The cluster-wide multicast listen address. If one or more well-known-addresses are listed (meaning the cluster uses unicast for cluster discovery), then this multicast property will not be present.
multicast-listen-port	String	false	none	The cluster-wide multicast listen port. If one or more well-known-addresses are listed (meaning the cluster uses unicast for cluster discovery), then this multicast property will not be present.
unicast-listen-port	String	false	none	The default unicast listen port for the cluster. This value is used by any cache servers that do not have a unicast listen port defined, as well as by any WebLogic Server Managed Servers that join the cluster.
<wellknownaddress>.server	String	true	none	If any of the defined well known addresses could not be correlated with a cache server (based on matching listen address and port information), they will be listed here, and the user is responsible for specifying a cache server name to be used as the well known address. This property is mandatory, meaning it must be specified either as an appliance property or via a deployment plan.

Supported Template Types

The Coherence*Web Extension for OVAB supports the Oracle Enterprise Linux (OEL) template type.