Section: Maintenance Commands (8) Local index
ceph - ceph file system control utility
[ -m monaddr ]
[ -w | command ... ]
is a control utility for communicating with the monitor cluster of a running
Ceph distributed file system.
There are three basic modes of operation.
To start in interactive
mode, no arguments are necessary. Control-d or 'quit' will exit.
To watch cluster state changes in real time,
starting in -w (watch) mode will print updates to stdout as they occur. For example,
to keep an eye on cluster state,
ceph -C ceph.conf -w
COMMAND LINE MODE
Finally, to send a single instruction to the monitor cluster (and wait for a
response), the command can be specified on the command line.
- -i infile
will specify an input file to be passed along as a payload with the command to the
monitor cluster. This is only used for specific monitor commands.
- -o outfile
will write any payload returned by the monitor cluster with its reply to outfile.
Only specific monitor commands (e.g. osd getmap) return a payload.
- -c ceph.conf, --conf=ceph.conf
Use ceph.conf configuration file instead of the default /etc/ceph/ceph.conf
to determine monitor addresses during startup.
- -m monaddress[:port]
Connect to specified monitor (instead of looking through ceph.conf).
To grab a copy of the current OSD map:
ceph -m 126.96.36.199:6789 osd getmap -o osdmap
To get a dump of placement group (PG) state:
ceph pg dump -o pg.txt
A more complete summary of commands understood by the monitor cluster can be found
in the wiki, at
is part of the Ceph distributed file system. Please refer to the Ceph wiki at
http://ceph.newdream.net/wiki for more information.
- INTERACTIVE MODE
- WATCH MODE
- COMMAND LINE MODE
- MONITOR COMMANDS
- SEE ALSO
This document was created by
using the manual pages.
Time: 22:01:24 GMT, April 16, 2011