实验简介

实验背景

ExaGear 是一款运行在 ARM64 服务器上的二进制指令动态翻译软件。它在程序运行时把 x86 指令逐段翻译成 ARM64 指令并执行,使绝大部分 Linux on x86 应用无需重新编译即可运行在 ARM64 服务器上,从而以较低成本完成 x86 应用到鲲鹏平台的整体迁移。

与源码迁移相比,动态二进制翻译不接触源代码,适用于三类场景:源码不可获得、源码规模过大短期无法改造、业务需要先跑起来再逐步替换。本实验以 x86_64 版 nginx 为例,完整走一遍"安装翻译引擎—启动 guest 环境—在 guest 中安装并运行 x86 应用—配置共享目录—升级与卸载"的全过程。

实验目标

  • 掌握 ExaGear for Server 的安装与 guest 环境的启动方法。
  • 掌握在 guest 环境中配置软件源、安装并运行 x86 应用的方法。
  • 掌握 host 与 guest 之间共享目录的配置方法。
  • 掌握 ExaGear 的升级、卸载以及卸载后的残留清理方法。

实验环境

项目配置
虚拟机 IP10.60.10.150
CPU / 内存4 vCPU / 6 GiB
系统盘102 GiB,实验开始前可用 34 GiB
操作系统openEuler 22.03 LTS(aarch64)
内核版本5.10.0-60.18.0.50.oe2203.aarch64
页大小4096 字节(4 KB)
登录方式SSH,root 用户

说明:原实验环境要求 8 GiB 内存,本实验在 6 GiB 内存、4 vCPU 的虚拟机上实测可完整完成全部步骤,未出现内存不足。

软件包准备

实验资料中提供的安装包如下,需上传到虚拟机的 /home 目录。

名称大小说明
ExaGear_V100R002C00.tar.gz108 MB含 CentOS 4KB、64KB 两套发布件,以及 Debug、ExaGear4Docker 变体

上传命令在本地执行(把 <本地路径> 换成本机实际路径):

scp <本地路径>/ExaGear_V100R002C00.tar.gz root@10.60.10.150:/home/

资源检查与清理

ExaGear 安装完成后占用约 0.9 GB(guest 镜像 813 MB,翻译引擎与配置约 100 MB),对磁盘要求不高;但 guest 环境内安装软件、升级软件包仍需要预留空间。开始实验前先确认磁盘与内存余量:

df -h /
free -g
getconf PAGESIZE
arch

判断标准与处理办法:

  • df -h / 的 Avail 大于 5 GB 即可正常完成本实验。
  • free -g 的 available 大于 2 GB 即可;若不足,可关闭与实验无关的服务释放内存。
  • getconf PAGESIZE 的结果决定后续安装哪一套发布件,必须记录。
  • arch 必须为 aarch64;若为 x86_64 说明登录到了错误的机器。

若磁盘余量不足,可清理与本实验无关的大文件。以下命令仅作参考,执行前需确认目标目录确无用途:

du -sh /opt/* /root/* 2>/dev/null | sort -rh | head -10

确认后可删除的典型对象包括历史安装包、内核源码目录、已不再使用的测试数据。删除操作不可恢复,务必逐项确认后再执行。

本实验所用虚拟机上还有 B03 遗留的两套编译器(/opt/compiler 6.5 GB)、安装包缓存(/root/software 4.8 GB),实测磁盘余量 33 GB,未做删除即可完成全部步骤。

预备知识

动态二进制翻译的执行过程

程序启动时,ExaGear 接管 x86 可执行文件的加载,把将要执行的 x86 指令块翻译成 ARM64 指令并缓存,之后再次执行同一代码块时直接命中缓存。因此首次运行较慢,重复执行逐渐接近原生速度。翻译过程对应用透明,应用看到的仍是 x86_64 架构、仍是 CentOS 7 的根文件系统。

组件分工

组件包名作用
命令行入口exagear-utils-1169-1提供 /usr/bin/exagear 脚本
64 位翻译引擎exagear-core-x64a64-1169-1x86_64 指令翻译为 ARM64;带 -p64k 后缀的为 64 KB 页版本
32 位翻译引擎exagear-core-x32a64-1169-1x86_32 指令翻译为 ARM64;64 KB 页环境无此包
guest 镜像exagear-guest-centos-7-x86_64-1169-1CentOS 7.8 x86_64 根文件系统,安装时解压到 /opt/exagear/images/centos-7-x86_64
系统集成exagear-integration-1169-1注册 systemd 服务与 binfmt_misc 处理器

binfmt_misc 的作用

exagear-integration 安装后会启动 exagear-x86_64.service、exagear-x86_32.service,在 /proc/sys/fs/binfmt_misc/ 下注册两个处理器。注册生效后,内核遇到 x86 ELF 文件会主动交给 ExaGear 执行,因此不必显式调用 exagear 命令,直接写二进制路径也能运行。这一点是后续"绝对路径运行 nginx"能够成立的原因,也是卸载后必须清理注册项的原因。

guest 环境的根目录

guest 环境没有独立的磁盘分区,它的根目录就是 host 上的一个普通目录:

/opt/exagear/images/centos-7-x86_64

在 guest 中执行 ls /,看到的是该目录下的内容;在 host 中访问 /opt/exagear/images/centos-7-x86_64/etc/nginx,等价于在 guest 中访问 /etc/nginx。理解这一点,才能理解为什么安装 x86 软件会直接改变 host 上的这个目录,也才能理解升级时配置被覆盖的现象。

注意:guest 环境的提示符与 host 完全相同,都是 [root@master 目录]#。判断当前处于哪一侧,唯一可靠的方法是执行 arch:输出 x86_64 为 guest,输出 aarch64 为 host。

任务一:安装 ExaGear for Server

步骤1 上传并解压安装包

登录虚拟机,进入 /home 目录查看安装包是否已上传:

cd /home
ls

解压安装包:

tar -zxvf ExaGear_V100R002C00.tar.gz
ls

执行结果如图 1-1。解压后多出 ExaGear_V100R002C00 目录,包内不仅有 CentOS 发布件,还包含 ExaGear4Docker 与 debug 两类目录,本实验只使用 CentOS/release 下的 RPM。

图 1-1 解压 ExaGear 安装包

图 1-1 解压 ExaGear 安装包

判断标准与处理办法:

  • 解压无报错,ls 能看到 ExaGear_V100R002C00 目录即为成功。
  • 若提示 gzip: stdin: not in gzip format,说明安装包上传不完整,需重新上传并比对文件大小(应为 108 MB)。

步骤2 确认系统页大小

ARM64 系统支持 4 KB 与 64 KB 两种页大小,ExaGear 的翻译引擎与页大小绑定,装错套件会无法启动 guest。先查询当前页大小:

getconf PAGESIZE

执行结果如图 1-2,本环境输出 4096。

图 1-2 查询系统页大小

图 1-2 查询系统页大小

判断标准与处理办法:

  • 输出 4096:使用 4 KB 页发布件,按步骤 3 安装五个包。
  • 输出 65536:使用 64 KB 页发布件,将 exagear-core-x64a64 换成 exagear-core-x64a64-p64k,并且不再安装 exagear-core-x32a64(64 KB 页环境不提供 32 位引擎)。

步骤3 安装 ExaGear

进入发布件目录,确认待安装的 RPM:

cd /home/ExaGear_V100R002C00/CentOS/release
ls

安装五个 RPM(4 KB 页环境):

rpm -ivh exagear-utils-1169-1.noarch.rpm \
  exagear-core-x64a64-1169-1.aarch64.rpm exagear-core-x32a64-1169-1.aarch64.rpm \
  exagear-guest-centos-7-x86_64-1169-1.noarch.rpm \
  exagear-integration-1169-1.noarch.rpm

执行结果如图 1-3。第 4 个包需要解压 101 MB 的 guest 镜像,是整条命令中耗时最长的一步,期间命令无任何输出属正常现象。

图 1-3 安装 ExaGear 五个 RPM 包

图 1-3 安装 ExaGear 五个 RPM 包

判断标准与处理办法:

  • 五个包的进度都到达 [100%],最后一行是 5:exagear-integration-1169-1,且没有 error: 输出,即为成功。
  • 出现 Created symlink ... exagear-x86_64.service 属正常信息,表示 systemd 服务已注册。
  • 出现 Unpacking archive with guest image 与 ...done. 表示 guest 镜像解压完成,这是耗时最长的一步,中途不要中断。
  • 若提示 package xxx is already installed,说明该包已装过,无需处理;若需重装见任务三步骤 2。

安装后可核对版本与目录:

cat /opt/exagear/cmcversion
ls /opt/exagear

cmcversion 输出 V100R002C00B007,/opt/exagear 下有 bin、images、integration、shared 四个子目录。

步骤4 进入 guest 环境并验证

执行 exagear 启动 guest shell:

exagear

进入后提示 Starting /bin/bash in the guest image /opt/exagear/images/centos-7-x86_64。此时提示符外观没有任何变化,需要靠 arch 判断:

arch

输出 x86_64 说明已处于虚拟的 x86 环境。退出 guest 后再确认一次:

exit
arch

执行结果如图 1-4。

图 1-4 进入 guest 环境并验证架构

图 1-4 进入 guest 环境并验证架构

判断标准与处理办法:

  • 进入后 arch 输出 x86_64,退出后输出 aarch64,一进一出两个结果不同,是 guest 生效的可靠判据。
  • 若执行 exagear 后立即回到原提示符、没有 Starting /bin/bash 提示,检查是否安装了 exagear-guest-centos-7-x86_64 包。
  • 若提示 failed to load exagear kernel module 或启动即退出,多为页大小与翻译引擎不匹配,回到步骤 2 重新判断并安装对应的 p64k 包。

任务小结

本任务完成了 ExaGear 的安装与 guest 环境验证。安装的关键在于页大小判别:4 KB 页装三件套(utils、x64a64、x32a64)加镜像与集成包,64 KB 页装 p64k 引擎且不含 32 位引擎。guest 环境的提示符与 host 一致,需用 arch 区分。

任务二:在 guest 环境中安装 x86 应用

步骤1 配置 guest 的 yum 源

guest 镜像是 CentOS 7.8,其自带的 CentOS-Base.repo 指向 mirrorlist.centos.org。CentOS 7 已于 2024 年 6 月停止维护,该地址在多数网络环境下不可用,需要改为镜像站的 baseurl。

进入 guest:

exagear

备份原有配置:

cp -a /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak

重写源配置:

cat > /etc/yum.repos.d/CentOS-Base.repo <<'EOF'
[base]
name=CentOS-$releasever - Base
baseurl=https://repo.huaweicloud.com/centos/$releasever/os/$basearch/
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

[updates]
name=CentOS-$releasever - Updates
baseurl=https://repo.huaweicloud.com/centos/$releasever/updates/$basearch/
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

[extras]
name=CentOS-$releasever - Extras
baseurl=https://repo.huaweicloud.com/centos/$releasever/extras/$basearch/
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
enabled=1
EOF

执行结果如图 2-1。$releasever、$basearch 由 yum 在运行时替换,输入时保持原样即可。

图 2-1 在 guest 内重写 CentOS-Base.repo

图 2-1 在 guest 内重写 CentOS-Base.repo

刷新缓存:

yum clean all
yum makecache

执行结果如图 2-2,末尾出现 Metadata Cache Created 表示源可用。

图 2-2 刷新 yum 缓存

图 2-2 刷新 yum 缓存

判断标准与处理办法:

  • yum makecache 能下载各仓库的 primary_db、filelists_db 并输出 Metadata Cache Created,说明源地址与网络均正常。
  • 若报 Cannot find a valid baseurl for repo: base/7/x86_64,检查 baseurl 是否写成了 centos-vault 之外的失效路径,或在 guest 中执行 curl -I https://repo.huaweicloud.com/centos/7/os/x86_64/ 确认该地址可访问。
  • 若报 Could not resolve host,说明 guest 的 /etc/resolv.conf 无效;该文件默认由 host 映射,可在 host 上确认 /etc/resolv.conf 是否可正常解析。

说明:原实验手册在此处还有 yum update 一步。guest 内执行 yum update 会升级 glibc、openssl 等基础库,在动态翻译环境下执行时间显著变长,且存在升级后 guest 镜像不可用、已装软件失效的风险。本实验跳过该步骤,直接安装目标软件;若确有升级需求,应先把 /opt/exagear/images/centos-7-x86_64 整体备份。

步骤2 安装 epel-release 并修正 EPEL 源

nginx 位于 EPEL 仓库,先安装 EPEL 仓库配置包:

yum install -y epel-release

执行结果如图 2-3,安装的是 epel-release-7-11.noarch。

图 2-3 安装 epel-release

图 2-3 安装 epel-release

epel-release 生成的 /etc/yum.repos.d/epel.repo 使用 metalink=https://mirrors.fedoraproject.org/...。该地址在 guest 环境内通常不可达,直接安装 nginx 会失败:

Cannot retrieve metalink for repository: epel/x86_64. Please verify its path and try again

因此需要先把 EPEL 源改为镜像站的固定 baseurl:

cp -a /etc/yum.repos.d/epel.repo /etc/yum.repos.d/epel.repo.bak
sed -i 's|^metalink=|#metalink=|' /etc/yum.repos.d/epel.repo
sed -i 's|^#baseurl=.*|baseurl=https://repo.huaweicloud.com/epel/7/$basearch/|' \
  /etc/yum.repos.d/epel.repo
grep -E '^\[|^baseurl' /etc/yum.repos.d/epel.repo

执行结果如图 2-4,三个仓库段的 baseurl 均指向镜像站。

图 2-4 修正 EPEL 源指向

图 2-4 修正 EPEL 源指向

判断标准与处理办法:

  • grep 输出中 [epel] 段下必须有一行 baseurl=https://repo.huaweicloud.com/epel/7/$basearch/,且不再有未注释的 metalink。
  • 若漏改 metalink,yum 仍会优先使用它并报错;两行 sed 的顺序不能颠倒,必须先注释 metalink 再改 baseurl。

步骤3 安装 nginx

在 guest 中安装 nginx:

yum install -y nginx

安装过程会下载约 26 MB、共 9 个包,其中 centos-logos 占 21 MB。执行结果如图 2-5(截图仅保留事务结束部分)。

图 2-5 安装 nginx 的执行结果

图 2-5 安装 nginx 的执行结果

判断标准与处理办法:

  • 末尾出现 Installed: nginx.x86_64 1:1.20.1-10.el7 与 Complete! 即为成功。
  • 出现 Header V4 RSA/SHA256 Signature ... NOKEY 属正常提示,yum 随后会自动导入 EPEL 的 GPG 公钥,不影响安装。
  • 若报 No package nginx available,说明 EPEL 源未生效,回到步骤 2 检查。
  • 安装完成后,nginx 的程序文件位于 guest 的 /usr/sbin/nginx,对应 host 路径 /opt/exagear/images/centos-7-x86_64/usr/sbin/nginx,可用 file 确认它是 x86-64 可执行文件。

步骤4 运行 x86 版 nginx

nginx 安装完成后,在 guest 与 host 中均可运行。

在 guest 中直接运行(当前仍在 guest 环境内,无需再执行 exagear):

nginx -h

执行结果如图 2-6。

图 2-6 guest 环境下运行 nginx -h

图 2-6 guest 环境下运行 nginx -h

退出 guest,回到 host:

exit

在 host 中运行有两种方式。

方式一,通过 exagear 命令指定程序:

exagear -- /usr/sbin/nginx -h

方式二,直接执行 guest 镜像内的绝对路径:

/opt/exagear/images/centos-7-x86_64/usr/sbin/nginx -h

两种方式执行结果如图 2-7。方式二之所以可行,是因为 exagear-integration 已向内核注册 binfmt_misc 处理器,内核会自动把 x86 二进制交给 ExaGear 执行。

图 2-7 host 环境下两种运行方式

图 2-7 host 环境下两种运行方式

进一步做服务级验证:启动 nginx,确认 80 端口监听,并访问首页:

exagear -- /usr/sbin/nginx
ss -lntp | grep ':80 '
curl -s http://127.0.0.1/ | head -6

停止 nginx 并确认端口释放:

exagear -- /usr/sbin/nginx -s quit
ss -lntp | grep ':80 ' || echo '80 port released'

执行结果如图 2-8,curl 返回 CentOS 默认欢迎页,说明这个 x86_64 二进制确实在 ARM64 机器上跑起来了。

图 2-8 启动 nginx 并访问 80 端口

图 2-8 启动 nginx 并访问 80 端口

判断标准与处理办法:

  • nginx -h 输出 nginx version: nginx/1.20.1 与用法说明,说明二进制可正常加载。
  • ss -lntp | grep ':80 ' 能看到 0.0.0.0:80 与 [::]:80 两个监听项,进程名为 nginx。
  • curl 返回 Welcome to CentOS 页面,说明服务可对外提供访问。
  • 停止后再次查询 80 端口应无输出,脚本中以 || echo 兜底打印 80 port released。
  • 若 exagear -- /usr/sbin/nginx 提示 nginx: [emerg] open() "/var/log/nginx/error.log" failed,说明 guest 镜像内的日志目录被删除,重新安装 nginx 包即可恢复。
  • 结束实验前务必执行 -s quit,否则 nginx 会一直占用 host 的 80 端口。

任务小结

本任务在 guest 环境中完成了 CentOS 源与 EPEL 源的配置,并安装了 x86_64 版 nginx。两个源问题的处理是重点:CentOS 7 的官方 mirrorlist 已失效,需改镜像站 baseurl;epel-release 自带 metalink 在 guest 内不可达,需注释 metalink 并补 baseurl。nginx 可通过 guest shell、exagear -- 命令、镜像内绝对路径三种方式运行。

任务三:配置、升级与卸载 ExaGear Server

步骤1 配置 host 与 guest 的共享目录

guest 环境与 host 之间默认不共享自有目录。把 host 的一个目录映射进 guest,需要两侧各建同名目录,并在 vpaths-list 中登记。

在 host 上创建共享目录并确认:

mkdir /share
ls /

在 guest 镜像内创建同名目录(host 视角的路径):

mkdir /opt/exagear/images/centos-7-x86_64/share
ls /opt/exagear/images/centos-7-x86_64

执行结果如图 3-1。

图 3-1 创建 host 与 guest 的共享目录

图 3-1 创建 host 与 guest 的共享目录

在 host 上创建测试文件:

echo 'Hello ExaGear!' > /share/test
cat /share/test

此时进入 guest 查看 /share:

exagear
ls /share

执行结果如图 3-2。guest 中的 /share 是空的——它看到的是镜像内的那个空目录,host 的 /share/test 尚未映射进来。

图 3-2 未配置 vpaths 时 guest 中的 /share

图 3-2 未配置 vpaths 时 guest 中的 /share

退出 guest,把 /share/ 追加到 vpaths-list:

exit
echo '/share/' >> /opt/exagear/images/centos-7-x86_64/.exagear/vpaths-list
tail -4 /opt/exagear/images/centos-7-x86_64/.exagear/vpaths-list

执行结果如图 3-3。

图 3-3 将 /share/ 写入 vpaths-list

图 3-3 将 /share/ 写入 vpaths-list

再次进入 guest 验证:

exagear
ls /share
cat /share/test
exit

执行结果如图 3-4,guest 能看到 test 并读到 Hello ExaGear!。

图 3-4 配置生效后 guest 可读取 host 文件

图 3-4 配置生效后 guest 可读取 host 文件

判断标准与处理办法:

  • 配置前 guest 的 /share 为空、配置后能读到 test,两个状态对比是判断配置是否生效的依据。
  • 路径必须以 / 结尾,写成 /share 不会生效。
  • 必须追加到新的一行,不能与其他路径写在同一行。
  • /home/、/root/、/tmp/、/proc/、/dev/ 等目录默认已在 vpaths-list 中,因此 guest 里能直接看到 host 的家目录与临时目录,这也是 guest 与 host 共用 /tmp 的原因。
  • 若修改后仍看不到文件,确认是否改的是当前镜像对应的 vpaths-list;重新安装 guest 包会覆盖该文件,见步骤 2。

步骤2 升级 ExaGear Server

升级前先备份 guest 的配置目录:

\cp -rf /opt/exagear/images/centos-7-x86_64/.exagear/* /tmp

注意:root 用户的 cp、mv、rm 默认带 -i 别名,批量覆盖时会被逐条询问"是否覆盖"。命令前加反斜杠 \cp 可绕过别名,等价于使用原始命令。若不加,后续命令会被这些询问卡住。

进入发布件目录,执行升级:

cd /home/ExaGear_V100R002C00/CentOS/release
rpm -Uvh exagear-utils-1169-1.noarch.rpm \
  exagear-core-x64a64-1169-1.aarch64.rpm \
  exagear-core-x32a64-1169-1.aarch64.rpm \
  exagear-guest-centos-7-x86_64-1169-1.noarch.rpm \
  exagear-integration-1169-1.noarch.rpm

执行结果如图 3-5。rpm 对五个包逐个提示 is already installed,cmcversion 仍为 V100R002C00B007。

图 3-5 同版本 rpm -Uvh 的实际效果

图 3-5 同版本 rpm -Uvh 的实际效果

判断标准与处理办法:

  • rpm -Uvh 只在新包版本号更高时才真正升级。实验资料只提供 1169 一个版本,对已安装的同版本包执行该命令,结果就是逐条提示 already installed,版本不变,这属于正常现象而非错误。
  • 拿到更高版本的发布件时,把上面命令中的 RPM 换成新版本文件即可,其余步骤不变。
  • 若需要在不换版本的前提下演练升级流程(重装、配置覆盖、合并),使用 --replacepkgs:
rpm -Uvh --replacepkgs exagear-utils-1169-1.noarch.rpm \
  exagear-core-x64a64-1169-1.aarch64.rpm \
  exagear-core-x32a64-1169-1.aarch64.rpm \
  exagear-guest-centos-7-x86_64-1169-1.noarch.rpm \
  exagear-integration-1169-1.noarch.rpm

执行结果如图 3-6。两处现象需要特别注意:一是提示 Found unpacked exagear image ... guest image content will be unchanged,已安装的软件(如 nginx)不会被清除;二是 .exagear 下的配置文件被覆盖回默认值。

图 3-6 使用 --replacepkgs 重装

图 3-6 使用 --replacepkgs 重装

验证配置是否被覆盖,并把备份合并回来:

grep -c '^/share/$' /opt/exagear/images/centos-7-x86_64/.exagear/vpaths-list
cat /tmp/vpaths-list \
  /opt/exagear/images/centos-7-x86_64/.exagear/vpaths-list \
  | sort -u > /tmp/vpaths-merged
\mv -f /tmp/vpaths-merged /opt/exagear/images/centos-7-x86_64/.exagear/vpaths-list
grep -n '^/share/$' /opt/exagear/images/centos-7-x86_64/.exagear/vpaths-list

执行结果如图 3-7。第一条 grep -c 输出 0,说明自定义的 /share/ 已丢失;合并后 grep -n 输出 57:/share/,说明已恢复。

图 3-7 配置被覆盖后合并恢复

图 3-7 配置被覆盖后合并恢复

重启服务并验证共享目录:

systemctl daemon-reload
systemctl restart exagear-x86_64 exagear-x86_32
systemctl is-active exagear-x86_64 exagear-x86_32
exagear
ls /share
exit
cat /opt/exagear/cmcversion

执行结果如图 3-8,两个服务均为 active,guest 中 /share 重新可见,版本仍为 V100R002C00B007。

图 3-8 重启服务并验证共享目录

图 3-8 重启服务并验证共享目录

判断标准与处理办法:

  • 合并命令不能写成 cat 备份 当前配置 > 当前配置。shell 会先截断目标文件再执行 cat,第二个输入实际为空,结果只剩备份内容;改为先写临时文件再 mv 才安全。
  • --replacepkgs 会先移除旧的 service 链接再重建,因此执行完必须 systemctl daemon-reload 并重启两个服务,is-active 都返回 active 才算完成。
  • 服务的 binfmt 注册在内核中原本仍然有效,即使 is-active 显示 inactive,绝对路径运行 x86 程序往往也能成功;但服务状态与注册状态不一致会给后续排错带来干扰,仍应重启到 active。
  • 升级后务必用 exagear 进 guest 验证业务目录是否还在,配置文件合并是否覆盖了全部自定义项(vpaths-list、opaths-list、utmp-list 等)。

步骤3 卸载 ExaGear Server

先卸载全部软件包:

rpm -qa | grep exagear | xargs rpm -e
rm -rf /opt/exagear/
ls /opt

再执行 exagear 确认命令已失效:

exagear

执行结果如图 3-9。ls /opt 中不再有 exagear 目录,exagear 报 /usr/bin/exagear: No such file or directory。

图 3-9 卸载 ExaGear

图 3-9 卸载 ExaGear

最后清理 binfmt_misc 残留注册项:

ls /proc/sys/fs/binfmt_misc/
echo -1 > /proc/sys/fs/binfmt_misc/x86_64_exagear_guest
echo -1 > /proc/sys/fs/binfmt_misc/x86_32_exagear_guest
ls /proc/sys/fs/binfmt_misc/

执行结果如图 3-10,注销后只剩 register 与 status。

图 3-10 清理 binfmt_misc 残留注册

图 3-10 清理 binfmt_misc 残留注册

判断标准与处理办法:

  • rpm -qa | grep exagear 应无输出;/opt/exagear 目录应已删除。
  • exagear 的报错信息有两种:本次会话中报 /usr/bin/exagear: No such file or directory(shell 缓存了旧路径),新开会话则报 command not found,两者都表示已卸载。执行 hash -r 可清除缓存。
  • 卸载后 /proc/sys/fs/binfmt_misc/ 下仍会残留 x86_64_exagear_guest、x86_32_exagear_guest 两项。若不注销,之后再运行任何 x86 程序都会失败并报 cannot execute binary file: Exec format error,容易误判为文件损坏。
  • 若需重新安装,按任务一执行 rpm -ivh 即可,guest 镜像会重新解压,之前安装的 x86 软件不会保留。

任务小结

本任务完成了共享目录配置、升级演练与卸载。共享目录的关键是两侧同名目录加 vpaths-list 登记,路径必须以 / 结尾。升级部分需区分两种情形:版本更高时 rpm -Uvh 直接生效;版本相同时只能提示 already installed,需用 --replacepkgs 演练。无论哪种方式,.exagear 配置都会被覆盖,必须与备份合并,并在重装后重启 systemd 服务。卸载后还要注销 binfmt_misc 注册项,否则会留下难以解释的执行错误。

常见问题与排错

现象原因处理办法
执行 exagear 提示 command not found未安装或已卸载按任务一安装五个 RPM
执行 exagear 后提示符未变化、无 Starting /bin/bashguest 镜像包未安装安装 exagear-guest-centos-7-x86_64
guest 启动即退出,提示加载内核模块失败页大小与翻译引擎不匹配getconf PAGESIZE 后改用 p64k 包
yum makecache 报 Cannot find a valid baseurlCentOS 7 官方源已下线按任务二步骤 1 改镜像站 baseurl
yum install nginx 报 Cannot retrieve metalink for repository: epel/x86_64EPEL 的 metalink 在 guest 内不可达注释 metalink,补镜像站 baseurl
yum install nginx 报 No package nginx available未装 epel-release 或 EPEL 源未生效先装 epel-release 并修正源
guest 中 ls /share 为空未配置 vpaths-list,或路径结尾缺 /追加 /share/ 到新的一行
升级后 guest 中 /share 消失.exagear 配置被新包覆盖用备份合并 vpaths-list
systemctl is-active 显示 inactive 但 x86 程序仍能跑内核中的 binfmt 注册未清除daemon-reload 后重启两个服务
卸载后运行 x86 程序报 Exec format errorbinfmt_misc 注册项残留向对应注册项写入 -1 注销
批量复制时终端不断询问"是否覆盖"root 的 cp、mv 带 -i 别名命令前加 \,如 \cp -rf

实验总结

本实验以 x86_64 版 nginx 为例,完成了 ExaGear 的部署与使用。安装阶段的核心是页大小判别,4 KB 与 64 KB 环境使用的翻译引擎不同,装错套件 guest 无法启动。运行阶段的核心是理解 guest 环境的本质:它是 host 上的一个目录,因此 guest 内安装软件、修改配置都会直接落在 host 的文件系统上,升级覆盖配置的问题也由此而来。共享目录依赖 vpaths-list 登记,升级与重装会重置该文件,需要与备份合并。卸载不是删除 RPM 就结束,还要注销 binfmt_misc 中的注册项,否则会留下执行 x86 程序报格式错误的隐患。

相较于源码迁移,动态二进制翻译的优势是无需改码、上线快,代价是运行时有翻译开销、且对依赖特定指令集或内核接口的程序兼容性有限。实际项目中通常把它作为过渡手段,为源码改造争取时间。

思考题

  1. ExaGear 的翻译结果会被缓存,那么第一次运行与第二次运行同一个 x86 程序的耗时应当有何差异?请设计一个方法验证你的判断。
  2. guest 环境的根目录是 host 上的 /opt/exagear/images/centos-7-x86_64。基于这一点,说明为什么在 guest 中执行 rm -rf /etc/nginx 之后,在 host 上也能看到该目录被删除。
  3. 实验中使用 --replacepkgs 演示了升级流程。如果拿到的是 1170 版本的发布件,rpm -Uvh 与 --replacepkgs 在执行结果上会有什么不同?配置是否仍会被覆盖?
  4. 卸载后如果不注销 binfmt_misc 注册项,运行 x86 程序会报什么错误?请解释该错误产生的过程。
  5. 某业务系统包含一个 x86 的 Java 服务和一个 aarch64 的原生数据库客户端,二者需要互相调用。使用 ExaGear 方案时,需要额外考虑哪些问题?
Logo

鲲鹏昇腾开发者社区是面向全社会开放的“联接全球计算开发者,聚合华为+生态”的社区,内容涵盖鲲鹏、昇腾资源,帮助开发者快速获取所需的知识、经验、软件、工具、算力,支撑开发者易学、好用、成功,成为核心开发者。

更多推荐