注意
本文档适用于 Ceph 的开发版本。
在 Windows 上挂载 CephFS
使用 ceph-dokan 在 Windows 上挂载 CephFS 文件系统。它利用 Dokany,这是一个 Windows 驱动程序,允许以类似于 FUSE 的方式在用户空间中实现文件系统。
请参阅安装指南以开始使用。
注意
有关客户端软件包支持的信息,请参阅操作系统建议。
用法
挂载文件系统
运行以下命令来挂载 Ceph 文件系统
ceph-dokan.exe -c c:\ceph.conf -l x
此命令使用驱动器号 x 挂载默认的 Ceph 文件系统。如果 ceph.conf 存在于默认位置 (%ProgramData%\ceph\ceph.conf),则此参数是可选的。
-l 参数允许使用空文件夹作为挂载点而不是驱动器号。
用于挂载文件系统的 uid 和 gid 默认为 0,可以使用以下 ceph.conf 选项进行更改
[client]
# client_permissions = true
client_mount_uid = 1000
client_mount_gid = 1000
如果您的 Ceph 集群上有多个文件系统,请使用 --client_fs 选项来挂载非默认文件系统
mkdir -Force C:\mnt\mycephfs2
ceph-dokan.exe --mountpoint C:\mnt\mycephfs2 --client_fs mycephfs2
使用 --root-path 参数挂载 CephFS 子目录
ceph-dokan -l y --root-path /a
如果设置了 -o --removable 标志,挂载将显示在 Get-Volume 结果中
PS C:\> Get-Volume -FriendlyName "Ceph*" | `
Select-Object -Property @("DriveLetter", "Filesystem", "FilesystemLabel")
DriveLetter Filesystem FilesystemLabel
----------- ---------- ---------------
Z Ceph Ceph
W Ceph Ceph - new_fs
运行 ceph-dokan --help 以获取完整的参数列表。
凭证
--id 选项传递 CephX 用户的名称,在挂载 CephFS 文件系统时使用其密钥环。以下命令是等效的
ceph-dokan --id foo -l x
ceph-dokan --name client.foo -l x
卸载文件系统 -----------------=-----
可以通过发出 ctrl-c 或使用 unmap 命令来移除挂载,如下所示
ceph-dokan.exe unmap -l x
注意
卸载 CephFS 文件系统时,您必须指定创建映射时使用的挂载点参数。
限制
Windows ACL 被忽略。支持 Posix ACL,但不能使用当前的 CLI 进行修改。将来,我们可能会添加更改文件所有权或权限的命令操作。
CephFS 不支持强制文件锁,而 Windows 非常依赖它。Ceph 依赖 Dokan 来处理文件锁,这些锁仅在本地强制执行。
与 rbd-wnbd 不同,ceph-dokan 不提供 service 命令。要确保 CephFS 挂载在其主机重启后仍然存在,请使用 NSSM。
故障排除
请参阅Windows 故障排除页面。