Windows/Unix/Linux—Install Pivotal GemFire from a ZIP or Compressed TAR File
For Windows, Solaris and all other Linux users, use the ZIP distribution to install and configure Pivotal GemFire on every physical and virtual machine where you will run Pivotal GemFire. You can also use the compressed TAR file on Linux distributions.
Prerequisites
Before you install GemFire, you must complete the following prerequisites:
- Confirm that your system meets the hardware and software requirements described in Supported Configurations and System Requirements.
- From the Pivotal GemFire product page, locate Downloads. Download the ZIP or compressed TAR distribution of GemFire.
- 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
Use the following procedure to install Pivotal GemFire:
Navigate to the directory where you downloaded the GemFire software, and unzip the .zip file or expand the compressed TAR file after creating the path_to_product directory.
Linux (Bourne and Korn shells - sh, ksh, bash) and Solaris. If you are using the command line, type the following command:
$ unzip pivotal-gemfire-N.N.N.zip -d path_to_product
or
$ tar -xzvf pivotal-gemfire-N.N.N.tgz -C path_to_product
path_to_product corresponds to the location where you want to install GemFire, and N.N.N is the version number. For example:
$ unzip pivotal-gemfire-N.N.N.zip -d /opt/pivotal
or
$ tar -xzvf pivotal-gemfire-N.N.N.tgz -C /opt/pivotal
Windows. Open the following .zip file with your preferred ZIP extraction tool, and extract the product files to the desired installation location on your machine.
Configure the JAVA_HOME environment variable.
If you will be using the
gfsh
command-line utility or managing servers and locators with theServerLauncher
andLocatorLauncher
APIs, then you must set JAVA_HOME to a JDK installation. For example:UNIX and Linux (Bourne and Korn shells - sh, ksh, bash)
JAVA_HOME=/usr/java/jdk1.8.0_121 export JAVA_HOME
Windows
set JAVA_HOME="C:\Program Files\Java\jdk1.8.0_121"
The following step only applies to environments where you are running GemFire processes or GemFire client applications outside of gfsh. The gfsh script sets these environment variables for you. If you are running GemFire processes or applications outside of gfsh, then configure the following environment variables 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.) The following variables definitions are examples; your installation path will vary, depending on where you install GemFire and the version (N.N.N) you are installing.UNIX and Linux (Bourne and Korn shells - sh, ksh, bash)
GEMFIRE=/opt/pivotal/pivotal-gemfire-N.N.N export GEMFIRE
Windows
set GEMFIRE=C:\pivotal\gemfire\pivotal-gemfire-N.N.N
Configure your GF_JAVA environment variables as shown in these examples. GF_JAVA must point to the
java
executable file under your JAVA_HOME. (If you have not done so already, you should also set your JAVA_HOME variable to a supported Java installation.)UNIX and Linux (Bourne and Korn shells - sh, ksh, bash)
GF_JAVA=$JAVA_HOME/bin/java export GF_JAVA
Windows
set GF_JAVA=%JAVA_HOME%\bin\java.exe
Add GemFire scripts to your the PATH environment variable. For example:
UNIX and Linux (Bourne and Korn shells - sh, ksh, bash)
PATH=$PATH:$JAVA_HOME/bin:/opt/pivotal/pivotal-gemfire-N.N.N/bin export PATH
Windows
set PATH=%PATH%;%JAVA_HOME%\bin;%GEMFIRE%\bin
Type
gfsh version
at the command line and verify that the output lists the version of Pivotal GemFire that you wished to install. For example:# gfsh version v9.0.0
If you want more detailed version information such as the date of the build, build number and JDK version being used, type
gfsh version --full
.Repeat this procedure for every virtual or physical machine on which you will run Pivotal GemFire.
If you need to uninstall GemFire, see Uninstalling GemFire.