Pivotal GemFire® v8.0

OSX: Upgrade Pivotal GemFire from a Homebrew Package

OSX: Upgrade Pivotal GemFire from a Homebrew Package

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



  1. From the OSX 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 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.

  5. Configure your environment 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.) For example:
      export GEMFIRE
      where version corresponds to the version of Pivotal GemFire you just installed.
    • Configure JAVA_HOME and PATH as appropriate for your machine. GF_JAVA must point to the java executable file under your JAVA_HOME. For example:
      export JAVA_HOME
      export GF_JAVA 
      export PATH 
  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
    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: