准备编译、安装和运行Nebula Graph的环境

本文介绍编译、安装Nebula Graph的要求和建议，以及如何预估集群运行所需的资源。

阅读指南

如果是带着如下问题阅读本文，可以直接单击问题跳转查看对应的说明。

• 编译Nebula Graph源码的要求是什么？

• 测试环境中运行Nebula Graph的要求是什么？

• 生产环境中运行Nebula Graph的要求是什么？

• 需要预留多少内存和硬盘空间给Nebula Graph集群？

编译Nebula Graph源码要求

硬件要求

操作系统要求

当前仅支持在Linux系统中编译Nebula Graph，建议使用内核版本为2.6.32及以上版本的Linux系统。

软件要求

软件版本需要如下表所示，如果它们不符合要求，或者也不确定它们的版本，请按照安装编译所需软件中的步骤进行操作。

其他第三方软件将在安装（cmake）阶段自动下载并安装到build目录中。

安装编译所需软件

本小节指导下载和安装Nebula Graph编译时需要的软件。

1. 安装依赖包。

   • CentOS、RedHat、Fedora用户请执行如下命令：

     $ yum update
     $ yum install -y make \
                      m4 \
                      git \
                      wget \
                      unzip \
                      xz \
                      readline-devel \
                      ncurses-devel \
                      zlib-devel \
                      gcc \
                      gcc-c++ \
                      cmake \
                      gettext \
                      curl \
                      redhat-lsb-core \
                      bzip2
     // 仅CentOS 8+、RedHat 8+、Fedora需要安装libstdc++-static和libasan。
     $ yum install -y libstdc++-static libasan

   • Debian和Ubuntu用户请执行如下命令：

     $ apt-get update
     $ apt-get install -y make \
                          m4 \
                          git \
                          wget \
                          unzip \
                          xz-utils \
                          curl \
                          lsb-core \
                          build-essential \
                          libreadline-dev \
                          ncurses-dev \
                          cmake \
                          gettext

2. 检查主机上的GCC和CMake版本是否正确。版本信息请参见软件要求。

   $ g++ --version
   $ cmake --version

   如果版本正确，用户可以跳过本小节。如果不正确，请根据如下步骤安装：

   1. 克隆仓库nebula-common到主机。

      $ git clone -b v2.5.1 https://github.com/vesoft-inc/nebula-common.git

      如需安装特定版本的Nebula Graph，使用--branch或-b选项指定相应的nebula-common分支。 例如，指定2.5.1，命令如下：

      $ git clone --branch v2.5.1 https://github.com/vesoft-inc/nebula-common.git

   2. 进入目录nebula-common。

      $ cd nebula-common

   3. 执行如下命令安装和启用GCC和CMake。

      // 安装CMake。
      $ ./third-party/install-cmake.sh cmake-install
      // 启用CMake。
      $ source cmake-install/bin/enable-cmake.sh
      //opt目录添加写权限。
      $ sudo mkdir /opt/vesoft && sudo chmod -R a+w /opt/vesoft
      // 安装GCC。安装到opt目录需要写权限，用户也可以修改为其他目录。
      $ ./third-party/install-gcc.sh --prefix=/opt
      // 启用 GCC。
      $ source /opt/vesoft/toolset/gcc/7.5.0/enable

3. 执行脚本install-third-party.sh。

   $ ./third-party/install-third-party.sh

测试环境运行Nebula Graph要求

硬件要求

操作系统要求

当前仅支持在Linux系统中安装Nebula Graph，建议在测试环境中使用内核版本为3.9及以上版本的Linux系统。

服务架构建议

例如单机测试环境，用户可以在机器上部署1个metad、1个storaged和1个graphd进程。

对于更常见的测试环境，例如三台机器构成的集群，用户可以按照如下方案部署Nebula Graph。

生产环境运行Nebula Graph要求

硬件要求

操作系统要求

当前仅支持在Linux系统中安装Nebula Graph，建议在生产环境中使用内核版本为3.9及以上版本的Linux系统。

用户可以通过调整一些内核参数来提高Nebula Graph性能，详情请参见内核配置。

服务架构建议

Danger

不要跨机房部署集群。

有且仅有3个metad进程，每个metad进程会自动创建并维护meta数据的一个副本。

storaged进程的数量不会影响图空间副本的数量。

用户可以在一台机器上部署多个进程，例如五台机器构成的集群，用户可以按照如下方案部署Nebula Graph。

Nebula Graph资源要求

用户可以预估一个3副本Nebula Graph集群所需的内存、硬盘空间和分区数量。

• 问题 1：为什么磁盘空间和内存都要乘以120%？

  答：额外的20%用于缓冲。

• 问题 2：如何获取RocksDB实例数量？

  答：在etc目录内查看配置文件nebula-storaged.conf，--data_path选项中的每个目录对应一个RocksDB实例，目录总数即是RocksDB实例数量。

Note

用户可以在配置文件nebula-storaged.conf中添加--enable_partitioned_index_filter=true来降低bloom过滤器占用的内存大小，但是在某些随机寻道（random-seek）的情况下，可能会降低读取性能。

FAQ

关于存储设备

Nebula Graph 是针对 NVMe SSD 进行设计和实现的，所有默认参数都是基于 SSD 设备进行调优，要求极高的 IOPS 和极低的 Latency。

• 不建议使用 HDD；因为其 IOPS 性能差，随机寻道延迟高；会遇到大量问题。

• 不要使用远端存储设备（如 NAS 或 SAN），不要外接基于 HDFS 或者 Ceph 的虚拟硬盘。

• 不需要使用磁盘阵列（RAID）。

• 使用本地 SSD 设备。

关于CPU架构

Enterpriseonly

Nebula Graph 2.5.1 不支持直接在 ARM 架构（包括 Apple Mac M1 或者华为鲲鹏）上运行或者编译。

最后更新: September 9, 2021