HPB開發節點搭建指南

導讀： 社區開發者在開發HPB DAPP的時候首先面臨的就是如何接入HPB主網的問題，本文介紹了開發者節點的搭建過程，本文基於Ubuntu 16.04搭建，開發節點至關於輕節點，可發起交易，進行區塊同步，但不能進入候選節點、高性能節點的選舉，也不能出塊，可做爲DAPP應用的接入節點。

進行開發節點搭建時您有如下兩種方式選擇：

（1） 方式一：經過源代碼進行節點搭建，選擇此種搭建方式須要具有必定軟件編程基礎。瞭解編譯過程。本方式須要首先完成GO編譯環境安裝，而後按照源代碼搭建步驟及示例進行；

（2） 方式二：經過HPB可執行文件進行節點搭建。本方式直接按照可執行文件搭建步驟及示例進行。

注意：

1. HPB程序必須以ROOT權限運行。
2. 任何與帳戶密碼相關的操做不要委託他人操做，以避免密碼泄露。
3. 啓動節點必須用戶本人操做以防止密碼泄露。

1. 檢查網絡鏈接

進行節點搭建前，用戶須要檢查服務器的網絡鏈接，分別輸入如下五個命令，以檢測服務器鏈接bootnode的過程當中是否存在延遲、丟包現象。

編號 命令 節點位置

1       ping -c 200 47.254.133.46     德國 \|
      2       ping -c 200 47.94.20.30       北京 \|
      3       ping -c 200 47.88.60.227      硅谷 \|
      4       ping -c 200 47.75.213.166     香港 \|
      5       ping -c 200 47.100.250.120    上海 \|

示例：（僅以編號1爲例，其他命令用戶均需執行）

輸入命令：ping 47.254.133.46後，等命令結束後控制檯會輸出總結信息其中「200 packets transmitted」表示發送200次包，「186 received」表示接受186次包，「7% packet loss」表示鏈接過程當中丟包比例爲7%；「time 199386ms」表示200次鏈接總耗時199836ms，「rtt min/avg/max/mdev = 230.439/248.901/290.203/9.397 ms」表示200次鏈接中最短期爲234.439ms，平均時間爲248.901ms，最長時間爲290.203ms，平均方差爲9.397ms。

提示：如服務器位置與節點位置爲相同洲，則丟包現象需爲0%、延遲小於100ms才能達標；（如國內服務器連北京或上海節點時，丟包現象應爲0%）；當爲跨洲鏈接時，丟包現象通常存在，延遲通常不超過300ms，但其達標數值很難界定，當用戶對其丟包比例以及延遲現象不肯定時，可詢問HPB社區工做人員這兩項是否達標。

不達標的用戶需聯繫網絡服務提供商或者數據中心，解決網絡問題。

2. 源代碼搭建示例

(1) 步驟1肯定程序執行路徑

輸入**sudo mkdir** */home/ghpb-bin*建立程序執行路徑；

其中/home/ghpb-bin可改成指定路徑.

切換成ROOT用戶，根據提示輸入ROOT帳戶密碼。

(2) 步驟2 選擇下載路徑

輸入 **cd** */home/*；其中/home/可改成指定路徑；

(3) 步驟3 下載HPB主網可執行程序

輸入 **sudo git clone** *https://github.com/hpb-project/hpb-release*

提示：若是提示go-hpb已存在，則輸入命令：rm -rf go-hpb後再下載go-hpb源碼。

(4) 步驟4 查看HPB主網可執行程序

輸入**cd** *hpb-release/*進入hpb-release目錄，輸入ls命令查看該目錄文件，可看到bin、config和README.md三個文件。

(5) 步驟5 拷貝創世文件到執行路徑

輸入**cd** *config/*進入config目錄，繼續輸入**sudo** **cp** *gensis.json /home/ghpb-bin/**；*其中/hone/gphb-bin/爲您所設置的程序執行路徑。

(6) 步驟6 進入下載路徑

輸入**cd** */home/*將源碼下到home目錄下，其中/home/可改成源碼下載路徑

索引：HPB源代碼

(7) 步驟7編譯go-hpb

輸入**cd** *go-hpb/*；繼續輸入**make all**編譯go-hpb;

(8) 步驟8拷貝程序到執行路徑

輸入**sudo cp** *build/bin/\* /home/ghpb-bin/*便可；
         其中/home/ghpb-bin/爲您設置的程序執行路徑；

(9) 步驟9 初始化節點

輸入**cd** */home/ghpb-bin/*進入程序執行路徑；繼續輸入**sudo** *./ghpb* **--datadir** *node/data* **init** *gensis.json*，當出現」Successfully wrote genesis state database=chaindata」時，繼續下一步；其中/home/ghpb-bin/爲您設置的程序執行路徑；

(10) 步驟10導出帳戶

從HPB錢包導出您的帳戶信息文件，輸入cd node/data/後繼續輸入mkdir keystore便可，輸入ls可看到ghpb和keystore兩個文件；

按順序進入路徑/home/ghpb-bin/node/data/keystore，將帳戶信息文件拷入keystore文件夾中。

提示：若是沒有權限進入這個目錄，輸入命令 chmod 777 /home/ghpb-bin -R，以後再從新進入。

(11) 步驟11 新建帳戶

輸入 ./ghpb --datadir node/data account new，稍等片刻根據提示設置新帳戶的密碼，重複輸入後將返回新帳戶地址，用戶需記錄該地址；

(12) 步驟12啓動節點

**啓動方式一**：輸入**cd** */home/ghpb-bin/*進入ghpb-bin目錄，繼續輸入

`sudo ./ghpb --datadir node/data  --networkid 100 --port 3004 --syncmode full  --nodetype synnode console；`

當出現「Welcome to the GHPB JavaScript console!」信息時，節點啓動成功。

（13） 提示：節點間測試帶寬的端口號爲本地ghpb端口號加100；開發節點防火牆中本地端口（如3004）必須打開，測試帶寬端口可不打開，選擇啓動方式一時，若是用戶退出遠程服務器或者關掉終端，節點程序將中止運行。

啓動方式二：輸入cd /home/ghpb-bin/進入ghpb-bin目錄後，繼續輸入

sudo nohup ./ghpb --datadir node/data --networkid 100 --verbosity 3 --syncmode full --rpc --rpcapi hpb,web3,admin,txpool,debug,personal,net,miner,prometheus --nodetype synnode &

而後，按兩次回車。

提示：節點間測試帶寬的端口號爲本地ghpb端口號加100；開發節點防火牆中本地端口（默認爲30303）必須打開，測試帶寬端口可不打開，等待15s後繼續輸入命令：

sudo ./ghpb attach http://127.0.0.1:8545

3. 可執行文件搭建示例

(1) 步驟1肯定程序執行路徑

輸入**sudo mkdir** */home/ghpb-bin*建立程序執行路徑；其中/home/ghpb-bin可改成指定路徑

切換成ROOT用戶：輸入su root；根據提示輸入ROOT帳戶密碼。

(2) 步驟2 選擇下載路徑

輸入 **cd** */home/*；其中/home/可改成指定路徑；

(3) 步驟3 下載HPB主網可執行程序

輸入**sudo git clone** <https://github.com/hpb-project/hpb-release>

若是提示hpb-release已存在，則輸入命令：rm -rf hpb-release後再下載hpb-release文件。

(4) 步驟4 查看HPB主網可執行程序

輸入**cd** *hpb-release/*進入hpb-release目錄，輸入ls命令查看該目錄文件，可看到bin、config和README.md三個文件。

(5) 步驟5 拷貝創世文件到執行路徑

輸入**cd** *config/*進入config目錄，繼續輸入**sudo** **cp** gensis.json  /home/ghpb-bin/，其中/hone/gphb-bin/爲您所設置的程序執行路徑。

(6) 步驟6 進入下載路徑

輸入cd .. ，繼續輸入cd bin/，進入到bin目錄，而後解壓HPB主網程序。

輸入sudo tar zxvf ghpb-vx.x.x.x.tar.gz 命令解壓ghpb-vx.x.x.x.tar.gz文件，其中x.x.x.x爲HPB軟件的最新版本號。

(7) 步驟7修改文件權限

輸入 sudo chmod +x ghpb-v0.0.0.1 -R

(8) 步驟8 拷貝程序到執行路徑

輸入sudo cp ghpb-vX.X.X.X/* /home/ghpb-bin/，其中/home/ghpb-bin/爲您設置的程序執行路徑；

(9) 步驟9 初始化節點

輸入**cd** */home/ghpb-bin/*進入程序執行路徑；繼續輸入**sudo** *./ghpb* **--datadir** *node/data* **init** *gensis.json*，當出現」Successfully wrote genesis state database=chaindata」時，繼續下一步；其中/home/ghpb-bin/爲您設置的程序執行路徑；

(10) 步驟10 導出帳戶

從HPB錢包導出您的帳戶信息文件,建立keystore,輸入cd node/data/後繼續輸入mkdir keystore便可；

輸入ls可看到ghpb和keystore兩個文件。

(11) 步驟11導入節點

按順序進入路徑/home/ghpb-bin/node/data/keystore，將帳戶信息文件拷入keystore文件夾中；

提示：若是沒有權限進入這個目錄，輸入命令 chmod 777 /home/ghpb-bin -R，以後再從新進入。

(12) 步驟12 新建帳戶

輸入*./ghpb* **--datadir** *node/data* **account new**，稍等片刻根據提示設置新帳戶的密碼，重複輸入後將返回新帳戶地址，用戶需記錄該地址；

(13) 步驟13啓動節點

啓動方式一：輸入cd /home/ghpb-bin/進入ghpb-bin目錄；

繼續輸入

sudo ./ghpb --datadir node/data --networkid 100 --port 3004 --syncmode full --nodetype synnode console；

當出現「Welcome to the GHPB JavaScript console!」信息時，節點啓動成功。

提示：節點間測試帶寬的端口號爲本地ghpb端口號加100；開發節點防火牆中本地端口（如3004）必須打開，測試帶寬端口可不打開,選擇啓動方式一時，若是用戶退出遠程服務器或者關掉終端，節點程序將中止運行。

啓動方式二：輸入cd /home/ghpb-bin/進入ghpb-bin目錄；

繼續輸入

sudo nohup ./ghpb --datadir node/data --networkid 100 --verbosity 3 --syncmode full --rpc --rpcapi hpb,web3,admin,txpool,debug,personal,net,miner,prometheus --nodetype synnode &

而後，按兩次回車；

提示：節點間測試帶寬的端口號爲本地ghpb端口號加100；開發節點防火牆中本地端口（默認爲30303）必須打開，測試帶寬端口可不打開，等待10s後繼續輸入命令：

sudo ./ghpb attach http://127.0.0.1:8545

做者：感謝HPB Wallet 開發團隊整理供稿。

更多技術諮詢

1.若是你想了解更多關於HPB的技術信息，請訪問咱們的GitHub WiKi：

HPB WiKi of GitHub

2.若是你想得到更多HPB信息，請關注咱們的官方網站：

HPB Website