跳转至

使用源码安装NebulaGraphGraph

使用源码安装NebulaGraph允许自定义编译和安装设置,并测试最新特性。

前提条件Graph

  • 准备正确的编译环境。参见Graph。

    Note

    暂不支持离线编译NebulaGraph。

  • 待安装NebulaGraph的主机可以访问互联网。

安装步骤Graph

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

    • [推荐]如果需要安装v2.5.1版本的NebulaGraph,执行如下命令:
      $ git clone --branch v2.5.1 https://github.com/vesoft-inc/nebula-graph.git
      
    • 如果需要安装最新的开发版本用于测试,执行如下命令克隆master分支的代码:
      $ git clone https://github.com/vesoft-inc/nebula-graph.git
      
  2. 进入目录nebula-graph

    $ cd nebula-graph
    
  3. 创建目录build并进入该目录。

    $ mkdir build && cd build
    
  4. 使用CMake生成makefile文件。

    Note

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

    更多CMake参数说明,请参见Graph。

    • 如果在第1步下载了v2.5.1版本的源码,执行如下命令。选项-DNEBULA_COMMON_REPO_TAG-DNEBULA_STORAGE_REPO_TAG用于指定Graph库的分支,以使各NebulaGraph组件的版本保持一致。
      $ cmake -DENABLE_BUILD_STORAGE=on -DENABLE_TESTING=OFF -DCMAKE_BUILD_TYPE=Release \
      -DNEBULA_COMMON_REPO_TAG=v2.5.1 -DNEBULA_STORAGE_REPO_TAG=v2.5.1 ..
      
    • 如果在第1步下载了master分支的代码,执行如下命令即可。
      $ cmake -DENABLE_BUILD_STORAGE=on -DENABLE_TESTING=OFF -DENABLE_MODULE_UPDATE=ON -DCMAKE_BUILD_TYPE=Release ..
      
  5. 编译NebulaGraph。

    Note

    检查Graph

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

    $ make -j{N} # E.g., make -j2
    
  6. 安装NebulaGraph。

    $ sudo make install-all
    
  7. 安装目录下的 etc/ 目录中(默认为/usr/local/nebula/etc)的配置文件为参考模版,用户可以根据需要创建自己的配置文件。如果要使用 script 目录下的脚本,启动、停止、重启、中止和查看服务,配置文件需要命名为 nebula-graph.confnebula-metad.confnebula-storaged.conf

    Compatibility

    在 2.0.1 中,可以直接使用 script 目录下的脚本,不需要将配置文件重新命名。

更新master版本Graph

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

1. 在目录nebula-graph/中,执行命令git pull upstream master更新源码。

2. 在目录nebula-graph/modules/common/nebula-graph/modules/storage/中,分别执行命令git pull upstream master

3. 在目录nebula-graph/build/中,重新执行make -j{N}make install-all

下一步Graph

  • Graph
  • Graph
  • Graph

CMake参数Graph

使用方法Graph

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

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

ENABLE_BUILD_STORAGEGraph

从2.5.1版本开始,NebulaGraph的graph和storage代码仓库分离,可以各自单独编译。ENABLE_BUILD_STORAGE默认值为OFF,表示Storage服务不会和Graph服务一起安装。

如果单机部署NebulaGraph进行测试,可以设置ENABLE_BUILD_STORAGE=ON,安装时会自动下载和安装Storage服务。

CMAKE_INSTALL_PREFIXGraph

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

ENABLE_WERRORGraph

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

ENABLE_TESTINGGraph

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

ENABLE_ASANGraph

ENABLE_ASAN默认值为OFF,表示关闭内存问题检测工具ASan(AddressSanitizer)。该工具是为NebulaGraph开发者准备的,如果需要开启,可以设置为ON

MAKE_BUILD_TYPEGraph

MAKE_BUILD_TYPE控制NebulaGraph的build方法,取值说明如下:

  • Debug

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

  • Release

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

  • RelWithDebInfo

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

  • MinSizeRel

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

CMAKE_C_COMPILER/CMAKE_CXX_COMPILERGraph

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

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

ENABLE_CCACHEGraph

ENABLE_CCACHE默认值为ON,表示使用ccache(compiler cache)工具加速编译。

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

NEBULA_THIRDPARTY_ROOTGraph

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

问题排查Graph

如果出现编译失败,请参考以下建议:

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

  2. 检查Graph是否正确安装。

  3. 使用make -j1降低编译并发度。

  4. 更新代码:git pull,并再次编译,第4步加上CMake选项-DENABLE_MODULE_UPDATE=ON


最后更新: September 13, 2021
Back to top