GridGain In-Memory Data Fabric for C++
==================================

GridGain In-Memory Data Fabric for C++ provides data grid functionality.
Using GridGain C++ APIs you can execute perform concurrent operations on
the data stored in cache.

GridGain In-Memory Data Fabric for C++ can access cluster and share data with .Net and
Java applications using portable object format.

Support for the following will be added in next releases:
 * ACID transactions management.
 * Distributed locks.
 * Async operations.
 * Cache SQL queries and continuous queries.
 * Event listening.
 * Compute grid functionality.

Building the Library
==================================

Full source code is provided. Users should build the library for intended platform.

Building on Linux With Autotools
----------------------------------

Common Requirements:

 * GCC, g++, autotools, automake, and libtool must be installed
 * Java Development Kit (JDK) must be installed: https://java.com/en/download/index.jsp
 * JAVA_HOME environment variable must be set pointing to Java installation directory.

Building the library:
 * Navigate to the direcotry /platforms/gridgain/cpp
 * Execute the following commands one by one:
     * libtoolize
     * aclocal
     * autoheader
     * automake --add-missing
     * autoreconf
     * ./configure
     * make
     * (optional) make install 

NOTE: "make install" command may require superuser privileges. In this case it must be
executed as "sudo make install".

Development:

 * GRIDGAIN_HOME environment variable must be set to GridGain installation directory.
 * IGNITE_HOME environment variable must be set to GridGain installation directory
   (that is, IGNITE_HOME = GRIDGAIN_HOME).
 * Once both libraries are built and installed, required headers are placed in the
   "/usr/local/include/gridgain" directory.
 * GridGain for C++ depends on jni.h file located inside ${JAVA_HOME}/include directory.
   Add this directory to headers search path: "-I${JAVA_HOME}/include".
 * Library is placed in the "/usr/local/lib" directory. Link it to your project: "-lgridgain".
 * GridGain depends on "libjvm.so" library shipped with Java. Typically this library is located inside
   $JAVA_HOME/jre/lib/amd64/server directory. Ensure that LD_LIBRARY_PATH environment variable points to this directory.


Building on Windows with Visual Studio (tm)
----------------------------------

Common Requirements:

 * Microsoft Visual Studio (tm) 2010
 * Windows SDK 7.1
 * Java Development Kit (JDK) must be installed: https://java.com/en/download/index.jsp
 * JAVA_HOME environment variable must be set pointing to Java installation directory.

Building the library:

 * Open and build platforms\gridgian\cpp\project\vs\gridgain.sln (or gridgain_86.sln if you are running
   32-bit platform).

Development:

 * GRIDGAIN_HOME environment variable must be set to GridGain installation directory.
 * IGNITE_HOME environment variable must be set to GridGain installation directory
   (that is, IGNITE_HOME = GRIDGAIN_HOME).
 * Update Include Directories in Project Properties with paths to:
   * $(GRIDGAIN_HOME)\platforms\grigain\cpp\common\include
   * $(GRIDGAIN_HOME)\platforms\grigain\cpp\common\os\win\include
   * $(GRIDGAIN_HOME)\platforms\grigain\cpp\jni\include
   * $(GRIDGAIN_HOME)\platforms\grigain\cpp\jni\os\win\include
   * $(GRIDGAIN_HOME)\platforms\grigain\cpp\core\include
   * $(GRIDGAIN_HOME)\platforms\grigain\cpp\core\os\win\include
   * $(JAVA_HOME)\include
   * $(JAVA_HOME)\include\win32
 * Update Library Directories with path to the built binaries
 * Update Linker\Input\Additional Dependencies in Project Properties with path to
   * ignite.common.lib
   * ignite.jni.lib
   * gridgain.core.lib
 * Make sure that your application is aware about ignite.jni.dll and gridgain.core.dll libraries. The easiest way
   to achieve this is to either make sure these files are in %PATH%, or to put them into the output directory of
   your project with help of PostBuild events.
