2 Installing a Client Distribution

2.2.1 Supported Environments

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

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

• Visual Studio 2005 SP1 and Visual Studio 2008: The following redistributable run-time 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 computers.

  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 does 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 run-time 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

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.1 Prerequisites

The following are required to use Coherence for .NET:

• Microsoft .NET 2.0, 3.0, or 3.5 run time

• Microsoft .NET 2.0, 3.0, or 3.5 SDK

• Supported Microsoft Windows operating system (see the system requirements for the appropriate .NET run time above)

• MSHelp 2.x run time, which is included in Visual Studio 200x and 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:

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.

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.