客户端

环境依赖

  • 插入内核FUSE模

  • 安装libfuse

modprobe fuse
yum install -y fuse

配置文件

fuse.json

{
  "mountPoint": "/cfs/mountpoint",
  "volName": "ltptest",
  "owner": "ltptest",
  "masterAddr": "10.196.59.198:17010,10.196.59.199:17010,10.196.59.200:17010",
  "logDir": "/cfs/client/log",
  "logLevel": "info",
  "profPort": "27510"
}
配置选项

名称

类型

描述

必需

mountPoint

string

挂载点

volName

string

卷名称

owner

string

所有者

masterAddr

string

Master节点地址

logDir

string

日志存放路径

logLevel

string

日志级别:debug, info, warn, error

profPort

string

golang pprof调试端口

exporterPort

string

prometheus获取监控数据端口

consulAddr

string

监控注册服务器地址

lookupValid

string

内核FUSE lookup有效期,单位:秒

attrValid

string

内核FUSE attribute有效期,单位:秒

icacheTimeout

string

客户端inode cache有效期,单位:秒

enSyncWrite

string

使能DirectIO同步写,即DirectIO强制数据节点落盘

autoInvalData

string

FUSE挂载使用AutoInvalData选项

ronly

bool

以只读方式挂载,默认为false

writecache

bool

利用内核FUSE的写缓存功能,需要内核FUSE模块支持写缓存,默认为false

keepcache

bool

保留内核页面缓存。此功能需要启用writecache选项,默认为false

token

string

如果创建卷时开启了enableToken,此参数填写对应权限的token

readRate

int

限制每秒读取次数,默认无限制

writeRate

int

限制每秒写入次数,默认无限制

followerRead

bool

从follower中读取数据,默认为false

accessKey

string

卷所属用户的鉴权密钥

secretKey

string

卷所属用户的鉴权密钥

disableDcache

bool

禁用Dentry缓存,默认为false

subdir

string

设置子目录挂载

fsyncOnClose

bool

文件关闭后执行fsync操作,默认为true

maxcpus

int

最大可使用的cpu核数,可限制client进程cpu使用率

enableXattr

bool

是否使用*xattr*,默认是false

enableBcache

bool

是否开启本地一级缓存,默认false

挂载

执行如下命令挂载客户端:

./cfs-client -c fuse.json

如果使用示例的``fuse.json``,则客户端被挂载到``/mnt/fuse``。所有针对``/mnt/fuse``的操作都将被作用于CubeFS。

卸载

建议使用标准的Linux umount 命令终止挂载。

预热

执行如下命令预热文件或者目录:

./cfs-preload -c preload.json
{
   "target":"/",
   "volumeName": "cold4",
   "masterAddr": "10.177.69.105:17010,10.177.69.106:17010,10.177.117.108:17010",
   "logDir": "/mnt/hgfs/share/cfs-client-test",
   "logLevel": "debug",
   "ttl": "100",
   "replicaNum": "1",
   "zones": "",
   "action":"clear",
   "traverseDirConcurrency":"4",
   "preloadFileConcurrency":"10",
   "preloadFileSizeLimit":"10737418240",
   "readBlockConcurrency":"10"
   "prof":"27520"
}
配置选项

名称

类型

描述

必需

target

string

要预热的目录或者文件

volName

string

卷名称

masterAddr

string

Master节点地址

logDir

string

日志存放路径

logLevel

string

日志级别:debug, info, warn, error

ttl

string

预热缓存生存期

action

string

预热行为:clear-清理预热缓存;preload-预热数据

replicaNum

string

预热数据副本数(1-16)

zones

string

预热副本所在zone

traverseDirConcurrency

string

遍历目录的任务并发数

preloadFileConcurrency

string

预热文件的并发数

preloadFileSizeLimit

string

预热文件的阈值,文件大小低于该阈值的文件才可以被预热

readBlockConcurrency

string

从纠删卷读取数据的并发数

prof

string

golang pprof调试端口

一级缓存

部署在用户客户端的本地读cache服务,对于数据集有修改写,需要强一致的场景不建议使用。 部署缓存后,客户端需要增加以下挂载参数,重新挂载后缓存才能生效。

客户端缓存配置参数

名称

类型

描述

必需

maxStreamerLimit

string

文件元数据缓存数目

bcacheDir

string

需要开启读缓存的目录路径

启动命令

./cfs-bcache -c bcache.json

配置文件

{
   "cacheDir":"/home/service/var:1099511627776",
   "logDir":"/home/service/var/logs/cachelog",
   "logLevel":"warn"
}
缓存服务配置选项

名称

类型

描述

必需

cacheDir

string

缓存数据的本地存储路径:分配空间(单位Byte)

logDir

string

日志路径

logLevel

string

日志级别