OSX: Install Pivotal GemFire from a Homebrew Package

If your operating system is Mac OSX, you can install Pivotal GemFire from a Homebrew package.

Prerequisites

Confirm that your system meets the hardware and software requirements described in Supported Configurations and System Requirements.
If you have not already done so, download and install a compatible JDK for your system.

Procedure

From the OSX computer on which you will install GemFire, open a terminal window.
If you previously installed GemFire using Homebrew, execute this untap command to ensure a clean update:
```
$ brew untap pivotal/tap
```
In the terminal window, enter this command to install Homebrew, if you have not already installed it:
```
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
Execute this command to install Pivotal GemFire:
```
$ brew tap pivotal/tap && brew install gemfire
```
This starts the install process, resolves dependencies, and displays the packages it will install. The GemFire software is installed into the /usr/local/Cellar/gemfire/version directory where version corresponds to the latest version of GemFire you just installed (for example, 8.2.1). Note that Homebrew installs the executables such as gfsh in the /usr/local/Cellar/gemfire/version/bin directory and creates symbolic links to the GemFire executables in /usr/local/bin. All other GemFire product files including SampleCode and HTTP module installers are installed in /usr/local/Cellar/gemfire/version/libexec.
Configure your JAVA_HOME environment variable to point to a supported version of Java. For example, you can add the following line to your .bash_profile:
```
JAVA_HOME=$(/usr/libexec/java_home)
```
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
v8.2.1
```
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.
You may also need to ensure that the host name of your machine is configured in your system hosts file. For example, you may need to map your machine's hostname to your IP address in the /etc/hosts file in order for gfsh and Pulse to operate correctly.
If you need to uninstall GemFire, see How to Uninstall GemFire.

What to Do Next

After you install Pivotal GemFire from a homebrew package file, you perform the following tasks:

For a really quick introduction to GemFire, try Pivotal GemFire in 15 Minutes or Less.
Try a more detailed product tutorial with a sample social networking application. See Pivotal GemFire Tutorial.
To learn about the cluster Configuration Service, see Tutorial: Creating and Using a Cluster Configuration.
Go through the remaining QuickStart and code examples. See Setting Up the Product Examples for more information.