Skip to content

Latest commit

 

History

History
245 lines (166 loc) · 8.81 KB

build_guide_riscv_zh.md

File metadata and controls

245 lines (166 loc) · 8.81 KB
Raw

在RISC-V架构的openEuler上源码编译安装iSulad

RISC-V虚拟环境的搭建

RISC-V的环境搭建是通过在host上使用QEMU虚拟机实现，您要做的是使用任意一Linux发行版作为host安装QEMU虚拟机，在虚拟机中启动RISC-V的openEuler镜像，在虚拟机镜像中完成iSulad的安装。

1. 安装虚拟机

首先是在host上安装QEMU，打开终端，依次运行以下命令：

wget https://download.qemu.org/qemu-5.1.0.tar.xz
tar xvJf qemu-5.1.0.tar.xz
cd qemu-5.1.0
./configure --target-list=riscv64-softmmu
make 
make install

2. 启动文件准备

安装好支持RISC-V的QEMU之后，就可以使用它来启动虚拟机的镜像，镜像的下载和安装可以参考openEuler RISC-V 移植版的获取和运行，启动QEMU的虚拟机Linux环境，应该有以下几个文件：

可以创建run_oe1_rv64.sh文件如下：

#!/bin/sh

qemu-system-riscv64 \
    -machine virt \    
    -nographic \
    -smp 8 \
    -m 124G \
    -drive file=oe-rv-base-expand.qcow2,format=qcow2,id=hd0 \
    -object rng-random,filename=/dev/urandom,id=rng0 \
    -device virtio-rng-device,rng=rng0 \
    -device virtio-blk-device,drive=hd0 \
    -netdev user,id=usernet,hostfwd=tcp::12055-:22 \
    -device virtio-net-device,netdev=usernet \
    -append 'root=/dev/vda1 systemd.default_timeout_start_sec=600 selinux=0  rw highres=off console=ttyS0 mem=4096M earlycon' \
    -kernel fw_payload.elf  \

里面是一些参数的设定，可以查看QEMU的参数说明根据本地计算机配置进行调整。

3.启动虚拟机

可以采用两种方式：

  1. 在终端直接输入shell文件中的内容
  2. 如果创建了shell文件，只需要在终端里输入 sh run_oe1_rv64.sh

默认的登录用户名/密码是：root/openEuler12#$

源码编译及安装

首先使用yum安装依赖的软件包，之后参考build_guide的逐步源码构建和安装iSulad进行编译和安装,以下给出了编译过程中可能出现的错误以及其解决方案。

依赖软件包安装

正式编译项目之前，要在系统上安装编译工具、代码版本控制等用途的软件包。

这个过程会使用yum工具来对rpm软件包进行安装，如果刚刚使用oe-rv-rv64g-30G.qcow2，里面并没有提供yum工具，可以使用下面的命令进行yum的安装：

wget https://isrc.iscas.ac.cn/mirror/openeuler-sig-riscv/oe-RISCV-repo/noarch/yum-4.2.15-8.noarch.rpm --no-check-certificate
rpm -ivh yum-4.2.15-8.noarch.rpm

之后，可以使用yum工具进行所需软件包的安装：

sudo yum --enablerepo='*' install -y automake autoconf libtool cmake make libcap libcap-devel libselinux libselinux-devel libseccomp libseccomp-devel yajl-devel git libcgroup tar python3 python3-pip device-mapper-devel libarchive libarchive-devel libcurl-devel zlib-devel glibc-headers openssl-devel gcc gcc-c++ systemd-devel systemd-libs libtar libtar-devel vim

要修改yum源的配置，在 /etc/yum.repos.d/下打开oe-rv.repo文件，一般使用Index of /oe-RISCV-repo/为yum源的地址。

编译过程中可能出现的错误以及其解决方案

Clock skew detected错误

需要调整虚拟机时间为本地时间，时间调整命令的格式如下： date -s 2020-09-28

源码编译安装protobuf

源码编译安装protobuf时与build_guide不同，需要选择按照以下两种方式的任意一种进行安装，以满足后面的grpc能够顺利编译：

第一种安装方法

首先输入以下命令：

$ pkg-config --cflags protobuf 
$ pkg-config --libs protobuf 
$ pkg-config --cflags --libs protobuf 


$ git clone https://gitee.com/src-openeuler/protobuf.git
$ cd protobuf
$ git checkout openEuler-20.03-LTS-tag
$ tar -xzvf protobuf-all-3.9.0.tar.gz
$ cd protobuf-3.9.0

此过程参考了stack overflow,如果按照build_guide编译，在编译grpc时，会报错： 'std::system_error'。

在编译之前要对文件做一些修改,使用如下命令打开protobuf源文件下的src/google/protobuf/stubs/common.cc文件：

vi src/google/protobuf/stubs/common.cc

在这个文件中，把有关 _WIN32 的所有代码都注释掉,如下：

// updated by Aimer on linux platform

//#ifdef _WIN32
//#define WIN32_LEAN_AND_MEAN // We only need minimal includes
//#include <windows.h>
//#define snprintf _snprintf // see comment in strutil.cc
//#elif defined(HAVE_PTHREAD)
#include <pthread.h>
//#else
//#error "No suitable threading library available."
//#endif

此处参考了protobuf 安装流程

$ sudo -E ./autogen.sh
$ sudo -E ./configure CXXFLAGS="$(pkg-config --cflags protobuf)" LIBS="$(pkg-config --libs protobuf)"
$ sudo -E make -j $(nproc)
$ sudo -E make install
$ sudo -E ldconfig

最后，验证编译是否成功。

protoc --version

输出：libprotoc 3.9.0(或其他的版本号)

第二种安装方法

由于protobuf和grpc的安装的依赖关系，您可以将它们视为一个组合，还可以先编译grpc，再在third_party文件夹下的protobuf目录下安装protobuf，相关的编译方法可以搜索protobuf+grpc编译，但这种方式编译成功率很低。

源码编译安装grpc

$ git clone https://gitee.com/src-openeuler/grpc.git
$ cd grpc
$ git checkout openEuler-20.03-LTS-tag
$ tar -xzvf grpc-1.22.0.tar.gz
$ cd grpc-1.22.0

修改源码：

  • 在include/grpcpp/impl/codegen/call_op_set.h line 90添加
 /// Default assignment operator
  WriteOptions& operator=(const WriteOptions& other) = default;
  • 将src/core/lib/gpr/log_linux.cc、src/core/lib/gpr/log_posix.cc、src/core/lib/iomgr/ev_epollex_linux.cc这几个文件中的 gettid()改为sys_gettid()

参考protobuf+grpc源码编译安装过程

$ sudo -E make -j $(nproc)
$ sudo -E make install
$ sudo -E ldconfig

之后会遇到cannot find -latomic的问题,按链接中的处理即可:

grpc测试用例

cd examples/cpp/helloworld/
make                 //编译
./greeter_server     //服务器
./greeter_client     //客户端（重新开一个服务器连接）

安装lxc时的问题

在编译lxc的过程中会遇到两个问题：

  • 关于__NR_signalfd 解决方案：lxc的issue
  • 再次遇到'cannot find -latomic'的问题 这次不能使用上次的方法，这次是缺少静态链接库，使用find命令搜到libatomic.a复制到/usr/lib下，编译通过。

内核编译及内核模块的编译

iSulad的启动还需要一个overlay的内核模块。由于虚拟机镜像默认没有提供overlay，因此您需要开启此模块并进行编译封装。

  1. 下载与当前镜像系统一致的版本的内核源码（内核版本可以使用uname -a命令来查看）
git clone https://gitee.com/openeuler/kernel.git
git checkout 某一分支
  1. 在内核源码的目录下，执行make menuconfig，在配置界面找到File systems ---> 在Overlay filesystem support前配置成[M]或[*]（单击空格键切换），之后保存并退出；
  2. 使用make Image命令，在/内核源码路径/arch/riscv/boot/ 下生成Image文件；
  3. 下载内核封装工具opensbi:
git clone https://gitee.com/src-openeuler/opensbi.git
cd opensbi
unzip v0.6.zip
cd opensbi-0.6
make O=build-oe/qemu-virt PLATFORM=qemu/virt FW_PAYLOAD=y FW_PAYLOAD_PATH=/生成的Image路径/Image

这一步会生成elf文件，编译结束会提示elf文件所在位置。

  1. 先使用scp将elf文件拷贝至host，再将.qcow2文件、.elf文件、.sh文件放在同一路径下，最后修改run_oe1-rv64.sh中的kernel 参数处的elf文件名为新添加的elf文件名。
  2. 执行sh run_oe1-rv64.sh

参考链接