Windows/Unix/Linux—Install VMware Tanzu GemFire from a Compressed TAR File

Use the compressed TAR file distribution to install and configure Tanzu GemFire on every physical and virtual machine where you will run Tanzu GemFire.

Prerequisites

Before you install Tanzu GemFire, you must complete the following prerequisites:

Confirm that your system meets the hardware and software requirements described in Supported Configurations and System Requirements.
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 Tanzu GemFire. (You should find a bin directory under JAVA_HOME.)

Complete the following steps to download:

Log in to the Broadcom Customer Support Portal with your customer credentials. Before downloading, ensure you meet the requirements, for more information, see the Download Broadcom products and software article.
Go to the VMware Tanzu GemFire downloads page. Select VMware Tanzu GemFire, click Show All Releases, and select a version.
Click I agree to Terms and Conditions. Click the HTTPS Download icon next to VMware GemFire to download.

Procedure

Use the following procedure to install Tanzu GemFire:

Navigate to the directory where you downloaded Tanzu GemFire, and expand the compressed TAR file after creating the path_to_product directory.
```
$ tar -xzvf pivotal-gemfire-N.N.N.tgz -C path_to_product
```
path_to_product corresponds to the location where you want to install Tanzu GemFire, and N.N.N is the version number.
Configure the JAVA_HOME environment variable.

If you will be using the gfsh command-line utility or managing servers and locators with the ServerLauncher and LocatorLauncher 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_272
export JAVA_HOME
```
- Windows
```
set JAVA_HOME="C:\Program Files\Java\jdk1.8.0_272"
```
This step only applies to environments where you are running Tanzu GemFire processes or Tanzu GemFire client applications outside of gfsh. The gfsh script sets these environment variables for you. If you are running Tanzu GemFire processes or applications outside of gfsh, then configure the following environment variables for Tanzu GemFire.
- Set the GEMFIRE environment variable to point to your Tanzu 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 Tanzu 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 Tanzu GemFire that you want 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 Tanzu GemFire.