ThingsKit物联网平台安装部署升级说明

第1步、获取数据库升级脚本文件

部署版,脚本获取方式

ThingsKit物联网平台安装部署升级说明

扫码加微信

源码版,脚本获取方式

从git仓库拉更新代码后,到源码目录application\src\main\data\upgrade\thingskit获取脚本文件。

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),远程连接数据库,执行数据库升级脚本。

ThingsKit物联网平台安装部署升级说明

第4步、服务端升级

备份旧版配置内容

备份脚本文件内的关键配置信息。

ThingsKit物联网平台安装部署升级说明

删除旧版部署包内容

清空旧版部署包目录web_server下的所有内容

ThingsKit物联网平台安装部署升级说明

上传新版部署包内容

新版本的功能可能涉及到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物联网平台

进入部署包的脚本目录,如下图。

ThingsKit物联网平台安装部署升级说明

脚本文件赋权(linux)

在执行脚本文件之前,需要赋予执行权限。

chmod +x linux.sh                #linux系统赋权

运行脚本文件

执行脚本文件会弹出对应的操作类型,例如:初始化数据库、启动应用、停止应用等。


#################################
#########windows操作新系统#########
#################################
windows


#################################
#########linux操作新系统#########
#################################
./linux

脚本:运行物联网平台服务端

windwos效果图:

ThingsKit物联网平台安装部署升级说明

linux效果图:

ThingsKit物联网平台安装部署升级说明

启动结果验证

物联网平台服务端,默认端口为8080。部署成功后,访问localhost:8080/swagger-ui.html效果如图:

ThingsKit物联网平台安装部署升级说明

第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证书
ThingsKit物联网平台安装部署升级说明

上传新版部署包

将解压后并修改配置文件的前端目录上传到nginx的工作目录。

需要上传到nginx的前端包内容如下图:

ThingsKit物联网平台安装部署升级说明

nginx的工作目录如下图:

ThingsKit物联网平台安装部署升级说明

重启nginx

部署包上传并修改配置文件后,启动或重启nginx。

启动结果验证

物联网平台管理端,默认端口为9527。部署成功后,访问登录与效果图如下:

地址:http://localhost:9527

超级管理员账号:sysadmin
超级管理员密码:Sysadmin@123

租户管理员默认密码:123456