TFS使用文档-安装篇

TFS(Taobao FileSystem)是一个高可扩展、高可用、高性能、面向互联网服务的分布式文件系统,其设计目标是支持海量的非结构化数据的存储;TFS使用C++语言开发,需要运行在64bit Linux OS上,本文介绍如何在Linux环境编译安装TFS。

安装依赖的软件包

  • automake TFS基于automake工具构建

  • libtool automake需要使用libtool

  • realine 用于命令行编辑的库

  • libz-devel 用于数据压缩/解压缩

  • uuid-devel 用于生成全局唯一ID

  • tcmalloc google的内存管理库

    • 下载源码安装

    • apt-get install libgoogle-perftools-dev

    • yum install google-perftools.x86_64

安装tb-common-utils

TFS使用tb-common-utils软件包,tb-common-utils包含淘宝使用的基础系统库tbsys和网络库tbnet两个组件;安装tb-common-utils前需要设置环境变量TBLIB_ROOT,tbsys和tbnet将会被安装TBLIB_ROOT对应的路径(必须是绝对路径)下,TFS会在这个路径下查找tbsys、tbnet头文件和库。

设置TBLIB_ROOT环境变量

在~/.bash_profile文件中加入,export TBLIB_ROOT=path_to_tbutil , 然后执行source ~/.bash_profile

下载源码

# svn co -r 18 http://code.taobao.org/svn/tb-common-utils/trunk tb-common-utils
注意: 这里不要checkout最新版本,version18以后的修改导致部分接口不能前向兼容。

编译安装

# cd tb-common-utils
# sh build.sh

如果一切顺利,tb-common-utils已经安装成功到$TBLIB_ROOT路径下;如遇到问题请先阅读后面的编译FAQ

安装TFS

TFS开源用户大都只使用TFS的基本功能,所以这个版本我们默认只编译TFS的nameserver,dataserver,client和tool,以去除对mysql的依赖,需要使用到rcserver(全局资源管理服务),metaserver(TFS自定义文件名服务)的用户请自行编译安装这两个服务。

下载源码

# svn co http://code.taobao.org/svn/tfs/branches/dev_for_outer_users tfs

编译安装

# cd tfs
# sh build.sh init
# ./configure --prefix=path_to_tfs --with-release
# make
# make install
  • –prefix 指定tfs安装路径,默认会被安装到~/tfs_bin目录

  • –with-release 指定按release版本的参数进行编译,如果不指定这个参数,则会按开发版本比较严格的参数编译,包含-Werror参数,所有的警告都会被当错误,在高版本gcc下会导致项目编译不过,很多开源用户反馈的编译问题都跟这个有关,因为gcc高版本对代码的检查越来越严格,淘宝内部使用的gcc版本是gcc-4.1.2。

至此,TFS已经安装成功了,你可以开始部署TFS服务

编译FAQ

Q: 使用TFS一定需要64bit Liunx?
A: 是的,否则整个项目不能正常编译通过。

Q: 编译TFS过程中出现出现类似tbnet.h:39: fatal error: tbsys.h: No such file or directory的错误提示?
A: 需要先安装tb-common-utils软件包。

Q: 在安装tb-common-utils过程中,提示设置please set TBLIB_ROOT varialbe first!!?
A: 需要先设置TBLIB_ROOT环境变量,再编译安装tb-common-utils。

Q: 编译过程中出现类似警告:格式 ‘%lu’ 需要类型 ‘long unsigned int’,但实参 3 的类型为 ‘size_t’ ?
A: 你的机器使用的应该是32bit OS,如果你坚持要编译,可以自行修改代码或者直接忽略这些警告。

Q: 执行./configure时,提示configure: error: readline header files not found, --disable-readline or install gnu readline library?
A: 你需要安装readline库,或在configure时加上--disable-readline参数,不使用readline库。

Q: 执行./configure时,提示configure: error: tcmalloc link failed (--without-tcmalloc to disable)?
A: 你需要安装tcmalloc库, 或在configure时加上--without-tcmalloc参数,不使用tcmalloc库。

Q: 编译过程中出现大量的错误信息,类似于warnings being treated as error?
A: 请确认在./configure的时候是否加了--with-release参数。

Q: 编译过程中提示类似client_request_server.cpp:722:38: error: no matching function for call to ‘atomic_inc(volatile uint64_t*)’的错误信息?
A: 你的系统时32位的,请在64bit Linux编译安装TFS;因为32bit系统不支持对64bit整数的原子操作。

Q: 编译时遇到session_util.cpp:2:23: fatal error: uuid/uuid.h: No such file or directory?
A: 你需要先安装uuid库, 用于生成全局唯一ID, uuid库是e2fsprogs包工具的一部分;

Q: 编译时提示tfs_meta_helper.cpp:15:18: fatal error: zlib.h: No such file or directory?
A: 你需要先安装zlib,用于压缩/解压缩。

有问题或建议请直接留言,或微博@淘宝TFS。


本文出自 “XFICC” 博客,请务必保留此出处http://xficc.blog.51cto.com/1189288/1573268

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。