FAQ

1. 服务器最低配置要求

2核CPU、4G内存、10G硬盘

2. 网络连接异常

当日志出现Connection refused或者Transport endpoint is not connected之类的异常记录。 请检查防火墙设置。FastCFS 共有9个服务端口,这些对应的端口应该打开：

• fdir
  • 默认集群端口 11011
  • 默认服务端口 11012
• fvote
  • 默认集群端口 41011
  • 默认服务端口 41012
• fauth
  • 默认集群端口 31011
  • 默认服务端口 31012
• fstore
  • 默认集群端口 21014
  • 默认副本端口 21015
  • 默认服务端口 21016

3. 服务有没有启动顺序？

有。应按顺序启动fvote（可选），fdir， fauth（可选），fstore，fuseclient。

4. FastCFS支持单盘数据恢复吗？

支持。
实现机制：从本组的其他服务器上获取数据，恢复指定硬盘（即存储路径）上的所有数据。
使用场景：硬盘坏掉后更换为新盘，或者因某种原因重新格式化硬盘。
单盘故障恢复后，重启fs_serverd时，加上命令行参数 --data-rebuild <store_path>，
其中 store_path为要恢复数据硬盘对应的存储路径。

5. FastCFS是如何防脑裂的？

leader/master选举时采用过半数机制，一个分组的节点数最好为奇数（比如3个）。
配置项为 quorum，默认值为auto，表示节点数为奇数时开启，为偶数时关闭。
详情参见源码目录下的conf/full/cluster.conf

v3.4引入公用选举节点，在偶数节点数（比如双副本）时也可以防脑裂，详情参见配置文档。

6. fdir和fstore多副本（如3副本）情况下，停机后重启不能写入数据

为了保证数据一致性，当停机时间超过配置参数max_shutdown_duration（默认配置300秒），
需要等待本组的其他服务器在线才可以选出master/leader。

以3副本为例，如果3台服务器停机均超过max_shutdown_duration，而有的服务器没有启动，
那么master/leader选举不出来，导致不能写入数据。此时启动fdir_serverd需要加上命令行
参数--force-master-election，启动fs_serverd需要加上命令行参数--force-leader-election

7. 如何验证多个副本的数据一致性？

faststore需要源码编译，修改make.sh，将
CFLAGS='-Wall'
修改为：
CFLAGS='-Wall -DFS_DUMP_SLICE_FOR_DEBUG=32'
启动fs_serverd，数据将导出到 $base_path/data/dump/slice.index，例如：
/opt/fastcfs/fstore/data/dump/slice.index

文件格式：
类型 文件ID block偏移量 slice偏移量 slice长度 数据长度 数据CRC32

可以通过 diff 命令比较同一组服务器下的两个节点导出的slice.index是否相同。

注意：-DFS_DUMP_SLICE_FOR_DEBUG=32 这个编译选项仅供测试环境进行数据一致性验证，请不要在生产环境使用。

8. fuse客户端通过df看到的空间明显大于存储池配额

这是因为客户端没有启用auth，需要将配置文件/etc/fastcfs/auth/auth.conf中的auth_enabled设置为true，修改后重启fcfs_fused生效。

友情提示：如何配置auth服务请参阅 认证配置文档

9. FastCFS作为NFS后端存储时NFS client mount失败

出错信息：reason given by server: No such file or directory

解决方法：

NFS v3直接使用服务端配置的目录如：/opt/fastcfs/fuse，而v4将服务端配置的路径作为基路径，mount要使用/

NFS挂载默认会使用最新的NFS协议，挂载命令示例（支持v4前提下使用）：

mount -t nfs -onolock 172.16.168.131:/ /mnt/nfs

NFS v3挂载命令示例：

mount -t nfs -onolock 172.16.168.131:/opt/fastcfs/fuse /mnt/nfs

指定NFS v4挂载命令示例：

mount -t nfs -onolock,nfsvers=4 172.16.168.131:/ /mnt/nfs

友情提示：

• CentOS 6需要使用NFS v3挂载
• /etc/exports中需要设置fsid=0，例如：/opt/fastcfs/fuse 172.16.168.130(fsid=0,rw,sync,no_root_squash,no_all_squash)

10. 为何删除了足够多的数据，df看到磁盘占用空间不见降低呢？

FastCFS基于trunk file进行空间分配，目前trunk file只会增加而不会释放。文件数据删除后空间会回收利用，通过fuse client上df命令可以看到FastCFS的可用空间将增加。

11. 如何将fastore的数据清除干净？

一些特殊情况下，需要清除掉faststore的数据，此时要删除faststore的系统目录（server.conf中配置的base_path，默认为/opt/fastcfs/fstore）和用户数据存放目录（默认为/opt/faststore/data，配置多盘的情况要逐一删除数据目录），删除命令示例（文件删除后不可恢复，请再三确认后执行）：

rm -rf /opt/fastcfs/fstore /opt/faststore/data

12. 日志中报没有访问权限，如何进行排查？

/opt/fastcfs/fcfs/logs/fcfs_fused.log 中的错误示例：

[2023-02-25 06:39:08] ERROR - file: client_proto.c, line: 607, fdir server 192.168.3.210:11012 response message: response status 1, error info: Operation not permitted

问题排查：

依次查看各台fdir server上的日志文件 /opt/fastcfs/fdir/logs/fdir_serverd.log，找到对应的出错信息，然后使用最新版本的fdir_stat 查看对应的完整路径（文件名），根据文件或目录owner、权限、访问用户及其用户组进行排查。

按文件或目录inode查询示例：

fdir_stat -Fn fs 9007199660325177

按父目录inode + 子目录名或者文件名查询示例：

fdir_stat -Fn fs 9007199667318991 test

友情提示：如果采用的是装包方式，程序fdir_stat 所在的rpm包名为fastDIR-client，deb包名为fastdir-client