查看迁移结果

前提条件

• 已成功登录鲲鹏DevKit。
• 已创建系统迁移工程并完成迁移实施。

迁移报告

1. 进入“迁移结果”页面，显示当前迁移工程报告。若存在SQL语句，则显示“下载非源码SQL汇总文件”按钮，可下载非源码SQL的汇总文件。
   图1 迁移报告
   

   表1 迁移报告参数说明

   参数	说明
   源成分名	迁移的源成分名。
   所属节点	成分所属节点，支持过滤。
   成分归属	成分的归属，支持过滤。
   源成分来源	成分的来源。
   目标成分名	迁移至的目标成分名。
   状态	显示该成分的迁移状态，包括已迁移、待迁移和已屏蔽。
   指导建议	请单击“查看详情”，查看指导建议详情。
   状态来源	显示该成分的来源，默认为工具迁移，若修改成分状态，状态来源将变更为“自定义”。
   备注	备注信息。
   更新时间	显示迁移状态的更新时间。
   操作	可按照迁移进度修改状态，并进行备注。

2. 单击“指导建议”列“查看详情”，右侧将展示指导建议详情。
   • 已迁移：请根据“建议详情”中验证方法进行系统功能性验证，以Tomcat迁移至东方通为例。
     图2 建议详情
     
   • 待迁移：请根据“建议详情”中迁移指导进行手动迁移及系统功能性验证，以RabbitMQ迁移为例。
     图3 建议详情
     
     

     待迁移成分支持单击指导建议下方“编辑并重新迁移”按钮，可返回新建工程页面，重新编辑成分信息后单击“重启”再次尝试迁移。

   • Java应用迁移：对于Java应用包，可自动转为运行在鲲鹏平台的Jar包。
     图4 Java应用转换
     
     • 替换失败的依赖，请根据迁移指导，通过执行下载依赖文件脚本，获取相关依赖或配套文件。
       1. 单击“下载依赖文件脚本”，解压下载的压缩包，然后执行解压目录下的脚本以获取相关依赖或配套文件。

          sh dependency_download.sh

          如下为示例，显示如下加粗内容则表示依赖下载成功：

          Start downloading: DmDialect-for-hibernate5.6-8.1.3.140.jar
          Start downloading: DmJdbcDriver18-8.1.3.140.jar
          Download failed: 
          DmDialect-for-hibernate5.6-8.1.3.140.jar       100%[====================================================================================================>]  49.62K   203KB/s    in 0.2s    
          Downloaded: DmDialect-for-hibernate5.6-8.1.3.140.jar
          DmJdbcDriver18-8.1.3.140.jar                   100%[====================================================================================================>]   1.31M  92.7KB/s    in 8.3s    
          Downloaded: DmJdbcDriver18-8.1.3.140.jar
          All files have been downloaded.

          

          • 需在联网环境下执行脚本，具体操作请参见配置wget代理。
          • 执行完成后，会在脚本同级目录生成download文件夹，下载的依赖存放于该文件夹下。
       2. 对于“与架构相关的依赖文件”，请根据“替换软件包路径”，逐一替换未成功转换的依赖；对于“与数据库相关的依赖文件”，请根据处理建议进行迁移。
       3. 请使用自行准备的测试用例，在鲲鹏环境中验证应用是否迁移成功。
     • 替换成功的依赖，请根据迁移指导进行操作，且替换成功的依赖支持回退操作。回退之后，“与架构相关的依赖文件”将使用原软件包替换转换后的软件包；“与数据库相关的依赖文件”将删除应用包中添加的依赖文件。

3. 迁移完成后，可关闭右侧侧滑框。单击“操作”列“编辑”，在下拉框中选择需要更新的状态，然后单击“保存”。
   

   可勾选多个成分，然后单击左上角“批量编辑”，同时对所选择的多个成分进行编辑，修改完成后单击“确定”。

源码迁移指导-SQL迁移

若迁移内容未选择数据库，将不会解析源码文件中的SQL语句。

1. 进入“迁移结果”页面，源码迁移指导默认为“SQL迁移”页签，支持下载SQL迁移报告汇总文件。
   

   SQL迁移报告汇总文件包含SQL汇总文件和源码patch文件。其中patch文件根据实际情况生成，具体使用方式详见源码SQL回写patch使用指导。

   图5 SQL迁移
   

   表2 兼容性评估说明

   参数	说明
   SQL总数	提取的SQL总数。
   已兼容	显示已兼容目标数据库的SQL数，无需更改。
   不兼容	显示不兼容目标数据库的SQL数，请根据已生成的patch文件进行源码改写，具体操作请参见源码SQL回写patch使用指导。 若未生成patch但SQL已转换，请参考已转换的SQL及识别的上下文信息手动修改源码。 若由于SQL转换失败，导致patch未能生成，请手动转换后并自行修改源码。
   待确认	显示待确认目标数据库的SQL数，请结合源文件调整SQL语句后，使用数据库迁移工具进行兼容性分析及转换。
   兼容率	显示SQL的兼容率，即：已兼容/SQL总数。
   注：SQL迁移汇总表支持通过SQL兼容性进行过滤，单击“查看详情”，源码文件也仅展示筛选的兼容性。

   表3 参数说明

   参数	说明
   文件名	文件名称。
   源路径	文件的源路径。
   源码包名	源码包名称。
   SQL总数	该文件SQL总数。
   不兼容SQL数	该文件中不兼容的SQL数。
   待确认SQL数	该文件中待确认的SQL数。
   已生成patch条数	不兼容SQL中，已生成patch的条数。
   指导建议	请单击“查看详情”，查看指导建议详情。
   状态	显示该文件的迁移状态，包括已迁移、待迁移和已屏蔽。
   状态来源	显示该成分的来源，默认为工具迁移，若修改成分状态，状态来源将变更为“自定义”。
   备注	备注信息。
   更新时间	显示迁移状态的更新时间。
   操作	可按照迁移进度修改状态，并进行备注。

2. 单击“指导建议”列“查看详情”，右侧将展示SQL迁移指导。
   用户可以将鼠标置于有波浪线的代码上，部分迁移路径支持对提取的SQL语句进行兼容性评估（不兼容和待确认的SQL语句前会有标识），以及对不兼容SQL提供转换和patch生成功能。其余迁移路径请根据悬浮中提示进行兼容性分析和转换。

   图6 指导建议
   

   

   • 以drop、grant、alter或truncate开头的SQL语句为高风险操作，且悬浮信息中会有提示，不建议在数据库中执行，例如：drop table t;。
   • .Net源码不提供SQL拼接和补全能力，请确认识别到的数据库操作相关语句在目标数据库是否兼容。若不兼容，请修改源码文件。
   • 源码SQL相关接口详见源码SQL接口说明。

3. 迁移完成后，可关闭当前侧滑框。单击“操作”列“编辑”，在下拉框中选择需要更新的状态，然后单击“保存”。
   

   可勾选多个文件，然后单击左上角“批量编辑”，同时对所选择的多个源码文件进行编辑，修改完成后单击“确定”。

源码迁移指导-配置迁移

1. 单击“配置迁移”，切换至配置迁移页签，支持下载修改建议汇总文件。
   图7 配置迁移
   

   表4 参数说明

   参数	说明
   文件名	文件名称。
   源路径	文件的源路径。
   源码包名	源码包名称。
   建议数	该文件建议总数。
   指导建议	请单击“查看详情”，查看指导建议详情。
   状态	显示该文件的迁移状态，包括已迁移、待迁移和已屏蔽。
   状态来源	显示该成分的来源，默认为工具迁移，若修改成分状态，状态来源将变更为“自定义”。
   备注	备注信息。
   更新时间	显示迁移状态的更新时间。
   操作	可按照迁移进度修改状态，并进行备注。

2. 单击“指导建议”列“查看详情”按钮，右侧将展示配置迁移指导意见。
   用户可以将鼠标置于有波浪线的代码上，在悬浮的提示中单击Quick Fix替换成建议代码（可选择“在本文件中批量修改该类建议”对同类问题进行批量修改）或根据提示信息确认需要更改配置，例如IP地址、端口号不一致等。

   图8 指导建议
   

   

   • 用户可以直接在源码文件中进行修改，修改完之后，可单击右上角的保存、回退或取消按钮。
   • 用户可以单击源码文件模块右上角的上下键，进行上下切换。
   • 单击左侧文件列表中，即可下载用户所需要的源码文件。

3. 修改完成后，可关闭当前侧滑框。单击“操作”列“编辑”，在下拉框中选择需要更新的状态，然后单击“保存”。
   

   可勾选多个文件，然后单击左上角“批量编辑”，同时对所选择的多个源码文件进行编辑，修改完成后单击“确定”。