1.0.3以上的版本升级

    • 如果是第一次安装使用 Linkis，或重装 Linkis，无需关注 Linkis 升级指南。
    • 如果涉及到其他平台的组件（DataSphereStudio/Qualitis/Visualis等），升级前，请确认版本之间的兼容性，最好使用推荐的版本，可参考 https://github.com/apache/linkis#ecosystem。
    • 建议通过软链方式来进行版本管控，可以通过修改软链的目标地址 来切换版本 如:
    • 升级过程主要是需要关注数据库表结构的调整和部分配置参数的调整
    • 除了后端服务的升级，linkis的管理台资源也需要一并升级
    • 每个版本的主要变动点 可以查阅版本的总览信息https://linkis.apache.org/zh-CN/docs/x.x.x /release 以及版本的:https://linkis.apache.org/zh-CN/download/main
    • 每个版本的数据库变化/配置参数变化 都是基于上一个版本

    按（文档中关于管理台的安装可以跳过），进行新版本的安装。

    安装服务时，如果历史数据保留，请保留历史数据，如果无需保留数据，直接重装即可，也无需关注升级流程

    找到对应的版本db/upgrade/x.x.x-schema/ sql变动文件

    如果是跨多个版本执行，请按版本顺序，依次执行， 如果某些版本没有x.x.x_schema(linkis>=1.1.0版本后，只要涉及到数据库表的调整，都会有对应版本的schema文件),则表示该版本没有数据表的变化

    注意

    1. ├── linkis_ddl.sql # 当前版本的全量ddl 数据库定义语言 建表语句 
    2. ├── linkis_dml.sql # 当前版本的全量dml 数据操纵语言   数据的增改
    3. └── upgrade
    4.     ├── 1.1.0_schema   # 对应版本的sql
    5.     │   └── mysql
    6.     │       ├── linkis_ddl.sql
    7.     │       └── linkis_dml.sql
    8.     ├── 1.1.1_schema
    9.     │   └── mysql
    10.     │       ├── linkis_ddl.sql
    11.     │       └── linkis_dml.sql
    12.         └── mysql
    13.             └── linkis_ddl.sql
    1.     #如果是跨多个版本执行，请按版本顺序，依次执行 先执行ddl 再执行dml 
    2.     #比如当前从linkis-1.0.3 升级到linkis-1.1.2 
    3.     source upgrade/1.1.0_schema/mysql/linkis_ddl.sql
    4.     source upgrade/1.1.0_schema/mysql/linkis_dml.sql
    6.     source upgrade/1.1.1_schema/mysql/linkis_ddl.sql

    1.1.1 版本调整将原来的TOKEN配置从${LINKIS_HOME}/conf/token.properties迁移到数据库表linkis_mg_gateway_auth_token, 对于原来在token.properties额外配置的TOKEN，需要手动迁移表中

    1.1.1 中支持支持UDF多版本控制、UDF存储到BML的功能特性，UDF函数存储的表结构有调整，UDF的历史数据，需要单独进行迁移

    1.1.1 版本中调整了session字段的key，从bdp-user-ticket-id-> 调整为 linkis_user_session_ticket_id_v1， 如果是对Linkis的升级。同时部署DSS或者其他项目，但他们服务lib包中，所依赖的Linkis的linkis-module-x.x.x.jar包 <1.1.1，则需要修改位于${LINKIS_HOME}/conf/linkis.properties文件

    1.1.1 开始调整了yarn队列默认集群名wds.linkis.rm.cluster sit调整为default，如果一直使用的sit，请修改表数据 linkis_cg_rm_external_resource_provider中的集群名

    1. #查看老版本是否有安装第三方appconn
    2. cd ${LINKIS_HOME_OLD}/lib/linkis-engineconn-plugins/
    3. ll
    4.  appconn -> /appcom/Install/LinkisInstall/appconn
    7. #新版本保持一致 
    8. cd ${LINKIS_HOME}/lib/linkis-engineconn-plugins/ 
    9. #软链

    如果原来版本有安装dss，需要拷贝原来包中的dss-gateway-support-x.x.x.jar 至linkis的./lib/linkis-spring-cloud-services/linkis-mg-gateway/目录下 如:

    1. cp ${LINKIS_HOME_OLD}/lib/linkis-spring-cloud-services/linkis-mg-gateway/dss-gateway-support-1.1.3.jar ${LINKIS_HOME}/lib/linkis-spring-cloud-services/linkis-mg-gateway/dss-gateway-support-1.1.3.jar

    上传至管理台所在的服务器上 ，解压

    nginx配置文件默认是 在 nginx的日志文件在 /var/log/nginx/access.log 和/var/log/nginx/error.log

    场景1： 如果是集成再DSS项目中，修改DSS项目中linkis管理台资源的地址指向 dss的nginx配置文件默认是 在/etc/nginx/conf.d/dss.conf

    1. #示例
    2.         server {
    3.             ......
    4.             location dss/linkis {
    5.             alias   /appcom/Install/linkis-web-newversion/dist; # 静态文件目录  
    6.             index  index.html index.html;
    7.             }
    8.             .....
    9.         }
    1. #示例
    2.         server {
    3.             ......
    4.             location dss/linkis {
    5.             alias   /appcom/Install/linkis-web-newversion/dist; # 静态文件目录 
    6.             index  index.html index.html;
    7.             }
    8.             ......

    重新加载nginx 配置

    • 管理台升级后，因为浏览器可能存在缓存，如果要验证效果，最好清空下浏览器缓存