#集群文件系统

# 系统概述

崖山集群文件系统（后续简称YFS）是YashanDB的一个用户态存储服务组件，提供了文件系统以及磁盘组管理能力，用于管理共享磁阵。

通过YFS，用户可实现共享磁阵上基本的文件/文件夹的创建、删除、浏览等功能。此外，YFS还提供了管理diskgroup（磁盘组）、failuregroup（故障组）等重要特性，以支持共享集群的存储高可用。

YFS绕过系统缓冲，对磁盘设备直接IO，以同步方式写入块设备和直接读取块设备，达到接近裸设备的性能指标。

在共享集群部署模式下，YFS管理挂载在各集群服务器的共享磁阵，对外提供一致和高效的文件管理接口。

YashanDB通过YFS实现共享集群多服务器并发读写，充分释放集群系统的计算能力。

用户可以通过专用工具yfscmd管理 YFS，进行基本的文件管理操作，与一般文件系统类似，例如目录或文件的创建、删除等。

YFS还提供丰富的API接口，客户程序（例如YashanDB）通过调用这些API执行存储管理，实现组件可插拔。

YFS API兼容一般文件系统的大多数操作。

YFS通过磁盘组（diskgroup）的方式管理磁盘设备，内部通过多个故障组和多副本机制，支持数据高可用。同时提供可配置的冗余级别，方便用户根据业务特征决定数据冗余度。

YFS除通过磁盘组实现数据高可用之外，还支持服务高可用。当集群服务器数发生变化或个别服务器异常退出时，YFS可进行自动调整，恢复服务能力。

同时，由于YFS内部采用了与DB相同的redo和checkpoint机制，用于保证YFS状态的一致性和可靠性，因此当整个集群发生异常重启时，系统能够自动从异常中恢复服务。

目前YFS服务属于YCS管理的子模块，YFS启停被纳入于YCS的启停流程中。

##首次启动YFS需指定-F参数
$ ycsctl start ycs -F

##后续启动YFS不要指定-F参数
$ ycsctl start ycs

##停止YFS
$ ycsctl stop ycs

Caution：

1.首次启动YFS时应当指定 -F参数，以便初始化 YFS 的元数据。之后再启动时请不要指定 -F参数，否则会清空整个YFS的数据。

2.YashanDB的安装过程中已执行-F参数首次启动YFS，后续请不要再选择此参数，避免数据丢失和系统异常。