1.概述
本文列举运行升级工具时，可能出现的报错和解决方案。
2.升级弹出”upgrade fail:.upgrade 文件夹不完整, 请删除该文件夹, 并重试”
问题现象：升级弹出”upgrade fail:.upgrade 文件夹不完整, 请删除该文件夹, 并重试”
原因分析：使用升级工具时没权限或者空间不足导致.upgrade文件夹不全或是升级成功或失败后未成功删除.upgrade文件
解决方案：
① 删除升级工具同级文件夹下的.upgrade文件夹，重启升级工具；
② 如果已经删除了文件夹还是报错，且无隐藏文件，可以把升级工具换个文件夹后进行升级。
ps：① .upgrade文件夹可能会被隐藏，Windows需要设置显示隐藏文件夹，在Linux中使用ls -a指令才能看到
② 升级工具要生成文件可能涉及到一些权限问题，所以win最好不要放到系统盘c盘，linux不要直接放到opt/或者usr/local之类的文件夹下
3.报错upgrade fail: Please check the database service to ensure that it is available jdbc :hsqldb:file:///data/software/tomcat/webapps/webroot/WEB-INF/embed/finedb/db
问题现象：运行升级工具报错：upgrade fail: Please check the database service to ensure that it is available jdbc :hsqldb:file:///data/software/tomcat/webapps/webroot/WEB-INF/embed/finedb/db
原因分析：升级时工程未关闭或者后台进程没有关干净，升级工具无法启动将要升级的工程
解决方案：关闭工程，重新执行升级工具。linux关闭工程参考：https://help.fanruan.com/finereport/doc-view-3977.html?source=4
4.启动升级工具失败，报错“段错误”或“段错误（dumped core）”
问题现象：
原因分析：上传文件时的编码方式有关，不同操作系统间传输过程导致编码问题
解决方案：Linux中升级工具获取优先推荐oss链接下载，上传工具建议使用xftp。
5.启动升级工具时Windows报错“此应用无法在你的电脑运行”
问题现象：
原因分析：升级工具完整性有问题，下载的时候出现异常导致文件不完整文件损坏
解决方案：重新下载升级工具，下载完成后注意文件大小正常应该会有1.3个G左右
6.升级过程中弹出报错，形如"Fail to write entity Entity"
问题现象：
原因分析：备份finedb失败
解决方案：检查工程中智能运维-备份还原-平台配置的备份是否正常，保证工程备份平台配置能够成功，如备份失败，可联系我们的技术人员协助排查。
7.Linux中启动升级工具报错“cannot execute binary file：Exec format error”
问题现象：
原因分析：Linux为arm架构，无法启动amd64版本的升级工具
解决方案：使用arm版本升级工具，形如FineUpgrade_v11_linux_2022-02-22-arm64-ENG.sh。
ps:可以使用uname -m 查询服务器架构，常见x86_64(amd)，aarch64(arm)
8.升级失败，报错upgrade fail ：Port：38888，39888 is already used
问题现象：
原因分析：升级的环境中有工程占用了websocket端口
解决方案：关闭占用了websocket端口的工程
9.升级失败，报错有“There is insufficient memory for the Java Runtime Environment to continue”
问题现象：
原因分析：后台Tomcat进程没有关闭占用内存
解决方案：ps -ef |grep tomcat查看Tomcat相关进程，kill对应的pid，可参考：https://help.fanruan.com/finereport/doc-view-3977.html?source=4
10.升级工具卡住进度条一直没有动
问题现象：
upgrade.log日志搜索关键字Fine assist start failed会有会有报错：
Caused by:com.sun.tools.attach.AttachNotSupportedException
原因分析：\webapps\webroot\WEB-INF\lib的tools.jar影响升级工具启动工程
解决方案：删除\webapps\webroot\WEB-INF\lib的下的tools.jar