第1步、获取数据库升级脚本文件
部署版,脚本获取方式
扫码加微信
源码版,脚本获取方式
从git仓库拉更新代码后,到源码目录application\src\main\data\upgrade\thingskit获取脚本文件。
第2步、备份数据库:PSQL
💡 提示
执行升级脚本前对数据库进行备份。
docker exec -it psql容器名 bash #进入PGSQL运行环境
cd /data #数据库挂载目录:单机模式(二选一)
cd /var/lib/postgresql/data #数据库挂载目录:微服务模式(二选一)
pg_dump --verbose -U postgres -d 数据库名 -f 输出文件.dmp #备份数据库
第3步、执行数据库升级脚本
💡 提示
数据库升级脚本基于阶梯式升级。执行数据库脚本文件时,一定要依次执行。
升级脚本不能跨版本执行。例如当前有如下版本。
- v1.0.1
- v1.0.2
- v1.0.3
执行数据库脚本文件时,如果当前版本时v1.0.1时,不能先执行脚本文件thingsKit_1.0.2_1.0.3.sql
。后执行或跳过脚本文件thingsKit_1.0.1_1.0.2.sql
。一定要依次执行。
💡 提示
执行升级脚本前对数据库进行备份。
二选一:命令行(PSQL)
docker exec -it pgsql容器名 bash #进入PGSQL运行环境
cd /data #数据库挂载目录:单机模式(二选一)
cd /var/lib/postgresql/data #数据库挂载目录:微服务模式(二选一)
pg_dump --verbose -U postgres -d 数据库名 -f 输出文件.dmp #备份数据库
psql -U postgres -d 数据库名 -x -f 升级脚本文件.sql #执行SQL文件
二选一:数据库管理工具(例如:navicat)
利用数据库管理工具(例如:navicat),远程连接数据库,执行数据库升级脚本。
第4步、服务端升级
备份旧版配置内容
备份脚本文件内的关键配置信息。
删除旧版部署包内容
清空旧版部署包目录web_server
下的所有内容
上传新版部署包内容
新版本的功能可能涉及到data目录下的内容。所以我们需要全量上传到部署环境的web_server
目录下。
修改启动脚本文件
根据自生操作系统修改脚本文件内的环境变量,具体修改内容如下:
#################################
#########不可修改的配置内容#########
#################################
export APP_VERSIONBASE=V1.0.3
#################################
#########必须修改的配置内容#########
#################################
SET BASE=W:\_publish\web_server #基于部署包存放位置,填写对应的绝对路径
#数据库配置信息
set SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:20638/thingskit
set SPRING_DATASOURCE_USERNAME=postgres
set SPRING_DATASOURCE_PASSWORD=thingskit
###################################
#########选择性修改的配置内容#########
###################################
rem cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)
set DATABASE_TS_TYPE=sql
set DATABASE_TS_LATEST_TYPE=sql
set MINIO_URL=http://localhost:9000
set MINIO_NAME=thingskit
set MINIO_PWD=thingskit
启动ThingsKit物联网平台
进入部署包的脚本目录,如下图。
脚本文件赋权(linux)
在执行脚本文件之前,需要赋予执行权限。
chmod +x linux.sh #linux系统赋权
运行脚本文件
执行脚本文件会弹出对应的操作类型,例如:初始化数据库、启动应用、停止应用等。
#################################
#########windows操作新系统#########
#################################
windows
#################################
#########linux操作新系统#########
#################################
./linux
脚本:运行物联网平台服务端
windwos效果图:
linux效果图:
启动结果验证
物联网平台服务端,默认端口为8080。部署成功后,访问localhost:8080/swagger-ui.html效果如图:
第5步、组态升级
前端部署包需要解压后,部署到nginx的工作目录。
第6步、大屏升级
前端部署包需要解压后,部署到nginx的工作目录。
第7步、前端升级
前端部署包需要解压后,部署到nginx的工作目录。
修改前端配置文件
在前端配置文件web_ui/_app.config.js
修改必要的配置参数。内容如下:
VITE_GLOB_API_URL #服务端API访问地址
VITE_GLOB_UPLOAD_URL #服务端资源上传访问地址
VITE_GLOB_WEB_SOCKET #服务端实时数据访问地址
VITE_GLOB_CONTENT_SECURITY_POLICY #是否启用SSL证书
上传新版部署包
将解压后并修改配置文件的前端目录上传到nginx的工作目录。
需要上传到nginx的前端包内容如下图:
nginx的工作目录如下图:
重启nginx
部署包上传并修改配置文件后,启动或重启nginx。
启动结果验证
物联网平台管理端,默认端口为9527。部署成功后,访问登录与效果图如下:
地址:http://localhost:9527
超级管理员账号:sysadmin
超级管理员密码:Sysadmin@123
租户管理员默认密码:123456