# 安装

# gvite节点是什么?

gvite节点分为全节点和超级节点，超级节点是特殊的全节点。目前全节点存储全量的账本数据，并且和全网同步数据达成共识。 全节点可以完成GVITE支持的所有功能，例如通过全节点，可以获取全网的数据，也可以作为发送交易和接收交易的操作节点以及竞选超级节点和对超级节点投票。 全节点支持开启 HTTP、WEBSOCKET 和 IPC API，同样支持命令行模式和其交互。

# 开始之前

安装方式支持二进制安装和源码安装两种

# 二进制文件安装

通过命令行下载和安装gvite, 支持ubuntu、mac、centos、windows

# ubuntu安装示例

## 下载
curl -L -O https://github.com/vitelabs/go-vite/releases/download/1.0.2/gvite-1.0.2-linux.tar.gz

## 解压
tar -xzvf gvite-1.0.2-linux.tar.gz

## 进入解压目录，包含三个文件 gvite、bootstrap 和 node_config.json
cd gvite-1.0.2-linux

## 启动
./bootstrap

程序是否正常启动，通过查看启动脚本所在目录的 gvite.log 看日志来确定, 这个文件

cat gvite.log

如下说明启动成功

t=2018-11-09T17:44:48+0800 lvl=info msg=NodeServer.DataDir:/home/ubuntu/.gvite/testdata module=gvite/node_manager
t=2018-11-09T17:44:48+0800 lvl=info msg=NodeServer.KeyStoreDir:/home/ubuntu/.gvite/testdata/wallet module=gvite/node_manager
Prepare the Node success!!!
Start the Node success!!!

# mac 安装示例

## 下载
curl -L -O https://github.com/vitelabs/go-vite/releases/download/1.0.2/gvite-1.0.2-darwin.tar.gz
## 解压
tar -xzvf gvite-1.0.2-darwin.tar.gz
## 进入解压目录，包含三个文件 gvite、bootstrap 和 node_config.json
cd gvite-1.0.2-darwin
## 启动
./bootstrap

程序是否正常启动，通过查看启动脚本所在目录的 gvite.log 看日志来确定, 这个文件

cat gvite.log

如下说明启动成功

t=2018-11-09T17:44:48+0800 lvl=info msg=NodeServer.DataDir:~/Library/GVite/testdata module=gvite/node_manager
t=2018-11-09T17:44:48+0800 lvl=info msg=NodeServer.KeyStoreDir:~/Library/GVite/testdata/wallet module=gvite/node_manager
Prepare the Node success!!!
Start the Node success!!!

# 安装目录文件说明

安装目录：指gvite启动脚本和配置文件所在文件夹。例如上文中的安装目录路径为： ~/gvite-${version}-${os}

• gvite： 执行程序
• bootstrap： 启动脚本
• node_config.json： 配置文件 配置说明

# 端口

系统默认端口 8483、8484，需要保证没有被其他程序占用，并且防火墙允许其通信

 netstat -nlp|grep 8483 

确定是否有被占用，例如gvite正常启动后会显示

netstat -nlp|grep 8483
(Not all processes could be identified, non-owned process info
 will not be shown, you would have to be root to see it all.)
tcp6       0      0 :::8483                 :::*                    LISTEN      22821/gvite     
udp6       0      0 :::8483                 :::*                                22821/gvite

# 运行目录说明

cd ~/.gvite/testdata

这是gvite的数据目录，在下面你会看到ledger ledger_files LOCK p2p rpclog runlog wallet 等目录和文件。 gvite 数据目录说明:

• ledger： 账本目录
• rpclog： rpc访问日志
• runlog： 运行日志目录, runlog目录
• wallet： 钱包keyStore目录，用于存储私钥生成的keyStore文件，如果是超级节点涉及到挖矿账户安全，请妥善保管

mac 默认目录：~/Library/GVite/testdata

# 源码安装

# golang 环境确认

go env

# 编译可执行文件

• 在终端执行

  go get github.com/vitelabs/go-vite

代码所在位置

$GOPATH/src/github.com/vitelabs/go-vite/

GOPATH 默认位置是 ~/go

进入代码所在目录并运行

make gvite

生成的gvite可执行文件位于：

$GOPATH/src/github.com/vitelabs/go-vite/build/cmd/gvite/gvite

# 配置文件配置

node_config.json 参见: 配置文件说明

# 启动脚本编写

配置文件和编译后的gvite在同一目录，例如linux 环境通过执行

nohup ./gvite -pprof >> gvite.log 2>&1 &

启动

# 监控

# 命令行确认当前节点高度

• 首先参照全节点的启动方式，启动全节点。

• 通过命令行连接全节点：找到全节点的安装目录。进入到该目录，然后执行如下命令

  Unix/Linux平台：

  ./gvite attach ~/.gvite/testdata/gvite.ipc
  

  Windows平台：

  gvite-windows-amd64.exe attach \\.\pipe\gvite.ipc
  

  在交互命令行中输入：

  vite.ledger_getSnapshotChainHeight();
  

  得到

  "{\"id\":0,\"jsonrpc\":\"2.0\",\"result\":\"499967\"}"
  

  499967 即为当前的高度，命令行支持的更多命令参见 vite.help 命令

# 全节点奖励配置

Gvite-1.1.1起新增了全节点奖励功能。用户运行一个全节点并满足以下版本和配置要求，即可参加全节点奖励活动。

本文档主要阐述如何为全节点添加奖励相关配置，全节点如何运行，参见安装。

# 版本要求

全节点最低版本要求: 1.1.1

# 配置要求

当前，vite对运行全节点会发放一定量的奖励，参与奖励的全节点需要进行一些额外的配置。

1. 配置全节点状态数据上报地址: "DashboardTargetURL":"wss://stats.vite.net"
2. 在PublicModules配置项中新增"dashboard";
3. 新增接收奖励地址: "RewardAddr":"vite_xxxx", 此地址为奖励发放地址, 请确保保管好私钥;

配置文件新增加项如下所示(确保最终的node_config.json文件符合json格式):

  "PublicModules": [
    "ledger",
    "public_onroad",
    "net",
    "contract",
    "pledge",
    "register",
    "vote",
    "mintage",
    "consensusGroup",
    "tx",
    "dashboard"  // 新增加
  ],
  "DashboardTargetURL":"wss://stats.vite.net",  // 新增加
  "RewardAddr":"vite_xxx"   // 新增加

# 配置结果check

当配置完成并重启节点后, 可以检查链接内容(链接内容刷新5min内有延迟), 查看是否包含自己节点, 并检查是否配置成功(例如地址和名称是否正确).

# 下一步

• 配置超级节点
• 节点钱包管理
• 超级节点运行规则