1.概述
本文列举运行升级工具时，可能出现的报错和解决方案。
2. 启动升级工具出现报错
2.1 升级弹出”upgrade fail:.upgrade 文件夹不完整, 请删除该文件夹, 并重试”
问题现象：
升级弹出”upgrade fail:.upgrade 文件夹不完整, 请删除该文件夹, 并重试”
原因分析：
使用升级工具时没权限或者空间不足导致.upgrade文件夹不全或是升级成功或失败后未成功删除.upgrade文件
解决方案：
① 删除升级工具同级文件夹下的.upgrade文件夹，重启升级工具；
② 如果已经删除了文件夹还是报错，且无隐藏文件，可以把升级工具换个文件夹后进行升级。
注：1）.upgrade文件夹可能会被隐藏，Windows需要设置显示隐藏文件夹，在Linux中使用ls -a指令才能看到
2） 升级工具要生成文件可能涉及到一些权限问题，所以win最好不要放到系统盘 c 盘，linux 不要直接放到 opt/或者usr/local 之类的文件夹下
2.2 报错“段错误”或“段错误（dumped core）
问题现象：
启动升级工具失败，报错“段错误”或“段错误（dumped core）”
原因分析：
上传文件时的编码方式有关，不同操作系统间传输过程导致编码问题
解决方案：
Linux中升级工具获取优先推荐oss链接下载，上传工具建议使用xftp。
2.3 Windows报错“此应用无法在你的电脑运行”
问题现象：
原因分析：
升级工具完整性有问题，下载的时候出现异常导致文件不完整文件损坏
解决方案：
重新下载升级工具，下载完成后注意文件大小正常应该会有 1.3 个 G 左右
2.4 Linux中启动升级工具报错“cannot execute binary file：Exec format error”
问题现象：
原因分析：
Linux 为 arm 架构，无法启动 amd64 版本的升级工具
解决方案：
使用 arm 版本升级工具，形如 FineUpgrade_v11_linux_2022-02-22-arm64-ENG.sh。
注：可以使用uname -m 查询服务器架构，常见x86_64(amd)，aarch64(arm)
2.5 升级工具执行失败报错：segmentation fault
问题现象：
原因分析：
升级工具文件上传 linux 系统过程编码异常导致。
解决方案：
重打压缩包后传输。
3. 升级过程中出现报错
3.1 升级过程中弹出报错"Fail to write entity Entity"
问题现象：
原因分析：
备份finedb失败
解决方案：
检查工程中智能运维-备份还原-平台配置的备份是否正常，保证工程备份平台配置能够成功，如备份失败，可联系我们的技术人员协助排查。
3.2 报错 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
3.3 升级过程中跳出，弹出提示空间不足
问题现象：升级过程中出现提示：设备上没有空间
原因分析：
设备空间不足
解决方案：
保证空间充足
3.4 升级失败，日志报错“Error while dialing dial tcp :20216: connect: connection refused"
问题现象：
原因分析：
升级工程 webroot\WEB-INF\lib 下有 jar 的 .bak 文件被意外扫描为 jar 包。
解决方案：
移除 webroot\WEB-INF\lib下jar 的 .bak 文件，检查确保 lib 下无 jar 的 .bak 文件。
3.5 升级到备份就卡住，而且出现进度倒退的情况
原因分析：
后台有一个额外的升级工具进程没能正确关闭，可能导致前台进度读混乱。
解决方案：
杀掉进程后重新升级。
3.6 升级备份过程失败，工具闪退
问题描述：
linux 下执行升级工具备份工程是失败，并且升级工具闪退。
原因分析：
升级工具执行备份的过程中，乱码的文件无法执行会导致闪退。
解决方案：
1）将可能存在乱码的目录移除，待升级成功后再移入对应的文件夹中。
2）确认升级工具的大小（V11工具是1.31G），避免出现因传输工具导致文件缺失。
3）确认传输过程升级工具的编码，可以本地将工具压缩，上传到linux下再解压
4. 升级失败
4.1 报错upgrade fail ：Port：38888，39888 is already used
问题现象：
原因分析：
升级的环境中有工程占用了websocket端口
解决方案：
关闭占用了websocket端口的工程
4.2 报错有“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
5. 升级工具卡住进度条一直没有动
问题现象：
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
