1CEPH-SYN(8)                          Ceph                          CEPH-SYN(8)
2
3
4

NAME

6       ceph-syn - ceph synthetic workload generator
7

SYNOPSIS

9       ceph-syn [ -m monaddr:port ] --syn command ...
10
11

DESCRIPTION

13       ceph-syn is a simple synthetic workload generator for the Ceph distrib‐
14       uted file system. It uses the userspace client library to generate sim‐
15       ple  workloads against a currently running file system. The file system
16       need not be mounted via ceph-fuse(8) or the kernel client.
17
18       One or more --syn command arguments specify the particular workload, as
19       documented below.
20

OPTIONS

22       -d     Detach from console and daemonize after startup.
23
24       -c ceph.conf, --conf=ceph.conf
25              Use   ceph.conf   configuration  file  instead  of  the  default
26              /etc/ceph/ceph.conf  to  determine  monitor   addresses   during
27              startup.
28
29       -m monaddress[:port]
30              Connect   to  specified  monitor  (instead  of  looking  through
31              ceph.conf).
32
33       --num_client num
34              Run num different clients, each in a separate thread.
35
36       --syn workloadspec
37              Run the given workload.  May  be  specified  as  many  times  as
38              needed. Workloads will normally run sequentially.
39

WORKLOADS

41       Each  workload should be preceded by --syn on the command line. This is
42       not a complete list.
43
44       mknap path snapname
45              Create a snapshot called snapname on path.
46
47       rmsnap path snapname
48              Delete snapshot called snapname on path.
49
50       rmfile path
51              Delete/unlink path.
52
53       writefile sizeinmb blocksize
54              Create a file, named after our client id, that is sizeinmb MB by
55              writing blocksize chunks.
56
57       readfile sizeinmb blocksize
58              Read  file,  named  after  our client id, that is sizeinmb MB by
59              writing blocksize chunks.
60
61       rw sizeinmb blocksize
62              Write file, then read it back, as above.
63
64       makedirs numsubdirs numfiles depth
65              Create a hierarchy of directories that  is  depth  levels  deep.
66              Give  each  directory  numsubdirs  subdirectories  and  numfiles
67              files.
68
69       walk   Recursively walk the file system (like find).
70

AVAILABILITY

72       ceph-syn is part of Ceph, a massively scalable,  open-source,  distrib‐
73       uted  storage  system.  Please  refer  to  the  Ceph  documentation  at
74       https://docs.ceph.com for more information.
75

SEE ALSO

77       ceph(8), ceph-fuse(8)
78
80       2010-2023, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
81       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
82
83
84
85
86dev                              Nov 02, 2023                      CEPH-SYN(8)
Impressum