Start Datastores for WAN Replication

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).

Procedure

  1. When you start a data store for a GemFire XD cluster that will host a gateway sender or gateway receiver, specify the server group(s) for the gateway sender and receiver configurations in the cluster. The following example command might be used to start a data store that hosts a gateway sender:
    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.

  2. When starting a data store to host a gateway receiver, you may additionally need to specify an address that can be used to access the member across the WAN. This is required if the local server address would fail to resolve over the WAN, causing gateway senders to be unable to communicate with the gateway receiver instance.

    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
    Each server specifies a -custom-NIC1 property, specifying the remote WAN address that gateway senders should use to reach the member. The gateway receiver in this cluster would specify "NIC1" as the remote hostname for senders to use, so that the sender on each member would pick up the address configured in the start command. For example:
    gfxd> CREATE GATEWAYRECEIVER test_receiver 
    > (hostnameforsenders 'NIC1' startport 1530 endport 1541) server groups (receivergroup1);

    See Create a Gateway Receiver for more information.