CREATE GATEWAYSENDER

Creates a gateway sender to replicate data to a remote GemFire XD cluster.

Syntax

CREATE GATEWAYSENDER sender-name
(
  REMOTEDSID integer-constant
  [ SOCKETBUFFERSIZE integer-constant ]
  [ SOCKETREADTIMEOUT integer-constant ]
  [ MANUALSTART boolean-constant ]
  [ ENABLEBATCHCONFLATION boolean-constant ]
  [ BATCHSIZE integer-constant ]
  [ BATCHTIMEINTERVAL integer-constant ]
  [ ENABLEPERSISTENCE boolean-constant ]
  [ DISKSTORENAME disk-name ]
  [ MAXQUEUEMEMORY integer-constant ]
  [ ALERTTHRESHOLD integer-constant ]
)
  SERVER GROUPS ( server_group_name [, server_group_name] * )
sender-name
A unique identifier for the gateway sender.
REMOTEDSID
An integer that uniquely identifies the remote GemFire XD cluster to which this gateway sender will send table DML operations. You must associate this remote GemFire XD cluster with the local GemFire XD cluster when you start the locator(s) for the local cluster. See Configure Locators for WAN Member Discovery.
SOCKETBUFFERSIZE
An integer value that sets the buffer size in bytes of the socket connection for this gateway sender. If you supply a null value, GemFire XD uses the default of 32768 bytes.
SOCKETREADTIMEOUT
The amount of time in milliseconds that this gateway sender blocks while waiting to receive an acknowledgment from a remote site. The default value is 10000 milliseconds.
MANUALSTART
A boolean value that specifies whether you need to manually start the gateway sender. If you supply a null value, the default is "false" and the gateway sender attempts to start automatically. Use SYS.START_GATEWAYSENDER to manually start a sender.
ENABLEBATCHCONFLATION
A Boolean value that determines whether GemFire XD should conflate messages. The default is false.
BATCHSIZE
The maximum number of messages that a batch can contain. The default is 100 messages.
BATCHTIMEINTERVAL
The maximum number of milliseconds that can elapse between sending batches. The default is 1000 milliseconds.
ENABLEPERSISTENCE
A Boolean value that determines whether GemFire XD persists the gateway queue. The default is "False."
DISKSTORENAME
The named disk store to use for storing the queue overflow, or for persisting the queue. If you specify a value, the named disk store must exist. If you specify a null value, GemFire XD uses the default disk store for overflow and queue persistence.
MAXQUEUEMEMORY
The maximum amount of memory in megabytes that the queue can consume before overflowing to disk. The default is 100 megabytes.
ALERTTHRESHOLD
The maximum number of milliseconds that an event can remain in this gateway queue before GemFire XD logs an alert. The default is value is "0."
SERVERGROUPS
A comma-separated String of server group names. GemFire XD creates the gateway sender only on those GemFire XD servers and peers that are members of the specified server group(s). This parameter cannot be null.
Note: The server group names that you specify are converted to all-uppercase characters, even if you specify a quoted identifier.
Note: You can configure both partitioned tables and replicated tables to use a gateway sender. However, you must create replicated tables in the same server groups as the gateway sender(s) that you specify in the CREATE TABLE statement.

Example

Create and start a gateway sender with persistence:

CREATE GATEWAYSENDER cluster-1-sender
(
  REMOTEDSID 2
  ENABLEPERSISTENCE true
  DISKSTORENAME cluster-1-wan-store 
)
SERVER GROUPS (primary_sender_group);

Information for the gateway sender is added to the GATEWAYSENDERS.