一、安装(linux系统,windows需要docker)
1.安装wget
下载http://downloads.sourceforge.net/gnuwin32/wget-1.11.4-1-setup.exe
安装后,设置系统环境变量到安装目录的bin
2.下载
release版本
//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例如要下载适用于Centos 7.5的2.5.0安装包:
wget https://oss-cdn.nebula-graph.com.cn/package/2.5.0/nebula-graph-2.5.0.el7.x86_64.rpm
wget https://oss-cdn.nebula-graph.com.cn/package/2.5.0/nebula-graph-2.5.0.el7.x86_64.rpm.sha256sum.txt
下载适用于ubuntu 1804的2.5.0安装包:
wget https://oss-cdn.nebula-graph.com.cn/package/2.5.0/nebula-graph-2.5.0.ubuntu1804.amd64.deb
wget https://oss-cdn.nebula-graph.com.cn/package/2.5.0/nebula-graph-2.5.0.ubuntu1804.amd64.deb.sha256sum.txt
3.安装
安装RPM包
$ sudo rpm -ivh --prefix=<installation_path> <package_name>安装DEB包
$ sudo dpkg -i --instdir==<installation_path> <package_name>
二、启动nebula graph服务
Nebula Graph使用脚本nebula.service管理服务,包括启动、停止、重启、中止和查看。nebula.service的默认路径是/usr/local/nebula/scripts,如果修改过安装路径,请使用实际路径。
1.启动Nebula Graph服务
对于使用RPM或DEB文件安装的Nebula Graph,执行如下命令启动服务:
$ sudo /usr/local/nebula/scripts/nebula.service start all (路径改为实际安装路径)
2.停止Nebula Graph服务
请勿使用kill -9 命令强制终止进程,否则可能较小概率出现数据丢失。
$ sudo /usr/local/nebula/scripts/nebula.service stop all
3.查看Nebula Graph服务
$ sudo /usr/local/nebula/scripts/nebula.service status all
Nebula Graph服务由Meta服务、Graph服务和Storage服务共同提供,这三种服务的配置文件都保存在安装目录的etc目录内,默认路径为/usr/local/nebula/etc/,用户可以检查相应的配置文件排查问题。
三、连接nebula graph
1.Nebula Graph客户端
用户可以使用已支持的客户端或者命令行工具来连接Nebula Graph数据库
2.使用Nebula Console连接Nebula Graph
Nebula Graph服务已启动。运行Nebula Console的机器和运行Nebula Graph的服务器网络互通。
1) 在Nebula Console下载页面,下载需要的版本
2) (可选)为方便使用,重命名文件为nebula-console。在Windows系统中,请重命名为nebula-console.exe
3) 在运行Nebula Console的机器上执行如下命令,为用户授予nebula-console文件的执行权限。Windows系统请跳过此步骤。
$ chmod 111 nebula-console
4) 在命令行界面中,切换工作目录至nebula-console文件所在目录。
5)执行如下命令连接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]
-
参数说明如下。
参数 说明 -h
显示帮助菜单。 -addr
设置要连接的graphd服务的IP地址。默认地址为127.0.0.1。 -port
设置要连接的graphd服务的端口。默认端口为9669。 -u/-user
设置Nebula Graph账号的用户名。未启用身份认证时,可以使用任意已存在的用户名(默认为 root
)。-p/-password
设置用户名对应的密码。未启用身份认证时,密码可以填写任意字符。 -t/-timeout
设置整数类型的连接超时时间。单位为秒,默认值为120。 -e/-eval
设置字符串类型的nGQL语句。连接成功后会执行一次该语句并返回结果,然后自动断开连接。 -f/-file
设置存储nGQL语句的文件的路径。连接成功后会执行该文件内的nGQL语句并返回结果,执行完毕后自动断开连接。
用户可以使用./nebula-console --help
命令获取所有参数的说明,也可以在项目仓库找到更多说明。
四、部署 Studio
在部署 RPM 版 Studio 之前,用户需要确认以下信息:
Nebula Graph 服务已经部署并启动。详细信息,参考Nebula Graph 安装部署。
使用的 Linux 发行版为 CentOS ,安装有 lsof 和版本为 v10.16.0 + 以上的 Node.js。
Note
node 及 npm 命令需要安装在 /usr/bin/目录下,以防出现 RPM 安装时 node 命令找不到的情况。 例如nodejs12默认目录为/opt/rh/rh-nodejs12,用户可以使用以下命令建立软连接:
$ sudo ln -s /opt/rh/rh-nodejs12/root/usr/bin/node /usr/bin/node
$ sudo ln -s /opt/rh/rh-nodejs12/root/usr/bin/npm /usr/bin/npm
确保在安装开始前,以下端口处于未被使用状态。
端口号 | 说明 |
---|---|
7001 | Studio提供web服务使用。 |
8080 | Nebula HTTP Gateway Client进行HTTP通信使用。 |
5699 | Nebula Importer导入数据导入使用。 |
安装
1.根据需要选择并下载RPM包,建议选择最新版本。常用下载链接如下:
安装包 | 检验和 | Nebula版本 |
---|---|---|
nebula-graph-studio-3.0.0-1.x86_64.rpm | nebula-graph-studio-3.0.0-1.x86_64.rpm.sha256 | 2.5.0 |
2.使用sudo rpm -i <rpm>命令安装RPM包。
例如,安装Studio 3.0.0 版本需要运行以下命令:
$ sudo rpm -i nebula-graph-studio-3.0.0-1.x86_64.rpm
当屏幕返回以下信息时,表示 PRM 版 Studio 已经成功启动。
egg started on http://0.0.0.0:7001
nohup: 把输出追加到"nohup.out"
--- START OF NEBULA IMPORTER ---
[INFO] httpserver.go:80: Starting http server on 5699
3.启动成功后,在浏览器地址栏输入 http://ip address:7001。
卸载
用户可以使用以下的命令卸载 Studio。
$ sudo rpm -e nebula-graph-studio-3.0.0-1.x86_64
异常处理
如果在安装过程中自动启动失败或是需要手动启动或停止服务,请使用以下命令
手动启动服务
$ bash /usr/local/nebula-graph-studio/scripts/start.sh
手动停止服务
$ bash /usr/local/nebula-graph-studio/scripts/stop.sh
如果启动服务时遇到报错报错 ERROR: bind EADDRINUSE 0.0.0.0:7001,用户可以通过以下命令查看端口7001是否被占用。
$ lsof -i:7001
如果端口被占用,且无法结束该端口上进程,用户可以通过以下命令修改Studio服务启动端口,并重新启动服务。
//修改studio服务启动端口
$ vi config/config.default.js
//修改
...
config.cluster = {
listen: {
port: 7001, // 修改这个端口号,改成任意一个当前可用的即可
hostname: '0.0.0.0',
},
};
...
//重新启动npm
$ npm run start