1 Introduction To The GemFire Plugin

This user guide describes details on configuring and using GemFire specifically in the context of a Grails application. Complete documentation on GemFire is available at http://www.gemstone.com/products/gemfire.

1.1 Installing Gemfire

Installing GemFire

If you plan to use Gemfire only in peer-2-peer mode then you can skip this installation. If you want to use Gemfire in client/server mode then follow these instructions to install Gemfire:

1. Register at the SpringSource GemFire download site to access the download.

The registration process is quick and helps us help you later if you have questions or problems. The product includes an evaluation license.

1. Install GemFire Enterprise 6.5 according to the instructions on the download site.

You can also get GemFire from your salesperson.

Configure your environment for GemFire.

1. Set the JAVA_HOME environment variable to point to your Java runtime installation. (There should be a bin directory under JAVA_HOME.)
2. Set the GEMFIRE environment variable to point to your GemFire installation top-level directory. (There should be bin, lib, dtd, and other directories under GEMFIRE.)
3. Configure GF_JAVA and your PATH and CLASSPATH as shown in these examples. (GF_JAVA must point to the java executable file under your JAVA_HOME.)

Unix Bourne and Korn shells (sh, ksh, bash)

GF_JAVA=$JAVA_HOME/bin/java;export GF_JAVA
PATH=$PATH:$JAVA_HOME/bin:$GEMFIRE/bin;export PATH
CLASSPATH=$GEMFIRE/lib/gemfire.jar:$GEMFIRE/lib/antlr.jar:$GEMFIRE/lib/gfSecurityImpl.jar:$CLASSPATH;export CLASSPATH

Windows

set GF_JAVA=%JAVA_HOME%binjava.exe
set PATH=%PATH%;%JAVA_HOME%bin;%GEMFIRE%bin
set CLASSPATH=%GEMFIRE%libgemfire.jar;%GEMFIRE%libantlr.jar;%GEMFIRE%libgfSecurityImpl.jar;%CLASSPATH%