適用於 Linux 的英特爾 oneAPI DL 框架開發人員工具包

對於英特爾® oneAPI DL 框架開發人員工具套件，請執行下列步驟：

以下說明假設您已安裝英特爾® oneAPI 軟體。請參閱 英特爾 oneAPI 工具組頁面 用於安裝選項。

1. 配置您的系統
2. 建置並運行為amp使用命令列開啟項目。

介紹

如果您想使用 oneDNN 和 oneCCLamples，您必須安裝 英特爾® oneAPI 基礎工具套件。基礎套件包含所有英特爾® oneAPI DL 框架開發人員工具套件（DLFD 套件）組件以及所有必要的依賴項。

如果您希望使用 DL DevKit 庫而不嘗試提供的amp文件中，您只需要安裝 DLFD 套件。否則，安裝 英特爾® oneAPI 基礎工具包.

該工具包是一套開發庫，可快速輕鬆地建立或優化深度學習框架，從而充分利用最新英特爾® 處理器的效能。該工具包為深度學習框架提供了靈活的選項，包括 CPU 或 GPU 上的最佳效能。

• 英特爾® oneAPI 深度神經網路庫
• 英特爾® oneAPI 集體通訊庫

英特爾® oneAPI 深度神經網路庫

英特爾® oneAPI 深度神經網路庫是一個用於深度學習應用的開源性能庫。本函式庫包含英特爾® 架構處理器和英特爾® 處理器顯示卡最佳化的神經網路的基本建置模組。該程式庫面向有興趣提高英特爾 CPU 和 GPU 上的應用程式效能的深度學習應用程式和框架開發人員。許多流行的深度學習框架都與該庫整合。

英特爾® oneAPI 集體通訊庫

英特爾® oneAPI 集體通訊庫是一個提供深度學習中使用的通訊模式的高效實施的庫。

• 建置於英特爾® MPI 庫之上，允許使用其他通訊庫。
• 經過最佳化以推動通訊模式的可擴充性。
• 可跨各種互連工作：Intel® Omni-Path 架構、InfiniBand* 和乙太網
• 支援深度學習框架的通用 API（Caffe*、Theano*、Torch* 等）
• 軟體包包含英特爾® MLSL 軟體開發套件 (SDK) 和英特爾® MPI 庫執行階段元件。

配置您的系統

英特爾® oneAPI DL 框架開發人員工具套件
運行amp使用英特爾® oneAPI DPC++/C++ 編譯器和英特爾® 執行緒建置模組的文件，您必須安裝 英特爾® oneAPI 基礎工具包 在配置您的系統之前。

有關係統要求的完整列表，請參閱 英特爾® oneAPI 深度神經網路庫發行說明.

要配置您的系統，您需要：

• 設定CPU/GPU或FPGA的環境變數
• 對於 GPU 用戶，安裝 GPU 驅動程式
• 對具有長時間運行的 GPU 計算工作負載的應用程式停用 Hangcheck
• 對於GPU用戶，將用戶加入到影片群組

為 CLI 開發設置環境變量

為了使用命令列介面 (CLI)，oneAPI 工具包中的工具是透過環境變數進行配置的。透過取得 setvars 腳本來設定 CLI 環境：

選項 1：每個會話一次源 setvars.sh

每次打開一個新的終端窗口時源 setvars.sh：
您可以在oneAPI 安裝的根資料夾中找到setvars.sh 腳本，對於sudo 或root 用戶，該根資料夾通常為/opt/intel/oneapi/；當作為普通用戶安裝時，該根資料夾通常為~ /intel/oneapi/。

對於 root 或 sudo 安裝：
。 /opt/intel/oneapi/setvars.sh
對於普通用戶安裝：
。 〜/英特爾/oneapi/setvars.sh

選項 2：一次性設置 setvars.sh

若要自動為您的專案設定環境，請將命令 source /setvars.sh 包含在啟動腳本中，該命令將在其中自動呼叫（替換為 oneAPI 安裝位置的路徑）。對於 sudo 或 root 用戶，預設安裝位置為 /opt/intel/oneapi/；作為普通用戶安裝時，預設安裝位置為 ~/intel/oneapi/。

對於前amp文件，您可以將 source /setvars.sh 命令新增至 ~/.bashrc 或 ~/.bashrc_profile 或者 ~/.profile file. 要使系統上所有帳戶的設置永久生效，請在系統的 /etc/pro 中創建單行 .sh 腳本file來源 setvars.sh 的 .d 資料夾（有關更多詳細信息，請參閱 Ubuntu 環境變數文檔).

筆記
可以使用配置來管理 setvars.sh 腳本 file，如果您需要初始化特定版本的函式庫或編譯器，而不是預設為“最新”版本，這尤其有用。
有關詳細信息，請參閱 使用配置 File 管理 Setvars.sh。。如果您需要在非 POSIX shell 中設定環境，請參閱 oneAPI開發環境搭建 了解更多配置選項。

對於 GPU 用戶，安裝 GPU 驅動程式

如果您按照安裝指南中的說明安裝 GPU 驅動程序，則可以跳過此步驟。如果您尚未安裝驅動程序，請按照以下說明進行操作 安裝指南.

GPU：禁用 Hangcheck

本節僅適用於在本機環境中具有長時間運行的 GPU 運算工作負載的應用程式。不建議將其用於虛擬化或 GPU 的其他標準用途（例如遊戲）。

GPU 硬體執行時間超過四秒的工作負載是長時間運作的工作負載。預設情況下，符合長時間運行工作負載條件的單一執行緒被視為掛起並終止。
透過停用hangcheck逾時時間，可以避免此問題。

筆記 如果系統重新啟動，hangcheck 會自動啟用。您必須在每次重新啟動後再次停用hangcheck，或按照指示永久停用hangcheck（多次重新啟動）。

若要停用hangcheck直到下次重新啟動：
sudo sh -c“echo N> /sys/module/i915/parameters/enable_hangcheck”

要在多次重新啟動時停用hangcheck：

筆記 如果更新了內核，則會自動啟用 hangcheck。 每次內核更新後運行以下過程以確保禁用 hangcheck。

1. 打開終端機。
2. 打開 grub file 在 /etc/default.
3. 在蠐螬 file, 找到 GRUB_CMDLINE_LINUX_DEFAULT=” 行。
   在引號 (“”) 之間輸入此文本：
   i915.enable_hangcheck=0
4. 運行此命令：
   sudo 更新 grub
5. 重啟系統。 Hangcheck 保持禁用狀態。

GPU：將用戶加入影片群組

對於 GPU 運算工作負載，非 root（普通）使用者通常無權存取 GPU 裝置。確保將您的普通用戶新增至影片群組；否則，為 GPU 裝置編譯的二進位檔案在由一般使用者執行時將會失敗。要解決此問題，請將非 root 使用者新增至影片群組： sudo usermod -a -G video

有關最新的要求列表，請參閱 英特爾® oneAPI 集體通訊庫發行說明.

運行 Samp項目
運行方式amp使用命令列開啟項目。

運行 Sample 項目使用命令行

英特爾® oneAPI DL 框架開發人員工具套件

如果您想使用 oneDNN 和 oneCCLamples，您必須安裝 英特爾® oneAPI 基礎工具組 (BaseKit).
BaseKit 包含所有英特爾® oneAPI DL 框架開發人員工具包元件以及所有必要的依賴項。

BaseKit安裝完成後，可執行amp使用中的說明 建置並運行英特爾® oneAPI DL 框架開發人員工具套件 Samp文件使用命令行.

使用容器

英特爾® oneAPI DL 框架開發人員工具套件

容器允許您設置和配置用於構建、運行和分析 oneAPI 應用程序的環境，並使用圖像分發它們：

• 您可以安裝包含預配置了您需要的所有工具的環境的映像，然後在該環境中進行開發。
• 您可以保存環境並使用圖像將該環境移動到另一台機器而無需額外設置。
• 您可以根據需要準備具有不同語言和運行時、分析工具或其他工具集的容器。

下載 Docker* 圖像

您可以從以下位置下載 Docker* 映像： 容器儲存庫.

筆記 Docker 鏡像大約有 5 GB，下載需要大約 15 分鐘。 它將需要 25 GB 的磁盤空間。
圖片=英特爾/oneapi-dlfdkit
泊塢窗拉“$圖像”

通過命令行使用容器

英特爾® oneAPI DL 框架開發人員工具套件
直接編譯並執行容器。

下面的命令使用 –device=/dev/dri 啟用 GPU（如果可用）（在 Linux* VM 或 Windows* 中可能無法使用）。該命令將使您處於容器內的命令提示字元下，處於互動模式。

圖片=英特爾/oneapi-dlfdkit
# –device=/dev/dri 啟用 GPU（如果可用）。可能在 Linux VM 或 Windows 中不可用 docker run –device=/dev/dri -it “$image”

進入容器後，您可以使用 Run a S 與其交互amp使用命令列的項目。

筆記 如果您使用代理，您可能需要在 -it “$image”之前包含代理設定：

docker run -e http_proxy=”$http_proxy” -e https_proxy=”$https_proxy” -it “$image”

將英特爾® Advisor、英特爾® Inspector 或 VTune™ 與容器結合使用

使用這些工具時，必須為容器提供額外的功能：

–cap-add=SYS_ADMIN –cap-add=SYS_PTRACE
docker run –cap-add=SYS_ADMIN –cap-add=SYS_PTRACE \
–device=/dev/dri -it “$image”

下一步

英特爾® oneAPI DL 框架開發人員工具套件

建構完自己的專案後，重新view 英特爾® oneAPI DL 框架工具套件代碼 Samp萊斯 了解該工具包的功能。

聲明和免責聲明

英特爾技術可能需要啟用硬件，軟件或服務才能激活。
沒有任何產品或組件是絕對安全的。
您的費用和結果可能會有所不同。

© 英特爾公司。 英特爾、英特爾標識和其他英特爾標誌是英特爾公司或其子公司的商標。 其他名稱和品牌可能是其他人的財產。

優化通知

對於非英特爾微處理器，英特爾編譯器可能會或可能不會進行相同程度的最佳化，以實現非英特爾微處理器所獨有的最佳化。這些最佳化包括SSE2、SSE3和SSSE3指令集以及其他最佳化。英特爾不保證非英特爾製造的微處理器上的任何最佳化的可用性、功能性或有效性。本產品中與微處理器相關的最佳化旨在與 Intel 微處理器一起使用。某些非特定於英特爾微架構的最佳化是為英特爾微處理器保留的。有關本通知涵蓋的特定指令集的更多信息，請參閱適用的產品使用者和參考指南。
通知修訂 #20110804

本文檔未授予任何智慧財產權許可（明示或暗示、透過禁止反言或其他方式）。

所描述的產品可能包含設計缺陷或錯誤（稱為勘誤表），這可能導致產品偏離已發布的規格。目前特徵勘誤表可依要求提供。

英特爾否認所有明示和默示保證，包括但不限於適銷性、特定用途適用性和不侵權的默示保證，以及因履行過程、交易過程或貿易使用產生的任何保證。

文件/資源

適用於 Linux 的英特爾 oneAPI DL 框架開發人員工具包 [pdf] 使用者手冊 適用於 Linux 的 oneAPI DL 框架開發人員工具包、適用於 Linux 的框架開發人員工具包、適用於 Linux 的開發人員工具包、適用於 Linux 的工具包

參考

• 使用者手冊