summaryrefslogtreecommitdiffstats
path: root/doc/man/8/rbd-replay-many.rst
blob: 8241f37cb63c35ca0c1face5da2801f829124d26 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
:orphan:

==================================================================================
 rbd-replay-many -- replay a rados block device (RBD) workload on several clients
==================================================================================

.. program:: rbd-replay-many

Synopsis
========

| **rbd-replay-many** [ *options* ] --original-image *name* *host1* [ *host2* [ ... ] ] -- *rbd_replay_args*


Description
===========

**rbd-replay-many** is a utility for replaying a rados block device (RBD) workload on several clients.
Although all clients use the same workload, they replay against separate images.
This matches normal use of librbd, where each original client is a VM with its own image.

Configuration and replay files are not automatically copied to clients.
Replay images must already exist.


Options
=======

.. option:: --original-image name

   Specifies the name (and snap) of the originally traced image.
   Necessary for correct name mapping.

.. option:: --image-prefix prefix

   Prefix of image names to replay against.
   Specifying --image-prefix=foo results in clients replaying against foo-0, foo-1, etc.
   Defaults to the original image name.

.. option:: --exec program

   Path to the rbd-replay executable.

.. option:: --delay seconds

   Delay between starting each client.  Defaults to 0.


Examples
========

Typical usage::

       rbd-replay-many host-0 host-1 --original-image=image -- -c ceph.conf replay.bin

This results in the following commands being executed::

       ssh host-0 'rbd-replay' --map-image 'image=image-0' -c ceph.conf replay.bin
       ssh host-1 'rbd-replay' --map-image 'image=image-1' -c ceph.conf replay.bin


Availability
============

**rbd-replay-many** is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to
the Ceph documentation at https://docs.ceph.com for more information.


See also
========

:doc:`rbd-replay <rbd-replay>`\(8),
:doc:`rbd <rbd>`\(8)