## 说明

本次升级主要目的是解决3月9号测试网停止出块的问题。

## 备份旧版本二进制文件

在升级前请备份旧版本二进制文件，请按照之前的安装方式从以下两种方式中选择其中合适的一种方式进行操作：

- 如果之前是通过PPA方式安装的，二进制文件默认在'/usr/bin/PlatON'目录下，请执行以下命令进行备份：

```
sudo cp /usr/bin/PlatON/platon /tmp/platon0.10.0
```

- 如果是通过源码构建的方式安装的，请根据各自安装的路径备份二进制文件。

## 升级

请按照旧版本的安装方式从以下三种方式中选择其中合适的一种方式进行操作：

- 如果您之前是通过PPA的方式安装的platon，请重新安装0.10.1版本，执行以下命令：

```
sudo apt update && sudo apt remove platon0.10.0 --purge && sudo apt install platon0.10.1
```

- 如果您上一个版本是通过源码编译的方式安装的，请通过以下命令重新编译：

```
git pull origin release-0.10.0 && make clean && make all
```

编译完成后，请将编译生成的'platon'文件（默认会生成到$PlatON-Go/build/bin）拷贝到原来'platon'所在目录。


- 如果您之前是通过二进制直接安装的，请重新从PlatON官方[下载渠道](http://47.91.153.183/platon-node/0.10.1-20200310/platon-ubuntu-amd64-0.10.1.tar.gz)下载正确的platon二进制压缩文件后，将文件解压到之前platon安装的目录。

注意：以下假设之前的platon安装在'/usr/bin/PlatON/'目录

```
sudo tar -xvf platon-ubuntu-amd64-0.10.1.tar.gz --strip-components 1 -C /usr/bin/PlatON/ && sudo chmod +x /usr/bin/PlatON/platon
```

## 校对版本信息

升级完成后，请执行以下命令查看版本信息：

```
platon version
```

请确认版本信息跟以下信息是一致的：

```
Version: 0.10.1-unstable
Git Commit: 1bc1d754bbc4ac338559cdd0622884a17eec110c
```

## 检查磁盘空间

**请确保platon进程指定的'datadir'路径所在磁盘有至少有5G剩余空间。**

## 重启

重启节点请按照以下节点类型以下两种方式中选择其中合适的一种方式进行操作：

- 当前共识轮的节点
  
  当前共识轮的节点包括KubePool 、CloudPool、istaking、MATPool、PlatGo、DolphinTwo、Walkpos、Bit Cat、topool、浜離宮、BlockTEST、RooPool、WonderBox、OG、SNZPool、platon.node.3、BlockPool、FinNX、crazybee、DeepCore、wayish、S5、DMX、Xpool、HelloPool。
  
  以上节点请首先确认服务器上是否已经安装了screen（可以通过'screen -h'命令看是否有帮助文档输出），如果没有安装，请先安装：

  ```
  sudo apt update && sudo apt install screen
  ```
  确认安装好screen后，从[这里](http://47.91.153.183/opensource/scripts/timer_restart.sh)下载脚本`timer_restart.sh`，建议保存到PlatON数据目录`datadir`平级目录，并在脚本的保存目录中执行以下命令：

  **注意：请将命令行中的'{datadir}'替换为platon进程启动时'--datadir'所指定目录的绝对路径**

  ```
  chmod u+x ./timer_restart.sh
  screen -S updateplaton20200311
  sh ./timer_restart.sh {datadir}
  ```
  > timer_restart脚本中按UTC时间指定了统一启动的时间点，执行完上述脚本后请耐心等待节点进程启动
  如果在升级过程中终端退出，重新登录终端后使用'screen -r updateplaton20200311'重新回到screen查看升级状态

- 其他节点
  
  其他节点请从[这里](http://47.91.153.183/opensource/scripts/restart.sh)下载脚本`restart.sh`，建议保存到PlatON数据目录`datadir`平级目录，并在脚本的保存目录中执行以下命令：

  **注意：请将命令行中的'{datadir}'替换为platon进程启动时'--datadir'所指定目录的绝对路径**

  ```
  chmod u+x ./restart.sh
  sh ./restart.sh {datadir}
  ```
  > restart.sh脚本直接重新启动节点进程，重启后链可能不会恢复，请耐心等待当前轮共识节点升级完成


## 检查

到了进程启动时间点（具体时间请查看公告）后，请查看进程启动情况，如不能正常启动，请及时联系客服人员。