permalink: docs/installation/ redirect_from:

  • overview/installation/
  • 2.1.0/docs/installation/ version: 2.1.0

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

编译过程中遇到问题，请先参考下面的常见问题，如果还不能解决，可以通过[Github Issues]({{ site.pegasus_github_url }}/issues)向我们咨询。

安装依赖

Pegasus编译依赖以下软件：

  • 编译器：GCC-5以上版本，要求支持C++14
  • CMake：3.5.2及以上版本
  • 其他库：libaio、snappy、zstd、lz4、zlib

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

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

如果是CentOS，可以使用yum安装依赖库：

yum -y groupinstall "Development Tools"
yum -y install cmake libaio-devel snappy-devel zstd-devel lz4-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

源码获取

我们推荐下载遵循ASF Release Policy发布的源码包。 下载地址：

<https://dist.apache.org/repos/dist/release/incubator/pegasus/{{ page.version }}/apache-pegasus-{{ page.version }}-source-release.zip>

你也可以通过git clone的方式获取Pegasus源码：

git clone {{ site.pegasus_github_url }}.git --recursive
cd pegasus
git checkout -b v{{ page.version }} v{{ page.version }}
git submodule update

源码编译

./run.sh build -c

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

编译打包

打包server端程序包，用于服务部署：

./run.sh pack_server

打包client端库，用于C/C++端客户端开发：

./run.sh pack_client

打包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

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

使用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