创建系统迁移工程

前提条件

• 已成功登录鲲鹏DevKit。
• 已添加待迁移系统，且该系统已导入成分信息。

操作步骤

1. 在页面左侧，选择“系统迁移”单击“”进入“新建迁移”页签。
   图1 新建迁移
   

   表1 新建迁移说明

   参数	说明
   迁移工程名称	系统迁移工程名称，工具默认会自动生成工程名称，可根据实际情况进行自定义修改。
   选择待迁移的系统	需要选择已添加的待迁移系统，且该信息系统已导入成分信息。

2. 单击“校验并进行下一步”，在“选择迁移路径”选择需要迁移的节点信息、迁移目标、迁移目标版本。
   

   维护人员可在工具所在服务器中通过修改“/opt/DevKit/devkitplugins/porting/config/migration_route.json”文件更新工具所支持的迁移路径，修改完成后需要重启DevKit服务。其中“/opt”为工具安装目录，请根据实际情况替换。

   systemctl restart gunicorn_plugin.service

3. 单击“下一步”，弹窗页面显示迁移评估进度，评估完成后，会自动跳转至“迁移评估”界面。
   • 默认展开“迁移难易程度评估”页签，如图2所示，参数如表2所示。
     图2 迁移难易程度评估
     

     表2 迁移难易程度评估说明

     参数	说明
     迁移难易程度评估	显示迁移难易度总分、工作量。
     迁移难易度细节评分，具体说明请参见迁移难易度细节评分说明。
     维度/类型/指标项	按照维度/类型/指标项进行评估。
     评估标准	显示各个维度/类型/指标项的评估标准，即最大评估得分。
     评估得分	展示各个维度/类型/指标项的评估得分。
     工作量细节评估，具体说明请参见工作量细节评估说明。
     工作量细节	显示工作量评估细节。
     工作量（人天）	评估出各个工作量细节预计需要投入的人力。

     • 评估参数设置

       可通过单击“评估参数设置”修改迁移评估参数，修改完成后单击“确定”则立即生效。其中“编译型语言行数”归属于“自研代码修改与编译”。

   • 单击“迁移兼容性评估”页签查看迁移兼容性评估，界面参数描述如表3所示。
     图3 迁移兼容性评估
     

     表3 迁移兼容性评估说明

     参数	说明
     兼容性统计	显示已兼容、可兼容、不兼容和待确认数。
     迁移性统计	显示易、中、难和暂不支持数。
     系统成分汇总
     序号	显示节点序号。
     节点名称	显示迁移的节点名称。
     IP地址	显示迁移的节点IP地址。
     成分总数	显示迁移的节点的成分总数。
     易	显示难易度为“易”的成分数，用户花费少量努力即可完成迁移。
     中	显示难易度为“中”的成分数，用户根据工具的指导，对组件进行少量的修改即可完成迁移。
     难	显示难易度为“难”的成分数，用户需要进行大段代码改造才可完成迁移。
     暂不支持	显示不支持的成分数，工具目前没有提供相应指导。
     已兼容	显示该节点已兼容目标环境数据库、中间件、Java应用等的成分数。
     可兼容	显示该节点不兼容目标环境数据库、中间件、Java应用等的成分数，可以通过工具辅助，按照迁移指导进一步操作达到兼容目标环境。
     待确认	显示该节点暂不能确定兼容性的成分数，您可联系DevKit技术支持工程师，或者根据您的经验确认。 说明： 将软件在鲲鹏平台运行，若运行成功，则表示已兼容；若运行不成功，请根据扫描出的Native函数进行适配修改。
     不兼容	显示该节点不兼容目标环境的成分数。
     操作	可单击“查看”进行详细信息查看。

   • 单击“任务信息”页签，将显示工程名称、工程更新时间、信息系统、分析状态和选择迁移路径。
     图4 任务信息
     
4. 单击“下一步”进入迁移指导。
   • 默认展开“迁移指导报告”页签，如图5所示，参数如表4所示。
     图5 迁移指导报告
     
     

     • 可在“选择节点”单击过滤需要查看指导详情的节点。
     • 单击指导规则名称，右侧将会显示该指导规则详情。
     1. 单击可展开对应指导规则详情。
        对于“组件”类型，单击“查看指导”，右侧将会显示建议详情和指导；对于“文件”类型，单击“查看指导”，将跳转至“指导建议汇总”。

        表4 指导详情

        参数	说明
        待适配组件统计	显示待适配组件总数以及可替换、待修改、待重构的组件数。 可替换：已提供替换组件，用户可直接使用替换组件进行替换。 待修改：已提供修改点，用户可按照提示进行修改；或已提供指导方案，无法提供具体修改点，用户可根据指导方案进行适配。 待重构：已识别到不兼容且无法提供方案，请用户进行同功能替换。
        待适配文件统计	显示待修改配置文件数、参考适配项行数。
        指导规则	显示指导规则的名称。
        指导规则ID	显示指导规则的ID，默认不显示。
        类型	显示指导规则的类型，包括组件和文件。
        软件分类	显示指导规则的软件分类，包括Java应用、Java运行时、数据库、中间件、硬件和OS。
        标签	显示指导规则的标签。
        优先级	显示该迁移指导的优先级，分别为高、中、低。
        故事点	故事点是一种度量单位，用于表示完成一个产品待办项或者其他任何某项工作所需的所有工作量的估算结果。数值越大表示越复杂或难易度越高，具体说明如下： 0：迁移优先级非常低或者无需更改。 1：只需进行少量库替换或者简单的接口修改。 3：需要进行复杂的修改，但有可提供的指导方案。 5：需要重新设计或大量代码改造。 7：需要重新开发构建该组件或子系统。 13：目前没有提供相应的指导方案。
        状态	显示该迁移指导的状态，包括已执行、未执行和已屏蔽。
        备注	显示该迁移指导编辑时的备注信息。
        状态更新时间	该指导规则状态的更新时间。
        操作	可编辑迁移规则状态和备注信息；可查看迁移指导。
        组件名	表示组件名。
        文件名	表示文件名。
        源路径	该组件/文件的源路径。
        建议详情	通过建议详情指导用户进行迁移。
        待修改行数	文件的待修改行数，类型为“文件”时显示。
        分析结果	包括可替换、待修改和待重构，类型为“组件”时显示。

     2. 按照指导建议已完成修改的指导规则，可将状态修改为“已执行”；对于无需关注或无影响的指导规则，可将状态修改为“已屏蔽”。
        • 单击指导规则“操作”列“编辑”，可对单个指导规则的状态进行修改，修改完成后单击“保存”。
        • 可勾选多个指导规则，然后单击“批量编辑”，同时对所选择的多个指导规则进行编辑，修改完成后单击“确定”。
   • 单击“指导建议汇总”查看待适配文件的检查结果界面。
     图6 指导建议汇总
     

     表5 指导建议汇总参数说明

     参数	说明
     文件列表	分析的文件名称，可通过节点筛选需要查看的节点。
     待适配文件	显示待适配文件详情，用户可通过待适配的具体位置和指导建议进行修改。

     

     用户可以单击待适配文件模块右上角的上下键，进行上下切换。

   • 单击“任务信息”页签，将显示工程名称、工程更新时间、信息系统、工程状态和选择迁移路径。

相关任务

• 若需要终止系统迁移工程，请单击系统工程右侧“”，或单击信息系统右侧“”，单击“操作”列“终止工程”。
• 若需要删除系统迁移工程，请单击系统工程右侧“”，或单击信息系统右侧“”，单击“操作”列“删除”。
  

  若单击信息系统右侧“”，将删除该系统下所有迁移工程；若单击系统迁移右侧“”，将删除所有迁移工程。删除后的数据无法恢复，请谨慎操作。

• 若需要修改系统迁移工程名称，请单击系统工程右侧“”，修改完成后单击“确定”。