Saturn Console部署踩坑总结

时间:2024-03-28 17:36:39

照官网的关于  3.1.0  的文档介绍,一步步做,会遇到一些坑,下面做一下总结

1.修改默认的日志输出路径
官网上给的参数是:SATURN_CONSOLE_LOG,其实这个参数是无效的,官网文档应该是没有更新吧,应该用:saturn.console.log
官网的启动参数描述如下:

Saturn Console部署踩坑总结

我的启动命令如下:

Saturn Console部署踩坑总结

2.浏览器不兼容问题(登录用户名显示不正常)
我们首次访问的时候,右上角看到的登录用户都是Unknown ,我们注销后用默认的用户名密码admin来登录,不同的浏览器上显示的行为不一样;
360极速浏览器上显示一直不正常,谷歌浏览器显示正常

Saturn Console部署踩坑总结

官方解释:手动到数据库表  sys_config 中添加  property为AUTHORIZATION_ENABLED,value为true的记录。
这样添加后,能够解决登录名显示的问题,但下面的配置项值,在360极速浏览器中依然没有显示。
这个确实存在浏览器兼容问题,建议使用谷歌、火狐浏览器。

3.页面缓存问题导致显示不正常
当打开页面的时候,显示Unknown用户,我们换admin用户登录后,页面会丢失两个显示“系统配置”、“权限管理”。

Saturn Console部署踩坑总结

官方解释:缓存问题,强制页面刷新即可。

4.数据库表简单说明
当数据库sql文件执行后,应该是有15张表,其中,用户、角色、权限以及其关联表5张有初始化数据,其他10张表都是空的;
系统第一次启动后,sys_config 这个表会被写入一条记录,值是随机生成的,如下:

Saturn Console部署踩坑总结

系统配置相关的数据都会记录到   sys_config   这个表里面

5.页面系统配置报错
登录成功后,官网文档应该配置ZK集群与Console的绑定。
系统配置   --->   Console配置   --->   ZK集群配置,  配置项:CONSOLE_ZK_CLUSTER_MAPPING,我以  
default:test 为值进行更新,会报错

Saturn Console部署踩坑总结

再去页面刷新,配置项的值被读取出来正常展示。(谷歌浏览器)
官方解释:手动到数据库表  sys_config 中添加  property为CONSOLE_ZK_CLUSTER_MAPPING,value为    default:test   的记录,这个test是我们自己取的ZK集群名称。

6.添加ZK集群(能写入数据库却不能读取)

Saturn Console部署踩坑总结

查看数据库,数据的确写进去了

Saturn Console部署踩坑总结

添加后的效果

Saturn Console部署踩坑总结

如果ZK集群不能正常展示,那么后面的工作就无法开展了。

这个问题困扰了很久,也跟官方人员微信请教过好多次,尝试各种方法,毕竟别人不是现场查看,可谓是历经艰难,在我的虚拟机里面,无意间重装系统,重新配置系统环境,得到了解决。
系统启动的时候会跟网卡以及hosts文件里面的配置有一定的关系。
hosts文件里面,得配上本机的名字。还应该用  hostname -i 查看下当前机器的ip,要能够正常输出 ,不能出现多个ip串。
网卡必须eth0或者bond0。

修改/etc/hosts文件之前的内容:

Saturn Console部署踩坑总结

查看本机的主机名:

Saturn Console部署踩坑总结

在127.0.0.1 的这一行添加上我们的主机名,如下:

Saturn Console部署踩坑总结

查看网卡信息,确保eth0或者bond0。在这个问题上面,也是费了不小的劲儿。
我的环境是CentOS7,修改网卡名称跟CentOS6还是很不一样的,具体的操作过程就不写在这里了,最终修改后如下:

Saturn Console部署踩坑总结

8.登录后,session过期的提示也是挺不合理的。

Saturn Console部署踩坑总结

9.我们第一次部署Console,会遇到下面的问题
登录后,做了一些操作,注销,再次登录怎么都登录不成功,如下图:

Saturn Console部署踩坑总结

强制刷新也是没用的,这个情况,我们需要重启Console就可以解决问题。