列出存储池

    1. ceph osd lspools

    创建存储池

    1. 要创建一个存储池，执行：
    3. ceph osd pool create {pool-name} {pg-num} [{pgp-num}] [replicated] \
    4.         [crush-ruleset-name] [expected-num-objects]
    5. ceph osd pool create {pool-name} {pg-num}  {pgp-num}   erasure \
    6.         [erasure-code-profile] [crush-ruleset-name] [expected_num_objects]
    9. 参数含义如下：
    11. {pool-name}
    13. 描述:    存储池名称，必须唯一。
    14. 类型:    String
    15. 是否必需:    必需。
    16. {pg-num}
    18. 描述:    存储池拥有的归置组总数。关于如何计算合适的数值，请参见归置组。默认值 8 对大多数系统都不合适。
    19. 类型:    整数
    20. 是否必需:    Yes
    21. 默认值:    8
    22. {pgp-num}
    24. 描述:    用于归置的归置组总数。此值应该等于归置组总数，归置组分割的情况下除外。
    25. 类型:    整数
    26. 是否必需:    没指定的话读取默认值、或 Ceph 配置文件里的值。
    27. 默认值:    8
    28. {replicated|erasure}
    30. 描述:    存储池类型，可以是副本（保存多份对象副本，以便从丢失的 OSD 恢复）或纠删（获得类似 RAID5 的功能）。多副本存储池需更多原始存储空间，但已实现所有 Ceph 操作；纠删存储池所需原始存储空间较少，但目前仅实现了部分 Ceph 操作。
    31. 类型:    String
    32. 是否必需:    No.
    33. 默认值:    replicated
    34. [crush-ruleset-name]
    36. 描述:    此存储池所用的 CRUSH 规则集名字。指定的规则集必须存在。
    37. 类型:    String
    38. 是否必需:    No.
    39. 默认值:    对于多副本（ replicated ）存储池来说，其默认规则集由 osd pool default crush replicated ruleset 配置决定，此规则集必须存在。 对于用 erasure-code 编码的纠删码（ erasure ）存储池来说，不同的 {pool-name} 所使用的默认（ default ）纠删码配置是不同的，如果它不存在的话，会显式地创建它。
    40. [erasure-code-profile=profile]
    42. 描述:    仅用于纠删存储池。指定纠删码配置框架，此配置必须已由 osd erasure-code-profile set 定义。
    43. 类型:    String
    44. 是否必需:    No.
    45. 创建存储池时，要设置一个合理的归置组数量（如 100 ）。也要考虑到每 OSD 的归置组总数，因为归置组很耗计算资源，所以很多存储池和很多归置组（如 50 个存储池，各包含 100 归置组）会导致性能下降。收益递减点取决于 OSD 主机的强大。
    47. 如何为存储池计算合适的归置组数量请参见归置组。
    49. [expected-num-objects]
    51. 描述:    为这个存储池预估的对象数。设置此值（要同时把 filestore merge threshold 设置为负数）后，在创建存储池时就会拆分 PG 文件夹，以免运行时拆分文件夹导致延时增大。
    52. 类型:    Integer
    53. 是否必需:    No.
    54. 默认值:    0 ，创建存储池时不拆分目录。

    设置存储池配额

    1. 存储池配额可设置最大字节数、和/或每存储池最大对象数。
    3. ceph osd pool set-quota {pool-name} [max_objects {obj-count}] [max_bytes {bytes}]
    5. 例如：
    6. ceph osd pool set-quota data max_objects 10000
    7. 要取消配额，设置为 0 。

    删除存储池

    1. 要删除一存储池，执行：
    3.     ceph osd pool delete {pool-name} [{pool-name} --yes-i-really-really-mean-it]
    5. 如果你给自建的存储池创建了定制的规则集，你不需要存储池时最好删除它。如果你曾严格地创建了用户及其权限给一个存储池，但存储池已不存在，最好也删除那些用户

    重命名存储池

    1. 要重命名一个存储池，执行：
    3. ceph osd pool rename {current-pool-name} {new-pool-name}
    4. 如果重命名了一个存储池，且认证用户有每存储池能力，那你必须用新存储池名字更新用户的能力（即 caps ）。
    6. Note 适用 0.48 Argonaut 及以上。

    查看存储池统计信息
    要查看某存储池的使用统计信息，执行命令：

    1. rados df

    拍下存储池快照
    要拍下某存储池的快照，执行命令：

    1. ceph osd pool mksnap {pool-name} {snap-name}
    2. Note 适用 0.48 Argonaut 及以上。

    删除存储池快照
    要删除某存储池的一个快照，执行命令：

    1. ceph osd pool rmsnap {pool-name} {snap-name}
    2. Note 适用 0.48 Argonaut 及以上。

    调整存储池选项值

    1. 要设置一个存储池的选项值，执行命令：
    2. ceph osd pool set {pool-name} {key} {value}
    1. 你可以设置下列键的值：
    3. size
    5. 描述:    设置存储池中的对象副本数，详情参见设置对象副本数。仅适用于副本存储池。
    6. 类型:    整数
    7. min_size
    9. 描述:    设置 I/O 需要的最小副本数，详情参见设置对象副本数。仅适用于副本存储池。
    10. 类型:    整数
    11. 适用版本:    0.54 及以上。
    12. crash_replay_interval
    14. 描述:    允许客户端重放确认而未提交请求的秒数。
    15. 类型:    整数
    16. pgp_num
    18. 描述:    计算数据归置时使用的有效归置组数量。
    19. 类型:    整数
    20. 有效范围:    等于或小于 pg_num 。
    21. crush_ruleset
    23. 描述:    集群内映射对象归置时使用的规则集。
    24. 类型:    整数
    25. hashpspool
    27. 描述:    给指定存储池设置/取消 HASHPSPOOL 标志。
    28. 类型:    整数
    29. 有效范围:    1 开启， 0 取消
    30. 适用版本:    0.48 及以上。
    31. nodelete
    33. 描述:    给指定存储池设置/取消 NODELETE 标志。
    34. 类型:    整数
    35. 有效范围:    1 开启， 0 取消
    36. 适用版本:    Version FIXME
    37. nopgchange
    39. 描述:    给指定存储池设置/取消 NOPGCHANGE 标志。
    40. 类型:    整数
    41. 有效范围:    1 开启， 0 取消
    42. 适用版本:    Version FIXME
    43. nosizechange
    45. 描述:    给指定存储池设置/取消 NOSIZECHANGE 标志。
    46. 类型:    整数
    47. 有效范围:    1 开启， 0 取消
    48. 适用版本:    Version FIXME
    49. write_fadvise_dontneed
    51. 描述:    设置或取消指定存储池的 WRITE_FADVISE_DONTNEED 标志。
    52. 类型:    Integer
    53. 有效范围:    1 开启， 0 取消
    54. noscrub
    56. 描述:    设置或取消指定存储池的 NOSCRUB 标志。
    57. 类型:    Integer
    58. 有效范围:    1 设置， 0 取消
    59. nodeep-scrub
    61. 描述:    设置或取消指定存储池的 NODEEP_SCRUB 标志。
    62. 类型:    Integer
    63. 有效范围:    1 开启， 0 取消
    64. hit_set_type
    66. 描述:    启用缓存存储池的命中集跟踪，详情见 Bloom 过滤器。
    67. 类型:    String
    68. 有效值:    bloom, explicit_hash, explicit_object
    69. 默认值:    bloom ，其它是用于测试的。
    70. hit_set_count
    72. 描述:    为缓存存储池保留的命中集数量。此值越高， ceph-osd 守护进程消耗的内存越多。
    73. 类型:    整数
    74. 有效范围:    1. Agent doesn’t handle > 1 yet.
    75. hit_set_period
    77. 描述:    为缓存存储池保留的命中集有效期。此值越高， ceph-osd 消耗的内存越多。
    78. 类型:    整数
    79. 实例:    3600 1hr
    80. hit_set_fpp
    82. 描述:    bloom 命中集类型的假阳性概率。详情见 Bloom 过滤器。
    83. 类型:    Double
    84. 有效范围:    0.0 - 1.0
    85. 默认值:    0.05
    86. cache_target_dirty_ratio
    88. 描述:    缓存存储池包含的脏对象达到多少比例时就把它们回写到后端的存储池。
    89. 类型:    Double
    90. 默认值:    .4
    91. cache_target_dirty_high_ratio
    93. 描述:    缓存存储池内包含的已修改（脏的）对象达到此比例时，缓存层代理就会更快地把脏对象刷回到后端存储池。
    94. 类型:    Double
    95. 默认值:    .6
    96. cache_target_full_ratio
    98. 描述:    缓存存储池包含的干净对象达到多少比例时，缓存代理就把它们赶出缓存存储池。
    99. 类型:    Double
    100. 默认值:    .8
    101. target_max_bytes
    103. 描述:    达到 max_bytes 阀值时 Ceph 就回写或赶出对象。
    104. 类型:    整数
    105. 实例:    1000000000000 #1-TB
    106. target_max_objects
    108. 描述:    达到 max_objects 阀值时 Ceph 就回写或赶出对象。
    109. 类型:    整数
    110. 实例:    1000000 #1M objects
    111. hit_set_grade_decay_rate
    113. 描述:    在两个连续 hit_sets 间的热度衰退速率。
    114. 类型:    Integer
    115. 有效范围:    0 - 100
    116. 默认值:    20
    117. hit_set_grade_search_last_n
    119. 描述:    计算热度时，在 hit_sets 里最多计数 N 次。
    120. 类型:    Integer
    121. 有效范围:    0 - hit_set_count
    122. 默认值:    1
    123. cache_min_flush_age
    125. 描述:    达到此时间（单位为秒）时，缓存代理就把某些对象从缓存存储池刷回到存储池。
    126. 类型:    整数
    127. 实例:    600 10min
    128. cache_min_evict_age
    130. 描述:    达到此时间（单位为秒）时，缓存代理就把某些对象从缓存存储池赶出。
    131. 类型:    整数
    132. 实例:    1800 30min
    133. fast_read
    135. 描述:    在纠删码存储池上，如果打开了这个标志，读请求会向所有分片发送子操作读，然后等着，直到收到的分片足以解码给客户端。对 jerasure 和 isa 纠删码插件来说，只要前 K 个请求返回，就能立即解码、并先把这些数据发给客户端。这样有助于资源折衷，以提升性能。当前，这些标志还只能用于纠删码存储池。
    136. 类型:    Boolean
    137. 默认值:    0
    138. scrub_min_interval
    140. 描述:    在负载低时，洗刷存储池的最大间隔秒数。如果是 0 ，就按照配置文件里的 osd_scrub_min_interval 。
    141. 类型:    Double
    142. 默认值:    0
    143. scrub_max_interval
    145. 描述:    不管集群负载如何，都要洗刷存储池的最大间隔秒数。如果是 0 ，就按照配置文件里的 osd_scrub_max_interval 。
    146. 类型:    Double
    147. 默认值:    0
    148. deep_scrub_interval
    150. 描述:    “深度”洗刷存储池的间隔秒数。如果是 0 ，就按照配置文件里的 osd_deep_scrub_interval 。
    151. 类型:    Double
    152. 默认值:    0

    获取存储池选项值

    1. 要获取一个存储池的选项值，执行命令：
    3. ceph osd pool get {pool-name} {key}
    1. 你可以获取到下列选项的值：
    3. size
    5. 描述:    见 size
    6. 类型:    整数
    7. min_size
    9. 描述:    见 min_size
    10. 类型:    整数
    11. 适用版本:    0.54 及以上
    12. crash_replay_interval
    14. 描述:    见 crash_replay_interval
    15. 类型:    整数
    16. pgp_num
    18. 描述:    见 pgp_num
    19. 类型:    整数
    20. 有效范围:    小于等于 pg_num 。
    21. crush_ruleset
    23. 描述:    见 crush_ruleset
    24. 类型:    整数
    25. hit_set_type
    27. 描述:    见 hit_set_type
    28. 类型:    String
    29. 有效选项:    bloom 、 explicit_hash 、 explicit_object
    30. hit_set_count
    32. 描述:    见 hit_set_count
    33. 类型:    整数
    34. hit_set_period
    36. 描述:    见 hit_set_period
    37. 类型:    整数
    38. hit_set_fpp
    40. 描述:    见 hit_set_fpp
    41. 类型:    Double
    42. cache_target_dirty_ratio
    44. 描述:    见 cache_target_dirty_ratio
    45. 类型:    Double
    46. cache_target_dirty_high_ratio
    48. 描述:    见 cache_target_dirty_high_ratio
    49. 类型:    Double
    50. cache_target_full_ratio
    52. 描述:    见 cache_target_full_ratio
    53. 类型:    Double
    54. target_max_bytes
    56. 描述:    见 target_max_bytes
    57. 类型:    整数
    58. target_max_objects
    60. 描述:    见 target_max_objects
    61. 类型:    整数
    62. cache_min_flush_age
    64. 描述:    见 cache_min_flush_age
    65. 类型:    整数
    66. cache_min_evict_age
    68. 描述:    见 cache_min_evict_age
    69. 类型:    整数
    70. fast_read
    72. 描述:    见 fast_read
    73. 类型:    Boolean
    74. scrub_min_interval
    76. 描述:    见 scrub_min_interval
    77. 类型:    Double
    78. scrub_max_interval
    80. 描述:    见 scrub_max_interval
    81. 类型:    Double
    82. deep_scrub_interval
    84. 描述:    见 deep_scrub_interval
    85. 类型:    Double

    设置对象副本数

    1. 要设置多副本存储池的对象副本数，执行命令：
    3. ceph osd pool set {poolname} size {num-replicas}
    4. Important {num-replicas} 包括对象自身，如果你想要对象自身及其两份拷贝共计三份，指定 3 。
    5. 例如：
    7. ceph osd pool set data size 3
    8. 你可以在每个存储池上执行这个命令。注意，一个处于降级模式的对象其副本数小于规定值 pool size ，但仍可接受 I/O 请求。为保证 I/O 正常，可用 min_size 选项为其设置个最低副本数。例如：
    10. ceph osd pool set data min_size 2
    11. 这确保数据存储池里任何副本数小于 min_size 的对象都不会收到 I/O 了。

    获取对象副本数
    要获取对象副本数，执行命令：

    1. ceph osd dump | grep 'replicated size'

    Ceph 会列出存储池，且高亮 replicated size 属性。默认情况下， Ceph 会创建一对象的两个副本（一共三个副本，或 size 值为 3 ）。

    1. [root@c4 ceph-cluster]# ceph osd pool get default.rgw.control all
    2. size: 2
    3. min_size: 1
    4. pg_num: 8
    5. pgp_num: 8
    6. crush_rule: replicated_rule
    7. hashpspool: true
    8. nodelete: false
    9. nopgchange: false
    10. nosizechange: false
    11. write_fadvise_dontneed: false
    12. noscrub: false
    13. nodeep-scrub: false
    14. use_gmt_hitset: 1
    15. auid: 18446744073709551615
    16. fast_read: 0