1. 概述
本文主要汇总了小版本升级时的常见问题及解决方案。
1.1 排查思路
如果在线更新升级失败,可参考以下排查步骤进行排查:
1)根据上述外网地址,查看相关地址是否能正常连通。
2)是否有替换文件夹中文件的权限。
3)检查工程中是否有其他多余的jar,可备份后移除尝试。
4)设计器更新注意需要先切换工作目录会设计器目录。
2. 常见问题及解决方案
2.1 JAR 包不匹配导致的异常
现象:点击图表不出现编辑界面或远程设计切换工作目录失败。
原因分析:仅更新了设计器端,没有更新服务端,造成远程设计 JAR 包不匹配。
解决方案:同步更新服务器端到同一版本
2.2 MAC 设计器更新后无法打开模板
原因分析:更新操作不对;mac版本的设计器更新的时候 注意一下 jxbrowser 的包,和 windows 的版本是有区分的,不要拿 windows 版本的去更换。
解决方案:更换 JAR 包
2.3 分辨率异常
原因分析:2019-12-11之后的 JAR 的启动动画不再使用 javaFx ,而插件界面使用 fx 实现,所以点开插件管理设计器会变小,分辨率也会改变,这个是 java8 的 bug 。
解决方案:禁用 dpi,请参考:Windows高分屏下设计器显示问题 。
2.4 设计器卡死
原因分析:
1)设计器卡死出现比较多为3月份的JAR,JAR 包 BUG 。
2)集群环境推送日志的时候也会打印日志,会造成一个递归的调用直到栈溢出。
3)mac版本的设计器,如果同时运行magnet ,会影响报表的性能,导致设计器卡死。
解决方案:
1)更新 JAR 包即可。
2)更新 JAR 到 2019-06 月份之后的版本。
3)禁用 magnet,或者把 magnet 对设计器禁用。
2.5 升级 JAR 后 tomcat 启动闪退
现象:后台报错:java.lang.ClassNotFoundException: com.fr.plugin.cloud.analytics.core.schedule.CollectExecutorJob
原因分析:云端运维插件解压安装影响。
解决方案:删除如图所示 2 个 update 文件夹,重启工程。
2.6 服务器手动更新后平台访问失败且无 catalina.out 日志
现象:服务器部署在 linux 上,手动更新 JAR 包到最新,重启服务器后平台会无法访问,利用备份回退 JAR 包是可以正常访问的;手动重新更换 JAR 包,但是还是访问失败;页面报错“网址拒绝了连接请求”,catalina.out 日志没有输出,catalina.log 为 0kb 。
原因分析:catalina.sh 文件被改过。
解决方案:更换正常的 catalina.sh 文件,重启工程。
2.7 升级后添加用户无法保存,且没有密码选项
现象:升级 JAR 版本之后添加用户有问题,没有密码选项,选择平台内认证保存不上。
原因分析:浏览器缓存导致的。
解决方案:清理浏览器缓存。