导读：

本文教大家如何安装 oneAPI，推荐大家使用linux系统，因此windows/mac也可以使用 VM 虚拟机搭建 linux 环境。

虚拟机的配置是根据 oneAPI 和 oneDNN 动态实验调整出来的，不要只按照网上独立的虚拟机安装教程

本文包括：

  1. linux（ubuntu18）安装 oneAPI
  2. 安装 oneDNN，使用最新的 icx/icpx（DPC++编译器）

最终离不开 linux 系统，所以入门 linux 不会错~

PS：虚拟机方式不能使用 GPU 加速

如果你选择使用虚拟机，请看接下来的教程，否则可以直接跳过！

VM 和 Ubuntu 的安装 #

安装 VMware 虚拟机 #

  1. 下载安装包
  2. 更改默认安装位置
  3. 按默认配置
  4. 输入密钥

下载 Ubuntu 镜像 #

如果网速慢，建议寻找国内镜像，各大高校的下载速度挺快的，选择离你最近的高校镜像加速速度更佳哟~

另外，我下载的是桌面版，讲解也以图像界面为主。

安装 Ubuntu18 #

  1. 创建虚拟机
  2. 向导界面选择“自定义高级”
  3. 兼容性选择当前vmware 版本
  4. 在安装程序光盘影像文件选择下载的镜像(iso)路径
  5. 输入全名（就是用户名），用户名（这里我写的始终没有发现在哪体现）和密码 （这里写不好，后期都能改，不要慌）
  6. 虚拟机名称可以随便取；“位置”就是将来虚拟机文件所在的目录，因为虚拟机文件比较大，要选择一个磁盘空间比较大的目录。
  7. 下一步，设置要分配给虚拟机的 CPU，电脑配置高的可以往上调，这样在后面使用make -jx带劲（4 核以上）。
  8. 内存推荐8G以上
  9. 默认
  10. I/O 控制器类型默认推荐
  11. 虚拟磁盘类型默认推荐
  12. 创建新虚拟磁盘
  13. 磁盘空间，因为后面要安装 oneapi，建议60GB以上
  14. 磁盘文件名，没有什么影响
  15. 完成之后会自动安装
  16. 登录进去之后一般就会问你要不要升级到新版本，点取消，否则系统就白装了

更改国内源 #

  1. 备份文件 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
  2. 更改文件权限使其可编辑 sudo chmod 777 /etc/apt/sources.list
  3. sudo gedit /etc/apt/sources.list

我使用的 Ubuntu18，因此使用

deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse

deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse

  1. 更新软件列表，换源完成

    sudo apt-get update
sudo apt-get upgrade

卸载旧的 vim，**原来的不好用！** #

sudo apt-get remove vim-common

安装新的 vim #

sudo apt-get install vim

接下来是重点了！

oneapi 的安装 #

在虚拟机打开浏览器下载Intel oneAPI Base Toolkit和Intel® oneAPI HPC Toolkit

https://www.intel.com/content/www/us/en/developer/tools/oneapi/toolkits.html?wapkw=toolkit#base-kit

安装包方式： #

  1. 打开下载目录，右键点击 Properties 复制目录
  2. 打开终端，输入pwd查找当前目录地址，以便更好的使用相对路径
  3. 输入sudo sh Downloads/l_BaseKit_p_2022.3.0.8767.sh (注意自己的目录)
    1. 输入sudo意思为所有用户安装，也可以不放

命令行方式： #

  1. 在下载界面往下滑有个 Command Line Download,复制这里的命令使用 wget 下载

  2. 例如

    wget https://registrationcenter-download.intel.com/akdlm/irc_nas/18852/l_BaseKit_p_2022.3.0.8767.sh

sudo sh ./l_BaseKit_p_2022.3.0.8767.sh

    下一步： #

  3. 输入之后会弹出图形界面，接下来按照图形界面的指示进行安装即可 (虚拟机没有 GPU，使用 CPU 就行，因此无视 GPU 错误)，默认安装路径是/opt/intel/oneapi/

  4. Intel® oneAPI HPC Toolkit同操作

  5. 很多人说要设置环境变量，就看自己需不需要了

    1. 如果不需要，每次使用 icx/icpx 等时候，或者发现命令找不到时候，要使用source /opt/intel/oneapi/setvars.sh激活（新建一个新的 terminal 都要运行一次），而环境变量就是节省你输入的次数，但是会每次打开 terminal 运行
    2. 接下来开始设置环境变量，如果不需要可以跳过
    3. sudo gedit ~/.bashrc or sudo vim ~/.bashrc
    4. 将source /opt/intel/oneapi/setvars.sh > /dev/nulll写入最后一行，但我们仍需要优化。

  6. 运行这句后 oneAPI 会添加所有工具包，可能会污染你的工作环境，可以写一个 config.txt 文件自定义加载的环境,比如自带的 python 就有些问题。

  7. sudo vim /opt/intel/oneapi/config.txt # 在指定目录下新建了一个配置文件，内容如下排除了 intelpython：intelpython=exclude

  8. source /opt/intel/oneapi/setvars.sh --config="/opt/intel/oneapi/config.txt" > /dev/null最后写入这个去。

  9. 注意：官方说使用 intel 优化的 python 版本，不要使用图形界面，应去除 python 组件，使用Anaconda安装（2022.12.5 更新）

oneDNN 的部署-icx/icpx 编译 #

oneAPI Base Tookit 安装时候已经带上了 oneDNN，但是版本不是最新的，如果你想要体验最新的 oneDNN 环境，请在 oneAPI Base Tookit 卸载默认的 oneDNN 组件，然后继续看此节。

  1. 这里我不建议直接 git clone，因为 clone 下来的是开发版不稳定，直接下载已经 Releases 的正式版！并且自己本地下载直接移动到虚拟机界面，速度更快！附 Github 地址

  2. 如果没有设置前面的环境变量，记得source /opt/intel/oneapi/setvars.sh

  3. mkdir -p build
cd build
export CC=icx
export CXX=icpx
cmake .. \
          -DDNNL_CPU_RUNTIME=SYCL \
          -DDNNL_GPU_RUNTIME=SYCL

  4. 构建库，make -j

    1. 这里有个知识点，一般只有 j效率太低了，就像这里的构建，很多次会使用系统奔溃重启！而 make 可以根据 cpu 总数进行合理利用

    2. 使用make -j后面跟一个数字，比如make -j4 make -j6 make -j14等。

      含义是 让 make 最多允许 n 个编译命令同时执行，这样可以更有效的利用 CPU 资源。

    3. 并行的任务不宜太多，有时候能 j8，j8 就好了

    4. cpu_num=`cat /proc/stat | grep cpu[0-9] -c`
echo "make -j${cpu_num}"
make -j${cpu_num}

    5. 因此建议 make -j 数字

  5. 使用ctest命令，如果检验是 0%说明你没有启动source /opt/intel/oneapi/setvars.sh,因为我们使用虚拟机，它是没有 CPU 的,因此他是不可能 100%，一般 80%就是正确的

  6. 文档中说要构建文档，经过测试无法成功，并且自带的 doc 文件已经有了，感觉是官方的 bug，再次可以直接跳过

  7. sudo cmake --build . --target install

  8. icpx getting_started.cpp -ldnnl测试

example_utils.hpp #

如果使用的项目需要使用，需要将 oneDNN 目录里的 example 文件夹里的example_utils.hpp移动与项目文件同目录，例如这里取AlexNet.cpp为主文件

  1. 编译指令

    icpx AlexNet.cpp -ldnnl