Install vFabric GemFire from a JAR File

For non-RHEL users, install and configure vFabric GemFire on every physical and virtual machine where you will run vFabric GemFire.

Prerequisites
  • Confirm that your system meets the hardware and software requirements described in Supported Configurations and System Requirements.
  • From the VMware downloads page, select VMware vFabric GemFire.
    • If you are installing GemFire for evaluation, click "Try Now," and download GemFire and the product examples.
    • If you have purchased GemFire, download the vFabric GemFire offering you have purchased and the product examples from the Product Downloads tab. You can also get GemFire from your salesperson.
  • Know how to configure environment variables for your system. If you have not done so already, set the JAVA_HOME environment variable to point to a Java runtime installation supported by GemFire. (You should find a bin directory under JAVA_HOME.)
Procedure
  1. The GemFire installation program is distributed as an executable JAR file. Ensure that the path to a supported version of the Java executable is in your PATH environment variable:
    java -version
  2. Change to the directory where you downloaded the GemFire software, and execute the JAR file installer. On the command line, type the following command for your operating system:
    • UNIX and Linux (Bourne and Korn shells - sh, ksh, bash)
      java -jar vFabric_GemFire_XXX_Installer.jar
      where XXX corresponds to the version of GemFire that you are installing.
    • Windows:
       
      java.exe -jar vFabric_GemFire_XXX_Installer.jar
      where XXX corresponds to the version of GemFire that you are installing.
    Note: You can also run the JAR file installer with optional arguments. Options include non-interactive (unattended) installations for scripted deployments and source code (open source) installations. See Installer Options for more details.
  3. When the License Agreement (EULA) is displayed, press Enter to scroll and read. Enter agree to accept the license.
  4. At the prompt, enter the full path of the directory in which you will install GemFire.

    By default, GemFire is installed in the directory where you executed the JAR file.

  5. Enter yes to create the directory if necessary, or to verify that the installation directory is correct.

    The installer copies the license agreement and installs GemFire to a top-level GemFire directory in the location you specified.

    Note: If you have difficulties getting the installer to work correctly, you can unzip the jar file directly with any common zip extraction tool.
  6. Configure your environment for GemFire.
    • Set the GEMFIRE environment variable to point to your GemFire installation top-level directory. (You should see bin, lib, dtd, and other directories under GEMFIRE.)
    • 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 and Linux (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%\bin\java.exe 
        set PATH=%PATH%;%JAVA_HOME%\bin;%GEMFIRE%\bin 
        set CLASSPATH=%GEMFIRE%\lib\gemfire.jar;%GEMFIRE%\lib\antlr.jar;^
        %GEMFIRE%\lib\gfSecurityImpl.jar;%CLASSPATH%
  7. If you have purchased a production license, activate the license. See Understanding vFabric GemFire Licenses and Installing and Configuring vFabric GemFire Licenses.
  8. Repeat this procedure for every virtual or physical machine on which you will run vFabric GemFire.

Installer Options

-Dgemfire.installer.directory=<path>

Use this option to run the installer in unattended mode. For example:
java -jar -Dgemfire.installer.directory=/home/gemfire/vFabric_GemFire_XXX_Installer.jar
where XXX corresponds to the version of GemFire that you are installing.

Unattended mode is useful for automated deployments. When using this option, you must specify the installation directory (<path>) for GemFire. During installation, the directory <path>/vFabric_GemFire_XXX will be created where XXX corresponds to the version of GemFire that you are installing.

If GemFire files are detected in the target installation directory, the installation will fail rather than overwrite the preexisting files.

-Dgemfire.installer.opensource=true

Use this option to install GemFire source code. Many open source licenses require that vendors who use or modify their libraries make that code available. An additional directory called opensource will be created in the GemFire installation directory.

What to do next