最新ceph集群常用命令梳理

结合网络、官网、手动查询等多方渠道，整理ceph维护管理常用命令，并且梳理常规命令在使用过程中的逻辑顺序。另外整理期间发现ceph 集群的命令体系有点乱，详细情况各自体验。

一：ceph集群启动、重启、停止

1：ceph 命令的选项如下：

选项简写描述

--verbose-v详细的日志。

--valgrindN/A（只适合开发者和质检人员）用 Valgrind 调试。

--allhosts-a在 ceph.conf 里配置的所有主机上执行，否 则它只在本机执行。

--restartN/A核心转储后自动重启。

--norestartN/A核心转储后不自动重启。

--conf-c使用另外一个配置文件。

Ceph 子命令包括：

命令描述

start启动守护进程。

stop停止守护进程。

forcestop暴力停止守护进程，等价于 kill -9

killall杀死某一类守护进程。

cleanlogs清理掉日志目录。

cleanalllogs清理掉日志目录内的所有文件。

2：启动所有守护进程

要启动、关闭、重启 Ceph 集群，执行 ceph 时加上 相关命令，语法如下：

/etc/init.d/ceph [options] [start|restart|stop] [daemonType|daemonID]

下面是个典型启动实例：

sudo /etc/init.d/ceph -a start

加 -a （即在所有节点上执行）执行完成后Ceph本节点所有进程启动。

把 CEPH 当服务运行，按此语法：

service ceph [options] [start|restart] [daemonType|daemonID]

典型实例：  service ceph -a start

3:启动单一实例

要启动、关闭、重启一类守护进程  本例以要启动本节点上某一类的所有 Ceph 守护进程，

/etc/init.d/ceph  [start|restart|stop] [daemonType|daemonID]

/etc/init.d/ceph start osd.0

把ceph当做服务运行，启动一节点上某个 Ceph 守护进程，

按此语法： service ceph  start {daemon-type}.{instance}

service ceph  start osd.0

二：集群维护常用命令概览

1：检查集群健康状况

启动集群后、读写数据前，先检查下集群的健康状态。你可以用下面的命令检查：

ceph health   或者 ceph health detail （输出信息更详细）

要观察集群内正发生的事件，打开一个新终端，然后输入：

ceph -w

输出信息里包含：

集群唯一标识符

集群健康状况

监视器图元版本和监视器法定人数状态

OSD 版本和 OSD 状态摘要

其内存储的数据和对象数量的粗略统计，以及数据总量等。

新版本新增选项如下：

-s, --status          show cluster status

-w, --watch           watch live cluster changes

--watch-debug         watch debug events

--watch-info          watch info events

--watch-sec           watch security events

--watch-warn          watch warn events

--watch-error         watch error events

--version, -v         display version

--verbose             make verbose

--concise             make less verbose

使用方法演示：

ceph -w --watch-info

2：检查集群的使用情况

检查集群的数据用量及其在存储池内的分布情况，可以用 df 选项，它和 Linux 上的 df 相似。如下：

ceph df

输出的 GLOBAL 段展示了数据所占用集群存储空间的概要。

SIZE: 集群的总容量；

AVAIL: 集群的空闲空间总量；

RAW USED: 已用存储空间总量；

% RAW USED: 已用存储空间比率。用此值参照 full ratio 和 near full \ ratio 来确保不会用尽集群空间。

详情见存储容量。

输出的 POOLS 段展示了存储池列表及各存储池的大致使用率。没有副本、克隆品和快照占用情况。例如，如果你把 1MB 的数据存储为对象，理论使用率将是 1MB ，但考虑到副本数、克隆数、和快照数，实际使用率可能是 2MB 或更多。

NAME: 存储池名字；

ID: 存储池唯一标识符；

USED: 大概数据量，单位为 KB 、 MB 或 GB ；

%USED: 各存储池的大概使用率；

Objects: 各存储池内的大概对象数。

新版本新增ceph osd df  命令，可以详细列出集群每块磁盘的使用情况，包括大小、权重、使用多少空间、使用率等等

3：检查集群状态

要检查集群的状态，执行下面的命令：:

ceph status

4：检查MONITOR状态

查看监视器图，执行下面的命令：:

ceph mon stat

或者：

ceph mon dump

要检查监视器的法定人数状态，执行下面的命令：

ceph quorum_status

5：检查 MDS 状态:

元数据服务器为 Ceph 文件系统提供元数据服务，元数据服务器有两种状态： up | \ down 和 active | inactive ，执行下面的命令查看元数据服务器状态为 up 且 active ：

ceph mds stat

要展示元数据集群的详细状态，执行下面的命令：

ceph mds dump

三：集群命令详解

######################mon 相关####################

1：查看mon的状态信息

[mon@ptmind~]# ceph mon stat

2：查看mon的选举状态

[mon@ptmind~]# ceph quorum_status

3：查看mon的映射信息

[mon@ptmind~]# ceph mon dump

4：删除一个mon节点

[mon@ptmind~]# ceph mon remove cs1

5：获得一个正在运行的mon map，并保存在1.txt文件中

[mon@ptmind~]# ceph mon getmap -o 1.txt

6：读取上面获得的map

[mon@ptmind~]# monmaptool --print 1.txt

7：把上面的mon map注入新加入的节点

[mon@ptmind~]# ceph-mon -i nc3 --inject-monmap 1.txt

8：查看mon的amin socket

[mon@ptmind~]# ceph-conf --name mon.nc3 --show-config-value admin_socket

9：查看ceph mon log日志所在的目录

[mon@ptmind~]# ceph-conf --name mon.nc1 --show-config-value log_file

/var/log/ceph/ceph-mon.nc1.log

10：查看一个集群ceph-mon.nc3参数的配置、输出信息特别详细，集群所有配置生效可以在此参数下确认

[mon@ptmind~]# ceph --admin-daemon /var/run/ceph/ceph-mon.nc3.asok config show | less

######################### msd 相关 ###################

1：查看msd状态

[mon@ptmind~]# ceph mds stat

2：删除一个mds节点

[mon@ptmind~]# ceph  mds rm 0 mds.nc1

3：设置mds状态为失败

[mon@ptmind~]# ceph mds rmfailed <int[0-]>

4：新建pool

[mon@ptmind~]# ceph mds add_data_pool <poolname>

5：关闭mds集群

[mon@ptmind~]# mds cluster_down

6：启动mds集群

[mon@ptmind~]# mds cluster_up

7：设置cephfs文件系统存储方式最大单个文件尺寸

[mon@ptmind~]# ceph mds set max_file_size 1024000000000

### 清除cephfs 文件系统步骤 ####

强制mds状态为featrue

[mon@ptmind~]# ceph mds fail 0

删除mds文件系统

[mon@ptmind~]# ceph fs rm leadorfs --yes-i-really-mean-it

#删除fs数据文件夹

[mon@ptmind~]# ceph osd pool delete cephfs_data cephfs_data --yes-i-really-really-mean-it

#删除元数据文件夹

[mon@ptmind~]# ceph osd pool delete cephfs_metadata cephfs_metadata --yes-i-really-really-mean-it

然后再删除 mds key  ，残留文件等

拆除文件系统前推荐先删除节点，待验证

[mon@ptmind~]# ceph  mds rm 0 mds.node242

################################ ceph auth 相关 ################################

1：查看ceph集群中的认证用户及相关的key

[mon@ptmind~]# ceph auth list

2：为ceph创建一个admin用户并为admin用户创建一个密钥，把密钥保存到/etc/ceph目录下：

[mon@ptmind~]# ceph auth get-or-create client.admin mds 'allow' osd 'allow *' mon 'allow *' > /etc/ceph/ceph.client.admin.keyring

或

[mon@ptmind~]# ceph auth get-or-create client.admin mds 'allow' osd 'allow *' mon 'allow *' -o /etc/ceph/ceph.client.admin.keyring

3：为osd.0创建一个用户并创建一个key

[mon@ptmind~]# ceph auth get-or-create osd.0 mon 'allow rwx' osd 'allow *' -o /var/lib/ceph/osd/ceph-0/keyring

4：为mds.nc3创建一个用户并创建一个key

[mon@ptmind~]# ceph auth get-or-create mds.nc3 mon 'allow rwx' osd 'allow *' mds 'allow *' -o /var/lib/ceph/mds/ceph-cs1/keyring

5：导入key信息

[mon@ptmind~]# ceph auth import   /var/lib/ceph/mds/ceph-cs1/keyring

6：删除集群中的一个认证用户

[mon@ptmind~]# ceph auth del osd.0

################################ osd  相关 ################################

1：查看osd列表

[mon@ptmind~]# ceph osd tree

2：查看数据延迟

[mon@ptmind~]# ceph osd perf

osd fs_commit_latency(ms) fs_apply_latency(ms)

0                     3                    4

1                   333                  871

2                    33                   49

3                     1                    2

。。。。。。。。。。。。

3：详细列出集群每块磁盘的使用情况，包括大小、权重、使用多少空间、使用率等等

[mon@ptmind~]# ceph osd df

4：down掉一个osd硬盘

[mon@ptmind~]# ceph osd down 0   #down掉osd.0节点

5：在集群中删除一个osd硬盘

[mon@ptmind~]# ceph osd rm 0

6：在集群中删除一个osd 硬盘 crush map

[mon@ptmind~]# ceph osd crush rm osd.0

7：在集群中删除一个osd的host节点

[mon@ptmind~]# ceph osd crush rm cs1

8：查看最大osd的个数

[mon@ptmind~]# ceph osd getmaxosd

max_osd = 90 in epoch 1202     #默认最大是90个osd节点

9：设置最大的osd的个数（当扩大osd节点的时候必须扩大这个值）

[mon@ptmind~]# ceph osd setmaxosd 2048

10：设置osd crush的权重为1.0

ceph osd crush set {id} {weight} [{loc1} [{loc2} ...]]

例如：

[mon@ptmind~]# ceph osd crush set osd.1 0.5 host=node241

11：设置osd的权重

[mon@ptmind~]# ceph osd reweight 3 0.5

reweighted osd.3 to 0.5 (8327682)

或者用下面的方式

[mon@ptmind~]# ceph osd crush reweight osd.1 1.0

12：把一个osd节点逐出集群

[mon@ptmind~]# ceph osd out osd.3:

3       1    osd.3   up      0      # osd.3的reweight变为0了就不再分配数据，但是设备还是存活的

13：把逐出的osd加入集群

[mon@ptmind~]# ceph osd in osd.3

marked in osd.3.

14：暂停osd （暂停后整个集群不再接收数据）

[mon@ptmind~]# ceph osd pause

15：再次开启osd （开启后再次接收数据）

[mon@ptmind~]# ceph osd unpause

16：查看一个集群osd.0参数的配置、输出信息特别详细，集群所有配置生效可以在此参数下确认

[mon@ptmind~]# ceph --admin-daemon /var/run/ceph/ceph-osd.0.asok config show | less

17：设置标志 flags ，不允许关闭osd、解决网络不稳定，osd 状态不断切换的问题

[mon@ptmind~]# ceph osd set nodown

取消设置

[mon@ptmind~]# ceph osd unset nodown

################################pool  相关################################

1：查看ceph集群中的pool数量

[mon@ptmind~]# ceph osd lspools   或者 ceph osd pool ls

2：在ceph集群中创建一个pool

[mon@ptmind~]# ceph osd pool create rbdtest 100            #这里的100指的是PG组:

3：查看集群中所有pool的副本尺寸

[mon@ptmind~]# ceph osd dump | grep 'replicated size'

4：查看pool 最大副本数量

[mon@ptmind~]# ceph osd pool get rbdpool size

size: 3

5：查看pool 最小副本数量

[root@node241 ~]# ceph osd pool get rbdpool min_size

min_size: 2

6：设置一个pool的pg数量

[mon@ptmind~]# ceph osd pool set rbdtest pg_num 100

7：设置一个pool的pgp数量

[mon@ptmind~]# ceph osd pool set rbdtest pgp_num 100

8: 修改ceph，数据最小副本数、和副本数

ceph osd pool set $pool_name min_size 1

ceph osd pool set $pool_name size 2

示例：

[mon@ptmind~]# ceph osd pool set rbdpool min_size 1

[mon@ptmind~]# ceph osd pool set rbdpool size 2

验证：

[mon@ptmind~]# ceph osd dump

pool 3 'rbdpool' replicated size 2 min_size 1

9:设置rbdtest池的最大存储空间为100T（默认是1T)

[mon@ptmind~]# ceph osd pool set rbdtest target_max_bytes 100000000000000

10: 为一个ceph pool配置配额、达到配额前集群会告警，达到上限后无法再写入数据

[mon@ptmind~]# ceph osd pool set-quota rbdtest max_objects 10000

11: 在集群中删除一个pool,注意删除poolpool 映射的p_w_picpath 会直接被删除，线上操作要谨慎。

[mon@ptmind~]# ceph osd pool delete rbdtest  rbdtest  --yes-i-really-really-mean-it  #集群名字需要重复两次

12: 给一个pool创建一个快照

[mon@ptmind~]# ceph osd pool mksnap rbdtest   rbdtest-snap20150924

13: 查看快照信息

[mon@ptmind~]# rados lssnap -p rbdtest

1       rbdtest-snap20150924    2015.09.24 19:58:55

2       rbdtest-snap2015092401  2015.09.24 20:31:21

2 snaps

14:删除pool的快照

[mon@ptmind~]# ceph osd pool rmsnap rbdtest  rbdtest-snap20150924

验证，剩余一个snap

[mon@ptmind~]# rados lssnap -p rbdtest

2       rbdtest-snap2015092401  2015.09.24 20:31:21

1 snaps

################################rados命令相关##################

rados 是和Ceph的对象存储集群（RADOS），Ceph的分布式文件系统的一部分进行交互是一种实用工具。

1：查看ceph集群中有多少个pool （只是查看pool)

[mon@ptmind~]# rados lspools    同  ceph osd pool ls 输出结果一致

2：显示整个系统和被池毁掉的使用率统计，包括磁盘使用（字节）和对象计数

[mon@ptmind~]# rados df

3：创建一个pool

[mon@ptmind~]# rados mkpool test

4：创建一个对象object

[mon@ptmind~]# rados create test-object -p test

5：查看对象文件

[mon@ptmind~]# rados -p test ls

test-object

6：删除一个对象

[mon@ptmind~]# rados rm test-object-1 -p test

7：删除foo池 (和它所有的数据)

[mon@ptmind~]# rados rmpool test test –yes-i-really-really-mean-it

8：查看ceph pool中的ceph object （这里的object是以块形式存储的）

[mon@ptmind~]# rados ls -p test | more

9：为test pool创建快照

[mon@ptmind~]# rados -p test mksnap testsnap

created pool test snap testsnap

10：列出给定池的快照

[mon@ptmind~]# rados -p test lssnap

1       testsnap        2015.09.24 21:14:34

11：删除快照

[mon@ptmind~]# rados -p test rmsnap testsnap

removed pool test snap testsnap

12：上传一个对象到test pool

[mon@ptmind~]# rados -p test put myobject blah.txt

13：

###使用rados 进行性能测试###

测试用例如下：

rados bench 600 write  rand -t 100 -b 4K -p datapool

选项解释：

测试时间 :600

支持测试类型：write/read ，加rand就是随机,不加就是顺序

并发数（ -t选项）：100

pool的名字是：datapool

################################ PG 相关 ################################

PG =“放置组”。当集群中的数据，对象映射到编程器，被映射到这些PGS的OSD。

1：查看pg组的映射信息

[mon@ptmind~]# ceph pg dump    或者 ceph pg ls

2：查看一个PG的map

[mon@ptmind~]# ceph pg map 0.3f

osdmap e88 pg 0.3f (0.3f) -> up [0,2] acting [0,2]   #其中的[0,2]代表存储在osd.0、osd.2节点，osd.0代表主副本的存储位置

3：查看PG状态

[mon@ptmind~]# ceph pg stat

4：查询一个pg的详细信息

[mon@ptmind~]# ceph pg  0.26 query

5：要洗刷一个pg组，执行命令：

[mon@ptmind~]# ceph pg scrub {pg-id}

6：查看pg中stuck的状态

要获取所有卡在某状态的归置组统计信息，执行命令：

ceph pg dump_stuck inactive|unclean|stale [--format <format>] [-t|--threshold <seconds>]

[mon@ptmind~]# ceph pg dump_stuck unclean

[mon@ptmind~]# ceph pg dump_stuck inactive

[mon@ptmind~]# ceph pg dump_stuck stale

Inactive （不活跃）归置组不能处理读写，因为它们在等待一个有最新数据的 OSD 复活且进入集群。

Unclean （不干净）归置组含有复制数未达到期望数量的对象，它们应该在恢复中。

Stale （不新鲜）归置组处于未知状态：存储它们的 OSD 有段时间没向监视器报告了（由 mon_osd_report_timeout 配置）。

可用格式有 plain （默认）和 json 。阀值定义的是，归置组被认为卡住前等待的最小时间（默认 300 秒）

7：显示一个集群中的所有的pg统计

[mon@ptmind~]# ceph pg dump --format plain

8：恢复一个丢失的pg

如果集群丢了一个或多个对象，而且必须放弃搜索这些数据，你就要把未找到的对象标记为丢失（ lost ）。

如果所有可能的位置都查询过了，而仍找不到这些对象，你也许得放弃它们了。这可能是罕见的失败组合导致的，集群在写入完成前，未能得知写入是否已执行。

当前只支持 revert 选项，它使得回滚到对象的前一个版本（如果它是新对象）或完全忽略它。要把 unfound 对象标记为 lost ，执行命令：

ceph pg {pg-id} mark_unfound_lost revert|delete

9：查看某个PG内分布的数据状态，具体状态可以使用选项过滤输出

ceph pg ls {<int>} {active|clean|down|replay|splitting|scrubbing|scrubq|degraded|inconsistent|peering|repair|recovering|backfill_wait|incomplete|stale|remapped|deep_scrub|backfill|

backfill_toofull|recovery_wait|undersized [active|clean|down|replay|splitting|scrubbing|scrubq|degraded|inconsistent|peering|repair|recovering|backfill_wait|incomplete|stale|remapped|

deep_scrub|backfill|backfill_toofull|recovery_wait|undersized...]} :  list pg with specific pool, osd, state

实例如下：

pg号   过滤输出的状态

[mon@ptmind~]# ceph   pg   ls       1     clean

10：查询osd 包含pg 的信息，过滤输出pg的状态信息

pg ls-by-osd <osdname (id|osd.id)>       list pg on osd [osd]

{<int>} {active|clean|down|replay|splitting|scrubbing|scrubq|degraded|

inconsistent|peering|repair|recovering| backfill_wait|incomplete|stale|remapped|deep_scrub|backfill|backfill_toofull|recovery_wait|undersized[active|clean|down|replay|splitting|

scrubbing|scrubq|degraded|inconsistent| peering|repair|recovering|backfill_ wait|incomplete|stale|remapped|deep_scrub|backfill|backfill_toofull|recovery_wait|undersized...]}

实例如下：

[mon@ptmind~]# ceph pg ls-by-osd osd.5

11：查询pool包含pg 的信息，过滤输出pg的状态信息

ceph pg  ls-by-pool   poolname   选项

ceph pg ls-by-pool   <poolstr>  {active|clean| down|replay|splitting|scrubbing|scrubq|  degraded|inconsistent|peering|repair| recovering|backfill_wait|incomplete|  stale|remapped|deep_scrub|backfill|

backfill_toofull|recovery_wait| undersized [active|clean|down|replay|  splitting|scrubbing|scrubq|degraded| inconsistent|peering|repair|recovering| backfill_wait|incomplete|stale| remapped|deep_scrub|backfill|backfill_

实例如下：

[mon@ptmind~]# ceph pg ls-by-pool test

12：查询某个osd状态为 primary pg ，可以根据需要过滤状态

pg ls-by-primary <osdname (id|osd.id)> {<int>} {active|clean|down|replay|splitting|scrubbing|scrubq|degraded|inconsistent|peering|repair|recovering|backfill_wait|incomplete|stale|remapped|deep_scrub|backfill|

backfill_toofull|recovery_wait|undersized [active|clean|down|replay|splitting|scrubbing|scrubq|degraded|inconsistent|peering|repair|recovering|backfill_wait|incomplete|stale|remapped|deep_scrub|backfill|

backfill_toofull|recovery_wait|undersized...]} :  list pg with primary = [osd]

实例如下：

osd号   过滤输出的状态

[mon@ptmind~]# ceph pg ls-by-primary    osd.3    clean

############################### rbd命令相关 #########################3

1：在test池中创建一个命名为kjh的10000M的镜像

[mon@ptmind~]# rbd create -p test --size 10000 kjh

2：查看ceph中一个pool里的所有镜像

[mon@ptmind~]# rbd ls test

kjh

3：查看新建的镜像的信息

[mon@ptmind~]# rbd -p test info kjh

4：查看ceph pool中一个镜像的信息

[mon@ptmind~]# rbd info -p test  --p_w_picpath kjh

rbd p_w_picpath 'kjh':

size 1000 MB in 250 objects

order 22 (4096 kB objects)

block_name_prefix: rb.0.92bd.74b0dc51

format: 1

5：删除一个镜像

[mon@ptmind~]# rbd rm  -p test  kjh

6：调整一个镜像的尺寸

[mon@ptmind~]# rbd resize -p test --size 20000 kjh

[mon@ptmind~]# rbd -p test info kjh   #调整后的镜像大小

rbd p_w_picpath 'kjh':

size 2000 MB in 500 objects

order 22 (4096 kB objects)

block_name_prefix: rb.0.92c1.74b0dc51

format: 1

#########rbd pool 快照功能测试###########

1：新建个pool叫’ptmindpool’同时在下面创建一个’kjhp_w_picpath’

[mon@ptmind~]# ceph osd pool create ptmindpool 256 256

pool 'ptmindpool' created

2:创建镜像

[mon@ptmind~]# rbd create kjhp_w_picpath --size 1024 --pool ptmindpool

3:查看镜像

[mon@ptmind~]# rbd --pool ptmindpool ls

kjhp_w_picpath

4:创建snap,快照名字叫’snapkjhp_w_picpath’

[mon@ptmind~]# rbd snap create ptmindpool/kjhp_w_picpath@snapkjhp_w_picpath

5:查看kjhp_w_picpath的snap

[mon@ptmind~]# rbd snap ls ptmindpool/kjhp_w_picpath

SNAPID NAME         SIZE

2 snapkjhp_w_picpath 1024 MB

6:回滚快照，

[mon@ptmind~]# rbd snap rollback ptmindpool/kjhp_w_picpath@snapkjhp_w_picpath

7:删除snap 删除snap报（rbd: snapshot 'snapshot-xxxx' is protected from removal.）写保护 ，使用 rbd snap unprotect volumes/snapshot-xxx' 解锁，然后再删除

[mon@ptmind~]# rbd snap rm ptmindpool/kjhp_w_picpath@snapkjhp_w_picpath

8:删除kjhp_w_picpath的全部snapshot

[mon@ptmind~]# rbd snap purge ptmindpool/kjhp_w_picpath

9: 把ceph pool中的一个镜像导出

导出镜像

[mon@ptmind~]# rbd export -p ptmindpool --p_w_picpath kjhp_w_picpath /tmp/kjhp_w_picpath.img

Exporting p_w_picpath: 100% complete...done.

验证查看导出文件

l /tmp/kjhp_w_picpath.img

-rw-r--r-- 1 root root 1073741824 Sep 24 23:15 /tmp/kjhp_w_picpath.img

10:把一个镜像导入ceph中

[mon@ptmind~]# rbd import /tmp/kjhp_w_picpath.img  -p ptmindpool --p_w_picpath importmyp_w_picpath1

Importing p_w_picpath: 100% complete...done.

验证查看导入镜像文件

rbd -pptmindpool ls

importmyp_w_picpath1