1.0升级指南

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

1. 注意事项

  1.     **如果您是首次接触并使用Linkis，您可以忽略该章节；如果您已经是 Linkis 的使用用户，安装或升级前建议先阅读：[Linkis1.0 与 Linkis0.X 的区别简述]($0eb377e3f3d5ddcf.md)**。

2. 服务升级安装

  1.  因为1.0基本上对所有服务进行了升级，包括服务名进行了修改，所以0.X到1.X升级时服务需要进行重新安装。
  3.  在安装时如果需要保留0.X的数据，一定要选择1跳过建表语句（见下面代码）。
  5.  Linkis1.0 的安装可以参考[如何快速安装使用Linkis-1.0]($970df92f9080684d.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
  7. Please input the choice: ## choice 1

3. 数据库升级

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

3.1 表结构修改部分：

  1.  linkis\_task 表新增了submit\_user和label\_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.X的Configuration表完全不同，需要重新执行建表语句和初始化语句。
  3.  这意味着，**Linkis0.X 用户已有的引擎配置参数，已无法迁移到Linkis1.0之中**（建议用户重新配置一次引擎参数）。
  5.  执行建表语句如下：
  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]($970df92f9080684d.md)