软件包重构
软件包重构功能分析待迁移软件包的构成,重构并生成鲲鹏平台兼容的软件包。该功能只支持在鲲鹏平台环境上运行。
前提条件
- 已成功登录鲲鹏DevKit。
- RPM包只能在类RHEL系统上执行,重构过程中需要依赖系统组件rpmrebuild/rpmbuild/rpm2cpio,请提前检查系统环境是否已满足。
安装rpmrebuild:自行下载rpmrebuild组件,并上传至服务器执行以下命令安装。
1
rpm -ivh xxx.rpm
安装rpmbuild:执行以下命令检查yum源中的rpmbuild的RPM包并安装。
1 2
yum list | grep rpm-build yum install -y rpm-build
如果yum源中不存在rpmbuild的RPM包,请自行下载对应组件,并上传至服务器执行以下命令安装。
1
rpm -ivh xxx.rpm
- DEB包只能在类Debian系统上执行,重构过程中需要依赖系统组件ar/dpkg-deb,请提前检查系统环境是否已满足。
- 如果RPM包或者DEB包里面包含JAR包或EAR包,或者需要对JAR包和EAR包进行重构,请检查系统是否存在JAR命令,如果不存在,请安装JDK工具。
- 当前工具已新增arm/aarch64路径并添加依赖库,如果JAR和EAR包中依赖库路径存在架构相关关键字,请自行检查源码中加载依赖库路径是否正确。
操作步骤
- 在页面左侧,选择“软件包重构”单击“”进入创建分析任务区。
- 填写“软件包存放路径”。可以通过以下两种方式实现:
- 单击“上传”按钮上传软件包。
- 当前支持对RPM包、DEB包、JAR包和EAR包进行重构。
- 只允许同时上传一个软件包,软件包不超过1GB。
- 手动上传软件包时,需先检查是否存在上传目录,若不存在,则需创建工具指定路径,并给devkit用户开通读写和执行权限。
- 先将软件包手动上传到服务器上本工具的指定路径下(例如“/opt/DevKit/workspace/devadmin/porting/packagerebuild/”),给DevKit用户开读写和执行权限,再单击填写框选择下拉框中的软件包即可,也可以手动填写软件包名称。
- 单击“上传”按钮上传软件包。
- 配置依赖文件。
仅提供部分JAR文件自动下载功能,文件将下载到“/opt/DevKit/workspace/xx/porting/data”目录下(xx代表用户名),其他软件包重构过程中需要的依赖资源文件,请自行上传。
依赖文件有以下两种上传方式。
- 单击“上传”按钮上传,将需要上传的依赖文件拖拽至上传框内。
- 单击“点击添加上传”,选择单个或多个需要上传的依赖文件,单击“上传”按钮上传。
可同时上传多个依赖文件,框内如有同名文件时,将被选择的新文件覆盖,且每个最大不超过1GB。
工具默认勾选“授权访问外部网络获取重构软件包需要的依赖文件”。
- 单击“确认重构”进入软件包重构进程,并弹出重构进度对话框。
- 软件包重构过程中可以离开当前页面进行其他操作。
- 用户可在任务进行过程中单击关闭,取消任务。
- 重构成功后,单击“下载重构软件包”可查看执行结果,如图5所示。
- 软件包重构结果默认保存在“/opt/DevKit/workspace/xx/porting/report/packagerebuild/task_name/”路径下(xx代表用户名,task_name即任务名称),执行完成后您可以进入该路径查看已重构的软件包。用户也可以点击页面上的历史报告,查看重构失败原因并按建议进行处理,失败报告的详细信息请参考重构失败说明。
- 用户可在历史记录区下载和删除已重构的软件包。
- 用户可将重构的软件包部署到鲲鹏平台进行验证。
重构失败说明
失败报告如图6所示:
参数 |
说明 |
---|---|
重构信息 |
显示任务名称、报告生成时间、软件包存放路径以及重构结果。 |
已更新依赖文件 |
显示已经更新的依赖文件名和路径。文件来源主要是用户上传和工具自动下载。 |
缺少依赖文件 |
重构过程中缺失的依赖文件。
|
重构失败常见场景,请参见重构软件包常见失败场景进行处理。
父主题: 应用迁移工具