PlatON主网节点升级操作指南-v1.4.2

版本信息

ChainID: 210425

Version: 1.4.2

Git Commit: 382e9431034c9a3a2e9d748598d6770242743f54

二进制下载(二选一):
Ubuntu 18.04系统:
https://download.platon.network/platon/platon/1.4.2/platon
Ubuntu 20.04系统:
https://download.platon.network/platon/platon/ubuntu20.04/1.4.2/platon

注意:本次文档新增Ubuntu 20.04系统对应二进制文件

推荐配置

  • 服务器: 运行PlatON软件的服务器和备份服务器(均需具备防火墙)
  • 内存: 16GB RAM
  • 本地存储: 100GB系统盘、200GB数据盘(可在线扩容)
  • 处理器: 64位4核 (每核2.4 GHz以上)
  • 带宽: 5 MB/秒(可在线扩容)

1、安装指南

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

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

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

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

  • 直接用二进制

    # 备份二进制
    $ [[ -x /usr/bin/platon ]] && sudo mv /usr/bin/platon /usr/bin/platon_`platon version | grep '^Version:' | awk -F "[ ,:,-]" '{print $3}'`
    
    # 根据节点的主机系统,选择最新的二进制文件(二选一)
    # Ubuntu 18.04的platon版本
    $ wget https://download.platon.network/platon/platon/1.4.2/platon
    # Ubuntu 20.04的platon版本
    $ wget https://download.platon.network/platon/platon/ubuntu20.04/1.4.2/platon
    
    # 使用新的版本
    $ chmod +x platon
    $ sudo mv platon /usr/bin/platon
    
    # 查看版本
    $ platon version
    Version: 1.4.2-unstable
    Git Commit: 382e9431034c9a3a2e9d748598d6770242743f54
    
  • 源码编译(针对之前已成功编译过的环境,全新编译请参考官网源码安装

    根据节点的主机系统,选择在Ubuntu18.04或Ubuntu 20.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 fetch --all
    $ git checkout -b platon-1.4.2  382e9431034c9a3a2e9d748598d6770242743f54
    
    # 安装依赖和编译,如果出现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.4.2-unstable
    Git Commit: 382e9431034c9a3a2e9d748598d6770242743f54
    

3、择机重启进程

如果当前节点质押过,首先通过区块链浏览器查看节点是否已经被选为验证人(共识中)
如果已经当选,请等待节点退出验证人(共识中转为活跃中)后再进行重启操作。以下命令仅做参考,根据各自的管理方式,重启platon进程

# 查看进程号
$ ps aux |grep platon
root   13476 39.1 49.7 9174616 3925796 ?     Sl   Feb07 1140:19 /usr/bin/platon  --identity ....

# 停止platon节点,如kill 13476,上述示例中进程号为13476,实际操作时根据实际情况取值;执行kill命令后,可再使用上述ps命令查看进程是否正确退出,若正常退出再执行后续启动命令
$ kill <进程号>

# 启动platon节点
$ nohup platon --identity platon-node --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 &

# 重启后进入控制台检查节点版本是否生效:v1.4.2-unstable-382e9431-20231018
$ platon attach http://localhost:6789
Welcome to the PlatON JavaScript console!

PlatONnetwork/x.x.x.x/v1.4.2-unstable-382e9431-20231018/linux-amd64/go1.18

4、版本声明

当版本声明后,可在浏览器查看节点版本

  • 未质押过的节点,跳过本步骤。

  • 没定义$PLATON_MTOOLDIR的,需要根据实际部署情况补全绝对路径。

    #版本声明示例
    $ platon_mtool declare_version --keystore $PLATON_MTOOLDIR/keystore/staking.json --config $PLATON_MTOOLDIR/validator/validator_config.json
    

5、反馈

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

  1. 微信 bilovexin
  2. Telegram 验证节点群
  3. 邮箱 validator@platon.network