macOS—Upgrade Pivotal GemFire from a Homebrew Package

If your operating system is macOS, you can upgrade Pivotal GemFire from a Homebrew package.



  1. From the macOS computer on which you will install GemFire, open a terminal window.
  2. Untap Pivotal:

    $ brew untap pivotal/tap
  3. Retap Pivotal:

    $ brew tap pivotal/tap
  4. Upgrade GemFire to the latest version:

    $ brew upgrade gemfire

    This starts the upgrade process, resolves dependencies, and displays the new packages it will install. The latest GemFire software is installed into the /usr/local/Cellar/gemfire/version directory where version corresponds to the version of GemFire you are upgrading to. 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.

  5. 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:

    • On OS X 10.9 (Mavericks) or later:

      export JAVA_HOME='/usr/libexec/java_home -v  1.8'
    • On OS X 10.8.X

      export JAVA_HOME="$(/usr/libexec/java_home)"
  6. 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

    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.