kyreplace

下列思维导图的内容包括：kyreplace的使用场景、安装和系统升级步骤、常见问题解决办法以及遗留问题，分享给大家参考。

kyreplace

• 使用场景
  • centos7.3~centos7.9、centos8.0、centos8.1、centos8.2系统直接升级至麒麟ns8.2
    • centos7.3~7.9支持最小化安装、带有GUI的安装、最大化安装(右侧全选安装)；
• 安装
  • rpm -ivh kyreplace-1.0-1.noarch.rpm
• 系统升级步骤
  • 初始化
    • kyreplace -init
      • 安装相关的迁移工具及依赖(leapp及centos2kylin)
  • 迁移评估
    • kyreplace -check
      • assessment.json文件
  • 分析评估报告
    • centos8
      • 评估报告assessment.json文件
        • check
          • 列出系统环境问题
            • 软件包依赖缺失
            • 软件包重复
        • third
          • 会列出非系统仓库同源软件包，告知用户该部分软件包不会被迁移。
        • dep
          • 通过“result”告知用户是否可以执行迁移：
            • true
              • 可以迁移，同时列出无法被替换的系统仓库同源软件包
            • false
              • 不可以迁移，列出详细的迁移风险，包括迁移的具体阶段、该阶段的主要操作以及该操作造成的错误信息
        • compatibility
          • 列出迁移后的第三方软件包的依赖关系是否被满足。
            • true
              • 满足
            • false
              • 不满足，用户可根据实际需求，来判断是否进行迁移
      • 总体步骤
        • 用户对迁移评估报告assessment.json进行分析，解决其中的迁移风险后可以重新执行# kyreplace -check进行评估，直到“dep”部分的“result”为true，方可正式执行迁移。
    • centos7
      • 评估报告/var/log/leapp/leapp-report.txt
        • 报告中详细列举出当前OS与目标OS系统间的升级分析报告。
          • 报告点
            • 影响等级
            • 影响范围
            • 影响概述
            • 推荐解决方案
      • /var/log/leapp/answerfile
        • 影响系统升级部分描述
  • 迁移
    • kyreplace
      • 迁移完成后:reboot
    • kyreplace -c
      • 若在centos8的迁移过程中遇到报错（如网络中断、模块等问题），则可以在问题解决后，执行# kyreplace -c来继续迁移；centos 系列不支持；
  • 验证
    • centos8
      • nkvers
      • /var/tmp
        • 查看迁移前后的软件包信息
    • centos7
      • kylin-release 手动升级
        • rpm -e centos-release --nodeps
        • yum install kylin-release-8.2-1.0.el8.ks8.07.adv.x86_64.rpm
  • 常见问题解决
    • 7.6非最小安装迁移
      • 需手动安装无法自行升级的软件包
      • 卸载与目标系统冲突的软件包
    • centos8
      • No available modular metadata for modular package
        • 手动安装涉及的包
  • 遗留问题
    • centos-7.1~7.2
      • 磁盘格式问题-正在解决中

x2kylin_sh

• 使用场景
  • 用户软件从centos7.6 或者8.2 迁移到V10 SP2的自动化迁移评估
• 功能
  • 分析迁移软件包
    • 文件扫描
    • 依赖识别
    • 运行软件环境对齐
    • 运行结果分析
    • 自动识别编写语言和架构
  • 输出
    • 迁移影响分析
    • 修改指导
    • 需要引入的依赖rpm包
    • 需要修改的rpm包中的具体函数原型声明
• 特点
  • 支持单包扫描
    • rpm
    • tar.gz
  • 目录扫描
    • 同时分析多个软件包
  • 源操作系统支持
    • centos7.6
    • centos8.2
  • 目标操作系统
    • v10SP2
  • 识别的语言包括
    • C/C++
    • java
    • python
  • 架构
    • x86_64
    • arm
  • 差异分析
    • 直接依赖rpm包差异
    • so库差异
    • so库对外提供的代码级别的差异
    • 差异信息
      • html
      • json
  • 执行方式
    • 命令行
    • 程序API接口
• 安装
  • 依赖
    • python3 python3-pip net-tools pciutils systemd dmidecode util-linux
• 使用
  • 命令行
    • # x2kylin_sh [文件路径名] -os [源操作系统，默认为centos7]-lang [扫描语言] -arch [软件包架构，默认为x86_64] -t [扫描类型，默认为single] 参数说明：必选参数：- PATH，指定需要扫描的单个rpm 包路径，或指定需要扫描的路径文件夹（不支持嵌套目录，只支持单层目录）。可选参数：-h，查询帮助。-os，指定迁移分析的源操作系统，支持centos7/centos8。-lang，指定迁移分析软件包的语言，支持c/java/python，可以同时指定一种或以上语言类型。-arch，指定迁移分析的软件包架构，支持x86_64/aarch64。-t，指定迁移分析软件包的扫描方式类型， 支持single/batch - single，扫描目录下所有软件包对应于一个软件。  - batch，扫描目录下每个软件包为一个软件。