5 2 0:Setting Network Bandwidth Limit for SEP sesam Tasks

From SEPsesam


Welcome to the latest SEP sesam documentation version 5.2.0 Artemis. For previous documentation version(s), check documentation archive.


Overview


You can limit the network bandwidth used by SEP sesam operations to prevent them from consuming all available network resources. Bandwidth limits can be set for an individual backup or restore task, allowing you to control the data transfer rate for this operation, or you can define a global bandwidth limit that applies to all SEP sesam operations. By setting read and write bandwidth limits, you can optimize resource usage and ensure sufficient network bandwidth remains available for other activities.

Bandwidth limits are defined in MiB/s. For example, setting a value of 10240 will limit the read speed of a task to 10 GiB/s, allowing remaining bandwidth to be available for other operations.

Note
If both a global bandwidth limit and a task-specific limit are defined, the task-specific setting takes precedence and overrides the global limit for that particular task.

Setting bandwidth limit for a SEP sesam task

You can control the data transfer speed of any SEP sesam backup or restore task by setting a bandwidth limit in the task configuration. This helps to manage network load during a spcific SEP sesam operation.

The bandwidth limit can be configured when creating a new task or by modifying an existing one. To set the bandwith limit for a specific task, in the task configuration set the following option:

-o bwlimit=<value>

Replace the <value> with the actual limit value in MiB/s (for example, -o bwlimit=10240).

You can set this option when configuring a new task in the Web UI or Restore Assistant:

  • for backup task: in the Advanced options step, expand section Additional call arguments and add this option in Backup options field. You can also set if for restore in Restore options field. For more details, see Standard Backup procedure.
  • for restore task: in the Options step, expand section Advanced restore options and add this option in Options for restore field. For more details, see Standard Restore procedure.

Screenshots

Configuring global bandwidth limit

To configure a global bandwidth limit for SEP sesam operations, you can set the environment variables BWLIMIT, BWLIMIT_READ, and BWLIMIT_WRITE to control read and write limits:

  1. Open the <SESAM_ROOT>/var/ini/sm.ini file on the SEP sesam Server (where <SESAM_ROOT> is the pathname of the SEP sesam home directory).
  2. Locate the [ENVIRONMENT] section and insert either BWLIMIT variable (to set a general limit for both read and write), or BWLIMIT_READ , and BWLIMIT_WRITE variables (to control read and write limits separately):
[ENVIRONMENT]
# bwlimit for read and write 20 MiB/s => 72 GiB/h
BWLIMIT=20
Alternatively:
[ENVIRONMENT]
# bwlimit for read 20 MiB/s => 72 GiB/h
BWLIMIT_READ=20
# bwlimit for write 15 MiB/s => 54 GiB/h
BWLIMIT_WRITE=15

When a global limit is configured, you can override it by setting the task-specific limit. To disable the global limit for a task, set the value ==0 (zero). This can be useful when fast backup or restore performance is required.


See also

Standard Backup ProcedureStandard Restore ProcedureCreating a Migration TaskCreating a Replication TaskCreating a Command Task

Copyright © SEP GmbH (formerly SEP AG) 1999-2025. All rights reserved.
Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP GmbH. When compiling and designing user documentation SEP GmbH uses great diligence and attempts to deliver accurate and correct information. However, SEP GmbH cannot issue a guarantee for the contents of this manual.