9/37

# 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:

- Installing Coherence for Java

- Installing the C++ Client Distribution

- Installing the .NET Client Distribution

## 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.

## 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:

- Supported Environments

- Microsoft-Specific Requirements

- Extracting the Coherence for C++ Distribution

### 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+), as well as 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, as well as 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)

### Microsoft-Specific Requirements

When deploying on Microsoft Windows, just as with any MSVC based application, the corresponding MSVC runtime libraries must be installed on the deployment machine.

- Visual Studio 2005 SP1 and Visual Studio 2008: The following redistributable runtime libraries for x86 or x64 are required. If developing with Visual Studio 2008, the 2005 SP1 redistributable libraries must still be installed on both the development and deployment machines.

  x86:

  `http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en`

  x64:

  `http://www.microsoft.com/downloads/details.aspx?familyid=EB4EBE2D-33C0-4A47-9DD4-B9A6D7BD44DA&displaylang=en`

  The use of Oracle Coherence for C++ with MSVC 2005 SP1 (x86 and x64) requires both the Microsoft Visual C++ 2005 Service Pack 1 Redistributable and the Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package ATL Security Update. Coherence will not run without the security update. For more information on the security update, see

  `http://support.microsoft.com/?kbid=973544`

  The security update is available from the Microsoft Update Web site or directly from

  `http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=766a6af7-ec73-40ff-b072-9112bab119c2`

- Visual Studio 2010: Redistributable runtime libraries for x86 or x64.

  x86:

  `http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=a7b7a05e-6de6-4d3a-a423-37bf0912db84`

  x64:

  `http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=bd512d9e-43c8-4655-81bf-9350143d5867`

### 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 together with an application.

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

## 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:

- Prerequisites

- Running the Installer

- Deploying Coherence for .NET

### Prerequisites

The following are required to use Coherence for .NET:

- Microsoft .NET `2.0`, `3.0`, or `3.5` Runtime

- Microsoft .NET `2.0`, `3.0`, or `3.5` SDK

- Supported Microsoft Windows operating system (see the system requirements for the appropriate .NET Runtime above)

- MSHelp 2.x Runtime, which is included in Visual Studio 200x as well as the Microsoft products listed here:

  `http://www.helpware.net/mshelp2/h20.htm#MS_H2_Runtime`

- `Microsoft Visual Studio 2005` is required to build and run the examples included with Coherence for .NET:

### 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 runtime 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.

### 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.