cinder/doc/source/admin/blockstorage-ratelimit-volume-copy-bandwidth.rst
Thomas Goirand 61b6714946 Fix doc: s/cgroup-bin/cgroup-tools/
The cgroup-bin was a transition package to cgroup-tools in Debian
Buster, in Sid/Testing it was removed recently. As a consequence,
we must advise our users to install cgroup-tools rather than
cgroup-bin.

Change-Id: I9291f84dcd6b6ed1a6c45416e272ac63ce02b6e9
2020-05-01 13:25:11 +02:00

1.7 KiB

Rate-limit volume copy bandwidth

When you create a new volume from an image or an existing volume, or when you upload a volume image to the Image service, large data copy may stress disk and network bandwidth. To mitigate slow down of data access from the instances, OpenStack Block Storage supports rate-limiting of volume data copy bandwidth.

Configure volume copy bandwidth limit

To configure the volume copy bandwidth limit, set the volume_copy_bps_limit option in the configuration groups for each back end in the cinder.conf file. This option takes the integer of maximum bandwidth allowed for volume data copy in byte per second. If this option is set to 0, the rate-limit is disabled.

While multiple volume data copy operations are running in the same back end, the specified bandwidth is divided to each copy.

Example cinder.conf configuration file to limit volume copy bandwidth of lvmdriver-1 up to 100 MiB/s:

[lvmdriver-1]
volume_group=cinder-volumes-1
volume_driver=cinder.volume.drivers.lvm.LVMVolumeDriver
volume_backend_name=LVM
volume_copy_bps_limit=104857600

Note

This feature requires libcgroup to set up blkio cgroup for disk I/O bandwidth limit. The libcgroup is provided by the cgroup-tools package in Debian and Ubuntu, or by the libcgroup-tools package in Fedora, Red Hat Enterprise Linux, CentOS, openSUSE, and SUSE Linux Enterprise.

Note

Some back ends which use remote file systems such as NFS are not supported by this feature.