双击此处添加文字
新版本BI升级
来源: | 作者:佚名 | 发布时间: 2023-12-07 | 524 次浏览 | 分享到:

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更换支撑库

参考文档-更换支撑库