ceph-mgr 管理员指南¶

手动设置¶

平时，你可以用 ceph-ansible 之类的工具配置 ceph-mgr 守护进程。下面说明了如何手动配置好一个 ceph-mgr 守护进程。

首先，给守护进程创建认证密钥：

ceph auth get-or-create mgr.$name mon 'allow profile mgr' osd 'allow *' mds 'allow *'

把创建的密钥放入 mgr data 所指向的路径，对于名为 ceph 的集群、 mgr 的 $name 为 foo 的路径可能是 /var/lib/ceph/mgr/ceph-foo 。

启动 ceph-mgr 守护进程：

ceph-mgr -i $name

通过 ceph status 的输出可检查 mgr 是否起来了，起来的话应该会包含一行 mgr 状态：

mgr active: $name

客户端认证¶

管理器是一种新的守护进程，需要新的 CephX 能力。如果你是从旧版 Ceph 升级集群、或者使用默认的安装/部署工具，那么管理客户端应该可以自动获取到这个能力。如果你用了非标准工具，在调用某些 ceph 集群命令时可能会遇到 EACCES 错误。要修正此问题，需更改用户能力，在客户端的 cephx 能力里加上 mgr allow \* 声明。

高可用性¶

通常来说，你应该在每台运行 ceph-mon 守护进程的主机上都配置一个 ceph-mgr ，以实现相同级别的可用性。

默认情况下，监视器会把任意一个最先启动的 ceph-mgr 例程当作活跃的，其它的作为备用。 ceph-mgr 守护进程无需形成法定人数。

如果活跃的守护进程在 mon mgr beacon grace （默认 30s ）这么长的时间内都没向监视器们发送信标，那它就会被备用顶替。

如果你想提前做故障切换，可以用 ceph mgr fail <mgr name> 把 ceph-mgr 明确地标记为已失效。

模块的使用¶

用 ceph mgr module ls 命令可查看有哪些模块可用、哪些是当前已经启用的。启用或禁用模块分别使用命令 ceph mgr module enable <module> 和 ceph mgr module disable <module> 。

If a module is enabled then the active ceph-mgr daemon will load and execute it. In the case of modules that provide a service, such as an HTTP server, the module may publish its address when it is loaded. To see the addresses of such modules, use the command ceph mgr services.

Some modules may also implement a special standby mode which runs on standby ceph-mgr daemons as well as the active daemon. This enables modules that provide services to redirect their clients to the active daemon, if the client tries to connect to a standby.

Consult the documentation pages for individual manager modules for more information about what functionality each module provides.

Here is an example of enabling the Dashboard module:

$ ceph mgr module ls
{
        "enabled_modules": [
                "restful",
                "status"
        ],
        "disabled_modules": [
                "dashboard"
        ]
}

$ ceph mgr module enable dashboard
$ ceph mgr module ls
{
        "enabled_modules": [
                "restful",
                "status",
                "dashboard"
        ],
        "disabled_modules": [
        ]
}

$ ceph mgr services
{
        "dashboard": "http://myserver.com:7789/",
        "restful": "https://myserver.com:8789/"
}

The first time the cluster starts, it uses the mgr_initial_modules setting to override which modules to enable. However, this setting is ignored through the rest of the lifetime of the cluster: only use it for bootstrapping. For example, before starting your monitor daemons for the first time, you might add a section like this to your ceph.conf:

[mon]
    mgr initial modules = dashboard balancer

调用模块命令¶

对于实现了命令行钩子的模块，其实现的命令可以像一般的 Ceph 命令那样调用：

ceph <command | help>

如果你想查看管理器可以处理的命令列表（通常 ceph help 会显示所有 mon 和 mgr 命令），你可以直接向管理器守护进程发命令：

ceph tell mgr help

注意，没必要盯住具体的 mgr 例程，用 mgr 会自动选当前活跃的守护进程。

配置选项¶

mgr module path

描述: 从这个路径载人模块
类型: String
默认值: "<library dir>/mgr"

mgr data

描述: 从这个路径载人守护进程数据（如密钥环）
类型: String
默认值: "/var/lib/ceph/mgr/$cluster-$id"

mgr tick period

描述: mgr 向监视器发送信标、以及其它周期性检查的时间间隔，单位为秒。
类型: Integer
默认值: 5

mon mgr beacon grace

描述: 上一个信标收到后过多久没反应就当它失败了。
类型: Integer
默认值: 30