MapRFS native driver

MapR-FS native driver 是基于共享文件系统服务的一个插件,它提供了对 MapR-FS 分布式文件系统上数据的的高吞吐量访问,该文件系统旨在存储非常大量的数据。

在该驱动程序中,共享文件系统服务的共享是一个 MapR-FS 中的卷。实例通过 (mapr-posix) 客户端直接与 MapR-FS 存储后端通信。要挂载 MapR-FS 卷,需要 MapR POSIX 客户端。对每个共享的访问权限由用户和组基于访问类型控制,这与 MapR-FS ACE 保持一致,以支持对多个用户和组的访问控制。如果用户名和组名相同,则默认使用组访问类型。

更多详细信息,请参阅 MapR 文档

网络配置

存储后端和共享文件系统服务主机应位于扁平网络中。否则,它们之间应存在 L3 可达性。

支持的共享文件系统和操作

该驱动程序支持 MapR-FS 共享。

支持以下操作

  • 创建 MapR-FS 共享。

  • 删除 MapR-FS 共享。

  • 允许 MapR-FS 共享访问。

    • 仅支持用户和组访问类型。

    • 支持访问级别 (ro/rw)。

  • 拒绝 MapR-FS 共享访问。

  • 更新 MapR-FS 共享访问。

  • 创建快照。

  • 删除快照。

  • 从快照创建共享。

  • 扩展共享。

  • 缩小共享。

  • 管理共享。

  • 取消管理共享。

  • 管理快照。

  • 取消管理快照。

  • 确保共享。

需求

  • 在存储后端安装 MapR 核心软件包,版本 >= 5.2.x。

  • 要启用快照,MapR 集群应至少具有 M5 许可证。

  • 建立共享文件系统服务主机与存储后端之间的网络连接。

  • 获取一个 ticket,用于将访问 MapR-FS 的用户。

后端配置 (manila.conf)

将 MapR-FS 协议添加到 enabled_share_protocols

enabled_share_protocols = MAPRFS

为 MapR-FS 后端创建一个部分。示例

[maprfs]
driver_handles_share_servers = False
share_driver =
manila.share.drivers.maprfs.maprfs_native.MapRFSNativeShareDriver
maprfs_clinode_ip = example
maprfs_ssh_name = mapr
maprfs_ssh_pw = mapr
share_backend_name = maprfs

driver-handles-share-servers 设置为 False,因为该驱动程序不管理 share-servers 的生命周期。

将驱动程序后端添加到 enabled_share_backends

enabled_share_backends = maprfs

驱动程序选项

下表包含特定于此驱动程序的配置选项。

MapRFS 共享驱动程序配置选项的描述

配置选项 = 默认值

描述

[DEFAULT]

maprfs_base_volume_dir = /

(字符串) 在 MapRFS 中必须创建共享卷的路径。

maprfs_cldb_ip = None

(列表) CLDB 节点的 IP 或主机名列表。

maprfs_clinode_ip = None

(列表) 安装 mapr-core 的节点的 IP 或主机名列表。

maprfs_rename_managed_volume = True

(布尔值) 指定在开始管理时是否应重命名现有卷。

maprfs_ssh_name = mapr

(字符串) 集群管理员用户 ssh 登录名。

maprfs_ssh_port = 22

(端口号) CLDB 节点 SSH 端口。

maprfs_ssh_private_key = None

(字符串) 用于登录的 SSH 私钥的路径。

maprfs_ssh_pw = None

(字符串) 集群节点 SSH 登录密码。如果配置了 ‘maprfs_ssh_private_key’,则此参数不是必需的。

maprfs_zookeeper_ip = None

(列表) ZooKeeper 节点的 IP 或主机名列表。

已知限制

该驱动程序不处理用户身份验证,该驱动程序不会创建任何 ticket 或用户。这意味着当调用 ‘access_allow’ 或 ‘update_access’ 时,如果没有为用户提供 ticket,则不会产生任何效果。

共享元数据

可以通过指定附加选项来创建 MapR-FS 共享。为此使用元数据。每个带有 - 前缀的元数据选项都传递给 MapR-FS 卷。例如,要指定建议的卷配额,请将 _advisoryquota=10G 选项添加到元数据

$ manila create MAPRFS 1 --metadata _advisoryquota=10G

如果您需要使用自定义后端名称或导出位置而不是 uuid 创建共享,您可以指定 _name_path 选项

$ manila create MAPRFS 1 --metadata _name=example _path=/example

警告

指定无效选项将导致错误。

允许的选项列表取决于 mapr-core 版本。有关更多信息,请参阅 volume create