轻量级分布式文件系统FastDFS使用安装说明手册（新手入门级）

实验室所在的课题组以研究云计算为主，但所有的研究都是在基于理论的凭空想像，缺少分布式环境的平台的实践，云计算神马的都是浮云了。因此，我想借助Hadoop把实验室的服务器搭建出一个基础的分布式实验环境，方便于以后进行实验测试神马的。无意中，看到了一款开源的轻量级分布式文件系统FastDFS，它是用纯C语言实现，详细信息可参见博客：分布式文件系统FastDFS架构剖析。通过收集资料，自己动手做了一些安装和测试使用，现在对前人的一些经验进行一些总结。

一、FastDFS的安装过程

（1）准备工作-安装libevent

FastDFS 内部绑定了 libevent 作为 http 服务器 ，在V2.X版本必须安装 libevent ，本文安装的是V2.2版本，因此必须安装libevent。官方也推荐使用 http 方式下载文件。

如果已经安装了 libevent，请确认安装路径是 /usr ， 因为 FastDFS 在编译源程序时，需要到此目录下查找一些依赖文件，否则编译FastDFS 会出错 。如果不是，建议首先卸载 libevent ，然后安装到 /usr 下。Ubuntu10.4默认是安装了libevent，可以到软件中心卸载掉然后按照下面介绍的方式安装。本文安装的是 libevent1.4.14b-stable，下载地址：http://monkey.org/~provos/libevent/

安装步骤：

 tar vxzf libevent1.4.14b-stable.tar.gz

./configure --prefix=/usr   

make clean;   

make   

make install

安装libevent完成。

（2）安装 FastDFS

1、下载 FastDFS 源程序，下载地址 http://code.google.com/p/fastdfs/downloads/list ，这里下载的是 FastDFS_v2.04.tar.gz ，建议安装V2.X版本，比V1.X版本更加稳定且性能提升明显）、

2、在 FastDFS_v2.04.tar.gz 所在文件夹下执行：

tar vxzf FastDFS_v2.04.tar.gz /home/monkey/FastDFS  

tar vxzf FastDFS_v2.04.tar.gz /home/monkey/FastDFS

     注：/home/monkey/FastDFS 也可以是其他目录，记住这是解压目录，以后用 %FastDFS% 表示）

3、由于要使用内置的 http 服务，因此编辑 %FastDFS%/make.sh 文件，找到#WITH_HTTPD=1，修改成WITH_HTTPD=1，以支持HTTP。

4、进入 %FastDFS% 目录，执行：

./make.sh  

./make.sh

5、在 %FastDFS% 目录下，执行：

./make.sh install  

./make.sh install

如果运行如上命令后，在命令行信息最后看到类似

#ln -fs /usr/local/lib/libfastcommon.so.1 /usr/local/lib/libfastcommon.so   

#ln -fs /usr/local/lib/libfdfsclient.so.1 /usr/local/lib/libfdfsclient.so   

sh ./fdfs_link_library.sh  

#ln -fs /usr/local/lib/libfastcommon.so.1 /usr/local/lib/libfastcommon.so

#ln -fs /usr/local/lib/libfdfsclient.so.1 /usr/local/lib/libfdfsclient.so

sh ./fdfs_link_library.sh

恭喜你，已经安装成功了！

二、FastDFS的配置说明

FastDFS的配置文件在%FastDFS%/conf目录下，其中包括：

client.confà客户端上传配置文件

storage.confà文件存储服务器配置文件

tracker.confà负责均衡调度服务器配置文件

http.confàhttp服务器配置文件

配置文件需要根据服务器环境的不同，进行不同的配置，具体可以参考FastDFS官方的安装配置文档http://code.google.com/p/fastdfs/wiki/Setup，以及FastDFS原理介绍文档http://code.google.com/p/fastdfs/wiki/Overview

在本例中，为了方便起见，Tracker Server，Storage Server都安装在一台服务器上，IP:211.69.205.1。

（1）配置及启动Tracker Server

1、修改%FastDFS%/conf/tracker.conf文件，修改如下：

#可以自己指定目录位置，但目录必须存在，用于存储日志及storage server等信息，否则tracker server无法启动。

base_path=/home/yuqing/fastdfsàbase_path=/home/monkey/fastdfs_tracker

#改成你想要的http端口，将来http下载文件的端口就是它了。

http.server_port=8080àhttp.server_port=8090

#http支持

##include http.confà#include http.conf

#默认4GB，如果空间不足，建议调小，否则会报no free space的异常，无法正常启动。

reserved_storage_space = 4GBàreserved_storage_space = 1GB

#tracker server对storage server供服务的端口，使用默认的即可，也可以自定义

port=22122  

2、将http.conf文件拷贝到/etc/fdfs目录下，执行：

       cp %FastDFS%/conf/http.conf /etc/fdfs/

cp %FastDFS%/conf/http.conf /etc/fdfs/

注：为了支持http，必须将这个文件拷贝到此目录，否则无法启动，报param http.XXX not exist or is empty类似的错误。

3、进入/usr/local/bin/目录，启动tracker服务器，执行：

fdfs_trackerd %FastDFS%/conf/tracker.conf  

dfs_trackerd %FastDFS%/conf/tracker.conf

4、进入/home/soar/fastdfs_tracker/logs/trackerd.log查看tracker的启动日志，如果看到类似：

[2010-11-26 21:33:44] INFO - FastDFS v2.04, base_path=/home/monkey/fastdfs_tracker, connect_timeout=30s, network_timeout=60s, port=22122, bind_addr=, max_connections=256, work_threads=4, store_lookup=2, store_group=, store_server=0, store_path=0, reserved_storage_space=1024MB, download_server=0, allow_ip_count=-1, sync_log_buff_interval=10s, check_active_interval=120s, thread_stack_size=64 KB, storage_ip_changed_auto_adjust=1, storage_sync_file_max_delay=86400s, storage_sync_file_max_time=300s

[2010-11-26 21:33:44] INFO - HTTP supported: server_port=8090, default_content_type=application/octet-stream, anti_steal_token=0, token_ttl=0s, anti_steal_secret_key length=0, token_check_fail content_type=, token_check_fail buff length=0, check_active_interval=30, check_active_type=tcp, check_active_uri=/status.html

 恭喜你，tracker server已经启动成功！

（2）配置及启动Storage Server

1、修改%FastDFS%/conf/storage.conf文件，修改如下：

#可以自定义，但必须存在此目录，用于存储storage相关的log、group内的相关信息

base_path=/home/yuqing/fastdfsà/home/monkey/fastdfs_storge  

#文件的存储位置，在一台storage server上可以指定多个存储位置

store_path0=/home/yuqing/fastdfsàstore_path0=/home/monkey/fastdfs_storge   

#必须指定

group_name=group1

#修改成tracker server的IP和端口信息

tracker_server=192.168.209.121:22122àtracker_server=211.69.205.1:22122

#http支持

##include http.confà#include http.conf   

2、进入/usr/local/bin/目录，启动storage服务器，执行

fdfs_storaged %FastDFS%/conf/storage.conf  

3、进入/home/monkey/fastdfs_tracker/logs/storage.log查看storage服务器启动日志，如果看到类似：

[2010-11-26 21:38:59] INFO - FastDFS v2.04, base_path=/home/monkey/fastdfs_storge, store_path_count=1, subdir_count_per_path=256, group_name=group1, connect_timeout=30s, network_timeout=60s, port=23000, bind_addr=, client_bind=1, max_connections=256, work_threads=4, disk_rw_separated=1, disk_reader_threads=1, disk_writer_threads=1, buff_size=256KB, heart_beat_interval=30s, stat_report_interval=60s, tracker_server_count=1, sync_wait_msec=200ms, sync_interval=0ms, sync_start_time=00:00, sync_end_time=23:59, write_mark_file_freq=500, allow_ip_count=-1, file_distribute_path_mode=0, file_distribute_rotate_count=100, fsync_after_written_bytes=0, sync_log_buff_interval=10s, sync_binlog_buff_interval=60s, sync_stat_file_interval=300s, thread_stack_size=512 KB, upload_priority=10, if_alias_prefix=, check_file_duplicate=0, FDHT group count=0, FDHT server count=0, FDHT key_namespace=, FDHT keep_alive=0, HTTP server port=8888, domain name=

[2010-11-26 21:38:59] INFO - HTTP supported: server_port=8888, http_trunk_size=262144, default_content_type=application/octet-stream, anti_steal_token=0, token_ttl=0s, anti_steal_secret_key length=0, token_check_fail content_type=, token_check_fail buff length=0

[2010-11-26 21:39:29] INFO - file: storage_param_getter.c, line: 48, storage_ip_changed_auto_adjust=1

[2010-11-26 21:39:30] INFO - file: tracker_client_thread.c, line: 274, successfully connect to tracker server 211.69.205.1:22122, as a tracker client, my ip is 211.69.205.1

恭喜你，storage server已经启动成功！

 
三、FastDFS使用举例说明

经过前面的按照、配置、启动，马上就可以看到FastDFS的效果了，我们先上传一个文件，然后再通过http下载。

（1）上传文件

FastDFS安装包中，自带了客户端程序，通过程序可以进行文件上传。在使用这个客户端程序之前，首先需要配置client.conf，然后再进行文件上传及下载。

1、修改%FastDFS%/conf/client.conf文件，修改如下：

#可自定义，但此目录必须存在，用于存放文件上传log

base_path=/home/yuqing/fastdfsàbase_path=/home/monkey/fastdfs_tracker

tracker_server=192.168.209.121:22122àtracker_server=211.69.205.1:22122

http.tracker_server_port=8080àhttp.tracker_server_port=8090

##include http.confà#include http.conf

2、进入/usr/local/bin/目录，上传文件，执行：

fdfs_test %FastDFS%/conf/client.conf upload monkey.txt   

注：monkey.txt可以在/usr/local/bin/目录下自己创建一个。

如果命令行反馈类似如下，则说明上传文件成功。

（2）下载文件

在浏览器中，输入上图中的url地址， tracker server会自动重定向到存储文件的storage server，文件下载成功。至此，已经成功搭建了FastDFS，编写你自己的client来进行访问吧：）

轻量级分布式文件系统FastDFS使用安装说明手册（新手入门级）