Poster of Linux kernelThe best gift for a Linux geek
CEPH

CEPH

Section: Maintenance Commands (8)
Local index Up
 

NAME

ceph - ceph file system control utility  

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,
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

-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).
 

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

ceph(8), mkcephfs(8)


 

Index

NAME
SYNOPSIS
DESCRIPTION
INTERACTIVE MODE
WATCH MODE
COMMAND LINE MODE
OPTIONS
EXAMPLES
MONITOR COMMANDS
AVAILABILITY
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:01:24 GMT, April 16, 2011