src/ceph/doc/man/8/rbd-replay.rst

   1 :orphan:
   2
   3 =========================================================
   4  rbd-replay -- replay rados block device (RBD) workloads
   5 =========================================================
   6
   7 .. program:: rbd-replay
   8
   9 Synopsis
  10 ========
  11
  12 | **rbd-replay** [ *options* ] *replay_file*
  13
  14
  15 Description
  16 ===========
  17
  18 **rbd-replay** is a utility for replaying rados block device (RBD) workloads.
  19
  20
  21 Options
  22 =======
  23
  24 .. option:: -c ceph.conf, --conf ceph.conf
  25
  26    Use ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to
  27    determine monitor addresses during startup.
  28
  29 .. option:: -p pool, --pool pool
  30
  31    Interact with the given pool.  Defaults to 'rbd'.
  32
  33 .. option:: --latency-multiplier
  34
  35    Multiplies inter-request latencies.  Default: 1.
  36
  37 .. option:: --read-only
  38
  39    Only replay non-destructive requests.
  40
  41 .. option:: --map-image rule
  42
  43    Add a rule to map image names in the trace to image names in the replay cluster.
  44    A rule of image1@snap1=image2@snap2 would map snap1 of image1 to snap2 of image2.
  45
  46 .. option:: --dump-perf-counters
  47
  48    **Experimental**
  49    Dump performance counters to standard out before an image is closed.
  50    Performance counters may be dumped multiple times if multiple images are closed,
  51    or if the same image is opened and closed multiple times.
  52    Performance counters and their meaning may change between versions.
  53
  54
  55 Examples
  56 ========
  57
  58 To replay workload1 as fast as possible::
  59
  60        rbd-replay --latency-multiplier=0 workload1
  61
  62 To replay workload1 but use test_image instead of prod_image::
  63
  64        rbd-replay --map-image=prod_image=test_image workload1
  65
  66
  67 Availability
  68 ============
  69
  70 **rbd-replay** is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to
  71 the Ceph documentation at http://ceph.com/docs for more information.
  72
  73
  74 See also
  75 ========
  76
  77 :doc:`rbd-replay-prep <rbd-replay-prep>`\(8),
  78 :doc:`rbd <rbd>`\(8)