FastCFS is a block based standard file system which can be used as the back-end storage of databases, such as MySQL, PostgresSQL, Oracle etc.
V1.1.0
- Linux: Kernel version >= 3.10 (Full support)
- MacOS or FreeBSD (Only server side)
- libfuse (version 3.9.4 or newer)
- libfastcommon (tag: V1.0.45)
- libserverframe (tag: V1.1.1)
- fastDIR (tag: V1.1.0)
- faststore (tag: V1.1.0)
- FastCFS (tag: V1.1.0)
libfuse可以采用脚本libfuse_setup.sh一键编译和安装。
libfastcommon、libserverframe、fastDIR、faststore和FastCFS 五个安装包可采用 fastcfs.sh 脚本统一安装配置,也可以按照5.1 - 5.6部分独立安装配置。
统一安装方式
git clone https://github.com/happyfish100/FastCFS.git; cd FastCFS/
通过执行fastcfs.sh脚本,可自动从github仓库拉取或更新五个仓库代码,按照依赖顺序进行编译、安装,并能根据配置文件模版自动生成集群相关配置文件。
fastcfs.sh 命令参数说明:
- pull -- 从github拉取或更新代码库(拉取到本地build目录)
- makeinstall -- 顺序编译、安装代码库(make && make install)
- init -- 初始化集群目录、配置文件(已存在不会重新生成)
- clean -- 清除已编译程序文件(相当于make clean)
一键搭建(包括部署和运行)demo环境(需要root身份执行):
./helloWorld.sh --prefix=/usr/local/fastcfs-test
或执行如下命令(需要root身份执行):
./libfuse_setup.sh
./fastcfs.sh pull
./fastcfs.sh makeinstall
IP=$(ifconfig -a | grep -w inet | grep -v 127.0.0.1 | awk '{print $2}' | tr -d 'addr:' | head -n 1)
./fastcfs.sh init \
--dir-path=/usr/local/fastcfs-test/fastdir \
--dir-server-count=1 \
--dir-host=$IP \
--dir-cluster-port=11011 \
--dir-service-port=21011 \
--dir-bind-addr= \
--store-path=/usr/local/fastcfs-test/faststore \
--store-server-count=1 \
--store-host=$IP \
--store-cluster-port=31011 \
--store-service-port=41011 \
--store-replica-port=51011 \
--store-bind-addr= \
--fuse-path=/usr/local/fastcfs-test/fuse \
--fuse-mount-point=/usr/local/fastcfs-test/fuse/fuse1
注:--fuse-mount-point为mount到本地的路径,通过这个mount point对FastCFS进行文件存取访问。
FCFS_SHELL_PATH=$(pwd)/build/shell
$FCFS_SHELL_PATH/fastdir-cluster.sh restart
$FCFS_SHELL_PATH/faststore-cluster.sh restart
$FCFS_SHELL_PATH/fuse.sh restart
上述操作完成后,通过命令 df -h 可以看到FastCFS挂载的文件目录。
git clone https://github.com/happyfish100/libfastcommon.git; cd libfastcommon/
git checkout master
./make.sh clean && ./make.sh && ./make.sh install
默认安装目录:
/usr/lib64
/usr/lib
/usr/include/fastcommon
git clone https://github.com/happyfish100/libserverframe.git; cd libserverframe/
./make.sh clean && ./make.sh && ./make.sh install
git clone https://github.com/happyfish100/fastDIR.git; cd fastDIR/
./make.sh clean && ./make.sh && ./make.sh install
mkdir /etc/fdir/
cp conf/server.conf conf/client.conf conf/cluster_servers.conf /etc/fdir/
git clone https://github.com/happyfish100/faststore.git; cd faststore/
./make.sh clean && ./make.sh && ./make.sh install
mkdir /etc/fstore/
cp conf/server.conf conf/client.conf conf/servers.conf conf/cluster.conf conf/storage.conf /etc/fstore/
构建libfuse需要先安装meson和ninja。安装meson和ninja需要python3.5及以上版本。
包名:python3 python3-pip
Ubuntu下安装命令:
apt install python3 python3-pip -y
CentOS下安装命令:
yum install python3 python3-pip -y
pip3 install meson
pip3 install ninja
Ubuntu下安装命令:
apt install gcc g++ -y
CentOS下安装命令:
yum install gcc gcc-c++ -y
git clone https://github.com/libfuse/libfuse.git
cd libfuse/
git checkout fuse-3.10.1
mkdir build/; cd build/
meson ..
meson configure -D prefix=/usr
meson configure -D examples=false
ninja && ninja install
sed -i 's/#user_allow_other/user_allow_other/g' /etc/fuse.conf
git clone https://github.com/happyfish100/FastCFS.git; cd FastCFS/
./make.sh clean && ./make.sh && ./make.sh install
mkdir /etc/fcfs/
cp conf/fuse.conf /etc/fcfs/
In order to control FastCFS's performance, we provide highly configurable and tunable behavior for FastCFS via various settings.
FastCFS's configuration comprise multiple subfiles, one entry file and others use to reference. The directory /etc/fstore is the default location for FastCFS's config files, but when install multiple FastCFS instances on a single server, you must specify distinct location for each one.
FastCFS has the following config files:
- server.conf - Server global properties config
- cluster.conf - Cluster properties config
- servers.conf - Server group properties config
- storage.conf - Storage properties config
- client.conf - Use with client,need to reference cluster.conf
base_path = /path/to/faststore
base_path设置的目录必须是已存在。
各服务器的host参数设置的主机名必须是有效的,能够根据主机名获取到IP地址,或者直接设置成IP地址。
store-path-1 = /path/to/faststore/data1 store-path-2 = /path/to/faststore/data2 write-cache-path-1 = /path/to/faststore/cache
Coming soon.
FastCFS is an Open Source software released under the GNU AFFERO General Public License V3 (AGPL v3).