Skip Headers
Oracle® Coherence Client Guide
Release 3.7

Part Number E18678-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

2 Installing a Client Distribution

This chapter provides instructions for installing the C++ and .NET client distributions. There is no separate Java client distribution package. Java extend clients are created using Coherence for Java.

The following sections are included in this chapter:

2.1 Installing Coherence for Java

The Coherence for Java distribution is used to build and use Java-based extend clients. To install Coherence for Java, see "Installing Oracle Coherence for Java" in the Oracle Coherence Developer's Guide.

2.2 Installing the C++ Client Distribution

The Oracle Coherence for C++ distribution is used to develop and run C++ extend clients. The latest version of the distribution can be downloaded from the Coherence product page on the Oracle Technology Network:

http://www.oracle.com/technology/software/products/ias/htdocs/coherence.html

This section contains the following topics:

2.2.1 Supported Environments

Table 2-1 lists the supported platforms and operating systems for Coherence for C++:

Table 2-1 Platform and Operating System Support for Coherence for C++

Operating System Compiler Architecture

Microsoft Windows 2000+Foot 1 

MSVC 2005 SP1+Foot 2 , MSVC 2010

x86

Microsoft Windows Server 2003+Foot 3 

MSVC 2005 SP1+2, MSVC 2010

x64

Sun Solaris 10

SunPro 5.9Foot 4 

SPARC

Sun Solaris 10

SunPro 5.9Foot 5 

x86

Sun Solaris 10

SunPro 5.95

x64

Linux

GCC 3.4+Foot 6 

x86

Linux

GCC 3.4+6

x64

Apple OS X 10.4+Foot 7 

GCC 3.4+6

x86

Apple OS X 10.4+Foot 8 

GCC 3.4+6

x64


Footnote 1 Including Windows 32b XP, Vista, 2000, 2003, and 2008.

Footnote 2 Specifically MSVC 2005 SP1 (14.00.50727.762+), and MSVC 2008 and express versions are supported.

Footnote 3 Including Windows 64b XP, Vista, 2003, and 2008.

Footnote 4 Specifically Sun C++ 5.9 SPARC Patch 124863-14 or later are supported.

Footnote 5 Specifically Sun C++ 5.9 x86/x64 Patch 124864-14 or later are supported.

Footnote 6 Specifically GCC 3.4.6-8 and above, and GCC 4.x versions are supported.

Footnote 7 Including OS X Tiger (10.4), Leopard (10.5), and Snow Leopard (10.6)

Footnote 8 Including OS X Leopard (10.5), and Snow Leopard (10.6)

2.2.2 Microsoft-Specific Requirements

When deploying on Microsoft Windows, just as with any MSVC based application, the corresponding MSVC run-time libraries must be installed on the deployment computer.

2.2.3 Extracting the Coherence for C++ Distribution

Coherence for C++ is distributed as a ZIP file. Use a ZIP utility or the unzip command-line utility to extract the ZIP file to a location on the target computer. The extracted files are organized within a single directory called coherence-cpp.

The following example uses the unzip utility to extract the distribution to the /opt directory which is the suggested installation directory on UNIX-based operating systems. Use the ZIP utility provided with the target operating system if the unzip utility is not available.

unzip /path_to_zip/coherence-cpp-version_number-platform-architecture-compiler.zip -d /opt

The following example extracts the distribution using the unzip utility to the C:\ directory on the Windows operating system.

unzip C:\path_to_zip\coherence-cpp-version_number-platform-architecture-compiler.zip -d C:\

The following list describes the directories that are included in installation directory:

  • bin – This directory includes sanka.exe, which is an application launcher that is used to invoke executable classes embedded within a shared library.

  • doc – This directory contains Coherence for C++ documentation including the API documentation

  • examples – This directory includes examples that demonstrate basic functionality.

  • include – This directory contains header files that use the Coherence API and must be compiled with an application.

  • lib – This directory includes the Coherence for C++ library. The coherence.dll file is the main development and run-time library and is discussed in detail throughout this documentation.

2.3 Installing the .NET Client Distribution

The Oracle Coherence for .NET distribution is used to develop and use .NET extend clients. The latest version of the distribution can be downloaded from the Coherence product page on the Oracle Technology Network:

http://www.oracle.com/technology/software/products/ias/htdocs/coherence.html

This section contains the following topics:

2.3.1 Prerequisites

The following are required to use Coherence for .NET:

2.3.2 Running the Installer

Coherence for .NET is distributed as a ZIP file which contains an installer. Use a ZIP utility or the unzip command-line utility to extract the installer to a location on the target computer. The following example extracts the installer using the unzip utility to the C:\ directory:

unzip C:\path_to_zip\coherence-net-version_number.zip -d C:\

To run the installer:

  1. From the directory where the ZIP was extracted, double-click the coherence-net-version.msi file.

  2. Follow the instructions in the installer to complete the installation.

Note:

If the installer indicates that it is rolling back the installation, then run the installer in elevated execution mode. For example, executing the MSI file from a command prompt that was started as an Administrator should enable the installation process to complete. For Windows 7, right-click the command prompt and select run as Administrator.

The following list describes the directories that are included in the installation directory:

  • bin – This directory includes the Coherence for .NET library. The Coherence.dll file is the main development and run-time library and is discussed in detail throughout this documentation. A version of the library is included for .NET 2.0 and higher.

  • config – This directory contains XML schemas for Coherence configuration files and also includes a POF configuration file for Coherence-defined user types.

  • doc – This directory contains Coherence for .NET documentation including the API documentation. The API documentation is available as a compiled HTML Help (Coherence.chm) or as MSHelp 2.0 Help.

  • examples – This directory includes examples that demonstrate basic functionality.

2.3.3 Deploying Coherence for .NET

Coherence for .NET requires no specialized deployment configuration. Simply add a reference to the Coherence.dll found in the bin\net\2.0 folder to your Microsoft.NET application.

2.4 Compatibility Between Coherence*Extend Versions

Compatibility for the extend protocol and POF is maintained between point releases but not between major releases. In addition, within point releases, only forward compatibility is maintained from extend clients to cluster proxies. That is, an extend client can connect to cluster proxies that have either the same or higher version numbers. Extend clients should not attempt to connect with previous versions of cluster proxies.

Note:

Compatibility requires the use of POF, since POF can support backward compatible serialization change.