Bandwidth Scheduler in the Management Console
The Bandwidth Scheduler enables implementing bandwidth throttling and pausing data transfers in selected time windows. Bandwidth schedule for Agent groups can be set up by the Administrator in the Management Console, or it can be defined by the end-user in the Agent UI.
Create a bandwidth schedule
To create a bandwidth schedule:
- In the Management Console, click Bandwidth.
- Click + CREATE NEW SCHEDULE.
- Enter the name and provide an optional description.
-
(Optional) Add a custom rule:
- Click Add a rule.
-
Enter transfer speed limit values for incoming and/or outgoing traffic.
Note
- By default, the speed limit is applied to WAN/internet traffic. To enforce the limit on local connections, enable the Limit LAN bandwidth option in the Agent's profile.
- The minimum transfer speed value is 8 kB/s. Any number below that will result in all transfers (LAN and WAN) being paused if that rule is applied.
Tip
You can add up to five custom rules.
-
Select a rule, then click a cell to apply the rule to a time window.
Note
A single time window can have only one rule applied to it.
-
Click Save.
Apply a bandwidth schedule
To apply a bandwidth schedule to an Agents group:
- In the Management Console, click Groups.
- Locate and double-click the group you want to assign the bandwidth scheduler to.
-
In the Bandwidth tab, select the previously created bandwidth schedule, then click Save.
Warning
When an Agent receives its group bandwidth schedule, it is going to enforce it according to its local timezone. So it would be wise to assign different schedules to Agents that are located in different timezones.
Once the Agent is assigned a speed limit, either through the Management Console or the Agent UI, it reports the corresponding icon in the job. The icon appears even if the Limit LAN bandwidth option Agent profile is set to No
, but the Agent has a bandwidth limit applied.
Limitations and peculiarities
-
Bandwidth scheduler speed limits are not applied to a cloud storage connection by default. It can be changed with a custom parameter
rate_limit_cloud_connections
in Agent' Cloud storage profile. Note, if a Job has only two Agents one of which is a Cloud Agent, the configured bandwidth speed limits will be applied to and enforced by the other Agent in the job. -
With low limits for ZGT protocol (below 100Kbps), it's expected to see short-term exceeding of the limit at the start of a job run.
-
With low limits in jobs (below 1 Mbps), average speed may exceed the limit by up to 25%. To achieve the precise speed limit, add custom parameter
net.rate_limit_precise:true
to Agent profile. Using this parameter may affect the overall speed of syncrhonization and must be used with caution. Consult the support team. -
Minimal advisable speed limit for UTP, UTP2 and ZGT protocols is 1 Mbps. Speed limits lower than that requires adjusting MTU in the Profiles. Contact support to have it configured properly for your case.
-
Pause implies that agents v2.10 and newer stop all network activity, but will scan and index new or updated files. Agents of older version only pause upload and download data transfer but a few things still continue:
- Zero sized files will be synced
- File's deletion will be synced
- New files will be rescanned and indexed