1.安装依赖软件
为了编译和运行KFS文件系统,需要安装以下软件包:
- Boost (1.34或以上)
- cmake (2.4.6或以上)
- log4cpp (1.0或以上)
- gcc version (4.1或以上)
- xfs devel RPMs on Linux
下面介绍的是手动安装以上软件包的过程,这里假设你已经下载完成软件包压缩文件。
1、安装gcc
tar zxvf gcc-4.1.2.tar.gz
mkdir/usr/local/gcc-4.1.2
cd gcc-4.1.2
./configure --prefix=/usr/local/gcc-4.1.2 --enable-threads=posix --disable-checking --enable--long-long --host=i386-redhat-linux--with-system-zlib --enable-languages=c,c++,java
make
make install
备注:以上过程将gcc安装在/usr/local/gcc-4.1.2目录下,支持C/C++和JAVA语言,其它选项参见gcc提供的帮助说明。
2、安装log4cpp
tar xvzf log4cpp-1.0.tar.gz
cd log4cpp-1.0
./configure
make
make install
3、安装xfs
tar xvzf xfsprogs-3.0.1.tar.gz
cd xfsprogs-3.0.1
./configure
make
make install
make install-dev
4、安装cmake
tar xvzf cmake-2.6.4.tar.gz
cd cmake-2.6.4
./bootstrap
make
make install
5、安装boost
tar xvzf boost_1_39_0.tar.gz
cd boost_1_39_0
./bootstrap.sh
./bjam -sTOOLS=gcc --without-python install
2.编译和安装KFS
首先,到sourceforge下载kfs-0.5.tar.gz(点击下载),这里假设下载后目录为用户根目录。
然后,解压KFS软件包,这里假设解压后KFS所在目录:~/kfs-0.5,编译源码所在目录:~/kfs-0.5/build。
为了完整编译KFS,需要有以下三部分:
- 编译C++部分,生成MetaServer/ChunkServer,各种API操作的tools,C++客户端;
- 编译Java部分,生成kfs.jar,即Java客户端,以通过Java JNI调用本地的C++方法;
- 编译Python扩展模块,生成Python客户端。
2.1 编译C++部分
tar xvzf kfs-0.5.tar.gz
cd kfs-0.5
mkdir build
cd build
cmake -D CMAKE_BUILD_TYPE=RelWithDebInfo ~/kfs-0.5
gmake
gmake install
编译之后,二进制文件将被安装在以下目录:
- 可执行文件:~/kfs-0.5/build/bin
- 库文件:~/kfs-0.5/build/lib
备注:编译KFS过程中,带上了debug调试信息。
2.2 编译Java部分
cd ~/kfs-0.5
ant jar
编译之后,生成的文件为:
- Java class文件:~/kfs-0.5/build/classes
- Java Jar包:~/kfs-0.5/build/kfs-0.5.jar
最后,将生成的Jar包添加到CLASSPATH环境变量中:
export CLASSPATH=${CLASSPATH}:~/kfs-0.5/build/kfs-0.5.jar
2.3 编译Python扩展模块
为了编译Python扩展模块,首先需要进行步骤2.1,生成KFS客户端库文件,这里库文件所在目录是:~/kfs-0.5/。
编译Python扩展模块的步骤:
cd to ~/kfs-0.5/src/cc/access
Edit kfs_setup.py and setup the include path. Specifically, kfsext = Extension('kfs', include_dirs ['kfs/src/cc/', '<path to boost>'])
python kfs_setup.py ~/kfs-0.5/build/lib/ build
编译之后,生成共享链接库kfs.so,进行安装:
python kfs_setup.py ~/kfs-0.5/build/lib/ install
如果要安装到一个指定的目录下(如~/kfs-0.5/build/lib),需要设置home选项:
python kfs_setup.py ~/kfs-0.5/build/lib install --home=~/kfs-0.5/build/lib
同时,需要更新PYTHONPATH和LD_LIBRARY_PATH环境变量:
export PYTHONPATH=${PYTHONPATH}:~/kfs-0.5/build/lib/lib64/python
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:~/kfs-0.5/build/lib
3.启动KFS服务进程
1、 MetaServer
cd ~/kfs-0.5/build/src/cc/meta
cp ~/kfs-0.5/conf/MetaServer.prp ./
./metaserver MetaServer.prp
备注:这里需要提前创建MetaServer.prp中指定的和logDir和cpDir目录:./kfslog和./kfscp。
2、ChunkServer
cd~/kfs-0.5/build/src/cc/chunk
cp ~/kfs-0.5/conf/ChunkServer.prp ./
./chunkserver ChunkServer.prp
3、KfsClient
cd ~/kfs-0.5/build/src/cc/tools
./kfsshell –s <meta server name> -p <port>
./cptokfs –s <meta server name> -p <port> -d <source path> -k <kfs path>
./cpfromkfs –s <meta server name> -p <port> -d <source path> -k <kfs path>
备注:~/kfs-0.5/build/src/cc/tools目录下有各种API操作工具,如kfsshell、cptokfs、cpfromkfs等,这里没有一一列举。
4.查看和关闭KFS服务进程
1、查看进程
ps –aux | grep metaserver
ps –aux | grep chunkserver
ps –aux | grep kfsshell
2、关闭进程
kill -9 <pid>
5.参考资料
-
http://code.google.com/p/kosmosfs/
-
http://sourceforge.net/projects/kosmosfs/