|Configuring Multi-site (WAN) Deployments / Steps to Configure a Multi-site Deployment|
When you start a GemFire XD data store in a WAN deployment, you must specify a server group name in order to deploy configured gateway senders and gateway receivers. If the data store will host a gateway receiver, you may also need to specify a hostname that can be used to access the data store over the WAN (if the local peer discovery address for the member does cannot be used over the WAN).
gfxd server start -dir=/opt/gfxd/server1 -locators=ds1host:10101 -server-groups=OrdersDB,OrdersGatewaySenders
The command starts the data store as a member of both the "OrdersDB" and "OrdersGatewaySenders" group. The member would start any gateway sender configurations defined for either of those server groups. See Create and Start Gateway Sender.
To specify a hostname for WAN access, define the value in a -custom-name property when you start each data store that will host a gateway receiver. The following example command starts two separate GemFire XD data stores to host gateway receiver instances:
gfxd server start -dir=/opt/gfxd/recserver1 -locators=ds2host:10101 -server-groups=OrdersDB,receivergroup1 -custom-NIC1=ordersreceiver1
gfxd server start -dir=/opt/gfxd/recserver2 -locators=ds2host:10101 -server-groups=OrdersDB,receivergroup1 -custom-NIC1=ordersreceiver2
gfxd> CREATE GATEWAYRECEIVER test_receiver > (hostnameforsenders 'NIC1' startport 1530 endport 1541) server groups (receivergroup1);
See Create a Gateway Receiver for more information.