projects / ceph.git / blame
| Commit | Line | Data |
|---|---|---|
| 7c673cae FG |
1 | :orphan: |
| 2 | ||
| 3 | ================================================================================== | |
| 4 | rbd-replay-many -- replay a rados block device (RBD) workload on several clients | |
| 5 | ================================================================================== | |
| 6 | ||
| 7 | .. program:: rbd-replay-many | |
| 8 | ||
| 9 | Synopsis | |
| 10 | ======== | |
| 11 | ||
| 12 | | **rbd-replay-many** [ *options* ] --original-image *name* *host1* [ *host2* [ ... ] ] -- *rbd_replay_args* | |
| 13 | ||
| 14 | ||
| 15 | Description | |
| 16 | =========== | |
| 17 | ||
| 18 | **rbd-replay-many** is a utility for replaying a rados block device (RBD) workload on several clients. | |
| 19 | Although all clients use the same workload, they replay against separate images. | |
| 20 | This matches normal use of librbd, where each original client is a VM with its own image. | |
| 21 | ||
| 22 | Configuration and replay files are not automatically copied to clients. | |
| 23 | Replay images must already exist. | |
| 24 | ||
| 25 | ||
| 26 | Options | |
| 27 | ======= | |
| 28 | ||
| 29 | .. option:: --original-image name | |
| 30 | ||
| 31 | Specifies the name (and snap) of the originally traced image. | |
| 32 | Necessary for correct name mapping. | |
| 33 | ||
| 34 | .. option:: --image-prefix prefix | |
| 35 | ||
| 36 | Prefix of image names to replay against. | |
| 37 | Specifying --image-prefix=foo results in clients replaying against foo-0, foo-1, etc. | |
| 38 | Defaults to the original image name. | |
| 39 | ||
| 40 | .. option:: --exec program | |
| 41 | ||
| 42 | Path to the rbd-replay executable. | |
| 43 | ||
| 44 | .. option:: --delay seconds | |
| 45 | ||
| 46 | Delay between starting each client. Defaults to 0. | |
| 47 | ||
| 48 | ||
| 49 | Examples | |
| 50 | ======== | |
| 51 | ||
| 52 | Typical usage:: | |
| 53 | ||
| 54 | rbd-replay-many host-0 host-1 --original-image=image -- -c ceph.conf replay.bin | |
| 55 | ||
| 56 | This results in the following commands being executed:: | |
| 57 | ||
| 58 | ssh host-0 'rbd-replay' --map-image 'image=image-0' -c ceph.conf replay.bin | |
| 59 | ssh host-1 'rbd-replay' --map-image 'image=image-1' -c ceph.conf replay.bin | |
| 60 | ||
| 61 | ||
| 62 | Availability | |
| 63 | ============ | |
| 64 | ||
| 65 | **rbd-replay-many** is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to | |
| 20effc67 | 66 | the Ceph documentation at https://docs.ceph.com for more information. |
| 7c673cae FG |
67 | |
| 68 | ||
| 69 | See also | |
| 70 | ======== | |
| 71 | ||
| 72 | :doc:`rbd-replay <rbd-replay>`\(8), | |
| 73 | :doc:`rbd <rbd>`\(8) |