Data Domain: Replication Throttle Usage

Replication Throttle
Replication throttle is used to limit the network bandwidth used by replication. The throttle is always set at the source Data Domain Restorer (DDR).

There are two types of replication throttles, default and destination (available in DDOS 5.5 and later versions):

1. When the default throttle setting is configured, all replication contexts use this rate unless specific destinations have their own destination throttle settings.
2. Destination throttle (DDOS 5.5) applies custom limits to specific destinations when default settings do not meet requirements. If a default throttle exists, the destination throttle takes precedence.

Set the default replication throttle to 10 Mbps for all contexts, while configuring one Collection Replication context as unlimited using destination throttle. The keyword destination is used when specifying a destination throttle. The argument is a valid hostname.

There are three types of replication throttle settings:

1. A scheduled throttle rate is set at a predetermined time or period.
2. The current throttle maintains the set rate until the next scheduled change or until the system is rebooted.
3. Override throttle overrides two previous types of throttles. Persistent through reboot until replication throttle reset override command is issued.

Argument Definitions

destination <host>

Available in DDOS 5.5:
Specify the destination throttle. <host> is the hostname of the destination DDR.

default

Specify the default throttle. If "destination" or "default" is not used, the system applies the default throttle, except when running replication throttle show commands.

<sched-spec>

Specifies one or more three-letter days of the week (such as mon, tue, or wed), or the word daily (to set the schedule every day). This argument can also specify a time of day in a 24-hour format. 

<rate>

Includes a number, or the word unlimited. Rate can also be zero, disable, or disabled (each stops replication until the next rate change). If you set <rate> to zero, new contexts are also throttled to zero. The system enforces a minimum rate of 98,304 bits per second (about 100 Kb/s) and a maximum of 34,358,689,792 bits per second (about 34 Gbps).
The number can include a tag for bits or bytes per second. Do not use a space between the number and the bits or bytes specification. The default rate is bits per second.
In the rate variable:

  bps equals raw bits per second
  Kbps or kbps equals 1000 bits per second
  Mbps or mbps equals 1x106 bits per second
  Gbps or gbps equals 1x109 bits per second

throttle add

replication throttle add [destination <host> | default] <sched-spec> <rate>

Change the rate of network bandwidth replication uses. By default, the network bandwidth use is unlimited, meaning it continuously runs as fast as possible. Replication runs at the given rate until the next scheduled change, or until new throttle commands force a change.
Example: To limit replication to 20 megabits per second starting on Mondays and Thursdays at 6:00 AM, enter:

# replication throttle add mon thu 0600 20Mbps

To limit replication to 5 megabits per second for the destination DDR name ddr-ny starting on Tuesdays and Fridays at 10:00 AM, enter:

# replication throttle add destination ddr1-ny tue fri 2200 5Mbps

replication throttle del <sched-spec>

Remove one or more throttle schedule entries.
The sched-spec variable must include one or more three-letter days of the week (such as mon, tue, or wed), or the word daily (to set the schedule every day), and a time in 24-hour format.
Example: To remove an entry for Mondays at 1:00 PM, enter:

# replication throttle del mon 1300

throttle reset

replication throttle reset [destination <host> | default] {current | override
| schedule | all}

Use this command to reset a throttling schedule. Options include: current
Remove and reset the rate designated by the override command:

Remove and reset the rate designated by the replication throttle set override command.

schedule
Remove and reset scheduled changes.
all
Remove and reset current or override settings and remove all scheduled changes. This option returns the system to the default settings.
throttle set current

replication throttle set current [destination <host> | default] <rate>

Use this command to set the throttle rate until the next scheduled change or until a system reboot. Setting the throttle to current cannot be done if the throttle set override command is in effect.
throttle set override

replication throttle set override [destination <host> | default] <rate>

Use this command to set the throttle rate until another override command is invoked. Throttle override cannot be set if the throttle set current command is in effect.
throttle show

replication throttle show [destination <host> | default | all]

Show throttle configuration. All users may run this command option. If no option is specified, all is the default option.
throttle show performance

replication throttle show performance [destination <host> | default | all]
[interval <sec>] [count <count>]

Show current throttle throughput

All users may run this command option. If no option is specified, all is the default option.

Replication throttle also throttles DD Boost-managed file replication in addition to MTree replication.