ceph(8) - f14

1CEPH(8)                     System Manager's Manual                    CEPH(8)
2
3
4

NAME

6       ceph - ceph file system control utility
7

SYNOPSIS

9       ceph [ -m monaddr ] [ -w | command ... ]
10

DESCRIPTION

12       ceph is a control utility for communicating with the monitor cluster of
13       a running Ceph distributed file system.
14
15       There are three basic modes of operation.
16

INTERACTIVE MODE

18       To start in interactive mode, no arguments are necessary.  Control-d or
19       'quit' will exit.
20

WATCH MODE

22       To  watch  cluster  state  changes in real time, starting in -w (watch)
23       mode will print updates to stdout as they occur.  For example, to  keep
24       an eye on cluster state,
25
26              ceph -C ceph.conf -w
27

COMMAND LINE MODE

29       Finally,  to send a single instruction to the monitor cluster (and wait
30       for a response), the command can be specified on the command line.
31

OPTIONS

33       -i infile
34              will specify an input file to be passed along as a payload  with
35              the  command to the monitor cluster.  This is only used for spe‐
36              cific monitor commands.
37
38       -o outfile
39              will write any payload returned by the monitor cluster with  its
40              reply  to  outfile.   Only  specific  monitor commands (e.g. osd
41              getmap) return a payload.
42
43       -c ceph.conf, --conf=ceph.conf
44              Use  ceph.conf  configuration  file  instead  of   the   default
45              /etc/ceph/ceph.conf   to   determine  monitor  addresses  during
46              startup.
47
48       -m monaddress[:port]
49              Connect  to  specified  monitor  (instead  of  looking   through
50              ceph.conf).
51

EXAMPLES

53       To grab a copy of the current OSD map:
54
55              ceph -m 1.2.3.4:6789 osd getmap -o osdmap
56
57       To get a dump of placement group (PG) state:
58
59              ceph pg dump -o pg.txt
60

MONITOR COMMANDS

62       A  more  complete summary of commands understood by the monitor cluster
63       can be found in the wiki, at
64
65              http://ceph.newdream.net/wiki/Monitor_commands
66

AVAILABILITY

68       ceph is part of the Ceph distributed file system.  Please refer to  the
69       Ceph wiki at http://ceph.newdream.net/wiki for more information.
70