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

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

阅读指南Graph

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

• Graph

• Graph

• Graph

• Graph

编译NebulaGraph源码要求Graph

硬件要求Graph

操作系统要求Graph

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

软件要求Graph

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

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

安装编译所需软件Graph

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

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
   // 仅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版本是否正确。版本信息请参见Graph。

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

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

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

     ```bash
     $ git clone https://github.com/vesoft-inc/nebula-common.git
     ```
   
     类似2.0.0版本的NebulaGraph源码存储在特定的分支，您可以使用`--branch`或`-b`选项指定克隆的分支。例如指定2.0.0，命令如下：
   
     ```bash
     $ git clone --branch v2.0.0 https://github.com/vesoft-inc/nebula-common.git
     ```
   

   2. 进入目录nebula-common。

     ```bash
     $ cd nebula-common
     ```
   

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

     ```bash
     // 安装CMake。
     $ ./third-party/install-cmake.sh cmake-install
   
     // 启用CMake。
     $ source cmake-install/bin/enable-cmake.sh
   
     // 安装GCC。安装到opt目录需要root权限，您也可以修改为其他目录。
     $ sudo ./third-party/install-gcc.sh --prefix=/opt
   
     // 启用GCC。
     $ source /opt/vesoft/toolset/gcc/7.5.0/enable
   

测试环境运行NebulaGraph要求Graph

硬件要求Graph

操作系统要求Graph

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

服务架构建议Graph

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

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

生产环境运行NebulaGraph要求Graph

硬件要求Graph

操作系统要求Graph

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

您可以通过调整一些内核参数来提高NebulaGraph性能，详情请参见Graph。

服务架构建议Graph

通常您只需要3个metad进程，每个metad进程会自动创建并维护meta数据的一个副本。

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

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

警告：请不要跨机房部署集群。

NebulaGraph资源要求Graph

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

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

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

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

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

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

关于存储设备Graph

NebulaGraph是针对NVMe SSD进行设计和实现的，所有默认参数都是基于SSD设备进行调优。

不推荐使用HDD，因为HDD的IOPS性能差，随机寻道延迟高，可能还会遇到许多其他问题。也不建议使用远端存储设备，例如NAS或SAN。

请使用本地SSD设备。