rados – rados 对象存储工具¶

提纲¶

rados [ options ] [ command ]

描述¶

rados 工具可操纵 Ceph 对象存储集群（ RADOS ），是 Ceph 分布式存储系统的一部分。

选项¶

-p pool, --pool pool¶: 操作指定的存储池。大多数命令都得指定此参数。

--pgid¶: 作为 --pool 的外加参数， --pgid 是让用户指定 PG id 的，然后命令就径直导向此 PG 。加上这个选项，用户就可以把某些命令（如 ls ）的范围限定于指定 PG 。

-N namespace, --namespace namespace¶: 指定要给对象用的 rados 命名空间。

-s snap, --snap snap¶: 从指定的存储池快照读出。适用于所有与存储池相关的读操作。

-i infile¶: 指定输入文件，其内容将作为此命令的载荷发送给监视器集群。仅适用于部分监视器命令。

-o outfile¶: 把监视器集群返回的载荷写入 outfile 。仅适用于某些会返回载荷的监视器命令（如 osd getmap ）。

-c ceph.conf, --conf=ceph.conf¶: 用指定的 ceph.conf 配置文件而非默认的 /etc/ceph/ceph.conf 来确定监视器的初始地址。

-m monaddress[:port]¶: 连接指定监视器（而非通过 ceph.conf 查找）。

-b block_size¶: 设置块尺寸，适用于 put/get/append 操作、及写入压力测试。

--striper¶: 使用 rados 的条带化 API 而非默认的，支持的操作有 stat 、 get 、 put 、 append 、 truncate 、 rm 、 ls 以及所有与 xattr 相关的操作。

-O object_size¶: 在做写入压力测试的时候，设置 put/get 操作的对象尺寸。

全局命令¶

lspools: 罗列对象存储池
df: 显示利用率统计信息，显示整个系统以及各存储池的磁盘空间（字节数）、对象数量。
list-inconsistent-pg pool: 罗列指定存储池内不一致的归置组。
list-inconsistent-obj pgid: 罗列指定 PG 内不一致的对象。
list-inconsistent-snapset pgid: 罗列指定 PG 内不一致的 snapset 。

特定于存储池的命令¶

get name outfile: 从集群读出名为 name 的对象、并把它写入 outfile 。
put name infile [–offset offset]: 把 infile 的内容写入集群内名为 name 的对象、从偏移量 offset （默认为 0 ）处写起。 警告：put 命令创建的是单个 RADOS 对象，尺寸和你的输入文件完全一样。你如果不能保证对象的尺寸合理且一致，最好改用 RGW/S3 、 CephFS 或 RBD ，否则实际运行情况和你期望的会有出入。
append name infile: 把 infile 的内容追加给集群内名为 name 的对象。
rm name: 删除名为 name 的对象。
listwatchers name: 罗列此对象名的关注者。
ls outfile: 罗列指定存储池内的对象，并把名单写入 outfile 文件。
lssnap: 罗列指定存储池的快照。
clonedata srcname dstname –object-locator key: Clone object byte data from srcname to dstname. Both objects must be stored with the locator key key (usually either srcname or dstname). Object attributes and omap keys are not copied or cloned.
mksnap foo: Create pool snapshot named foo.
rmsnap foo: Remove pool snapshot named foo.
bench seconds mode [ -b objsize ] [ -t threads ]: 压力测试 seconds 秒。 mode 可以是 write 、 seq 或 rand 。 seq 和 rand 分别是顺序读、随机读压力测试，要想做读压力测试，先得加 –no-cleanup 选项做一次写压力测试。默认对象尺寸是 4 MB ，默认的模拟线程数（并行写操作）为 16 。–run-name <label> 选项适用于多个客户端并行测试以评估最大载荷。 <label> 表示任意对象名，默认为 “benchmark_last_metadata” ，且作为“读”和“写”操作的底层对象名。注： -b objsize 仅适用于 write 模式。注： write 和 seq 必须运行在相同的主机上，否则 write 所创建对象的名字不能被 seq 所接受。
cleanup [ –run-name run_name ] [ –prefix prefix ]: 清理先前的基准测试操作。注意：默认的 run-name 是 benchmark_last_metadata
listxattr name: 罗列一个对象的所有扩展属性。
getxattr name attr: 获取某一对象的扩展属性 attr 的值。
setxattr name attr value: 设置某一对象的扩展属性，把扩展属性 attr 的值设置为 value 。
rmxattr name attr: 删除某一对象的扩展属性 attr 。
stat name: 获取指定对象的 stat 信息（即 mtime 、 size ）。
stat2 name: 获取指定对象的 stat 信息（与 stat 类似，但是时间精度更高）。
listomapkeys name: 罗列 name 对象的对象映射图内存储的所有键。
listomapvals name: 罗列 name 对象的对象映射图内存储的所有键值对。值会被转储为十六进制。
getomapval [ –omap-key-file file ] name key [ out-file ]: 把 name 对象的对象映射图内 key 的值转储为十六进制。如果没有提供可选参数 out-file ，这个值就会写到标准输出。
setomapval [ –omap-key-file file ] name key [ value ]: 设置 name 对象的对象映射图内 key 的值。如果没加可选的 value 参数，就从标准输入读取。
rmomapkey [ –omap-key-file file ] name key: 从 name 对象的对象映射图内删除 key 。
getomapheader name: 把 name 对象的对象映射图头部转储为十六进制。
setomapheader name value: 设置 name 对象的对象映射图头部的值。
export filename: 把存储池内容序列化为一个文件或标准输出。
import [–dry-run] [–no-overwrite] < filename | - >: 把一个文件或标准输入的内容载入存储池。

实例¶

查看集群使用情况：

rados df

获取存储池 foo 内的对象列表，并显示在标准输出：

rados -p foo ls -

写入一个对象：

rados -p foo put myobject blah.txt

创建一个快照：

rados -p foo mksnap mysnap

删除对象：

rados -p foo rm myobject

读取对象的快照内容：

rados -p foo -s mysnap get myobject blah.txt.old

罗列 PG 0.6 内不一致的对象：

rados list-inconsistent-obj 0.6 --format=json-pretty

使用范围¶

rados 是 Ceph 的一部分，这是个伸缩力强、开源、分布式的存储系统，更多信息参见 http://ceph.com/docs 。

参考¶

ceph(8)