osdmaptool – ceph osd 运行图操作工具¶
提纲¶
描述¶
osdmaptool 工具可用于创建、查看、修改 Ceph 分布式存储系统的 OSD 集群运行图。很显然，它可用于提取内嵌的 CRUSH 图，或者导入新 CRUSH 图。
选项¶
-
--print¶ 修改完成后，打印此图的一份纯文本转储。
-
--dump<format>¶ <format> 为 plain 时以纯文本方式显示运行图，若不支持指定格式就默认为 json 。这是 print 选项的替代品。
-
--clobber¶ 修改时允许 osdmaptool 覆盖 mapfilename 。
-
--import-crushmapfile¶ 从 mapfile 载入 CRUSH 图并把它嵌入 OSD 图。
-
--export-crushmapfile¶ 从 OSD 图提取出 CRUSH 图并写入 mapfile 。
-
--createsimplenumosd [--pg-bits bitsperosd] [--pgp-bits bits]¶ 创建有 numosd 个设备的相对通用的 OSD 图。若指定了 –pg-bits 选项，每个 OSD 的归置组数量将是 bitsperosd 个位偏移。也就是 pg_num 属性将被设置为 numosd 数值再右移 bitsperosd 位。若指定了 –pgp-bits 选项， pgp_num 属性将被设置为 numosd 数值再右移 bits 位。
<译者注>: pgp_num map attribute: 意为 osd map 之中的 pgp_num 属性
-
--create-from-conf¶ 按默认配置创建一份 OSD 图。
-
--test-map-pgs[--pool poolid] [--range-first <first> --range-last <last>]¶ 打印出归置组到 OSD 的映射关系。如果指定了范围，那它就依次递归 osdmaptool 参数所指目录内 first 到 last 之间的。 例如： osdmaptool –test-map-pgs –range-first 0 –range-last 2 osdmap_dir. 它会递归 osdmap_dir 内名为 0 、 1 、 2 的文件。
-
--test-map-pgs-dump[--pool poolid] [--range-first <first> --range-last <last>]¶ 打印出所有归置组及其与 OSD 映射关系的汇总。如果指定了范围，那它就依次递归 osdmaptool 参数所指目录内 first 到 last 之间的。 例如： osdmaptool –test-map-pgs-dump –range-first 0 –range-last 2 osdmap_dir. 它会递归 osdmap_dir 内名为 0 、 1 、 2 的文件。
-
--test-map-pgs-dump-all[--pool poolid] [--range-first <first> --range-last <last>]¶ will print out the summary of all placement groups and the mappings from them to all the OSDs. If range is specified, then it iterates from first to last in the directory specified by argument to osdmaptool. Eg: osdmaptool –test-map-pgs-dump-all –range-first 0 –range-last 2 osdmap_dir. This will iterate through the files named 0,1,2 in osdmap_dir.
-
--test-random¶ does a random mapping of placement groups to the OSDs.
-
--test-map-pg<pgid>¶ map a particular placement group(specified by pgid) to the OSDs.
-
--test-map-object<objectname> [--pool <poolid>]¶ map a particular placement group(specified by objectname) to the OSDs.
-
--test-crush[--range-first <first> --range-last <last>]¶ map placement groups to acting OSDs. If range is specified, then it iterates from first to last in the directory specified by argument to osdmaptool. Eg: osdmaptool –test-crush –range-first 0 –range-last 2 osdmap_dir. This will iterate through the files named 0,1,2 in osdmap_dir.
-
--mark-up-in¶ mark osds up and in (but do not persist).
-
--tree¶ Displays a hierarchical tree of the map.
-
--clear-temp¶ clears pg_temp and primary_temp variables.
实例¶
要创建个有 16 个设备的简易图：
osdmaptool --createsimple 16 osdmap --clobber
查看结果：
osdmaptool --print osdmap
要查看存储池 0 的归置组映射情况：
osdmaptool --test-map-pgs-dump rbd --pool 0
pool 0 pg_num 8
0.0 [0,2,1] 0
0.1 [2,0,1] 2
0.2 [0,1,2] 0
0.3 [2,0,1] 2
0.4 [0,2,1] 0
0.5 [0,2,1] 0
0.6 [0,1,2] 0
0.7 [1,0,2] 1
#osd count first primary c wt wt
osd.0 8 5 5 1 1
osd.1 8 1 1 1 1
osd.2 8 2 2 1 1
in 3
avg 8 stddev 0 (0x) (expected 2.3094 0.288675x))
min osd.0 8
max osd.0 8
size 0 0
size 1 0
size 2 0
size 3 8
- 在上面的输出结果中，
存储池 0 有 8 个归置组，及后面的两张表：
一张表是归置组。每行表示一个归置组，列分别是：
归置组 id ，
acting set ，和
主 OSD 。
一张表是所有的 OSD 。每行表示一个 OSD ，列分别是：
映射到此 OSD 的归置组数量，
此 OSD 是它所属 acting set 的第一个，这样的归置组数量，
此 OSD 是归置组的主 OSD ，这样的归置组数量，
此 OSD 的 CRUSH 权重，还有
此 OSD 的权重。
再看是托管着归置组的 OSD 数量，是 3 个。接下来是
avarge, stddev （标准偏差）, stddev/average, expected stddev, expected stddev / average
min and max
映射到 n 个 OSD 的归置组数量。在本例中，全部的 8 个归置组都映射到了 3 个不同的 OSD 。
在一个均衡得不太好的集群中，我们也许会看到类似如下的归置组分布统计，其标准偏差是 1.41421 :
#osd count first primary c wt wt
osd.0 8 5 5 1 1
osd.1 8 1 1 1 1
osd.2 8 2 2 1 1
#osd count first primary c wt wt
osd.0 33 9 9 0.0145874 1
osd.1 34 14 14 0.0145874 1
osd.2 31 7 7 0.0145874 1
osd.3 31 13 13 0.0145874 1
osd.4 30 14 14 0.0145874 1
osd.5 33 7 7 0.0145874 1
in 6
avg 32 stddev 1.41421 (0.0441942x) (expected 5.16398 0.161374x))
min osd.4 30
max osd.1 34
size 00
size 10
size 20
size 364
使用范围¶
osdmaptool 是 Ceph 的一部分，这是个伸缩力强、开源、分布式的存储系统，更多信息参见 http://ceph.com/docs 。
