1.概述
1.1应用场景
现BI已全面开放使用新框架版本,为了能进行更好的产品功能体验,可以在服务器上部署一套新框架BI以供测试。将旧框架BI的支撑库另存一份作为新框架BI的测试支撑库,在测试确认无误后并正式投入使用。在此期间,如果旧框架BI也需要使用,则需要进行BI双开。
BI双开是指在现有安装BI的基础上,增加一个新的BI启动窗口,能和原来的BI同时使用且不冲突。BI默认安装的地址是localhost:8080,双开后生成新的端口链接localhost:8180(端口根据具体使用场景设定)。
1.2升级流程图
2.备份
在双开新框架BI之前,先备份旧框架支撑库及Cross_SBI、Cross_SBI_API、Cross_SBI_Task这三个文件夹,文件备份很重要,在双开过程中,如遇到不可修复的错误可以使用备份文件还原,确保正式环境的正常使用。
2.1支撑库备份
①支撑库为sqlite类型
在旧框架BI的安装根目录下的Cross_SBI_API文件夹下另存备份这三个sqlite文件。
②支撑库为MYSQL/MSSQL类型
利用数据库管理工具备份支撑库数据库(查看当前支撑库请查看文档:更换支撑库)
2.2文件夹备份
将BI安装路径下的Cross_SBI、Cross_SBI_API、Cross_SBI_Task三个文件夹备份(复制之前先将日志文件清理干净,这样能节省占用空间,清理日志文件请参考在线帮助文档:清理日志)。
3.安装新框架BI
(注:安装新框架BI前,先将桌面上的旧框架BI启动和停止服务的快捷方式更换为其他名字,避免安装新框架后快捷方式被覆盖掉)
根据在线文档部署BI,注意安装路径需要和旧框架BI分开。
Windows版本BI安装部署:Windows版本BI安装
Linux版本BI安装部署:Linux版本BI安装
4.修改新框架双开环境的端口
为了不影响旧框架BI的正常使用,需要修改新框架BI各项服务的端口号,这样就可以实现两套BI的同时启用。
旧框架BI各项服务的原端口号如下图所示,新框架BI各项服务的端口号需要与旧框架BI区分开。
列出修改后的端口号,确保端口号能正确配置。假定新框架bi端口修改情况如下。
“8080”替换为“8180”;
“3366”替换为“3388”;
“3030”替换为“3130”;
“3377”替换为“3378”。
4.1Cross_SBI
进入到Cross_SBI文件夹找到config.js配置文件,修改端口节点port,apiport,api.api_Port和task:task_Port。
4.2Cross_SBI_API
进入到Cross_SBI_API文件夹找到config.js配置文件,修改端口节点port,apiport,api.api_Port和task:task_Port(此值要和Cross_SBI目录中同名称节点值一致)。
4.3bi-full
进入到bi-full文件夹找到bootstrap-jdkprod.yml配置文件,修改端口节点server.port为9180。
5.修改Redis实例号
5.1Cross_SBI
进入到Cross_SBI文件夹找到config.js配置文件,修改节点redisDBIndex(修改为和旧框架BI不一样的值,以下修改redis实例号时值保持统一)。
5.2Cross_SBI_API
进入到Cross_SBI_API文件夹找到config.js配置文件,修改节点redisDBIndex。
5.3bi-full
进入到bi-full文件夹找到bootstrap-jdkprod.yml配置文件,修改端口节点spring.redis.database。
6.修改应用名称
6.1Cross_SBI
进入到Cross_SBI文件夹找到processes.json配置文件,分别修改两个节点对应name名称(默认为Cross_SBI和Cross_SBI_Session)。
6.2Cross_SBI_API
进入到Cross_SBI_API文件夹找到processes.json配置文件,分别修改节点对应name名称(默认为Cross_SBI_API)。
6.3bi-full
进入到bi-full文件夹找到pm2.json配置文件,修改节点对应name名称(默认为bi-full)。
7.修改API地址
在Cross_SBI和Cross_SBI_API目录中分别找到config.js配置文件,增加双开bi-full对应的webapi地址(添加时注意层级关系,如图所示)
例如:bi-full双开之后的ip为192.168.0.91,端口为9180,则Cross_SBI和Cross_SBI_API的对应配置如下
swarm:{
urls:{
datasource:"http://192.168.0.91:9180",
dataset:"http://192.168.0.91:9180",
memorycomputing:"http://192.168.0.91:9180",
login:"http://192.168.0.91:9180",
etl:"http://192.168.0.91:9180",
view:"http://192.168.0.91:9180",
rpt:"http://192.168.0.91:9180",
message:"http://192.168.0.91:9180",
messagequeue:"http://192.168.0.91:9180",
crawler:"http://192.168.0.91:9180",}
},
添加的层级和位置如下图所示。
8.关闭调度
调度如果不关闭,就会重复执行旧框架BI的调度任务,进入到bi-full文件夹找到application.properties配置文件,修改etl.triggerAutoStart值为false,后续正式使用新框架BI,且旧框架BI不再使用后,再将该参数调整为true。
9.修改双开启动文件
(Linux系统此步骤跳过)
修改安装目录下restart-offline-beta.bat中的前端访问地址。
双击桌面上的启动BI服务,启动新框架BI服务(注:关掉杀毒软件,如360等)
10.验证双开BI服务是否启动成功
(1)如果启动名称为8项,且有修改的Cross_SBI、Cross_SBI_API名称,且都为绿色,则成功,前往浏览器访问即可;
(2)如图只有原来4项,则配置不成功,再检查先前配置文件的参数设置是否正确。
11.切换支撑库
11.1复制支撑库
在数据库管理工具中,将原先旧框架BI的支撑库另存一份,作为新框架BI的支撑库进行测试和使用。
11.2更换支撑库
参考文档-更换支撑库。