【重要】MTool版本更新公告

节点伙伴们,我们在MTool现运行版本中发现了严重Bug,内容如下:

  • 在一些特定场景下,MTool从底层获取Gas Price会出现为0的情况,但MTool依然会发送该交易上链,导致该交易堵塞在交易池中,进而会影响该钱包地址后面发送交易都会被阻塞的问题;
  • 解决方案:节点工具MTool对Gas Price 为0的特殊情况进行处理,设置为默认Gas Price值
  • 影响范围:Alaya MTool 0.16.0、PlatON MTool 1.0.0及之前所有版本

交易堵塞并没有有效的检测方法,为了避免影响到您节点及钱包的重要操作,建议所有节点伙伴尽快升级MTool新版本以彻底解决此问题。

MTool更新手册如下:

一、Alaya MTool

以下安装方式为在线机器上的安装,如果在离线机器上安装,可使用移动 U 盘或者移动硬盘进行拷贝安装包到离线机器上,安装方法和在线安装方法一样。

1.1、Windows 下更新 Alaya MTool

1.1.1、安装前准备

在更新前,请您务必先备份MTool目录中的重要文件,然后再手工卸载旧版本,操作步骤:

step1. 备份目录

C:\alaya_mtool\mtool\current\keystoreC:\alaya_mtool\mtool\current\validator 目录备份到其他目录下(请勿备份到 C:\alaya_mtool下)。安装完新版本之后需要将备份目录拷贝回 C:\alaya_mtool\mtool\current\ 目录下。 (如果安装目录为自定义目录,则以实际为准)

step2. 卸载旧版本

双击 C:\alaya_mtool\unins000.exe 卸载所有旧版本的 MTool 及其他业务工具。

1.1.2、开始安装

step1. 下载 MTool 安装包

在在线机器上,复制链接https://download.alaya.network/alaya/mtool/windows/0.16.1/alaya_mtool.exe 到浏览器下载 MTool 安装包。

step2. 安装 MTool

双击 alaya_mtool.exe 进行安装。默认安装目录为 C:\alaya_mtool,建议不要更改此安装目录。弹出界面显示Completing the mtool Setup Wizard信息表示安装成功,点击Finish即可。

step3. 重启终端

安装完成之后,需要重启终端,让新添加的环境变量生效。

step4. 验证

打开一个PowerShell或其他命令行工具窗口,执行以下命令,并将返回的版本号信息截图发送给节点社区服务人员Colinan,以便确认升级是否成功。

alaya_mtool --version

1.2、Ubuntu 下更新 Alaya MTool

1.2.1、安装前准备

step1.备份钱包文件与节点配置文件

备份旧版本软件,可以参考将alaya_mtool文件夹重命名为alaya_mtool_bak,安装完新版本之后需要将旧版本目录中文件 ~/alaya_mtool_bak/keystore~/alaya_mtool_bak/validator拷贝回新版本对应目录下。

mv alaya_mtool alaya_mtool_bak    //alaya_mtool_bak 可根据自己实际情况定义,不要和目前文件夹名称相同

step2.删除老版本安装文件

rm -rf alaya_mtool.zip

1.2.2、开始安装

步骤如下:

step1. 下载 MTool 工具包

wget https://download.alaya.network/alaya/mtool/linux/0.16.1/alaya_mtool.zip

step2. 解压 MTool 工具包

(if ! command -v unzip;then sudo apt install unzip; fi;) && unzip alaya_mtool.zip && cd alaya_mtool

step3. 下载脚本

脚本下载到alaya_mtool 目录下,否则脚本无法找到新版本 mtool 的路径。

wget https://download.alaya.network/alaya/scripts/mtool_install.sh

备注: 如果为离线方式安装,需要手工下载jdk并设置java环境变量后在执行脚本。 jdk下载链接https://download.platon.network/third-tools/jdk-8u221-linux-x64.tar.gz

step4. 执行命令

chmod +x mtool_install.sh && ./mtool_install.sh
  • 提示 Install mtool succeed. 时,表示 MTool 安装成功,未安装成功时,请通过我们的官方客服联系方式反馈具体问题。

step5.恢复备份的钱包与配置文件

cd .. && mv alaya_mtool_bak/keystore/* alaya_mtool/keystore/ && mv alaya_mtool_bak/validator/* alaya_mtool/validator/

step6. 重新启动会话窗口

安装完成之后,需要重新启动会话窗口,让新添加的环境变量生效。

step7. 验证
重启会话窗口后,执行以下命令,并将返回的版本号信息截图发送给节点社区服务人员Colinan,以便确认升级是否成功。

alaya_mtool --version

二、PlatON MTool

2.1、Windows下更新PlatON MTool

2.1.1、安装前准备

在更新前,请您务必先备份MTool目录中的重要文件,然后再手工卸载旧版本,操作步骤:

step1. 备份目录

C:\platon_mtool\mtool\current\keystoreC:\platon_mtool\mtool\current\validator 目录备份到其他目录下(请勿备份到 C:\platon_mtool下)。安装完新版本之后需要将备份目录拷贝回 C:\platon_mtool\mtool\current\ 目录下。 (如果安装目录为自定义目录,则以实际为准)

step2. 卸载旧版本

双击 C:\platon_mtool\unins000.exe 卸载所有旧版本的 PlatON MTool 及其他业务工具。

2.1.2、开始安装

step1. 下载PlatON MTool安装包

在在线机器上,复制链接https://download.platon.network/platon/mtool/windows/1.0.1/platon_mtool.exe 到浏览器下载PlatON MTool安装包。

step2. 安装PlatON MTool

双击platon_mtool.exe进行安装。默认安装目录为 C:\platon_mtool,建议不要更改此安装目录。弹出界面显示Completing the mtool Setup Wizard信息表示安装成功,点击Finish即可。

step3. 重启终端

安装完成之后,需要重启终端(非重启服务器,关闭Cmd窗口或PowerShell窗口重新打开窗口即可),让新添加的环境变量生效。

step4. 验证

打开一个PowerShell或其他命令行工具窗口,执行以下命令,并将返回的版本号信息截图发送给节点社区服务人员Colinan,以便确认升级是否成功。

platon_mtool --version

2.2、Ubuntu下更新PlatON MTool

2.2.1、安装前准备

step1.备份钱包文件与节点配置文件

备份旧版本软件,安装完新版本之后需要将旧版本目录中文件 ~/platon_mtool_bak/keystore~/platon_mtool_bak/validator拷贝回新版本对应目录下。

mv platon_mtool platon_mtool_bak    //platon_mtool_bak 可根据自己实际情况定义,不要和目前文件夹名称相同

step2.删除老版本安装文件

rm -rf platon_mtool.zip

2.2.2、开始安装

步骤如下:

step1. 下载PlatON MTool工具包

wget https://download.platon.network/platon/mtool/linux/1.0.1/platon_mtool.zip

step2. 解压PlatON MTool工具包

(if ! command -v unzip;then sudo apt install unzip; fi;) && unzip platon_mtool.zip && cd platon_mtool

step3. 下载脚本

脚本下载到platon_mtool 目录下,否则脚本无法找到新版本mtool的路径。

wget https://download.platon.network/platon/scripts/mtool_install.sh

备注: 如果为离线方式安装,需要手工下载jdk并设置java环境变量后在执行脚本。 jdk下载链接https://download.platon.network/third-tools/jdk-8u221-linux-x64.tar.gz

step4. 执行命令

chmod +x mtool_install.sh && ./mtool_install.sh
  • 提示 Install platon mtool succeed. 时,表示 PlatON MTool 安装成功,未安装成功时,请通过我们的社区服务人员联系方式反馈具体问题。

step5.恢复备份的钱包与配置文件

cd .. && mv platon_mtool_bak/keystore/* platon_mtool/keystore/ && mv platon_mtool_bak/validator/* platon_mtool/validator/

step6. 重新启动会话窗口

安装完成之后,需要重新启动会话窗口(非重启服务器,关闭会话窗口或ssh工具重新打开窗口即可),让新添加的环境变量生效。

step7. 验证
重启会话窗口后,执行以下命令,并将返回的版本号信息截图发送给节点社区服务人员Colinan,以便确认升级是否成功。

platon_mtool --version

有使用最老版本的mtool-client涉及ssl访问的,需要同时复制 ca.crt 文件,并确认 validator/validator_config.json文件中 certificate的路径值,否则会报错:

com.platon.mtool.common.exception.MtoolException: certificate not found
2 Likes

666, 不愧是 运维专家