gfxd Launcher Commands
Use the gfxd command-line utility to launch GemFire XD utilities.
To display a full list of gfxd commands and options:
The command form to display a particular utility's usage is:
gfxd <utility> --help
With no arguments, gfxd starts an interactive SQL command shell:
$ export JAVA_ARGS="-Dgfxd.history=/Users/yozie/gfxd-history.sql" $ gfxd
To launch and exit a gfxd utility (rather than start an interactive gfxd shell) use the syntax:
gfxd <utility> <arguments for specified utility>
In this command form, <utility> is one of the following.
Starts and stops a GemFire XD Server member, and provides status of a running one.
Starts and stops a GemFire XD Locator member, and provides status of a running one.
Prints GemFire XD product version information.
Prints statistic values from a statistic archive.
Merges multiple logs files into a single log.
Prints information needed to obtain a new license.
Encrypts a password for use in the gemfirexd.properties file when using BUILTIN authentication, or for use with external data sources using an AsyncEventListener implementation or DBSynchronizer.
Confirms whether files of a disk store are valid.
Displays GemFire XD product version information.
Compacts an offline disk store to remove all unneeded records from the persistent files.
Asks all the distributed system members to compact their disk stores.
Asks the distributed system members to stop waiting for the specified disk store.
Prints disk stores that are currently missing from the distributed system.
Asks all data store and accessor system members to shut down.
Asks all the distributed system members to back up their persistent data.
To specify a system property when launching a gfxd utility, use -J-Dproperty_name=property_value argument.
In addition to launching various utilities provided with GemFire XD, when launched without any arguments, gfxd starts an interactive command shell that you can use to connect to a GemFire XD system and execute various commands, including SQL statements.
The launcher honors the current CLASSPATH environment variable and adds it to the CLASSPATH of the utility or command shell being launched. To pass additional arguments to the JVM, set the JAVA_ARGS environment variable when invoking the gfxd script.
The launcher uses the java executable that is found in the PATH. To override this behavior, set the GFXD_JAVA environment variable to point to the desired Java executable. (note the supported JRE versions in Supported Configurations and System Requirements).