PlatON v1.5.1版本升级操作说明

PlatON云图 验证节点
#1

PlatON v1.5.1版本升级操作说明

1、版本信息

本次PlatON版本信息如下：

ChainID: 210425

Version: 1.5.1

Git Commit: a8468d02836130c1fa4d928f0731f40f5ab4add0

二进制下载：
Ubuntu 18.04系统：
https://download.platon.network/platon/platon/1.5.1/platon
Ubuntu 20.04系统：
https://download.platon.network/platon/platon/ubuntu20.04/1.5.1/platon

Ubuntu 22.04系统：
https://download.platon.network/platon/platon/ubuntu22.04/1.5.1/platon

2、版本特性

  • 启用snap同步模式，相比于fast速度更快
  • 支持debug_trace接口
  • 同步以太坊版本1.10.17 ~ 1.11.0特性
  • 支持eth_getBlockReceipts方法获取区块内所有交易回执

3、说明

PlatON 自v1.5.1开始支持 snap 同步功能，fast同步不再支持，之前使用 fast 模式启动的节点请调整为 snap 模式。

4、安装指南

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

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

5、更新指南（先更新，暂不重启）

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

  • 直接用二进制

    # 备份二进制
$ [[ -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.5.1/platon

# 使用新的版本
$ chmod +x platon
$ sudo mv platon /usr/bin/platon

# 查看版本
$ platon version
Version: 1.5.1-unstable
Git Commit: a8468d02836130c1fa4d928f0731f40f5ab4add0

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

    # 备份二进制
$ [[ -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.5.1  a8468d02836130c1fa4d928f0731f40f5ab4add0

# 安装依赖和编译，如果出现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.5.1-unstable
Git Commit: a8468d02836130c1fa4d928f0731f40f5ab4add0

6、检查启动参数并择机重启进程

如果当前节点质押过，首先通过区块链浏览器查看节点是否已经被选为验证人（共识中）
如果已经当选，请等待节点退出验证人（共识中转为活跃中）后再进行重启操作。以下命令仅做参考，根据各自的管理方式，重启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 --http --http.port 6789 --http.api "platon,net,web3,admin" --http.addr "127.0.0.1" --nodekey ./data/nodekey --cbft.blskey ./data/blskey --verbosity 1  --syncmode "snap" > ./data/platon.log 2>&1 &

之前使用fast同步模式的节点请格外注意 因新版本已不再支持fast模式，仍使用原启动参数会导致启动失败， 请及时将syncmode调整为 snap.

重启后进入控制台检查节点版本是否生效：v1.5.1-unstable-a8468d02

$ platon attach http://localhost:6789
Welcome to the PlatON JavaScript console!
PlatONnetwork/x.x.x.x/v1.5.1-unstable-a8468d02

7、版本声明

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

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

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

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

8、反馈

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

  1. Telegram 验证节点群
  2. 邮箱 validator@platon.network
#2