ceph-syn – ceph synthetic workload generator

Synopsis

ceph-syn [ -m monaddr:port ] –syn command__…

Description

ceph-syn is a simple synthetic workload generator for the Cephdistributed file system. It uses the userspace client library togenerate simple workloads against a currently running file system. Thefile system need not be mounted via ceph-fuse(8) or the kernel client.

One or more —syn command arguments specify the particularworkload, as documented below.

Options

• -d
• Detach from console and daemonize after startup.

• -c ceph.conf, —conf=ceph.conf
• Use ceph.conf configuration file instead of the default/etc/ceph/ceph.conf to determine monitor addresses duringstartup.

• -m monaddress[:port]
• Connect to specified monitor (instead of looking throughceph.conf).

• —num_client num
• Run num different clients, each in a separate thread.

• —syn workloadspec
• Run the given workload. May be specified as many times asneeded. Workloads will normally run sequentially.

Workloads

Each workload should be preceded by —syn on the commandline. This is not a complete list.

• mknappath__snapname

• Create a snapshot called snapname on path.

• rmsnappath__snapname

• Delete snapshot called snapname on path.

• rmfilepath

• Delete/unlink path.

• writefilesizeinmb__blocksize

• Create a file, named after our client id, that is sizeinmb MB bywriting blocksize chunks.

• readfilesizeinmb__blocksize

• Read file, named after our client id, that is sizeinmb MB bywriting blocksize chunks.

• rwsizeinmb__blocksize

• Write file, then read it back, as above.

• makedirsnumsubdirsnumfilesdepth

• Create a hierarchy of directories that is depth levels deep. Giveeach directory numsubdirs subdirectories and numfiles files.

• walk

• Recursively walk the file system (like find).

Availability

ceph-syn is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer tothe Ceph documentation at http://ceph.com/docs for more information.

See also

ceph(8),ceph-fuse(8)