Using gfxd to Start and Stop Members

Use the gfxd utility to start servers.

You generally start a GemFire XD server with the gfxd server command from a command prompt or terminal window. If you need to initialize other resources before booting GemFire XD servers, you can start a server process from within a Java application with the FabricServer interface. See Starting GemFire XD Servers with the FabricServer Interface for more information about starting servers programmatically.

Note: If you use peer clients in a GemFire XD distributed system that also contains data stores, keep in mind that peer clients themselves cannot use disk stores to persist data. You must start data stores and locators before starting peer clients, because peer clients rely on those members to persist data. See Peer Client Considerations for Persistent Data for more information.

Start GemFire XD Servers

By default, the gfxd server command starts a server that can host data and provide connectivity to thin client applications. The complete syntax for starting a GemFire XD server with gfxd server is:
gfxd server start [-Jjvm_argument]* [-dir=working_directory] [-classpath=classpath]
      [-serverGroups=group1[,group2][,...]]
      [-maxHeap=size] [-initialHeap=size]
      [-run-netserver=true|false]
      [-rebalance]
      [-configScripts=sql-files] [-initScripts=sql-files]
      [-client-bind-address=client_address]
      [-client-port=port]
      [-critical-heap-percentage=<percentage>]
      [-mcast-port=<port> (default 10334)]
      [-mcast-address=<address> (default 239.192.81.1)]
      [-locators=<addresses>] [-start-locator=<address>]
      [-host-data=<true|false> (default true)]
      [-auth-provider=<provider>]
      [-server-auth-provider=<provider>]
      [-user=<username>] [-password[=<password>]]
      [-log-file=<path> (default gfxdserver.log)]
      [-property_name=property_value]*

The gfxd server command uses default values for any options that you do not specify on the command line. However in most cases you will want to specify non-default values for each server that you start. The sections that follow describe some of the most commonly-used options and configuration properties.

CAUTION:
Never move the working directory for a GemFire XD server or locator while the member is running.
CAUTION:
Never delete or modify GemFire XD persistence files, or move the files from the member working directory.

Stop GemFire XD Servers

You can use two additional command forms to stop a running GemFire XD server or display the status and process ID of a running server:
gfxd server stop [-dir=working_directory]

gfxd server status [-dir=working_directory]