mirror of https://github.com/ceph/ceph
101 lines
2.2 KiB
ReStructuredText
101 lines
2.2 KiB
ReStructuredText
==========================================
|
|
ceph -- ceph file system control utility
|
|
==========================================
|
|
|
|
.. program:: ceph
|
|
|
|
Synopsis
|
|
========
|
|
|
|
| **ceph** [ -m *monaddr* ] [ -w | *command* ... ]
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
**ceph** is a control utility for communicating with the monitor
|
|
cluster of a running Ceph distributed file system.
|
|
|
|
There are three basic modes of operation.
|
|
|
|
Interactive mode
|
|
----------------
|
|
|
|
To start in interactive mode, no arguments are necessary. Control-d or
|
|
'quit' will exit.
|
|
|
|
Watch mode
|
|
----------
|
|
|
|
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, run::
|
|
|
|
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.
|
|
|
|
|
|
Options
|
|
=======
|
|
|
|
.. option:: -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.
|
|
|
|
.. option:: -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.
|
|
|
|
.. option:: -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.
|
|
|
|
.. option:: -m monaddress[:port]
|
|
|
|
Connect to specified monitor (instead of looking through ceph.conf).
|
|
|
|
|
|
Examples
|
|
========
|
|
|
|
To grab a copy of the current OSD map::
|
|
|
|
ceph -m 1.2.3.4:6789 osd getmap -o osdmap
|
|
|
|
To get a dump of placement group (PG) state::
|
|
|
|
ceph pg dump -o pg.txt
|
|
|
|
|
|
Monitor commands
|
|
================
|
|
|
|
A more complete summary of commands understood by the monitor cluster can be found in the
|
|
wiki, at
|
|
|
|
http://ceph.newdream.net/wiki/Monitor_commands
|
|
|
|
|
|
Availability
|
|
============
|
|
|
|
**ceph** is part of the Ceph distributed file system. Please refer to the Ceph wiki at
|
|
http://ceph.newdream.net/wiki for more information.
|
|
|
|
|
|
See also
|
|
========
|
|
|
|
:doc:`ceph <ceph>`\(8),
|
|
:doc:`mkcephfs <mkcephfs>`\(8)
|