一、安裝（linux系統(tǒng)戴而，windows需要docker）
1.安裝wget
下載http://downloads.sourceforge.net/gnuwin32/wget-1.11.4-1-setup.exe
安裝后蝉稳，設(shè)置系統(tǒng)環(huán)境變量到安裝目錄的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>
二犬钢、啟動(dòng)nebula graph服務(wù)
Nebula Graph使用腳本nebula.service管理服務(wù)篷扩，包括啟動(dòng)、停止曹阔、重啟半开、中止和查看。nebula.service的默認(rèn)路徑是/usr/local/nebula/scripts赃份，如果修改過(guò)安裝路徑寂拆，請(qǐng)使用實(shí)際路徑。
1.啟動(dòng)Nebula Graph服務(wù)
對(duì)于使用RPM或DEB文件安裝的Nebula Graph抓韩，執(zhí)行如下命令啟動(dòng)服務(wù)：
$ sudo /usr/local/nebula/scripts/nebula.service start all （路徑改為實(shí)際安裝路徑）
2.停止Nebula Graph服務(wù)
請(qǐng)勿使用kill -9 命令強(qiáng)制終止進(jìn)程纠永，否則可能較小概率出現(xiàn)數(shù)據(jù)丟失。
$ sudo /usr/local/nebula/scripts/nebula.service stop all
3.查看Nebula Graph服務(wù)
$ sudo /usr/local/nebula/scripts/nebula.service status all
Nebula Graph服務(wù)由Meta服務(wù)谒拴、Graph服務(wù)和Storage服務(wù)共同提供尝江，這三種服務(wù)的配置文件都保存在安裝目錄的etc目錄內(nèi)，默認(rèn)路徑為/usr/local/nebula/etc/英上，用戶(hù)可以檢查相應(yīng)的配置文件排查問(wèn)題炭序。
三、連接nebula graph
1.Nebula Graph客戶(hù)端
用戶(hù)可以使用已支持的客戶(hù)端或者命令行工具來(lái)連接Nebula Graph數(shù)據(jù)庫(kù)
2.使用Nebula Console連接Nebula Graph
Nebula Graph服務(wù)已啟動(dòng)苍日。運(yùn)行Nebula Console的機(jī)器和運(yùn)行Nebula Graph的服務(wù)器網(wǎng)絡(luò)互通惭聂。
1) 在Nebula Console下載頁(yè)面，下載需要的版本
2) （可選）為方便使用相恃，重命名文件為nebula-console辜纲。在Windows系統(tǒng)中，請(qǐng)重命名為nebula-console.exe
3) 在運(yùn)行Nebula Console的機(jī)器上執(zhí)行如下命令，為用戶(hù)授予nebula-console文件的執(zhí)行權(quán)限侨歉。Windows系統(tǒng)請(qǐng)?zhí)^(guò)此步驟屋摇。
$ chmod 111 nebula-console
4) 在命令行界面中揩魂，切換工作目錄至nebula-console文件所在目錄幽邓。
5)執(zhí)行如下命令連接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]
-
參數(shù)說(shuō)明如下。
參數(shù) 說(shuō)明 -h顯示幫助菜單火脉。 -addr設(shè)置要連接的graphd服務(wù)的IP地址牵舵。默認(rèn)地址為127.0.0.1。 -port設(shè)置要連接的graphd服務(wù)的端口倦挂。默認(rèn)端口為9669畸颅。 -u/-user設(shè)置Nebula Graph賬號(hào)的用戶(hù)名。未啟用身份認(rèn)證時(shí)方援，可以使用任意已存在的用戶(hù)名（默認(rèn)為 root）没炒。-p/-password設(shè)置用戶(hù)名對(duì)應(yīng)的密碼。未啟用身份認(rèn)證時(shí)犯戏，密碼可以填寫(xiě)任意字符送火。 -t/-timeout設(shè)置整數(shù)類(lèi)型的連接超時(shí)時(shí)間。單位為秒先匪，默認(rèn)值為120种吸。 -e/-eval設(shè)置字符串類(lèi)型的nGQL語(yǔ)句。連接成功后會(huì)執(zhí)行一次該語(yǔ)句并返回結(jié)果呀非，然后自動(dòng)斷開(kāi)連接坚俗。 -f/-file設(shè)置存儲(chǔ)nGQL語(yǔ)句的文件的路徑。連接成功后會(huì)執(zhí)行該文件內(nèi)的nGQL語(yǔ)句并返回結(jié)果岸裙，執(zhí)行完畢后自動(dòng)斷開(kāi)連接猖败。
用戶(hù)可以使用./nebula-console --help命令獲取所有參數(shù)的說(shuō)明，也可以在項(xiàng)目倉(cāng)庫(kù)找到更多說(shuō)明降允。
四恩闻、部署 Studio
在部署 RPM 版 Studio 之前，用戶(hù)需要確認(rèn)以下信息：
Nebula Graph 服務(wù)已經(jīng)部署并啟動(dòng)拟糕。詳細(xì)信息判呕，參考Nebula Graph 安裝部署。
使用的 Linux 發(fā)行版為 CentOS 送滞，安裝有 lsof 和版本為 v10.16.0 + 以上的 Node.js侠草。
Note
node 及 npm 命令需要安裝在 /usr/bin/目錄下，以防出現(xiàn) RPM 安裝時(shí) node 命令找不到的情況犁嗅。 例如nodejs12默認(rèn)目錄為/opt/rh/rh-nodejs12边涕，用戶(hù)可以使用以下命令建立軟連接：
$ 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
確保在安裝開(kāi)始前，以下端口處于未被使用狀態(tài)。
| 端口號(hào) | 說(shuō)明 |
|---|---|
| 7001 | Studio提供web服務(wù)使用功蜓。 |
| 8080 | Nebula HTTP Gateway Client進(jìn)行HTTP通信使用园爷。 |
| 5699 | Nebula Importer導(dǎo)入數(shù)據(jù)導(dǎo)入使用。 |
安裝
1.根據(jù)需要選擇并下載RPM包式撼，建議選擇最新版本童社。常用下載鏈接如下：
| 安裝包 | 檢驗(yàn)和 | 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 版本需要運(yùn)行以下命令：
$ sudo rpm -i nebula-graph-studio-3.0.0-1.x86_64.rpm
當(dāng)屏幕返回以下信息時(shí)扰楼，表示 PRM 版 Studio 已經(jīng)成功啟動(dòng)。
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.啟動(dòng)成功后美浦，在瀏覽器地址欄輸入 http://ip address:7001弦赖。
卸載
用戶(hù)可以使用以下的命令卸載 Studio。
$ sudo rpm -e nebula-graph-studio-3.0.0-1.x86_64
異常處理
如果在安裝過(guò)程中自動(dòng)啟動(dòng)失敗或是需要手動(dòng)啟動(dòng)或停止服務(wù)浦辨，請(qǐng)使用以下命令
手動(dòng)啟動(dòng)服務(wù)
$ bash /usr/local/nebula-graph-studio/scripts/start.sh
手動(dòng)停止服務(wù)
$ bash /usr/local/nebula-graph-studio/scripts/stop.sh
如果啟動(dòng)服務(wù)時(shí)遇到報(bào)錯(cuò)報(bào)錯(cuò) ERROR: bind EADDRINUSE 0.0.0.0:7001蹬竖，用戶(hù)可以通過(guò)以下命令查看端口7001是否被占用。
$ lsof -i:7001
如果端口被占用流酬，且無(wú)法結(jié)束該端口上進(jìn)程币厕，用戶(hù)可以通過(guò)以下命令修改Studio服務(wù)啟動(dòng)端口，并重新啟動(dòng)服務(wù)康吵。
//修改studio服務(wù)啟動(dòng)端口
$ vi config/config.default.js
//修改
...
config.cluster = {
listen: {
port: 7001, // 修改這個(gè)端口號(hào)劈榨，改成任意一個(gè)當(dāng)前可用的即可
hostname: '0.0.0.0',
},
};
...
//重新啟動(dòng)npm
$ npm run start
