This topic describes the wan-copy region command in gfsh, the VMware Tanzu GemFire command-line interface.

Use this command to copy the entries of a region in a WAN site onto the same region in another WAN site, using a gateway sender.

This command copies region entries from a WAN site to another by putting them in batches of configurable size that are sent to the remote site by the selected gateway sender. Batch size is specified as number of entries per batch.

The command allows you to specify a maximum copy rate in order not to stress excessively the sending or receiving WAN sites. This rate is configured in entries per second.

Callbacks (cache listeners, replication to other WAN sites) will not be executed in the remote WAN site for the entries copied.

The main uses of this command are:

  • Recovery of a WAN site after a disaster in which the failed site needs to be put into service again with the data from another WAN site.

  • Adding a new WAN site to a Tanzu GemFire system in which the data in the new WAN site needs to be initially loaded from an existing WAN site.

The execution of a currently running instance of this command may be stopped by using this same command with the --cancel option.

Requirements:

The wan-copy region command requires the following:

  • A gateway sender is configured and running on the source WAN site.
  • A gateway receiver is configured and running on the remote WAN site.
  • The region to which the data will be copied has already been created on the remote WAN site.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

wan-copy region --region=value --sender-id=value [--max-rate=value] [--batch-size=value]
  [--cancel]

Name Description Default Value
‑‑region Required. The region for which the data is to be copied.
‑‑sender-id Required. The gateway sender to be used to copy the region entries.
‑‑max-rate The maximum copy rate in entries per second. If the sender is parallel, the maximum rate limit is applied to each server hosting buckets for the region to be copied. 0 (unlimited)
‑‑batch-size The size of the batches, in number of entries, to be used to copy the region entries. 1000
‑‑cancel Cancel a running wan-copy region command for the specified sender and region. If the sender-id and region passed are both “*”, then all running wan-copy region commands will be canceled.

Table 1. Copy Region Parameters

Example Commands:

wan-copy region --region=myRegion--sender-id=mySender --max-rate=1000 --batch-size=100
wan-copy region --region=/overload --sender-id=sender1 --cancel
wan-copy region --region=* --sender-id=* --cancel

Sample Output:

gfsh>wan-copy region --region=/overload --sender-id=myParallelSender --max-rate=100 --batch-size=100
        Member     | Status | Message
    -------------- | ------ | -----------------------
    server-sender  | OK     | Entries copied: 333
    server-sender3 | OK     | Entries copied: 334
    server-sender2 | OK     | Entries copied: 333

gfsh>wan-copy region --region=/overload --sender-id=mySerialSender --max-rate=100 --batch-size=100
        Member     | Status | Message
    -------------- | ------ | ----------------------------------------------------------------------
    server-sender2 | OK     | Sender mySerialSender is serial and not primary. 0 entries copied.
    server-sender3 | OK     | Sender mySerialSender is serial and not primary. 0 entries copied.
    server-sender  | OK     | Entries copied: 1000
gfsh>wan-copy region --region=/overload --sender-id=sender1 --cancel
        Member     | Status | Message
    -------------- | ------ | ------------------
    server-sender2 | OK     | Execution canceled
    server-sender  | OK     | Execution canceled
    server-sender3 | OK     | Execution canceled
gfsh>wan-copy region --region=myRegion --sender-id=myParallelSender --max-rate=100 --batch-size=10
        Member     | Status | Message
    -------------- | ------ | ------------------------------------------------------
    server-sender2 | OK     | Operation canceled after having copied 10 entries
    server-sender  | OK     | Operation canceled after having copied 10 entries
    server-sender3 | OK     | Operation canceled after having copied 10 entries
gfsh>wan-copy region --region=myRegion --sender-id=myParallelSender --max-rate=100 --batch-size=10
        Member     | Status | Message
    -------------- | ------ | ----------------------------------------------------------------------
    server-sender2 | OK     | Sender mySerialSender is serial and not primary. 0 entries copied.
    server-sender3 | OK     | Sender mySerialSender is serial and not primary. 0 entries copied.
    server-sender  | OK     | Operation canceled after having copied 4 entries

Error Messages:

Example of wan-copy region with an invalid region:

gfsh> wan-copy region --region=/regionX --sender-id=sender1
        Member     | Status | Message
    -------------- | ------ | -------------------------
    server-sender  | ERROR  | Region /regionX not found
    server-sender2 | ERROR  | Region /regionX not found
    server-sender3 | ERROR  | Region /regionX not found

Example of wan-copy region with a stopped gateway sender:

gfsh> wan-copy region --region=/region1 --sender-id=sender1
        Member     | Status | Message
    -------------- | ------ | -----------------------------
    server-sender  | ERROR  | Sender sender1 is not running
    server-sender2 | ERROR  | Sender sender1 is not running
    server-sender3 | ERROR  | Sender sender1 is not running

Example of cancel of wan-copy region when no command is running:

gfsh> wan-copy region --region=/region1 --sender-id=sender1 --cancel
        Member     | Status | Message
    -------------- | ------ | ------------------------------------------------------------------------------------
    server-sender2 | ERROR  | No running command to be canceled for region /region1 and sender sender1
    server-sender  | ERROR  | No running command to be canceled for region /region1 and sender sender1
    server-sender3 | ERROR  | No running command to be canceled for region /region1 and sender sender1

Example of cancel of all running wan-copy region commands:

gfsh> wan-copy region --region=* --sender-id=* --cancel
        Member     | Status | Message
    -------------- | ------ | ------------------------------------------------------------------------------------
    server-sender2 | OK     | Executions canceled: [(myRegion,mySender1), (myRegion,mySender)]
    server-sender  | OK     | Executions canceled: [(myRegion,mySender1), (myRegion,mySender)]
    server-sender3 | OK     | Executions canceled: [(myRegion,mySender1), (myRegion,mySender)]
check-circle-line exclamation-circle-line close-line
Scroll to top icon