permalink: 1.x/docs/build/compile-from-source/ version: 1.x

Pegasus目前只支持Linux平台。目前在CentOS、Ubuntu上都测试运行过。

编译过程中遇到问题，请先参考下面的常见问题，如果还不能解决，可以通过Github Issues向我们咨询。

用docker编译

如果你的机器支持运行docker,推荐使用我们提供的dockerfile进行编译:

安装依赖

Pegasus编译依赖以下软件：

  • 编译器：GCC-5以上版本，要求支持C++14
  • CMake：3.5.2及以上版本
  • Boost：1.58及以上版本
  • openssl: 1.10以下版本（pegasus 1.10及以下版本有该限制，以上版本无限制）
  • 其他库：libaio、snappy、zstd、lz4、gflags、zlib

如果是Ubuntu，可以使用apt-get安装依赖库：

sudo apt-get install build-essential cmake libboost-all-dev libaio-dev libsnappy-dev libzstd-dev liblz4-dev libgflags-dev zlib1g zlib1g.dev patch git curl zip automake libtool libssl-dev bison flex

如果是CentOS，可以使用yum安装依赖库（不含gflags）：

yum -y groupinstall "Development Tools"
yum -y install cmake boost-devel libaio-devel snappy-devel zstd-devel lz4-devel gflags-devel zlib zlib-devel patch openssl-devel bison flex

如果你的系统没有提供zstd的软件源，你可以尝试手动安装，这里提供一个安装脚本：

wget https://github.com/facebook/zstd/archive/v1.3.7.zip
unzip v1.3.7
cd zstd-1.3.7
mkdir cmake-build
cd cmake-build
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBDIR=lib -DZSTD_BUILD_PROGRAMS=OFF ../build/cmake
sudo make install -j8

源码编译

从github获取Pegasus源代码，并递归获取其依赖的rDSN和Rocksdb：

git clone https://github.com/xiaomi/pegasus.git --recursive
cd pegasus

如果要编译发布的稳定版本，请checkout至相应的tag（建议用最新的release版本），譬如：

git checkout -b v1.11.4 v1.11.4
git submodule update

运行build命令进行编译：

./run.sh build -c

编译后输出会放在当前目录的DSN_ROOT/文件夹下，里面包含bin、include、lib目录。

可以用pack_server命令打包server端程序包，用于服务部署：

./run.sh pack_server

可以用pack_client命令打包client端库，用于C/C++端客户端开发：

./run.sh pack_client

可以用pack_tools命令打包tools包，里面包含了各种工具（shell、bench）：

./run.sh pack_tools

编译成功后，推荐先体验onebox集群。

常见问题

更新代码后重新编译

如果通过git pull更新代码后，可能会出现编译失败的情况，这可能是因为：

  • 依赖的子模块发生了变化，需要更新子模块到合适的版本（通过git status可以看rdsn和rocksdb子模块是否发生变化）；
  • 编译配置发生了变化，CMake文件已过期；
  • thirdparty依赖发生了变化，需要重新下载和编译依赖库；

可以先尝试按照如下步骤是否能解决（解决子模块和编译配置发生变化的问题）：

git submodule update
./run.sh build -c

如果还不能解决，可以进一步尝试（解决thirdparty依赖变化的问题）：

./run.sh build -c --clear_thirdparty

如果还不能解决，可以咨询我们。

使用非系统自带的boost库

编译默认使用系统自带的boost库，但是如果系统自带的库版本太低且无法升级，可以自己下载和编译高版本的boost库，然后通过-b参数传进来：

./run.sh build -b /your/boost/installation/path

譬如：

./run.sh build -b /home/work/software/boost_1_58_0/output

使用toolchain编译

如果系统自带的编译器版本太低且难以升级（不支持C++14），可以自己下载和编译高版本的gcc工具链，然后放到PATH中：

export PATH="$TOOLCHAIN_DIR/bin:$PATH"
./run.sh build

运行时出现libstdc++版本不兼容问题

如果用户使用自己的（非系统自带的）gcc或者boost库，在运行时可能出现c++版本不兼容的错误：

./pegasus_server: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.14' not found (required by ./pegasus_server)
./pegasus_server: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.17' not found (required by ./pegasus_server)
./pegasus_server: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.19' not found (required by ./pegasus_server)
./pegasus_server: /usr/lib64/libstdc++.so.6: version `CXXABI_1.3.5' not found (required by ./pegasus_server)

此时最好使用pack工具打包成运行时的执行包：

  • pack_server：服务包，用于部署Pegasus集群的服务进程。注意在运行前需要：export LD_LIBRARY_PATH=$package_dir/DSN_ROOT/lib。
  • pack_client：C++客户端库，用于业务开发。
  • pack_tools：工具包，run.sh里面大部分命令都能用，包括shell和onebox工具。

以上三个pack工具都支持-b和-g选项，将用户自己的boost和gcc库放到DSN_ROOT/lib中，避免运行时链接到错误的库。这样，即使跨机器，只要libc兼容，执行包都能正常使用，避免库不兼容的困扰。

如果你用了自己的gcc，就在pack的时候加上-g选项，譬如：

./run.sh pack_server -g

如果你用了自己的boost，就在pack的时候加上-b选项，譬如：

./run.sh pack_server -b

如果都用了，就同时加上-b和-g选项，譬如：

./run.sh pack_server -b -g