1CEPH-SYN(8) Ceph CEPH-SYN(8)
2
3
4
6 ceph-syn - ceph synthetic workload generator
7
9 ceph-syn [ -m monaddr:port ] --syn command ...
10
11
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
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
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
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 http://ceph.com/docs for more information.
75
77 ceph(8), ceph-fuse(8)
78
80 2010-2021, 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 May 13, 2021 CEPH-SYN(8)