Pivotal GemFire® v8.1

Starting gfsh

Starting gfsh

Before you start gfsh, confirm that you have set the GEMFIRE and either the GF_JAVA or JAVA_HOME environment variables to the proper locations for your deployment, or that your PATH variable includes the java executable.

See Installing Pivotal GemFire for more information.

To manage servers and locators properly, gfsh requires that tools.jar (provided with the JDK) exist in the CLASSPATH.

Note: On Windows, you must have the JAVA_HOME variable set properly to use start, stop and status commands for both locators and servers.

To launch the gfsh command-line interface, execute the following command at the prompt on any machine that is currently installed with Pivotal GemFire:

Start gfsh on Windows:
where <product_directory> corresponds to the location where you installed Pivotal GemFire.
Start gfsh on Unix:
where <product_directory> corresponds to the location where you installed Pivotal GemFire. If you installed Pivotal GemFire using RPM, the default product directory installation location is /opt/pivotal/gemfire. Upon execution, the gfsh script appends the required Pivotal GemFire and JDK Jar libraries to your existing CLASSPATH.
If you have successfully started gfsh, the gfsh splash screen and prompt appears.
    _________________________     __
   / _____/ ______/ ______/ /____/ /
  / /  __/ /___  /_____  / _____  /
 / /__/ / ____/  _____/ / /    / /
/______/_/      /______/_/    /_/    v8.0.0

Monitor and Manage GemFire

You can also run some gfsh commands directly within your terminal without entering a gfsh prompt. For example, on Unix/Linux you could enter:
$ gfsh start server --name=server1
or on Windows:
prompt> gfsh start server --name=server1
See Creating and Running gfsh Command Scripts for more information.