.\" Man page generated from reStructuredText.
.
.TH "RBD-REPLAY-MANY" "8" "May 27, 2021" "dev" "Ceph"
.SH NAME
rbd-replay-many \- replay a rados block device (RBD) workload on several clients
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.nf
\fBrbd\-replay\-many\fP [ \fIoptions\fP ] \-\-original\-image \fIname\fP \fIhost1\fP [ \fIhost2\fP [ ... ] ] \-\- \fIrbd_replay_args\fP
.fi
.sp
.SH DESCRIPTION
.sp
\fBrbd\-replay\-many\fP 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.
.sp
Configuration and replay files are not automatically copied to clients.
Replay images must already exist.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-original\-image name
Specifies the name (and snap) of the originally traced image.
Necessary for correct name mapping.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-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.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exec program
Path to the rbd\-replay executable.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-delay seconds
Delay between starting each client.  Defaults to 0.
.UNINDENT
.SH EXAMPLES
.sp
Typical usage:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
rbd\-replay\-many host\-0 host\-1 \-\-original\-image=image \-\- \-c ceph.conf replay.bin
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
This results in the following commands being executed:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ssh host\-0 \(aqrbd\-replay\(aq \-\-map\-image \(aqimage=image\-0\(aq \-c ceph.conf replay.bin
ssh host\-1 \(aqrbd\-replay\(aq \-\-map\-image \(aqimage=image\-1\(aq \-c ceph.conf replay.bin
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AVAILABILITY
.sp
\fBrbd\-replay\-many\fP is part of Ceph, a massively scalable, open\-source, distributed storage system. Please refer to
the Ceph documentation at \fI\%http://ceph.com/docs\fP for more information.
.SH SEE ALSO
.sp
rbd\-replay(8),
rbd(8)
.SH COPYRIGHT
2010-2021, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" Generated by docutils manpage writer.
.