介绍 #

简要介绍 #

enca 是一个实用的编码转换工具。本案例使用 x86_64 架构虚拟机，通过评估工具 x2openEuler 评估 enca1.19 软件移植到 openEuler 操作系统的兼容性，并根据评估结果完成软件移植。

开发语言：C

建议的版本 #

建议使用版本为 enca 1.19.1。

说明: 本文档适用于 enca 1.19.1，其他版本的 enca 移植步骤也可参考本文档。

环境要求 #

操作系统要求 #

安装操作系统 #

如果是全新安装操作系统，安装方式建议不要使用最小化安装，否则很多软件包需要手动安装，可选择“Server with GUI”安装方式。 安装 openEuler 操作系统请参考：https://openeuler.org/zh/docs/20.03_LTS_SP1/docs/Installation/installation.html。

兼容性评估 #

评估工具：x2openEuler 评估环境：CentOS7.6

下载 x2openEuler 工具 #

下载指引：https://www.openeuler.org/zh/other/migration/

部署工具 #

rpm -ivh x2openEuler-2.0.0-1.x86_64.rpm

注意：安装 rpm 时需要使用 root 用户，且目前需要网络（用于下载安装依赖） 注意：根据提示安装依赖包如 bzip2-devel 等

su x2openEuler
x2openEuler redis-db -init

依次录入 redis 数据库的 ip:127.0.0.1 端口：6379 数据库索引号（0-16）：0 密码（工具会对密码加密处理）：如果 redis 密码没有设置或者为空时，直接回车即可

x2openEuler init source_centos7.6-openEuler20.03-LTS-SP1.tar.gz

备注：x2openEuler 使用 rpm 安装完成后会在/opt/x2openEuler 目录下带有 source_centos7.6-openEuler20.03-LTS-SP1.tar.gz 这个默认资源包 需要支持 centos8.2 到 openEuler20.03-LTS-SP1 的评估，则需获取对应的静态资源包导入，如对应的资源包为 source_centos8.2-openEuler20.03-LTS-SP1.tar.gz，导入此包命令：x2openEuler init source_centos8.2-openEuler20.03-LTS-SP1.tar.gz，请示情况选择对应的资源包

扫描软件 #

wget http://rpmfind.net/linux/epel/7/x86_64/Packages/e/enca-1.19-1.el7.x86_64.rpm
x2openEuler scan enca-1.19-1.el7.x86_64.rpm
注意要分析的移植文件需要有能够让x2openEuler用户可以读取的权限
扫描完成后会在/opt/x2openEuler/output目录生成html格式的报告

查看评估结果 #

软件兼容性评估报告分三块内容展示软件兼容性，分别是依赖包兼容性、C/C++接口兼容性、java 接口兼容性，依赖包兼容性反映了软件包安装过程中的直接依赖，非 100%表明无法正确安装；接口兼容性反映的是单个软件运行过程中对其他软件包、动态库或系统接口的调用变化，非 100%表明在某个功能调用时可能会触发异常，未调用到时可能表现正常；部分结果建议人工复核，最终软件包使用建优先级建议 openEuler 已移植包>openEuler 上人工重编译包>centos 软件包。

结果：通过报告可知外部接口兼容性 100%，依赖包兼容性人工复核后通过，经评估 enca1.19 软件包在 openEuler 20.03 LTS SP1 系统上兼容，可安装此软件包至 openEuler 20.03 LTS SP1 系统进行验证。

RPM 方式安装 enca #

1. 下载 rpm 包：http://rpmfind.net/linux/epel/7/x86_64/Packages/e/enca-1.19-1.el7.x86_64.rpm。

2. 上传至 openEuler 服务器。

   说明： 若服务器可以访问网络，则可以直接在服务器上使用 wget 命令下载源码包。

3. 执行如下命令，安装 enca。

    rpm -ivh enca-1.19-1.el7.x86_64.rpm

运行和验证 #

1. 执行如下命令，验证 enca 是否安装成功。

   enca --version

2. 回显信息如下，则表示安装成功。

   enca 1.19

   Features: -librecode-interface +iconv-interface +external-converter +language-detection +locale-alias+
   target-charset-auto +ENCAOPT

   Copyright (C) 2000-2005 David Necas (Yeti) (<yeti@physics.muni.cz>),
              2005 Zuxy Meng (<zuxy.meng@gmail.com>).

   Enca is free software; it can be copied and/or modified under the terms of
   version 2 of GNU General Public License, run `enca --license' to see the full
   license text.  There is NO WARRANTY; not even for MERCHANTABILITY or FITNESS
   FOR A PARTICULAR PURPOSE.