PIP-3操作手册(PIP-3 Node Manuel)

版本信息

ChainID: 100

Version: 1.1.0

Git Commit: f86c9f8469105ab1969316aefe259b9b5ab3308e

1、安装指南

​ 若已安装了PlatON节点,请跳到第2点进行更新操作;

​ 未安装节点,请严格按照官方文档安装,如有需要帮助请联系客服。

2、更新指南(先更新,暂不重启)

​ 以下步骤以 Ubuntu18.04 系统为例,更新操作分为两种方式:源码编译、直接使用二进制,请严格按照以下步骤操作升级,如有需要帮助请联系客服。

  • 源码编译(针对之前已成功编译过的环境,全新编译请参考官网源码安装

    # 备份二进制
    $ [[ -x /usr/bin/platon ]] && sudo mv /usr/bin/platon /usr/bin/platon_`platon version | grep '^Version:' | awk -F "[ ,:,-]" '{print $3}'`
    # 编译二进制
    $ git clone https://github.com/PlatONnetwork/PlatON-Go.git --recursive
    $ cd PlatON-Go/
    $ git checkout -b platon-1.1.0  f86c9f8469105ab1969316aefe259b9b5ab3308e
    # 安装依赖和编译,如果出现missing go.sum entry for module,使用go mod tidy移除未使用和添加缺失的依赖
    $ go mod download && make all
    # 使用新的版本
    $ chmod +x build/bin/platon
    $ sudo mv build/bin/platon /usr/bin/platon
    # 查看版本
    $ platon version
    Version: 1.1.0-unstable
    Git Commit: f86c9f8469105ab1969316aefe259b9b5ab3308e
    
  • 直接用二进制

    # 备份二进制
    $ [[ -x /usr/bin/platon ]] && sudo mv /usr/bin/platon /usr/bin/platon_`platon version | grep '^Version:' | awk -F "[ ,:,-]" '{print $3}'`
    # 下载最新的二进制文件
    $ wget https://download.platon.network/platon/platon/1.1.0/platon
    # 使用新的版本
    $ chmod +x platon
    $ sudo mv platon /usr/bin/platon
    # 查看版本
    $ platon version
    Version: 1.1.0-unstable
    Git Commit: f86c9f8469105ab1969316aefe259b9b5ab3308e
    

3、择机重启进程

如果当前节点质押过,首先通过区块链浏览器查看节点是否已经被选为验证人(共识中)
如果已经当选,请等待节点退出验证人(共识中转为活跃中)后再进行重启操作。

以下命令仅做参考,根据各自的管理方式,重启platon进程

nohup platon --identity platon --datadir ./data --port 16789 --rpcport 6789 --rpcapi "db,platon,net,web3,admin,personal" --rpc --nodekey ./data/nodekey --cbft.blskey ./data/blskey --verbosity 1 --rpcaddr 127.0.0.1 --syncmode "fast" >./data/platon.log 2>&1 &

4、提案处理

  • 质押过的节点,请通过区块链浏览器查看当前节点是否是以下状态:
  1. 出块中
  2. 共识中
  3. 活跃中

如果当前节点为上述3中状态的一种,请参考以下命令进行投票,提案id为<0xe193676cc5e0c8f057622cf70bb7ebce193d24a3e5b566ba41ea045c8c6157e5>:

# 升级提案投票命令示例
$ platon_mtool vote_versionproposal --proposalid 0xe193676cc5e0c8f057622cf70bb7ebce193d24a3e5b566ba41ea045c8c6157e5 --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json

如果节点状态为“候选中”,则需要做版本声明,请参考以下命令进行版本声明。

#版本声明示例
$ platon_mtool declare_version --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json
  • 未质押过的节点,跳过本步骤。
  • 没定义$PLATON_MTOOLDIR的,需要根据实际部署情况补全绝对路径。

5、反馈

platon升级失败的,可通过以下渠道反馈。

  1. 验证人微信群
  2. 邮箱 validator@platon.network
1 Like