NebulaGraph学习：1.安装、启动与连接

NebulaGraph学习：1.安装、启动与连接

一、安装

1.下载安装包

以ubuntu20.04为例：

wget https://oss-cdn.nebula-graph.com.cn/package/3.2.0/nebula-graph-3.2.0.ubuntu2004.amd64.deb

URL 格式如下：

//Centos 7
https://oss-cdn.nebula-graph.com.cn/package/<release_version>/nebula-graph-<release_version>.el7.x86_64.rpm

//Centos 8
https://oss-cdn.nebula-graph.com.cn/package/<release_version>/nebula-graph-<release_version>.el8.x86_64.rpm

//Ubuntu 1604
https://oss-cdn.nebula-graph.com.cn/package/<release_version>/nebula-graph-<release_version>.ubuntu1604.amd64.deb

//Ubuntu 1804
https://oss-cdn.nebula-graph.com.cn/package/<release_version>/nebula-graph-<release_version>.ubuntu1804.amd64.deb

//Ubuntu 2004
https://oss-cdn.nebula-graph.com.cn/package/<release_version>/nebula-graph-<release_version>.ubuntu2004.amd64.deb

2.安装NebulaGraph

• 安装 RPM 包

  $ sudo rpm -ivh --prefix=<installation_path> <package_name>
  

  --prefix为可选项，用于指定安装路径。如不设置，系统会将 Nebula Graph 安装到默认路径/usr/local/nebula/。

  例如，要在默认路径下安装3.2.0版本的 RPM 包，运行如下命令：

  sudo rpm -ivh nebula-graph-3.2.0.el7.x86_64.rpm
  

• 安装 DEB 包

  $ sudo dpkg -i <package_name>
  

  使用 DEB 包安装 Nebula Graph 时不支持自定义安装路径。默认安装路径为/usr/local/nebula/。

  例如安装3.2.0版本的 DEB 包：

  sudo dpkg -i nebula-graph-3.2.0.ubuntu1804.amd64.deb
  

二、启动

1.使用脚本管理服务

使用脚本nebula.service管理服务，包括启动、停止、重启、中止和查看。

语法

$ sudo /usr/local/nebula/scripts/nebula.service
[-v] [-c <config_file_path>]
<start | stop | restart | kill | status>
<metad | graphd | storaged | all>

参数	说明
-v	显示详细调试信息。
-c	指定配置文件路径，默认路径为/usr/local/nebula/etc/。
start	启动服务。
stop	停止服务。
restart	重启服务。
kill	中止服务。
status	查看服务状态。
metad	管理 Meta 服务。
graphd	管理 Graph 服务。
storaged	管理 Storage 服务。
all	管理所有服务。

2.启动 Nebula Graph 服务

非容器部署

对于非容器部署的 Nebula Graph，执行如下命令启动服务：

sudo /usr/local/nebula/scripts/nebula.service start all

容器部署

对于使用 Docker Compose 部署的 Nebula Graph，在nebula-docker-compose/目录内执行如下命令启动服务：

docker-compose up -d

3.停止 Nebula Graph 服

非容器部署

执行如下命令停止 Nebula Graph 服务：

sudo /usr/local/nebula/scripts/nebula.service stop all

容器部署

在nebula-docker-compose/目录内执行如下命令停止 Nebula Graph 服务：

docker-compose down

4.查看 Nebula Graph 服务

非容器部署

执行如下命令查看 Nebula Graph 服务状态：

sudo /usr/local/nebula/scripts/nebula.service status all

• 如果返回如下结果，表示 Nebula Graph 服务正常运行。

容器部署

在nebula-docker-compose目录内执行如下命令查看 Nebula Graph 服务状态：

docker-compose ps

三、连接

Nebula Graph 支持多种类型的客户端，包括命令行客户端、可视化界面客户端和流行编程语言客户端。详情参见客户端列表。

前提条件

• Nebula Graph 服务已启动。

• 运行 Nebula Console 的机器和运行 Nebula Graph 的服务器网络互通。

• Nebula Console 的版本兼容 Nebula Graph 的版本。

操作步骤

1. 在 Nebula Console 下载页面，确认需要的版本，单击 Assets。

2. 在 Assets 区域找到机器运行所需的二进制文件，下载文件到机器上。
   

3. （可选）为方便使用，重命名文件为nebula-console。

   mv nebula-console-linux-amd64-v3.2.0 nebula-console
   

4. 在运行 Nebula Console 的机器上执行如下命令，为用户授予 nebula-console 文件的执行权限。

   chmod 111 nebula-console
   

5. 在命令行界面中，切换工作目录至 nebula-console 文件所在目录。

6. 执行如下命令连接 Nebula Graph。

• Linux 或 macOS

  ./nebula-console -addr <ip> -port <port> -u <username> -p <password>
    [-t 120] [-e "nGQL_statement" | -f filename.nGQL]
  

• Windows

  > nebula-console.exe -addr <ip> -port <port> -u <username> -p <password>
    [-t 120] [-e "nGQL_statement" | -f filename.nGQL]
  

以linux为例：

./nebula-console -addr localhost -port 9669 -u root -p root

参数说明如下。

参数	说明
-h/-help	显示帮助菜单。
-addr/-address	设置要连接的 Graph 服务的 IP 地址。默认地址为 127.0.0.1。
-P/-port	设置要连接的 Graph 服务的端口。默认端口为 9669。
-u/-user	设置 Nebula Graph 账号的用户名。未启用身份认证时，可以使用任意已存在的用户名（默认为root）。
-p/-password	设置用户名对应的密码。未启用身份认证时，密码可以填写任意字符。
-t/-timeout	设置整数类型的连接超时时间。单位为秒，默认值为 120。
-e/-eval	设置字符串类型的 nGQL 语句。连接成功后会执行一次该语句并返回结果，然后自动断开连接。
-f/-file	设置存储 nGQL 语句的文件的路径。连接成功后会执行该文件内的 nGQL 语句并返回结果，执行完毕后自动断开连接。
-enable_ssl	连接 Nebula Graph 时使用 SSL 加密。
-ssl_root_ca_path	指定 CA 证书的存储路径。
-ssl_cert_path	指定 CRT 证书的存储路径。
-ssl_private_key_path	指定私钥文件的存储路径。

四、注册Storage服务

首次连接到 Nebula Graph 后，需要先添加 Storage 主机，并确认主机都处于在线状态。

前提条件

已连接 Nebula Graph 服务

操作步骤

1. 添加 Storage 主机。

   执行如下命令添加主机：

   ADD HOSTS <ip>:<port> [,<ip>:<port> ...];
   

   示例：

   ADD HOSTS 127.0.0.1:9779;
   

   请确保添加的主机 IP 和配置文件nebula-storaged.conf中local_ip配置的 IP 一致，否则会导致添加 Storage 主机失败。关于配置文件的详情，参见配置管理。

2. 检查主机状态，确认全部在线。

   SHOW HOSTS;
   

   
   在返回结果的 Status 列，可以看到所有 Storage 主机都在线。