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

Procedure

  1. From the OSX computer on which you will install GemFire, open a terminal window.
  2. In the terminal window, enter this command to install Homebrew, if you have not already installed it:
    $ ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
  3. After Homebrew is installed, 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 available version of GemFire. 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.

  4. 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)
    Note: 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.
  5. 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
    v7.0.2
    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.

What to Do Next

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