Adding Members to Server Groups

You define server group membership and/or create a server group when you start a GemFire XD member using the server-groups boot property.

For example, if you start a GemFire XD server from the command line with gfxd, use the server-groups property to specify the names of one or more server groups that the server should join:

gfxd server start -server-groups=OrdersDB,OrdersReplicationGrp,DBProcessInstance1

In this example, the GemFire XD server participates in three server groups: OrdersDB, OrdersReplicationGrp and DBProcessInstance1. If this is the first GemFire XD member to define a named server group, then GemFire XD creates the group and adds the new member after startup. If other GemFire XD members in the cluster were booted using the same server group, then GemFire XD adds this new member to the existing group. If you specify no -server-groups property, then GemFire XD automatically adds the data store member to the default server group.

If you start a GemFire XD peer client from within a Java application, specify the server-groups property as part of the JDBC peer client connection string. For example, use the connection URL:
jdbc:gemfirexd:;mcast-port=33666;host-data=true;server-groups=OrdersDB,OrdersReplicationGrp,DBProcessInstance1

Starting and Configuring GemFire XD Servers and Starting GemFire XD Servers with the FabricServer Interface provide more information about specifying boot properties.