系统升级

提示

在升级操作之前请备份原应用和数据库

IBI目录结构

ls app
## 以下目录和文件可以保留
├── config        # 配置文件授权证书存储目录
│     ├── application.properties
│     ├── license.cert
│     ├── logback.xml
│     ├── quartz.properties
├── user-files     # 包含upload之类用户生成的文件夹
├── ext-lib     # 存放用户添加的第三方jar包，如数据库驱动等
├── start-server.sh  # 启动脚本
├── stop-server.sh # 停止脚本

## 以下目录和文件需更新
├── template # 邮件、微信消息 等模板文件
├── static # 存放服务端提供的静态资源
├── webui # 前端资源文件夹
├── ibi.jar  # springboot fat jar

更新数据库

1. 当新版本数据库有新增表和字段变更时需要更新数据库，
2. 数据库增量更新脚本一般在对应类型数据库脚本目录的patch文件夹下面，
3. 更新跨越多个版本需要回溯执行之前的更新脚本

提示

升级操作可以选择在新目录升级，或者原目录升级，根据公司偏好任选一种即可

新目录升级

1. 进去旧版本安装目录并停止服务，访问应用确保服务停止成功并不可访问

./stop-server.sh

2. 解压新版本zip文件到新目录
3. 从旧版本的安装目录下面拷贝下面的文件/文件夹到新目录并覆盖

ls app
## 以下目录和文件可以保留
├── config        # 配置文件授权证书存储目录
│     ├── application.properties
│     ├── license.cert
│     ├── logback.xml
│     ├── quartz.properties
├── user-files     # 包含upload之类用户生成的文件夹
├── ext-lib     # 存放用户添加的第三方jar包，如数据库驱动等

4. 启动服务

./start-server.sh start

5. 访问应用，检查版本号

• 前端版本号: 登陆服务页脚查看
• 服务端版本号: 点击页脚License，弹窗查看Server Version

原目录升级

1. 进去安装目录并停止服务，访问应用确保服务停止成功并不可访问

./stop-server.sh

2. 解压新版本zip文件到新目录
3. 简单备份旧版本文件

mkdir bak-2023xxxx
cp -r template webui ibi.jar bak-2023xxxx

4. 在新版本解压目录下拷贝以下文件/文件夹，并拷贝覆盖到原目录

## 以下目录和文件需更新
├── template # 邮件、微信消息 等模板文件
├── static # 存放服务端提供的静态资源
├── webui # 前端资源文件夹
├── ibi.jar  # springboot fat jar

5. 启动服务

./start-server.sh start

6. 访问应用，检查版本号

• 前端版本号: 登陆服务页脚查看
• 服务端版本号: 点击页脚License，弹窗查看Server Version

补丁更新

补丁更新应用场景为bug修复，这类更新通过不会有大范围改动，仅对已知问题进行简单修复

服务端补丁

覆盖更新ibi.jar单个文件即可，覆盖操作之前建议先备份

前端补丁

覆盖更新webui文件夹即可，覆盖操作之前建议先备份

puppeteer插件更新

Puppeteer插件用于服务端模拟请求，使用场景为定时任务发送看板、看板数据监控、大屏导出等场景
Puppeteer更新频率比较低
具体安装配置查看邮件发送与服务端导出章节

1.15 升级说明

安装包目录如下:

.
├── config
├── datax
├── ext-lib
├── ibi.jar
├── koa-api  # 本次新增nodejs服务
├── logs
├── start-server.bat
├── start-server.sh
├── static
├── stop-server.sh
├── template
├── user-files
├── webui
└── webui-mobile

nodejs服务配置

• 本次新增用于服务端多维数据构造的nodejs服务，改服务位于koa-api目录
• nodejs服务为可选配置，本次更新功能中，下列工需用到nodejs服务
  • 交叉表导出数据到数据库、
  • 复杂报表使用多维查询高级配置、数据集表达值、指标值类型快速配置
• 当config/application.properties配置文件中包含nodejs服务地址配置时，start-server.sh、stop-server.sh脚本启动服务时会开启nodejs服务

nodejs.koa2.base-url=http://localhost:8027

• start-server.sh 增加默认参数，不需要输入start命令参数
• stop-server.sh 增加停止nodejs服务
• nodejs服务自身配置

$ tree koa-api
koa-api
├── bundle.js
├── bundle.js.LICENSE.txt
├── config.js # 配置文件 

module.exports = {
    baseServerUrl: 'http://localhost:8026/', // 指向java web服务地址
    port: 8027, // nodejs服务启动端口，与application.properties中nodejs.koa2.base-url对应
};