注意

本文档适用于 Ceph 的开发版本。

monmaptool -- ceph monitor cluster map manipulation tool

概要

monmaptool <action> [options] mapfilename

描述

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。按优先顺序排列如下:

  1. --monmap filename 用于指定要加载的 monmap

  2. --mon-host 'host1,ip2' 用于指定主机或 IP 地址列表

  3. [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)以获取更多信息。

另请参阅

ceph(8), crushtool(8),

由 Ceph 基金会为您呈现

Ceph 文档是由非营利性 Ceph 基金会 资助和托管的社区资源。如果您希望支持这项工作和我们的其他努力,请考虑 立即加入