1.0升级指南

本文简单介绍Linkis从0.X升级到1.0的注意事项,Linkis1.0 对Linkis的多个服务进行了调整,改动较大,本文将介绍从0.X到1.X升级过程中的注意事项。

1. 注意事项

如果您是首次接触并使用Linkis,您可以忽略该章节;如果您已经是 Linkis 的使用用户,安装或升级前建议先阅读:Linkis1.0 与 Linkis0.X 的区别简述

2. 服务升级安装

  1. 因为1.0基本上对所有服务进行了升级,包括服务名进行了修改,所以0.X1.X升级时服务需要进行重新安装。
  2. 在安装时如果需要保留0.X的数据,一定要选择1跳过建表语句(见下面代码)。
  3. Linkis1.0 的安装可以参考[如何快速安装使用Linkis-1.0]($c2f6ded58ccef64b.md)
  1. Do you want to clear Linkis table information in the database?
  2. 1: Do not execute table-building statements
  3. 2: Dangerous! Clear all data and rebuild the tables
  4. other: exit
  5. Please input the choice: ## choice 1

3. 数据库升级

  1. 服务安装完成后,需要对数据库进行结构修改,包括进行表结构变更和新增表和数据:

3.1 表结构修改部分:

  1. linkis\_task 表新增了submit\_userlabel\_json字段,更新语句是:
  1. ALTER TABLE linkis_task ADD submit_user varchar(50) DEFAULT NULL COMMENT 'submitUser name';
  2. ALTER TABLE linkis_task ADD `label_json` varchar(200) DEFAULT NULL COMMENT 'label json';

3.2 需要新执行的sql:

  1. cd db/module
  2. ##新增enginePlugin服务依赖的表:
  3. source linkis_ecp.sql
  4. ##新增public service-instanceLabel 服务依赖的表
  5. source linkis_instance_label.sql
  6. ##新增linkis-manager服务依赖的表
  7. source linkis_manager.sql

3.3 publicservice-Configuration表修改

  1. 为了支持Linkis1.X 的全标签化能力,configuration模块相关数据表已全部升级为标签化,和0.XConfiguration表完全不同,需要重新执行建表语句和初始化语句。
  2. 这意味着,**Linkis0.X 用户已有的引擎配置参数,已无法迁移到Linkis1.0之中**(建议用户重新配置一次引擎参数)。
  3. 执行建表语句如下:
  1. source linkis_configuration.sql
  1. 执行初始化语句,因为 Linkis1.0 支持对接多版本的引擎,所以执行初始化语句时,一定需要修改对应引擎的版本,如下所示。
  1. vim linkis_configuration_dml.sql
  2. ## 修改对应引擎的默认版本
  3. SET @SPARK_LABEL="spark-2.4.3";
  4. SET @HIVE_LABEL="hive-1.2.1";
  5. ## 保存执行初始化语句
  6. source linkis_configuration_dml.sql

4. 安装Linkis1.0

  1. 启动Linkis1.0,验证服务是否已正常启动并对外提供服务,具体请参考: [如何快速安装使用Linkis-1.0]($c2f6ded58ccef64b.md)