使用源码安装Nebula Graph

    安装步骤

    Note

    从2.6.0版本开始，Nebula-Graph、Nebula-Storage、Nebula-Common的代码仓库合并为Nebula代码仓库，因此编译步骤与之前版本的步骤有所不同。

    1. 克隆Nebula Graph的源代码到主机。

      • [推荐]如果需要安装2.6.0版本的Nebula Graph，执行如下命令：

      • 如果需要安装最新的开发版本用于测试，执行如下命令克隆master分支的代码：

    2. 进入目录nebula。

      1. $ cd nebula

    3. 创建目录build并进入该目录。

    4. 使用CMake生成makefile文件。

      Note

      默认安装路径为/usr/local/nebula，如果需要修改路径，请在下方命令内增加参数 -DCMAKE_INSTALL_PREFIX=<installation_path>。

      更多CMake参数说明，请参见CMake参数。

      1. $ cmake -DCMAKE_INSTALL_PREFIX=/usr/local/nebula -DENABLE_TESTING=OFF -DCMAKE_BUILD_TYPE=Release ..

    5. 编译Nebula Graph。

      检查。

      为了适当地加快编译速度，可以使用选项-j并行编译。并行数量N建议为\(\min(\text{CPU}核数,\frac{内存(GB)}{2})\)。

      1. $ make -j{N} # E.g., make -j2

    6. 安装Nebula Graph。

    master分支的代码更新速度快，如果安装了master分支对应的开发版Nebula Graph，可根据以下步骤更新版本。

    1. 在目录中，执行命令git pull upstream master更新源码。

    2. 在目录nebula/build中，重新执行make -j{N}和make install。

    下一步

    1. $ cmake -D<variable>=<value> ...

    下文的CMake参数可以在配置(CMake)阶段用来调整编译设置。

    CMAKE_INSTALL_PREFIX

    CMAKE_INSTALL_PREFIX指定Nebula Graph服务模块、脚本和配置文件的安装路径，默认路径为/usr/local/nebula。

    ENABLE_WERROR

    ENABLE_WERROR默认值为ON，表示将所有警告（warning）变为错误（error）。如果有必要，用户可以设置为OFF。

    ENABLE_TESTING默认值为ON，表示单元测试服务由Nebula Graph服务构建。如果只需要服务模块，可以设置为OFF。

    ENABLE_ASAN

    CMAKE_BUILD_TYPE

    控制Nebula Graph的build方法，取值说明如下：

    • Debug

      CMAKE_BUILD_TYPE的默认值，build过程中只记录debug信息，不使用优化选项。

    • Release

      build过程中使用优化选项，不记录debug信息。

    • RelWithDebInfo

      build过程中既使用优化选项，也记录debug信息。

    • MinSizeRel

      build过程中仅通过优化选项控制代码大小，不记录debug信息。

    通常情况下，CMake会自动查找并使用主机上的C/C++编译器，但是如果编译器没有安装在标准路径，或者想使用其他编译器，请执行如下命令指定目标编译器的安装路径：

    1. $ cmake -DCMAKE_C_COMPILER=<path_to_gcc/bin/gcc> -DCMAKE_CXX_COMPILER=<path_to_gcc/bin/g++> ..
    2. $ cmake -DCMAKE_C_COMPILER=<path_to_clang/bin/clang> -DCMAKE_CXX_COMPILER=<path_to_clang/bin/clang++> ..

    ENABLE_CCACHE

    ENABLE_CCACHE默认值为ON，表示使用Ccache（compiler cache）工具加速编译。

    如果想要禁用ccache，仅仅设置ENABLE_CCACHE=OFF是不行的，因为在某些平台上，ccache会代理当前编译器，因此还需要设置环境变量export CCACHE_DISABLE=true，或者在文件~/.ccache/ccache.conf中添加disable=true。更多信息请参见。

    NEBULA_THIRDPARTY_ROOT

    NEBULA_THIRDPARTY_ROOT指定第三方软件的安装路径，默认路径为/opt/vesoft/third-party。

    问题排查

    如果出现编译失败，请参考以下建议：

    1. 检查操作系统版本是否符合要求、内存和硬盘空间是否足够。

    2. 检查third-party是否正确安装。