注意
本文档适用于 Ceph 的开发版本。
monmaptool -- ceph monitor cluster map manipulation tool
概要
描述
monmaptool 是一个用于创建、查看和修改 Ceph 分布式存储系统监控器集群映射的实用程序。监控器映射指定了 Ceph 分布式系统中唯一的固定地址。所有其他守护程序绑定到任意地址并将自己注册到监控器。
当使用 --create 创建映射时,将创建一个具有新的随机 UUID 的新监控器映射。之后应跟上一个或多个监控器地址。
信使协议 v1 的默认 Ceph 监控器端口是 6789,协议 v2 的默认端口是 3300。
每次调用可以执行多个操作。
选项
- --print
在进行任何修改后,打印映射的纯文本转储。
- --feature-list [plain|parseable]
列出已启用的功能以及可用功能。
默认情况下,会生成人类可读的输出。
- --create
创建一个具有新 UUID 的新监控器映射(以及一个新的空 Ceph 集群)。
- --clobber
允许 monmaptool 在现有映射的位置创建新的 mapfilename。
仅在使用了 --create 时有用。
- --generate
根据命令行或 ceph 配置中指定的值生成新的 monmap。按优先顺序排列如下:
--monmap filename用于指定要加载的 monmap--mon-host 'host1,ip2'用于指定主机或 IP 地址列表[mon.foo]部分包含配置中的mon addr设置。请注意,不推荐使用此方法,并且在未来的版本中将删除支持。
- --filter-initial-members
通过应用
mon initial members设置来过滤初始 monmap。不在该列表中的监控器将被删除,而不在映射中的初始成员将使用虚拟地址添加。
- --add name ip[:port]
将具有指定 ip:port 的监控器添加到映射中。
如果设置了 nautilus 功能,且未指定端口,则监控器将同时为两种信使协议添加。
- --addv name [protocol:ip:port[,...]]
将具有指定 version:ip:port 的监控器添加到映射中。
- --rm name
从映射中移除具有指定名称的监控器。
- --fsid uuid
将 fsid 设置为给定的 uuid。如果未使用 --create 指定,将生成一个随机 fsid。
- --feature-set value [--optional|--persistent]
启用一个功能。
- --feature-unset value [--optional|--persistent]
禁用一个功能。
- --enable-all-features
启用所有支持的功能。
- --set-min-mon-release release
设置 min_mon_release。
示例
要创建一个包含三个监控器的新映射(用于一个新的 Ceph 集群)
monmaptool --create --add nodeA 192.168.0.10 --add nodeB 192.168.0.11 \
--add nodeC 192.168.0.12 --enable-all-features --clobber monmap
要显示映射内容
monmaptool --print monmap
要替换一个监控器
monmaptool --rm nodeA monmap
monmaptool --add nodeA 192.168.0.9 monmap
可用性
monmaptool 是 Ceph 的一部分,Ceph 是一个大规模可扩展、开源的分布式存储系统。请参阅 Ceph 文档(网址为 https://docs.ceph.net.cn)以获取更多信息。