Before you can build, deploy, and run the various components of the Coherent Bank application, you will need to have several prerequisites in place.
First of all, we strongly suggest that you run all the components of the application on a single Windows XP machine, at least the very first time. There are several reasons for this, but the most important one is that Windows is the only OS where you will be able to run all three applications —while we have tested Java and C++ applications both on Windows and OS X, you will only be able to run .NET application on Windows.
Once you become more familiar with the application architecture and configuration, you can experiment by moving things around and running the Coherence cluster across multiple machines, the web application on OS X, the .NET application on Windows, and the C++ application on Linux, but in the beginning you should keep things simple.
The following sections document other software you will need and any specific configuration settings you need to make.
If you don't already have it (and my guess is you do), you should download and install the latest release of Sun's JDK 1.6. Make sure that you have the full JDK installed, not just the JRE.
You will also need to set the JAVA_HOME
environment variable to point to your JDK. For example, if you installed JDK into the default location, your JAVA_HOME
should look similar to the following:
JAVA_HOME=C:\Program Files\Java\jdk1.6.0_18
You will need Visual Studio 2008 to build the .NET and C++ sample applications. If you don't already have it, you can download express editions of Microsoft Visual C# and Microsoft Visual C++ from http://www.microsoft.com/express/Windows/, but please keep in mind that we have only tested the build process with the full version of Visual Studio 2008.
The .NET application requires .NET Framework 3.5, but if you have Visual Studio 2008 this should already be installed.
The application should work with other Coherence versions as well, but it has been tested with 3.5.3 only, so it is strongly recommended that you use that release.
You will need to download and install several packages:
Download the Coherence Java release and install it according to the instructions in Chapter 2, Getting Started. Set the
COHERENCE_HOME
environment variable to point to your installation directory containing thebin
,lib
, and other Coherence folders.Download and install Coherence for C++ 32-bit Windows release. You should install it by extracting the
coherence-cpp
directory from the downloaded archive into theCOHERENCE_HOME
directory. For example, if yourCOHERENCE_HOME
isC:\coherence
, your Coherence for C++ installation should be inC:\coherence\coherence-cpp
.Download and install Coherence for .NET. Simply run the installer from the download archive and accept the installation defaults when prompted. Make sure that you use the default installation path, as that's the location used to find
Coherence.dll
when building the .NET sample application.
You will need to have Ant installed and in your system path in order to build and deploy the application. If you don't already have it, you can download it from http://ant.apache.org/.
Make sure that you set the ANT_HOME
environment variable to the Ant installation directory and that you add ANT_HOME\bin
to your PATH
.
You will need NAnt to build the .NET sample application. NAnt can be downloaded from http://nant.sourceforge.net/.
Make sure that you add NAnt's bin
directory to system PATH
as well.