仅源码包迁移

前提条件

• 已成功登录鲲鹏DevKit。
• 已准备好需要迁移的源成分包。

操作步骤

1. 在页面左侧，选择“系统迁移”单击进入“新建工程”页签。
   图1 基本配置
   
2. 填写“迁移工程名称”。工具默认会自动生成工程名称，也可根据实际情况进行自定义修改。

   名称需要满足如下要求：

   • 只能由中文、字母、数字和下划线组成。
   • 长度为1~64个字符。
3. “迁移场景”选择“仅源码包迁移”。
4. 选择需要扫描的“源码迁移服务”，支持SQL迁移、配置迁移。
   • SQL迁移：提取源码、注解、Mybatis中SQL语句及关联语句，并进行SQL兼容性评估、转换与patch文件生成。
   • 配置迁移：扫描配置文件中路径、驱动等相关配置项，并根据指导建议进行相应修改。
5. 选择“源码包获取方式”，支持以下两种方式。
   

   • “源码包上传”方式支持上传tar、tar.bz、tar.bz2、tar.gz、tar.xz、tbz、tbz2、tgz、txz、zip格式的源码包，可同时上传多个源码包，单个源码包大小限制默认为2048MB。
   • 对于Dockerfile和Docker Compose文件，会识别文件中不支持Arm架构的语句，提供指导建议。对于文件的匹配规则请参见Dockerfile和Docker Compose白名单及替换名单使用说明。
   • 支持识别源码中驱动、依赖、Druid、JPA配置，并提供Quick Fix修改建议。
   • 源码包上传
     图2 源码包上传
     

     单击“上传”按钮，可拖动源码包至上传区域，或单击“添加文件”选择源码包上传至服务器，然后单击“上传”按钮上传。

   • 节点服务器获取
     图3 节点服务器获取
     
     1. 选择“迁移工程节点”，可按照节点IP地址或名称进行搜索。若节点不存在可单击“添加节点”，添加迁移工程节点，具体操作可参考Agent管理。
        

        仅源码包迁移支持添加本机节点（即当前登录的DevKit节点）为迁移工程节点。

     2. 配置扫描路径。用户可扫描远程节点指定路径下源码文件，请配置需要扫描的文件路径。

        单击“添加扫描路径”，请输入源码包扫描路径。若需要扫描SQL的源码包，建议配置数据定义语言（DDL）文件，DDL文件获取请参见导出数据库定义语言文件方法。

6. 通过配置以下高级选项，可提升迁移的准确性。
   图4 高级配置
   

   表1 高级参数说明

   参数	说明
   迁移源数据库	指定迁移源数据库，可提升源码SQL迁移的准确性。 说明： 当MySQL迁移至Vastbase时，若当前环境未部署Vastbase-transform.jar，需配置相关下载信息，否则将不会对SQL进行兼容性评估与转换。
   迁移目标数据库	指定迁移目标数据库，可提升源码SQL迁移的准确性。
   工具包来源	选择工具包来源。 外网地址下载：将自动从鲲鹏镜像仓下载Vastbase-transform.jar至DevKit工具安装节点。 工具包上传：请复制下方提示信息中下载工具包链接，自行获取Vastbase-transform.jar。
   工具包上传	单击“上传”，上传已下载Vastbase-transform.jar。 说明： “工具包来源”选择“工具包上传”时显示该参数。
   配置DDL	需要扫描SQL的源码包建议配置DDL（数据定义语言），DDL记录了数据库表、字段的完整信息，通过DDL语句可以提升SQL语句解析的准确性。DDL文件获取请参见导出数据库定义语言文件方法。 说明： 当“源码包获取方式”选择“源码包上传”方式时，显示该参数。
   中间件类型选择	不涉及 宝兰德迁移策略：上传的源码包包含内置Tomcat相关配置文件，且需要迁移至内置宝兰德。 东方通迁移策略：上传的源码包包含内置Tomcat相关配置文件，且需要迁移至内置东方通。

7. 单击“开始迁移”，进入迁移结果界面。