一、安裝（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>

二、啟動nebula graph服務(wù)

Nebula Graph使用腳本nebula.service管理服務(wù)，包括啟動、停止、重啟、中止和查看。nebula.service的默認路徑是/usr/local/nebula/scripts，如果修改過安裝路徑，請使用實際路徑。

1.啟動Nebula Graph服務(wù)

對于使用RPM或DEB文件安裝的Nebula Graph，執(zhí)行如下命令啟動服務(wù)：

$ sudo /usr/local/nebula/scripts/nebula.service start all （路徑改為實際安裝路徑）

2.停止Nebula Graph服務(wù)

請勿使用kill -9 命令強制終止進程，否則可能較小概率出現(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)，默認路徑為/usr/local/nebula/etc/，用戶可以檢查相應的配置文件排查問題。

三、連接nebula graph

1.Nebula Graph客戶端

用戶可以使用已支持的客戶端或者命令行工具來連接Nebula Graph數(shù)據(jù)庫

2.使用Nebula Console連接Nebula Graph

Nebula Graph服務(wù)已啟動。運行Nebula Console的機器和運行Nebula Graph的服務(wù)器網(wǎng)絡(luò)互通。
1) 在Nebula Console下載頁面，下載需要的版本
2) （可選）為方便使用，重命名文件為nebula-console。在Windows系統(tǒng)中，請重命名為nebula-console.exe
3) 在運行Nebula Console的機器上執(zhí)行如下命令，為用戶授予nebula-console文件的執(zhí)行權(quán)限。Windows系統(tǒng)請?zhí)^此步驟。

$ 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]

1. 參數(shù)說明如下。

   參數(shù)	說明
   -h	顯示幫助菜單。
   -addr	設(shè)置要連接的graphd服務(wù)的IP地址。默認地址為127.0.0.1。
   -port	設(shè)置要連接的graphd服務(wù)的端口。默認端口為9669。
   -u/-user	設(shè)置Nebula Graph賬號的用戶名。未啟用身份認證時，可以使用任意已存在的用戶名（默認為root）。
   -p/-password	設(shè)置用戶名對應的密碼。未啟用身份認證時，密碼可以填寫任意字符。
   -t/-timeout	設(shè)置整數(shù)類型的連接超時時間。單位為秒，默認值為120。
   -e/-eval	設(shè)置字符串類型的nGQL語句。連接成功后會執(zhí)行一次該語句并返回結(jié)果，然后自動斷開連接。
   -f/-file	設(shè)置存儲nGQL語句的文件的路徑。連接成功后會執(zhí)行該文件內(nèi)的nGQL語句并返回結(jié)果，執(zhí)行完畢后自動斷開連接。

用戶可以使用./nebula-console --help命令獲取所有參數(shù)的說明，也可以在項目倉庫找到更多說明。

四、部署 Studio

在部署 RPM 版 Studio 之前，用戶需要確認以下信息：

Nebula Graph 服務(wù)已經(jīng)部署并啟動。詳細信息，參考Nebula Graph 安裝部署。
使用的 Linux 發(fā)行版為 CentOS ，安裝有 lsof 和版本為 v10.16.0 + 以上的 Node.js。

Note
node 及 npm 命令需要安裝在 /usr/bin/目錄下，以防出現(xiàn) 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

確保在安裝開始前，以下端口處于未被使用狀態(tài)。

安裝

1.根據(jù)需要選擇并下載RPM包，建議選擇最新版本。常用下載鏈接如下：

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 已經(jī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.啟動成功后，在瀏覽器地址欄輸入 http://ip address:7001。

卸載

用戶可以使用以下的命令卸載 Studio。

$ sudo rpm -e nebula-graph-studio-3.0.0-1.x86_64

異常處理

如果在安裝過程中自動啟動失敗或是需要手動啟動或停止服務(wù)，請使用以下命令

手動啟動服務(wù)
$ bash /usr/local/nebula-graph-studio/scripts/start.sh
手動停止服務(wù)
$ bash /usr/local/nebula-graph-studio/scripts/stop.sh
如果啟動服務(wù)時遇到報錯報錯 ERROR: bind EADDRINUSE 0.0.0.0:7001，用戶可以通過以下命令查看端口7001是否被占用。
$ lsof -i:7001
如果端口被占用，且無法結(jié)束該端口上進程，用戶可以通過以下命令修改Studio服務(wù)啟動端口，并重新啟動服務(wù)。
//修改studio服務(wù)啟動端口
$ vi config/config.default.js
//修改
...
config.cluster = {
listen: {
port: 7001, // 修改這個端口號，改成任意一個當前可用的即可
hostname: '0.0.0.0',
},
};
...
//重新啟動npm
$ npm run start