mirror of
https://github.com/ceph/ceph
synced 2024-12-25 21:03:31 +00:00
60aea05423
Includes various content cleanups: layout of synopsis, layout of comments in examples, typos. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
141 lines
3.0 KiB
ReStructuredText
141 lines
3.0 KiB
ReStructuredText
=======================================
|
|
rados -- rados object storage utility
|
|
=======================================
|
|
|
|
.. program:: rados
|
|
|
|
Synopsis
|
|
========
|
|
|
|
| **rados** [ -m *monaddr* ] [ mkpool | rmpool *foo* ] [ -p | --pool
|
|
*pool* ] [ -s | --snap *snap* ] [ -i *infile* ] [ -o *outfile* ]
|
|
*command* ...
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
**rados** is a utility for interacting with a Ceph object storage
|
|
cluster (RADOS), part of the Ceph distributed file system.
|
|
|
|
|
|
Options
|
|
=======
|
|
|
|
.. option:: -p pool, --pool pool
|
|
|
|
Interact with the given pool. Required by most commands.
|
|
|
|
.. option:: -s snap, --snap snap
|
|
|
|
Read from the given pool snapshot. Valid for all pool-specific read operations.
|
|
|
|
.. 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).
|
|
|
|
|
|
Global commands
|
|
===============
|
|
|
|
:command:`lspools`
|
|
List object pools
|
|
|
|
:command:`df`
|
|
Show utilization statistics, including disk usage (bytes) and object
|
|
counts, over the entire system and broken down by pool.
|
|
|
|
:command:`mkpool` *foo*
|
|
Create a pool with name foo.
|
|
|
|
:command:`rmpool` *foo*
|
|
Delete the pool foo (and all its data)
|
|
|
|
|
|
Pool specific commands
|
|
======================
|
|
|
|
:command:`get` *name* *outfile*
|
|
Read object name from the cluster and write it to outfile.
|
|
|
|
:command:`put` *name* *infile*
|
|
Write object name to the cluster with contents from infile.
|
|
|
|
:command:`rm` *name*
|
|
Remove object name.
|
|
|
|
:command:`ls` *outfile*
|
|
List objects in given pool and write to outfile.
|
|
|
|
:command:`lssnap`
|
|
List snapshots for given pool.
|
|
|
|
:command:`mksnap` *foo*
|
|
Create pool snapshot named *foo*.
|
|
|
|
:command:`rmsnap` *foo*
|
|
Remove pool snapshot names *foo*.
|
|
|
|
:command:`bench` *seconds* *mode* [ -b *objsize* ] [ -t *threads* ]
|
|
Benchmark for seconds. The mode can be write or read. The default
|
|
object size is 4 KB, and the default number of simulated threads
|
|
(parallel writes) is 16.
|
|
|
|
|
|
Examples
|
|
========
|
|
|
|
To view cluster utilization::
|
|
|
|
rados df
|
|
|
|
To get a list object in pool foo sent to stdout::
|
|
|
|
rados -p foo ls -
|
|
|
|
To write an object::
|
|
|
|
rados -p foo put myobject blah.txt
|
|
|
|
To create a snapshot::
|
|
|
|
rados -p foo mksnap mysnap
|
|
|
|
To delete the object::
|
|
|
|
rados -p foo rm myobject
|
|
|
|
To read a previously snapshotted version of an object::
|
|
|
|
rados -p foo -s mysnap get myobject blah.txt.old
|
|
|
|
|
|
Availability
|
|
============
|
|
|
|
**rados** 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)
|