英特爾(R) 至強融核(TM) 平臺軟件堆棧
英特爾(R) 至強融核(TM) 協處理器軟件開發平臺
gold 軟件預覽版本
驅動程序修訂版： 2.1.4346-16
Oct 19, 2012
部件號： MPSS gold README
出口法規： ECCN = 5D992a; ECCN = EAR99
*** 注意：
*** o 本文檔是關於包含英特爾(R) 至強融核(TM) 協處理器的系統。
*** o 在本文檔中，以“user_prompt>”開頭的行用於表示 Linux* shell 提示符，並且同一行上緊隨此字符串的文本表示將在 Linux* shell 中執行的命令。
免責聲明：
本文檔涉及英特爾開發的產品。 此部分強調對這些產品的使用方式和向其他人披露的信息的限制。 有關更多信息，請與英特爾現場代表聯繫。
英特爾不承擔任何可用性、效益或擔保責任。 此處包含的 license.txt 完整定義了此軟件的許可和使用，但 GPL 組件除外。 本文檔包含處於開發設計階段的產品的相關信息。 此處信息可能隨時更改，恕不另行通知。 請勿根據這些信息確定最終設計。
這些模塊中所包含的代碼可能是英特爾(R) 至強融核(TM) 協處理器所特有，並且不能與其它英特爾(R) 產品向後兼容。 此外，英特爾對未來產品中的代碼支持或指令集不做任何承諾。
* 文中涉及的其它名稱及商標屬於各自所有者資產。
===============================================================================
目錄
===============================================================================
1. 概述
1.1 軟件修訂號
1.2 相關軟件修訂號
2. 提交錯誤和其它請求
3. 硬件要求 - 首選配置
4. 英特爾(R) 至強融核(TM) 平臺軟件堆棧要求
4.1 一般要求
4.2 第三方軟件要求
5. 軟件安裝
5.1 安裝英特爾(R) 至強融核(TM) 平臺軟件堆棧
5.2 初始配置
5.3 安裝 OFED 軟件（可選）
5.4 安裝 GANGLIA* 軟件（可選）
6. 啓動和停止英特爾(R) 至強融核(TM) 協處理器平臺軟件堆棧服務
6.1 啓動英特爾(R) 至強融核(TM) 協處理器服務
6.2 啓動帶 OFED 支持的英特爾(R) 至強融核(TM) 協處理器服務
6.3 啓動帶 GANGLIA* 支持的英特爾(R) 至強融核(TM) 協處理器服務
6.4 停止英特爾(R) 至強融核(TM) 協處理器服務
7. 英特爾(R) 至強融核(TM) 協處理器的配置文件
7.1 包括重疊配置文件
7.2 啓動英特爾(R) 至強融核(TM) 協處理器
7.3 英特爾(R) 至強融核(TM) 協處理器閃存更新
7.4 進入/退出電源狀態 PC6
4.9 爲英特爾(R) 至強融核(TM) 協處理器選擇時鐘源
8. 可用的工具
8.1 Micinfo
8.2 Micflash
8.3 Micsmc
8.4 Miccheck
8.5 Micnativeloadex
8.6 Linux*“service”和“chkconfig”命令
8.7 Micctrl
8.8 Micrasd
8.9 Mpssflash
8.10 Mpssinfo
8.11 英特爾(R) 至強融核(TM) Shell 環境
9. 與嵌入式 Linux* OS 通信
9.1 SSH 訪問英特爾(R) 至強融核(TM)
9.2 網絡配置
9.3 NFS 安裝主機導出
9.4 英特爾(R) 至強融核(TM) 的 DHCP 配置
9.5 虛擬控制檯訪問
10. 重新編譯源中的 GPL 二進制
10.1 重新編譯主機驅動程序
10.2 重新編譯 GPL RPM
10.3 重新編譯英特爾(R) 至強融核(TM) 特定的 OFED RPM
10.4 重新編譯英特爾(R) 至強融核(TM) 特定的 OFED 協處理器 RPM
10.5 重新編譯英特爾(R) 至強融核(TM) 特定的 GANGLIA* RPM
11. 對稱通信接口支持的功能
12. MPSS 2.1 版本的軟件開發環境
12.1 支持的環境
12.2 編譯支持的環境
12.3 SCIF 的用戶模式代碼
12.4 P2P（對等）支持
12.5 SCIF 中的註冊緩存
12.6 英特爾(R) 至強融核(TM) 的 GNU 調試器 (GDB)
12.7 英特爾(R) 至強融核(TM) 的 Virtio 塊設備
13. 支持特性的快照
===============================================================================
1. 概述
===============================================================================
此“自述文件”與英特爾(R) 至強融核(TM) 平臺軟件堆棧版本修訂 2.1.4346-16 有關。
MPSS 2.1 包含 Linux* 驅動程序和 gold 及更高版本的支持工具。
1.1 軟件修訂號
下面列出了 MPSS 2.1 Linux* 程序包軟件組件的修訂號
MPSS 2.1 Linux* 主機驅動程序和運行時 2.1.4346-16
英特爾(R) 至強融核(TM) 協處理器閃存映像 EXT_HP2_A0_0375-01
EXT_HP2_B0_0375-01
EXT_HP2_B1_0375-01
1.2 相關軟件修訂號
MPSS 2.1 Linux* 程序包已使用下面指定修訂中的以下主機“操作系統”版本進行測試。
Red Hat* Enterprise Linux* 64 位 6.0 內核 2.6.32-71
Red Hat* Enterprise Linux* 64 位 6.1 內核 2.6.32-131
Red Hat* Enterprise Linux* 64 位 6.2 內核 2.6.32-220
Red Hat* Enterprise Linux* 64 位 6.3 內核 2.6.32-279
SUSE* Linux* Enterprise Server SLES 11 SP1 內核 2.6.32.12-0.7-default
SUSE* Linux* Enterprise Server SLES 11 SP2 內核 3.0.13-0.27-default
****************************************************************************
* 警告： 其它版本不支持此軟件。
*
* 此驅動程序依賴於 2.6.32 Linux* 內核。 提供主機驅動程序的源。 此時由軟件用戶決定是否要傳送至其它 Linux* 內核。
*
* 此時英特爾不負責提供任何資源來幫助非測試編譯，因此不存在支持的環境。
****************************************************************************
===============================================================================
2. 提交錯誤和其它請求
===============================================================================
需要英特爾開發解決方案的所有問題均應通過 http://premier.intel.com 向英特爾卓越支持提出
===============================================================================
3. 硬件要求 - 首選配置
===============================================================================
配置 1：
主板： W2600CR2（以前稱爲 Crown Pass）
Bios： BIOS 44，公開可用的生產版 BIOS 不支持
英特爾(R) 至強融核(TM) 協處理器，因此不應使用。
CPU： 英特爾(R) 至強(TM) 處理器 E5-2600 系列
協處理器： 英特爾(R) 至強融核(TM) 協處理器。
RAM： 32 GB ECC DDR3-1333 (8 x 4GB)
HDD： 1 TB SATA2
電源： 2x 1200W PMBus 非冗餘
顯卡： 兼容分配的顯卡
配置 2：
主板： S5520SC（以前稱爲 Shady Cove）
Bios： BIOS X2_59
CPU： 英特爾(R) 至強(TM) 處理器 5600 系列
協處理器： 英特爾(R) 至強融核(TM) 協處理器。
RAM： 24 GB 1333 MHz DDR3 (6 x 4GB)
HDD： 最小值 500GB
電源： 1200 瓦
顯卡： 兼容分配的顯卡
===============================================================================
4. 英特爾(R) 至強融核(TM) 平臺軟件堆棧要求
===============================================================================
4.1 一般要求
*** 注意：
*** o 在英特爾(R) 至強融核(TM) 平臺軟件堆棧 Beta 版本中添加了 SUSE* SP2 支持。 由此，已棄用 SUSE* SP1 作爲主機 OS 的支持，且會從未來版本中將其移除。
*** o 有關如何獲取 Red Hat* Enterprise Linux* 受支持的版本的信息，請訪問供應商網站。
*** o 有關如何獲取 SUSE* Linux* Enterprise Server 的信息，請訪問 Novell* (SUSE*) 供應商網站。
1) 英特爾(R) 至強融核(TM) 平臺軟件堆棧 gold 預覽版本程序包
2) 安裝英特爾(R) 至強融核(TM) 平臺軟件堆棧 2.1 版本需要超級用戶權限。
3) 至少安裝了一個英特爾(R) 至強融核(TM) 協處理器的受支持硬件平臺。
4) Linux* 主機操作系統（默認配置）。
支持的版本：
- Red Hat* Enterprise Linux* 6.0 64 位內核 2.6.32-71。
- Red Hat* Enterprise Linux* 6.1 64 位內核 2.6.32-131。
- Red Hat* Enterprise Linux* 6.2 64 位內核 2.6.32-220。
- Red Hat* Enterprise Linux* 6.3 64 位內核 2.6.32-279。
- SUSE* Linux* Enterprise Server (SLES) 11 SP1 內核
2.6.32.12-0.7-default。
- SUSE* Linux* Enterprise Server (SLES) 11 SP2 內核 3.0.13-0.27-default。
****************************************************************************
* 警告： 供應商更新會阻止加載英特爾(R) 至強融核(TM) 平臺軟件堆棧 2.1 Linux* 主機驅動程序
*
* o 背景： Red Hat* 和 SUSE* 均已發佈次要的內核版本更新，大多數用戶可獲得新內核的自動更新。 內核更新時，會導致版本控制與英特爾(R) 至強融核(TM) 平臺軟件堆棧 Linux* 主機驅動程序不兼容。
*
* o 解決方法 1：
* 將主機 Linux* 內核還原至原始內核：
*
* o 以超級用戶身份打開控制檯並且編輯文件 /boot/grub/menu.lst。
* o 此文件將顯示最新版本和各先前內核版本的可用啓動項列表，其中首先顯示最新版本。
* o Red Hat* 上的“default=0”或 SUSE* 項目的“default 0”會告知啓動系統使用頂部項目。 統計此項下方的項目數，直到找到原始內核的項目（RHEL* 6.0 的 2.6.32-71 或 SUSE* SLES SP2 的 SP2 內核 3.0.13-0.27-default）。編輯“default”並將其更改爲正確的啓動項。
* o 保存、退出，然後重新啓動。 這會使 OS 啓動至原始安裝的內核版本。
*
* o 解決方法 2：
* 請參閱第 10.1 節“重新編譯主機驅動程序”
****************************************************************************
4.2 第三方軟件要求
1) 在 Red Hat* Enterprise 上安裝 MPSS OFED 的要求
- OFED 1.5.4.1 ***注意： 當前僅支持 OFED 1.5.4.1。 （第 5.3 節“安裝 OFED 軟件”）
- rpm-build
- libstdc++-develgcc-gfortran
- libsysfs
- redhat-rpm-config
- tcl
- tk
- libtool
- bison
- flex
- zlib-devel
- gcc-c++
- tcl-devel
2) 在 Red Hat* Enterprise 上安裝 MPSS GANGLIA* 的要求
- apr
- apr-devel
- expat
- expat-devel
- gcc-c++
- libconfuse
- libconfuse-devel
- libtool
- rpm-build
- rrdtool
- rrdtool-devel
3) 在 SUSE* Linux* Enterprise Server (SLES) 上安裝 MPSS OFED 1.5.4.1 的要求
- gcc
- bison flex
- gcc-c++
- kernel-dev
- libgfortran43
- tcl-devel
- zlib-devel
4) 在 SUSE* Linux* Enterprise Server (SLES) 上安裝 MPSS GANGLIA* 的要求
- gcc-c++
- libapr1
- libapr1-devel
- libconfuse0
- libconfuse-devel
- libexpat0
- libexpat-devel
- libtool
- rpm-build
- rrdtool
- rrdtool-devel
===============================================================================
5. 軟件安裝
===============================================================================
5.1 安裝英特爾(R) 至強融核(TM) 平臺軟件堆棧
***注意：
*** o 本節中顯示的範例適用於 Red Hat* Enterprise Linux* 6.0。對於所需的程序包，相應地修改命令。
*** o SUSE* Linux* Enterprise Server 版本要求設置內核，以允許加載非 SUSE* 驅動程序模塊。 編輯“/etc/modprobe.d/unsupported-modules”文件，並將“allow_unsupported_modules”的值設置爲 1。
1) 在安裝 MPSS 軟件之前禁用 SELinux，以避免 SELinux 覆蓋標準 Linux* 權限設置。
2) 卸載先前版本的 MPSS 驅動程序（如果存在）
o 如果已安裝的版本早於 2.x.28xx，請使用以下項目卸載該驅動程序：
user_prompt> sudo modprobe -r mic
o 如果已安裝的版本爲 2.x.28xx 或更高版本，請使用以下項目卸載該驅動程序：
OFED 層
user_prompt> sudo service ofed-mic stop
user_prompt> sudo service opensmd stop
user_prompt> sudo service openibd stop
MPSS 層
user_prompt> sudo service mpss stop
user_prompt> sudo service mpss unload
3) 卸載先前版本的 MPSS 驅動程序（如果存在）
o Red Hat* Enterprise Linux*
user_prompt> sudo yum remove --noplugins --disablerepo=* intel-mic/*
o SUSE* Linux* Enterprise Server
user_prompt> sudo zypper remove intel-mic
4) 通過以下方式確定目標主機操作系統對應的 tar 文件
使用以下常規
rhel-6.0.tgz -> 用於 Red Hat* Enterprise (RHEL) 系統 6.0
rhel-6.1.tgz -> 用於 Red Hat* Enterprise (RHEL) 系統 6.1
rhel-6.2.tgz -> 用於 Red Hat* Enterprise (RHEL) 系統 6.2
rhel-6.3.tgz -> 用於 Red Hat* Enterprise (RHEL) 系統 6.3
suse-11.1.tgz -> 用於 SUSE* Linux* Server 11 SP1。
suse-11.2.tgz -> 用於 SUSE* Linux* Server 11 SP2 (SLES)。
5) 解壓縮 MPSS 程序包
user_prompt> tar xvzf STRING_PACKAGE_NAME-2.1.4346-16-rhel-6.0.tgz
6) 訪問解壓縮的目錄並安裝 MPSS 程序包
user_prompt> cd STRING_PACKAGE_NAME-2.1.4346-16-rhel-6.0
o Red Hat* Enterprise Linux*
user_prompt> sudo yum install --nogpgcheck --noplugins \
--disablerepo=* *.rpm
o SUSE* Linux* Enterprise Server
user_prompt> sudo zypper --no-gpg-checks install *.rpm
o 用匹配的閃存映像更新協處理器的閃存。 按照“英特爾(R) 至強融核(TM) 協處理器閃存更新”一節中的程序操作，然後返回此處。
5.2 初始配置
在首次啓動 MPSS 服務之前，系統管理員必須完成英特爾(R) 至強融核(TM) 協處理器配置。
1) 安裝本地 ssh 密鑰以使用虛擬網絡來與英特爾(R) 至強融核(TM) 協處理器通信。 對系統中需要訪問協處理器的所有用戶完成此操作，包括 Root 用戶（第 9.1 節“SSH 訪問英特爾(R) 至強融核(TM)）。
2) 初始化系統上安裝的英特爾(R) 至強融核(TM) 協處理器的默認配置。
user_prompt> sudo micctrl --initdefaults
“micctrl --initdefaults”會創建並填充對應於系統中安裝的每個英特爾(R) 至強融核(TM) 協處理器的默認配置文件。 這些配置文件名爲 default.conf 和 micN.conf，位於 /etc/sysconfig/mic/ 中。 N 是整數（0、1、2、3 等），用於標識系統中安裝的每個協處理器。
3) 如果默認配置滿足系統的要求，請繼續執行步驟 5。否則，請編輯 /etc/sysconfig/mic 中的配置文件（第 7 節“英特爾(R) 至強融核(TM) 協處理器的配置文件”）。
4) 要將在步驟 3 中對 default.config 進行的更改廣播至所有協處理器配置文件，請使用選項 --resetconfig。 此命令會刪除所有先前的協處理器配置文件，並使用新的編輯過的命令重新創建這些配置文件。
user_prompt> sudo micctrl --resetconfig
如果更改與特定的英特爾(R) 至強融核(TM) 協處理器配置文件相關，則僅更新該協處理器的配置。 例如，如果 /etc/sysconfig/mic/mic1.conf 已更改，則運行：
user_prompt> sudo micctrl --resetconfig mic1
5.3 安裝 OFED（可選）
*** 注意：
*** o 僅支持 OFED 1.5.4.1 版本。
*** o 本節中顯示的範例適用於 Red Hat* Enterprise Linux* 和 SUSE* Linux* Enterprise Server。
*** o 如果不滿足要求，則 OFED 安裝將提供完成安裝所需的 RPM 列表。 請根據需要加以安裝。
*** o 有關安裝 OFED 的任何其它信息，請參閱與 OFED 存檔捆綁的自述文件。
*** o yum 和 zypper 均支持軟件升級和降級。 但是，強烈建議在完整卸載現有英特爾(R) 至強融核(TM) 軟件後全新安裝替換軟件，以升級或降級英特爾(R) 至強融核(TM) 軟件。
1) 下載 OFED 1.5.4.1
user_prompt> wget \
http://www.openfabrics.org/downloads/OFED/ofed-1.5.4/OFED-1.5.4.1.tgz
2) 解壓縮 OFED 1.5.4.1 並訪問解壓縮文件夾
user_prompt> tar xf OFED-1.5.4.1.tgz
user_prompt> cd OFED-1.5.4.1
3) 執行安裝腳本
user_prompt> sudo perl install.pl
在安裝期間，選擇：
o 選項 2（安裝 OFED 軟件）
o 選項 3（所有軟件包）
o 選項 1（實施： OFA）
o Enable ROMIO support [Y/n]，回答 Y
o Enable shared library support [Y/n]，回答 Y
o Enable Checkpoint-Restart support [Y/n]，回答 N
4) 刪除 kernel-ib-devel 和 kernel-ib 程序包
user_prompt> sudo rpm -e kernel-ib-devel
user_prompt> sudo rpm -e kernel-ib
5) 安裝 MPSS OFED
o Red Hat* Enterprise Linux*
user_prompt> sudo yum install --nogpgcheck --noplugins \
--disablerepo=* ofed/*.rpm
o SUSE* Linux* Enterprise Server
user_prompt> sudo zypper --no-gpg-checks install ofed/*.rpm
5.4 安裝 GANGLIA*（可選）
*** 注意：
*** o 當前僅支持 GANGLIA* 3.1.7。
*** o 相同步驟適用於 Red Hat* Enterprise Linux* 和 SUSE* Linux* Enterprise Server。
*** o 有關安裝 GANGLIA* 的其它信息，請參閱位於 http://ganglia.sourceforge.net/ 的文件
*** o GANGLIA* 網頁的默認路徑是 /usr/share/ganglia。 如果已安裝 ganglia-web RPM，將會覆蓋以下文件：conf.php、get_context.php 和 host_view.php。
1) 從以下位置下載 GANGLIA* 3.1.7：http://ganglia.info/?p=269
2) 解壓縮 GANGLIA* 3.1.7 並訪問解壓縮文件夾
user_prompt> tar xf ganglia-3.1.7.tar.gz
user_prompt> cd ganglia-3.1.7
3) 執行配置工具
user_prompt> ./configure --with-gmetad --with-libpcre=no \
--sysconfdir=/etc/ganglia
4) 構建 GANGLIA* 內容並安裝二進制文件
user_prompt> make
user_prompt> make install
5) 生成 gmond 的默認配置
user_prompt> gmond --default_config > /etc/ganglia/gmond.conf
6) 編輯 /etc/ganglia/gmond.conf 以配置 udp_recv_channel，在第 54 行上添加以下條目
udp_recv_channel { port = 8649 }
7) 編輯 /etc/ganglia/gmetad.conf，在“data_source”這一行中配置羣集名稱
data_source "mic_cluster" localhost
8) 更改 RRD 文件夾的所有者
user_prompt> chown -R nobody /var/lib/ganglia/rrds
9) 將 GANGLIA* Web 內容複製到本地 Web 路徑
user_prompt> cp -r web <web_path>/ganglia
10) 啓動 gmond 和 gmetad 監控程序
user_prompt> gmond
user_prompt> gmetad
11) 安裝 MPSS ganglia
o Red Hat* Enterprise Linux*
user_prompt> sudo yum install --nogpgcheck --noplugins \
--disablerepo=* intel-mic-ganglia*.rpm
o SUSE* Linux* Enterprise Server
user_prompt> sudo zypper --no-gpg-checks install \
intel-mic-ganglia*.rpm
12) 將文件 intel-mic-ganglia-STRING_GANGLIA_VERSION.tar 的 web 內容複製到 GANGLIA* web 路徑
user_prompt> tar xf intel-mic-ganglia-STRING_GANGLIA_VERSION.tar
user_prompt> cp -r intel-mic-ganglia-STRING_GANGLIA_VERSION/* \
<web_path>/ganglia/
===============================================================================
6. 啓動和停止英特爾(R) 至強融核(TM) 協處理器平臺軟件堆棧服務
===============================================================================
6.1 啓動英特爾(R) 至強融核(TM) 協處理器 MPSS 服務
1) 使用 Linux* 服務命令啓動 MPSS。
user_prompt> sudo service mpss start
2) 使用“micctrl -w”檢查英特爾(R) 至強融核(TM) 協處理器的狀態。 如果服務成功啓動，則“micctrl -w”將會返回“mic0: online”。
user_prompt> sudo micctrl -w
o 將 MPSS 服務配置爲在主機 OS 啓動時啓動
user_prompt> sudo chkconfig mpss on
o 禁止 MPSS 服務在主機 OS 啓動時啓動
user_prompt> sudo chkconfig mpss off
6.2 啓動帶 OFED 支持的英特爾(R) 至強融核(TM) 協處理器服務
1) 啓動 MPSS 服務（第 6.1 節）。 如果 MPSS 尚未啓動，不要繼續執行任何進一步的操作。
2) 如果已安裝 IB HCA，請啓動其服務。
user_prompt> sudo service openibd start
user_prompt> sudo service opensmd start
3) 啓動英特爾(R) 至強融核(TM) 特定的 OFED 服務。
user_prompt> sudo service ofed-mic start
6.3 啓動帶 GANGLIA* 支持的 MPSS 基本服務
1) 配置文件 /opt/intel/mic/ganglia/etc/ganglia/gmond.conf。默認情況下，會禁用 CPU 指標；啓用它們將導致性能損失。 要啓用 CPU 指標，請取消註釋第 146 行中的塊。
2) 如果已安裝 intel-ganglia-mic rpm，則會啓動帶 MPSS 服務的英特爾(R) 至強融核(TM) 特定的
GANGLIA* 堆棧。
6.4 停止英特爾(R) 至強融核(TM) 協處理器服務
o 要停止英特爾(R) 至強融核(TM) OFED 堆棧，必須先停止 OFED 服務，然後才能停止 MPSS
user_prompt> sudo service ofed-mic stop
o 停止英特爾(R) 至強融核(TM) OFED 堆棧
user_prompt> sudo service mpss stop
user_prompt> sudo service mpss unload
user_prompt> sudo service opensmd stop
user_prompt> sudo service openibd stop
o 停止英特爾(R) 至強融核(TM) 服務
user_prompt> sudo service mpss stop
user_prompt> sudo service mpss unload
o 要停止英特爾(R) 至強融核(TM) 特定的 GANGLIA* Gmond，請對所有已安裝的協處理器重複以下命令。 將 0 更改爲每個協處理器的對應編號。
user_prompt> sudo ssh mic0 killall gmond
===============================================================================
7. 英特爾(R) 至強融核(TM) 的配置文件
===============================================================================
***注意：N 是對應於系統中已安裝的英特爾(R) 至強融核(TM) 協處理器標識號的整數 0、1、2 等。
英特爾(R) 至強融核(TM) 協處理器配置文件位於 /etc/sysconfig/mic/default.conf 和 /etc/sysconfig/mic/micN.conf 中。MPSS 設備驅動程序會安裝 default.conf。此文件用作所有已安裝的協處理器的集中式配置文件。 另外，該驅動程序會安裝 micN.conf 文件，該文件允許系統管理員單個配置每個英特爾(R) 至強融核(TM) 協處理器。
典型的 default.conf 類似以下：
# 使用協處理器上的詳細內核記錄
VerboseLogging Disabled
# 如果 NetworkBridgeName 未定義，會默認使用靜態 IP 地址對。
# 以“mic”開頭的網橋名稱將由 MPSS 監控程序創建。
# 假定已存在其它網橋。
# BridgeName micbr0
# 定義網絡地址的前 2 個八進制字符串。
# 靜態對配置將默認填充第二組的 2 個八進制字符串。
# 單個英特爾(R) 至強融核(TM) 配置文件可使用 MicIPaddress 和 HostIPaddress 覆蓋默認值。
Subnet 172.31
# 嵌入式 Linux* 文件系統基礎的來源
BaseDir /opt/intel/mic/filesystem/base \
/opt/intel/mic/filesystem/base.filelist
# 英特爾(R) 至強融核(TM) 協處理器唯一重疊文件，如“etc”等。
CommonDir /opt/intel/mic/filesystem/common \
/opt/intel/mic/filesystem/common.filelist
# 其它命令行參數。 更改這些內容時應謹慎。
ExtraCommandLine "console=hvc0 mce=off"
# 包括默認的所有其它功能配置文件
Include "conf.d/*.conf"
典型的 mic0.conf 文件類似以下：
# 包括所有英特爾(R) 至強融核(TM) 協處理器共有的配置
Include default.conf
# 英特爾(R) 至強融核(TM) OS 映像
OSimage /lib/firmware/mic/uos.img
# 在啓動 MPSS 時，啓動英特爾(R) 至強融核(TM) 協處理器
BootOnStart Enabled
# 要分配給英特爾(R) 至強融核(TM) 協處理器的主機名
Hostname "myhost-mic0.domain.com"
# 由 mpssd 分配和指派的英特爾(R) 至強融核(TM) MAC 地址
MicMacAddress "46:44:a9:16:52:03"
# 由 mpssd 分配和指派的主機 MAC 地址
HostMacAddress "12:3e:13:96:0d:dc"
# 可下載的文件系統映像位置
FileSystem /opt/intel/mic/filesystem/mic0.image
# 對每個協處理器唯一的嵌入式 Linux* 文件系統文件
CardDir /opt/intel/mic/filesystem/mic0 \
/opt/intel/mic/filesystem/mic0.filelist
7.1 包括重疊配置文件
每個協處理器都通過唯一的配置文件 micN.conf 啓動。系統管理員可使用 Include 配置參數包括其它配置文件。
Include 參數具有以下格式： Include <configuration file name>
要包括的配置文件必須可在基目錄 etc/sysconfig/mic 中找到。 基目錄下還可能包括子目錄。
根據英特爾(R) 至強融核(TM) 配置文件，在默認底部可找到一個特殊的 Include： Include conf.d/*.conf
這會使 /etc/sysconfig/mic/conf.d 中的任何文件被包括在內。
7.2 啓動英特爾(R) 至強融核(TM) 協處理器
mpssd 監控程序提供英特爾(R) 至強融核(TM) 協處理器的所有啓動信息。
o 要啓動的 Linux 影像
OSImage 參數表示 Linux* 內核 - 初始 Linux 啓動映像。 default.conf 表示名爲 uos.img 的英特爾(R) 至強融核(TM) 傳統默認映像。系統管理員可通過在英特爾(R) 至強融核(TM) 特定配置文件中重新定義 OSImage 參數來覆蓋默認值。
o 啓動設備類型和位置
RootDevice 參數指出啓動設備的類型以及設備的位置信息。 默認配置指定使用下載的 RAM 文件系統映像。 該映像將在從 BaseDir、CommonDir、MicDir 和 Overlay 配置參數要求時創建。
o 啓動時間
系統管理員決定在主機啓動時啓動 mpss 服務。 系統管理員可能不希望所有英特爾(R) 至強融核(TM) 協處理器都立即啓動。 BootOnStart 參數會定義此功能。 此參數可在英特爾(R) 至強融核(TM) 協處理器配置文件中單獨定義。
o 內核命令行參數
ExtraCommandLine 參數指定在英特爾(R) 至強融核(TM) 協處理器內核啓動時，傳遞給該內核的內核命令行參數。 協處理器驅動程序當前使用主機驅動程序生成的多個內核命令行參數。 分配至此處的值會附加在此列表上。
ExtraCommandLine 參數主要用於開發。
命令行參數更改後，重新啓動“mpss”服務。
o 啓動期間會顯示英特爾(R) 至強融核(TM) 協處理器的詳細消息
VerboseLogging 參數指定在英特爾(R) 至強融核(TM) 協處理器啓動時，是否將“quiet”內核命令行參數傳遞給該協處理器。
quiet 內核參數會在內核啓動時禁止大多數內核消息。 內核在“quiet”啓用狀態下會更加快速地啓動。
默認值是“啓用”。
o 指定文件系統內容
壓縮文件系統映像會在啓動時下載至英特爾(R) 至強融核(TM) 協處理器，壓縮文件系統映像生成的內容則由 BaseDir、MicDir 和 Overlay 參數定義。 文件系統內容爲一系列“重疊”。 重疊序列的順序可任意，但是通常順序基於命令，即英特爾(R) 至強融核(TM) 重疊列表。
BaseDir 參數默認包含 MPSS 安裝 RPM 的文件系統信息。 該信息位於已安裝的 default.conf 文件中，並且通常不會更改。
MicDir 參數定義每個協處理器唯一的英特爾(R) 至強融核(TM) 協處理器文件。 mpssd 會在此目錄中創建多個默認文件。 默認值會記錄在每個英特爾(R) 至強融核(TM) 協處理器配置文件中。
Overlay 參數可多次使用。 這樣可允許軟件在基礎 MPSS 文件頂部進行安裝。 通常 /etc/sysconfig/mic/conf.d 目錄中包含 Include 參數的各個文件，也會包含 Overlay 參數。
這三個參數具有同一格式。 自變量一，“dir”爲包含文件的目錄，這些文件均包含在文件系統中。 自變量二，“file”爲要包括的文件（可包括多個“file”自變量）和需要放置在文件系統中的所有信息。 條目具有以下格式：
dir <name> <perms> <uid> <gid>
file <name> <source> <perms> <uid> <gid>
slink <name> <target>
nod <name> <perms> <uid> <gid> <type> <major> <minor>
要填充的變量爲：
<name> 定義英特爾(R) 至強融核(TM) 協處理器文件系統上的位置
<perms> 爲文件權限的八進制表示法
<uid> 和 <gid> 爲文件所有者的數字用戶 ID 和組 ID
<source> 定義了實際文件的來源，這些文件要放置在英特爾(R) 至強融核(TM) 協處理器文件系統中
<target> 定義了象徵性鏈接的文件
<type> 定義了設備節點類型，且應爲塊設備分配“b”或爲字符設備分配“c”
<major> 和 <minor> 定義設備數量的 <major> 和 <minor>
例如，與默認 BaseDir 定義文件 base.filelist 相關的某些條目有：
dir /sys 755 0 0
dir /dev 0755 0 0
nod /dev/console 0600 0 0 c 5 1
file /etc/zcip/zcip.script etc/zcip/zcip.script 775 0 0
file /bin/busybox bin/busybox 755 0 0
slink /bin/fsync busybox 777 0 0
slink /bin/egrep busybox 777 0 0
slink /usr/bin/tee ../../bin/busybox 777 0 0
系統管理員不應對“BaseDir”定義的文件進行修改。 運行 micctrl 來設置默認配置會在“MicDir”中生成多個文件，其中包括 /etc/passwd 和網絡配置。 系統管理員可添加此目錄，還會更新 micN.filelist 文件進行匹配。
系統管理員還可能會手動編輯“MicDir”中生成的文件。 例如，可以在協處理器上爲用戶設置密碼。
系統管理員還可能希望在 /etc/sysconfig/mic/conf.d 目錄中添加配置文件，以訪問其它軟件。 請參閱 /etc/sysconfig/mic/conf.d/coi.conf 文件瞭解此操作示例。
7.3 英特爾(R) 至強融核(TM) 協處理器閃存更新
********************************************************************************
* 警告： 請特別注意英特爾(R) 至強融核(TM) 的工程樣品版本，執行以下步驟會重置該版本閃存。 將不正確的 ROM 文件傳遞至英特爾(R) 至強融核(TM) 協處理器會導致協處理器無響應且需要更換。
********************************************************************************
使用 micflash 工具搜索適用於目標英特爾(R) 至強融核(TM) 協處理器的兼容映像，然後執行閃存更新操作。 如果在下面省略“<target directory>”路徑，則 micflash 將在當前目錄和 /opt/intel/mic/flash 目錄中搜索兼容映像。
user_prompt> sudo /opt/intel/mic/bin/micflash \
-Update <target directory>
或者，請參考下表，確定應該用於英特爾(R) 至強融核(TM) 協處理器各步進/工程樣品的相應閃存映像：
步進（工程樣品#） | 閃存 ROM 名稱
--------------------+-----------------------------------------
A0 (ES0, ES1) | EXT_HP2_A0_0375-01.rom.smc
B0 (ES2) | EXT_HP2_B0_0375-01.rom.smc
B1 (QS) | EXT_HP2_B1_0375-01.rom.smc
***注意： 以 .smc 結尾的任何閃存映像文件同時包含閃存和 smc 固件。
3) 等待協處理器處於“就緒”狀態
user_prompt> sudo micctrl -w
user_prompt> mic0: ready
如果協處理器未處於“就緒”狀態，請執行下面的操作
user_prompt> sudo micctrl -r
user_prompt> sudo micctrl -w
user_prompt> mic0: ready
4) 使用“micflash -Update”命令更新協處理器的閃存
如果要使用用戶控制檯上顯示的狀態消息進行閃存更新。
user_prompt> sudo /opt/intel/mic/bin/micflash -Update \
/opt/intel/mic/flash/EXT_HP2_<XX>_0375-01.rom.smc
如果閃存更新無需狀態消息，且在操作結束時要重新啓動主機/節點。
user_prompt> sudo /opt/intel/mic/bin/micflash -silent -Update \
/opt/intel/mic/flash/EXT_HP2_<XX>_0375-01.rom.smc
如果閃存更新無需狀態消息，且在閃存更新操作結束時無需重新啓動主機/節點。
user_prompt> sudo /opt/intel/mic/bin/micflash -silent -noreboot \
-Update /opt/intel/mic/flash/EXT_HP2_<XX>_0375-01.rom.smc
如果閃存更新無需狀態消息，且在閃存更新操作結束時無需重新啓動主機/節點來記錄狀態。（推薦用於羣集環境中的多節點閃存更新）
user_prompt> sudo /opt/intel/mic/bin/micflash -silent -noreboot -Update \
/opt/intel/mic/flash/EXT_HP2_<XX>_0375-01.rom.smc \
-log <log_filename>
如果閃存更新無需狀態消息，且在閃存更新操作結束時需要重新啓動主機/節點來記錄狀態。（推薦用於羣集環境中的多節點閃存更新）
user_prompt> sudo /opt/intel/mic/bin/micflash -silent -Update \
/opt/intel/mic/flash/EXT_HP2_<XX>_0375-01.rom.smc \
-log <log_filename>
其中 <XX> 爲步進“A0”、“B0”或“B1”等。
<log_filename> 爲包含更新操作狀態的日誌文件名稱。
5) 如果系統中有多個協處理器，請使用“-device <bd_num>”選項來指定要更新的協處理器。 例如： 更新第二個英特爾(R) 至強融核(TM) 協處理器上的閃存：
user_prompt> sudo micctrl -r mic1
user_prompt> sudo micctrl -w
user_prompt> sudo /opt/intel/mic/bin/micflash -Update \
/opt/intel/mic/flash/EXT_HP2_<XX>_0375-01.rom.smc -device 1
其中 <XX> 爲步進“A0”、“B0”或“B1”等。
6) 加載新閃存映像需要重新啓動主機系統，並且必須先重新啓動主機系統，然後英特爾(R) 至強融核(TM) 協處理器纔可用。
7.4 進入/退出電源狀態 PC6
*** 注意： PC6 過渡不會與使用 EXT_ prefix 的已安裝閃存映像協同工作。 它僅與包含使用 INT_ prefix 的閃存映像的英特爾(R) 至強融核(TM) 協處理器協同工作。
o 有關 PC6 條目，
1. 確認您在 /etc/sysconfig/mic/default.conf 的 PowerManagement 部分具有“pc3_on;pc6_on”
2. 以 root 用戶身份通過 ssh 連接至協處理器
3. 使用命令
"echo 4 > /sys/devices/system/cpu/micpm/debug/governor_force_state"
如果協處理器沒有活動，這會將協處理器置於 PC6 中。 可通過查看 /var/log/messages 來驗證 PC6 條目。
通常，此時協處理器內核會繼續嘗試進入 PC6 直至成功。 由於某種原因，如果用戶希望停止 PC6 嘗試。
1. 以 root 用戶身份通過 ssh 連接至協處理器
2. 使用命令
"echo 1 > /sys/devices/system/cpu/micpm/debug/governor_force_state"
o 有關 PC6 退出，
任何通過驅動程序 (Sysfs vnet) 的協處理器訪問應將協處理器帶出 PC6。
7.5 爲英特爾(R) 至強融核(TM) 協處理器選擇時鐘源
用戶可爲協處理器選擇 micetc 或 TSC 時鐘源。
要在開機時選擇 TSC，
1. 編輯 default.conf 文件中的 PowerManagement 行以包括
"cpufreq_off;etc_off;pc3_off" in /etc/sysconfig/mic/default.conf
2. 重新啓動 mpss 服務
user_prompt> sudo service mpss stop
user_prompt> sudo micctrl --resetconfig
user_prompt> sudo service mpss start
***注意： - 對於此版本，micetc 爲默認選中。
- 使用 micetc 時鐘源並在多個線程中調用 gettimeofday 時，調用 gettimeofday 的時間比使用 TSC 時鐘源慢了超過 100x。
- 有時內核會聲明 tsc 時鐘源不穩定，並會選擇 jiffies 替代，這會將時間分辨率降低爲 10ms。 用戶可通過查看 /sys/devices/system/clocksource/clocksource0/current_clocksource 中的當前時鐘源設備來檢查是否已發生此降級。 用戶需要重新啓動協處理器以恢復使用 tsc 作爲時鐘源。
===============================================================================
8. 可用的工具
===============================================================================
*** 注意： 在不具備超級用戶權限的情況下，執行某些工具可能會導致工具縮減功能。
英特爾(R) 至強融核(TM) 工具位於 /opt/intel/mic/bin 目錄中。 Root 用戶和需要這些工具的用戶，應通過執行以下步驟將此目錄添加至各自的默認路徑：
o Red Hat* Enterprise Linux*： 將它添加至用戶的 .bash_profile PATH 行。
o SUSE* Linux* Enterprise Server (SLES) 11 SP1 和 SP2：
對於 Bash shell，將以下行添加至用戶的 .bashrc 文件
"export PATH=$PATH:/opt/intel/mic/bin"
o 還可在運行時使用以下命令爲 Bash shell 進行該設置
user_prompt> export PATH=$PATH:/opt/intel/mic/bin
8.1 Micinfo
Micinfo 提供有關係統配置的信息。 它包括主機、英特爾(R) 至強融核(TM) 硬件和驅動程序的相關信息。
要檢索所有信息，使用此命令：
user_prompt> sudo /opt/intel/mic/bin/micinfo
Micinfo 還會接受少量命令，這些命令可包括在命令行自變量中。 添加“-listdevices”將打印一張當前與系統連接的英特爾(R) 至強融核(TM) 設備列表。
user_prompt> sudo /opt/intel/mic/bin/micinfo -listdevices
使用“-deviceinfo <device>”將返回指定設備的所有設備特定信息。
user_prompt> sudo /opt/intel/mic/bin/micinfo -deviceinfo 0
（可選）將“-group <group name>”包括在內可縮小此命令顯示的信息範圍。 有效的組名稱包括 Version、Board、Core、Thermal 和 GDDR。
user_prompt> sudo /opt/intel/mic/bin/micinfo -deviceinfo 0 \
-group core
有關詳細信息，請參考 micinfo 手冊頁面。
user_prompt> man micinfo
8.2 Micflash
請參考“英特爾(R) 至強融核(TM) 協處理器閃存更新”一節瞭解如何更新閃存。
除更新閃存外，micflash 還可以保存和檢索閃存各部分的版本和信息。 Micflash 具有四個基本命令可用以： 保存硬件中的閃存、更新硬件中的閃存、顯示可更新部分並返回設備中的當前閃存版本。
使用此命令獲取硬件中當前閃存的副本：
user_prompt> sudo /opt/intel/mic/bin/micflash -save <destination_file>
這會將閃存的各個部分保存至某個文件，此文件稍後可用於 -Update。
使用此命令獲取閃存的相關信息，即有關硬件中可更新部分的信息：
user_prompt> sudo /opt/intel/mic/bin/micflash -info -device 0
使用此命令來檢索閃存中的版本信息：
user_prompt> sudo /opt/intel/mic/bin/micflash -getversion 2 \
-device 0
要檢索閃存映像文件的相關信息：
user_prompt> sudo /opt/intel/mic/bin/micflash -info <flash filename>
******************************************************************************
* 警告： 如果已執行閃存更新，則重新啓動系統以使英特爾(R) 至強融核(TM) 協處理器以新的閃存修訂版啓動。 如果執行了“更新”以外的任何其它閃存操作，請啓動 MPSS 服務以確保 MPSS 功能完整。
******************************************************************************
有關詳細信息，請參考手冊頁面。
user_prompt> man micflash
8.3 Micsmc
英特爾(R) 至強融核(TM) 平臺狀態面板 (micsmc)，或控制面板應用程序爲圖形工具，旨在減輕管理英特爾(R) 至強融核(TM) 設備的負擔。micsmc 可以兩種模式運行： GUI 模式和命令行模式。 GUI 模式提供有關英特爾(R) 至強融核(TM) 內核利用率、內核溫度、內存用量和電源使用量統計數據的持續更新信息。 CLI 模式會生成類似信息，但是此模式爲可用於腳本應用程序的單步操作。
用戶可使用任一模式查看整個系統（多個協處理器）或單個協處理器的統計信息。
micsmc 命令還可用於執行更爲高級的功能： 查看錯誤日誌、監控並連接至英特爾(R) 至強融核(TM) 設備、查看/管理日誌文件以及 Root/管理員用戶可管理每個協處理器或每個節點設置，如 ECC、擴展模式和電源狀態。
micsmc 工具部分基於 Qwt 項目的工作 (http://qwt.sf.net)
無自變量調用時，micsmc 將以 GUI 模式運行。 如上所述，GUI 模式通過圖形界面爲所有檢測到的英特爾(R) 至強融核(TM) 設備提供實時監控。
user_prompt> /opt/intel/mic/bin/micsmc
此外，micsmc 還可使用以下任一自變量以命令行模式調用：
英特爾(R) 至強融核(TM) 協處理器平臺狀態面板
版本： SYSMGMT_4119-1
由英特爾® 開發
此應用程序監控設備性能，包括驅動程序信息、溫度、內核用量等等。
此程序部分基於 Qwt 項目的工作 (http://qwt.sf.net)
要獲取“控制面板用戶指南”，請轉到：
"/opt/intel/mic/sysmgmt/docs/PlatformStatusPanellUserGuide.html"
用法：
======
-c 或 --cores： 顯示系統中每個設備的平均內核利用率級別以及每個內核的利用率級別
-f 或 --freq： 顯示系統中每個設備的時鐘頻率和電源級別
-i 或 --info： 顯示常規系統信息
-m 或 --mem： 顯示內存利用率數據
-t 或 --temp： 顯示系統中每個設備的溫度級別
--pwrenable [cpufreq | corec6 | pc3 | pc6 | all]：
** 此選項對於英特爾(R) 至強融核(TM)
** 軟件開發工具（以前稱爲 Knights Ferry）無效。
該選項具有 4 個可選自變量：
cpufreq： 在所有設備上啓用 cpufreq 電源管理功能
corec6： 在所有設備上啓用 corec6 電源管理功能
pc3： 在所有設備上啓用 pc3 電源管理功能
pc6： 在所有設備上啓用 pc6 電源管理功能
all： 在所有設備上啓用全部 4 個電源管理功能
注意： 如果未提供選項，則會將其禁用。 如果未提供自變量，則所有 4 個電源管理功能都將被禁用。
--pwrstatus： ** 此選項對於英特爾(R) 至強融核(TM)
** 軟件開發工具（以前稱爲 Knights Ferry）無效。
顯示每個設備的電源管理功能狀態
--turbo [status | enable | disable] [device [micN | 設備列表]：
** 此選項對於英特爾(R) 至強融核(TM)
** 軟件開發工具（以前稱爲 Knights Ferry）無效。
該選項具有 3 個可選自變量：
enable： 啓用擴展模式
disable： 禁用擴展模式
status： 顯示擴展模式狀態
注意： 如果未提供自變量，將顯示狀態。 除非提供設備自變量和一個或多個設備名稱列表， 否則該選項在所有可用的英特爾(R) 至強融核(TM) 協處理器上均可操作： 上述情況下當 device = micN 時，可爲 mic0 - mic255，或者按名稱列出的以空格分隔的設備列表
--ecc [status | enable | disable] [device [micN | list of devices]:
** 此選項對於英特爾(R) 至強融核(TM)
** 軟件開發工具（以前稱爲 Knights Ferry）無效。
該選項具有 3 個可選自變量：
enable: enable ECC
disable: disable ECC
status: display ECC
注意： 如果未提供自變量，將顯示狀態。 除非提供設備自變量和一個或多個設備名稱列表， 否則該選項在所有可用的英特爾(R) 至強融核(TM) 協處理器上均可操作： 上述情況下當 device = micN 時，可爲 mic0 - mic255，或者按名稱列出的以空格分隔的設備列表
--led [status | enable | disable] [device [micN | list of devices]:
** 此選項對於英特爾(R) 至強融核(TM)
** 軟件開發工具（以前稱爲 Knights Ferry）無效。
該選項具有 3 個可選自變量：
enable: enable LED Alert
disable: disable LED Alert
status: display LED Alert status
注意： 如果未提供自變量，將顯示狀態。 除非提供設備自變量和一個或多個設備名稱列表， 否則該選項在所有可用的英特爾(R) 至強融核(TM) 協處理器上均可操作： 上述情況下當 device = micN 時，可爲 mic0 - mic255，或者按名稱列出的以空格分隔的設備列表
-l, --lost: 顯示系統中所有的英特爾(R) 至強融核(TM) 協處理器以及它們目前是否處於“丟失節點”狀況的列表
-v, --version: 顯示工具版本。
-a, --all: 處理“all”僅限查看的選項： -i -t -f -m -c（不包括命令選項）
-h, --help: 顯示完整的用法信息，然後退出
***注意：
*** o 需要爲 micsmc 應用程序安裝 xdg-utils.rpm 來自動關聯 URL 並打開瀏覽器顯示它們。
*** o 在 SLES 11 SP1 中運行 micsmc 需要 libstdc++.6.0.13
在 micsmc GUI 中，單擊“高級”->“更新應用程序”會打開 web 瀏覽器並引導至英特爾(R) 至強融核(TM) 支持網站。 出於安全考慮，建議不要以 root 用戶的身份使用 xdg-open。 因此，micsmc GUI 中的“更新應用程序”功能僅限於常規用戶。
有關詳細信息，請參考手冊頁面
user_prompt> man micsmc
有關詳細信息，請參考 micsmc 用戶指南，網址如下：
/opt/intel/mic/sysmgmt/docs/PlatformStatusPanelUserGuide.html
8.4 Miccheck
Miccheck 是一種實用程序，它通過運行多種診斷測試來驗證英特爾(R) 至強融核(TM) 協處理器系統的配置。
Miccheck 提供界面，通過運行一系列診斷測試，在英特爾(R) 至強融核(TM) 系統上執行健全性檢查。
默認情況下，所有可用測試的子集均在運行，但是測試可單獨選擇。 可指定命令行自變量來指定所有所需測試、添加測試或從套件中除去測試。
默認行爲是在所有英特爾(R) 至強融核(TM) 協處理器中運行所有選中測試。 不過，還可在用戶指定的設備列表中運行測試。
選項
-------
常規：
這些選項必須在輸入文件中找到。
-h or --help
顯示一則幫助消息。 此選項還可用於顯示有關特定測試的具體信息。 在測試列表以外附加 --help 來執行此操作。
-i'filename', --input='filename'
請參閱“filename”中的選項。 文件的每行均解析爲單一命令行自變量。 可能包括以“#”爲前綴的註釋。
詳細信息：
默認行爲是輸出所有測試的狀態。
-l or --list
列出但不執行要運行的測試。
-q or --quiet
僅返回退出狀態，不輸出消息。
-s or --status
僅輸出錯誤和最終狀態。
-v or --verbose
輸出測試流程中的所有步驟。
-f or --force-exit
遇到錯誤立即退出。
-1 or --1-line
將錯誤寫到測試的同一行。
-n or --no-banner
啓動時壓縮應用程序標誌。
-o or --output
將所有輸出迴應至命名文件。
測試列表：
-t'testlist' or --test='testlist'
運行“testlist”指定的測試，“testlist”是逗號分隔的測試列表。
-a'testlist' or --add='testlist'
添加“testlist”指定的測試，“testlist”是逗號分隔的測試列表。
-d'testlist' or --drop='testlist'
除去“testlist”指定的測試，“testlist”是逗號分隔的測試列表。
設備選擇：
允許測試在特定的英特爾(R) 至強融核(TM) 設備上運行。 單一破折號不指定英特爾(R) 至強融核(TM) 設備。 可選擇一系列設備進行測試（例如： 2,4,6-8 將測試英特爾(R) 至強融核(TM) 設備 2、4 和 6 到 8）。
範例：
user_prompt> sudo /opt/intel/mic/bin/miccheck -t ping[5]
命令將使用用戶指定的超時來 ping 系統中已安裝的所有英特爾(R) 至強融核(TM) 協處理器。 每個 ping 將在 5 秒後超時。
user_prompt> sudo /opt/intel/mic/bin/miccheck \
-t postcode,IP,MAC 0,2,4-6
可使用 *miccheck(1)* 的一個調用運行多個測試。 上一範例會檢查 0、2、4、5 和 6 協處理器的郵編、IP 和 MAC 地址。
有關詳細信息，請參考手冊頁面。
user_prompt> man miccheck
8.5 Micnativeloadex
micnativeloadex 實用程序將英特爾(R) 至強融核(TM) 本地二進制文件複製到指定的英特爾(R) 至強融核(TM) 協處理器並執行該二進制文件。 該實用程序會自動檢查應用程序的庫依賴關係，並且如果可在默認搜索路徑（使用 SINK_LD_LIBRARY_PATH 環境變量設置）中找到這些依賴關係，則還可在執行前將庫複製到設備。 該實用程序自動複製所需依賴關係，由此簡化了英特爾(R) 至強融核(TM) 本地應用程序的運行。
此外，該實用程序還可將輸出從英特爾(R) 至強融核(TM) 上遠程運行的應用程序重定向回本地控制檯。 默認啓用此功能，但是可使用命令行選項禁用。 有關命令行選項的詳細信息，請參閱下方的幫助部分。
請注意，如果應用程序具有庫依賴關係，則 SINK_LD_LIBRARY_PATH 環境變量必須設置爲包含這些目錄。 該環境變量與常規 Linux* 應用程序的 LD_LIBRARY_PATH 工作原理相同。 要幫助確定所需的庫，可使用 -l 命令行選型執行 micnativeloadex。 這會顯示依賴關係列表，並列出已找到的依賴關係。 未找到的依賴關係可能需要列入 SINK_LD_LIBRARY_PATH 中。
該實用程序位於：
/opt/intel/mic/coi/tools/micnativeloadex/release/
該實用程序的命令行選項如下：
-a“args”轉至遠程應用程序的命令行自變量的可選字符串。
-d 要運行應用程序的英特爾(R) 至強融核(TM) 設備（從 0 開始）索引。
-e“environment”轉至遠程應用程序的可選環境字符串。 可使用空格作爲分隔符指定多個環境變量：
-e "LD_LIBRARY_PATH=/lib64/ DEBUG=1"
-h 打印此幫助消息。
-l 請勿在設備上執行二進制。 而是列出共享的庫依賴關係信息。
-p 禁用控制檯代理。
-t 等待遠程應用程序完成的時間（以秒爲單位）。 遠程應用程序超時後會終止。
-v 啓用詳細模式。 注意：如果遠程應用程序異常終止，系統將顯示詳細輸出。
8.6 Linux*“service”和“chkconfig”命令
“micstart”腳本已由 Linux* 系統服務支持替換。 Linux*“service”命令提供啓動和停止服務的訪問權。
對於 MPSS 使用
user_prompt> sudo service mpss start
user_prompt> sudo service mpss stop
Linux*“chkconfig”命令指定系統啓動時自動啓動的服務。 要自動啓動 MPSS 服務，請使用命令
user_prompt> sudo chkconfig mpss on
如果不需要在主機啓動時自動啓動，則使用“off”作爲自變量。
8.7 Micctrl
*** 注意： N 是與系統中協處理器設備編號相對應的數字 0、1、2、3 等。
“micctrl”命令爲系統管理員的幫助程序。 此命令支持的選項有：
-h or --help) 顯示幫助
-s or --status) 顯示系統中英特爾(R) 至強融核(TM) 協處理器的啓動狀態
-b or --boot) 啓動一個或多個英特爾(R) 至強融核(TM) 協處理器。 MPSS 服務必須正在運行。
-r or --reset) 重設一個或多個英特爾(R) 至強融核(TM) 協處理器
-w or --wait) 等待一個或多個英特爾(R) 至強融核(TM) 協處理器脫離“啓動中”或“重置中”狀態。
--initdefaults) 在 MPSS 軟件安裝後使用一次。 在 /etc/sysconfig/mic 中創建對每個英特爾(R) 至強融核(TM) 協處理器唯一的配置文件。 MPSS 服務必須未在運行。
--resetconfig) 在更改配置文件後使用。 它會根據新配置重新創建所有默認文件。 MPSS 服務必須未在運行。
--resetdefaults) 如果文件的手動編輯生成了未知情況，則用此將配置文件重置爲默認。 MPSS 服務必須未在運行。
--cleanconfig) [coprocessor list] “cleanconfig”選項刪除與 MicDir 配置參數相關的 filelist 文件和目錄。 然後會刪除 FileSystem 配置參數指定的映像文件。
如果配置參數不等同於 /intel/mic/filesystems 目錄中的文件和協處理器名稱（如 mic0、mic1 等），則還會刪除此默認位置中的任何等效文件。
然後刪除與協處理器相關的 /etc/sysconfig/mic/micN.conf 文件。
如果在命令行上指定的協處理器列表爲空，還會刪除 /etc/sysconfig/mic/default.conf 文件。
如果在 MPSS 監控程序當前正在運行期間進行嘗試，則“cleanconfig”選項會返回一個錯誤。
8.8 Micrasd
Micrasd 是運行在主機上的應用程序，用於處理和記錄英特爾(R) MIC 設備報告的硬件錯誤。 它可作爲服務監控程序運行。
要啓動 micrasd，使用此命令：
user_prompt> sudo /opt/intel/mic/bin/micrasd
僅超級用戶可以執行 micrasd，因爲它將觸發各種錯誤響應操作，例如協處理器重設和診斷。
使用“-daemon”選項會以監控程序模式運行 micrasd。 在此情況下，micrasd 會在背景中運行，並會默認處理/記錄錯誤。 在監控程序模式下，micrasd 日誌消息記錄在 /var/log/micras.log 文件中。
使用“-maint”選項將啓用維護模式，以用於錯誤測試和修復。
如果不帶任何自變量執行 micrasd，則它會在控制檯提示符下運行、連接至設備並等待錯誤。 使用 Ctrl-C 可退出 micrasd 並返回到控制檯提示符。
micrasd 的使用：
usage: micrasd [-daemon]
[-maint]
[-loglevel] [LEVELS]
[-help]
-daemon 以監控程序模式運行
-maint 選項可啓用維護模式，以用於錯誤測試和修復
-loglevel 設置日誌級別從 1 到 7
*位 0： 信息消息
*位 1： 警告消息
*位 2： 錯誤消息
*默認： 打開全部消息
-help 顯示幫助信息。
Micrasd 還可以作爲 Linux 系統服務運行。 Linux“service”命令提供啓動和停止 micras 服務的訪問權。 對於 micras 服務，請使用：
user_prompt> sudo service micras start
user_prompt> sudo service micras stop
注意 micras 服務對於 mpss 服務具有相依關係。 micras 服務必須在啓動 mpss 服務之後才啓動，並且必須在停止 mpss 服務之前停止。
Linux“chkconfig”命令指定系統啓動時自動啓動的服務。 要自動啓動 micras 服務，請使用命令：
user_prompt> sudo chkconfig micras on
使用“off”作爲自變量以禁止在主機啓動時自動啓動協處理器。
錯誤將記錄到 /var/log/messages 下的 Linux* syslog 中。 使用“micras”標籤來找到它們。
8.9 Mpssflash
mpssflash 實用程序是 micflash 工具的 POSIX 版本。 有關詳細信息，請參考手冊頁面。
user_prompt> man mpssflash
8.10 Mpssinfo
mpssinfo 實用程序是 micinfo 工具的 POSIX 版本。 有關詳細信息，請參考手冊頁面。
user_prompt> man mpssinfo
8.11 英特爾(R) 至強融核(TM) Shell 環境
協處理器上的 Linux* 環境使用 BusyBox 來提供若干個 Linux* 實用程序。 與主機 Linux* 分發版隨附的類似工具的用途相比，這些工具的用途略有不同。
例如，netcat 在英特爾(R) 至強融核(TM) 環境中的用途爲：
nc [-iN] [-wN] [-l] [-p PORT] [-f FILE|IPADDR PORT] [-e PROG]
而常規 netcat 實用程序的用途爲：
nc [-46DdhklnrStUuvzC] [-i interval] [-p source_port]
[-s source_ip_address] [-T ToS] [-w timeout] [-X proxy_protocol] [-x
proxy_address[:port]] [hostname] [port[s]]
要偵聽 TCP 端口 45678，用戶需要使用以下命令：
nc -lp 45678
而非
nc -l 45678
有關 BusyBox 的更多信息，請參閱鏈接 http://www.busybox.net/
===============================================================================
9. 與嵌入式 Linux* OS 通信
===============================================================================
標準網絡接口提供與英特爾(R) 至強融核(TM) 協處理器上的嵌入式 Linux* 操作系統通信。 該接口在 PCIe 總線上使用虛擬網絡驅動程序。 ssh 等標準網絡工具均受支持。
9.1 SSH 訪問英特爾(R) 至強融核(TM)
英特爾(R) 至強融核(TM) 嵌入式 Linux* OS 現在支持普通用戶和“root”用戶。 它還允許使用 ssh 密鑰的所有用戶進行網絡訪問。 MPSS 的配置階段根據主機 /etc/passwd 文件中當前用戶 ID 爲每個協處理器創建用戶。
對於 /etc/passwd 中的每個用戶（包括 root 用戶），如果用戶的“.ssh”目錄中找到 ssh 密鑰文件，這些文件也會填充至英特爾(R) 至強融核(TM) 協處理器的文件系統。 如果用戶不具備有效密鑰，他們就沒有英特爾(R) 至強融核(TM) 協處理器的網絡訪問權。
要生成 ssh 密鑰，請執行
user_prompt> ssh-keygen
user_prompt> sudo service mpss stop
user_prompt> sudo micctrl --resetconfig
user_prompt> sudo service mpss start
9.2 網絡配置
網絡配置通過編輯 /etc/sysconfig/mic/default.conf 文件來執行。下面說明此配置文件支持的選項。
編輯此文件之後，必須執行以下命令才能讓更改生效：
user_prompt> sudo micctrl --resetconfig
*** 注意： 對於 SUSE* Linux* Enterprise Server
*** o 必須禁用 NetworkManager。
*** o 用戶需要運行“service network restart”以讓新配置生效。
指定網絡拓撲
BridgeName 定義了要鏈接的靜態網橋名稱。 指定名稱會超載以提供三組不同的拓撲。
首先，如果此參數已註釋掉，則假定網絡拓撲爲靜態對。 如果這樣，則 CardIPaddress 和 HostIPaddress 參數會相關聯。
其次，如果網橋名稱以“mic”字符串開頭，則會使用此名稱創建靜態網橋，同時將英特爾(R) 至強融核(TM) 協處理器綁定到單一子網。
最後，如果網橋名稱並非以“mic”字符串開頭，則協處理器會附加到某個主機網絡接口相連的假定現有靜態網橋。
o Subnet
Subnet 參數定義了協處理器 IP 地址的前兩個或三個元素。 默認值爲字符串“172.31”。 這會將協處理器置於私人網絡範圍內（請參考 http://en.wikipedia.org/wiki/Private_network）。
靜態對網絡拓撲爲默認配置。 在 SUSE* 上，它是當前唯一受支持的配置。 兩元素的 Subnet 可通過添加第三元素（通過將英特爾(R) 至強融核(TM) 協處理器 ID 加一進行來指定）以及“.1”（用於協處理器）和“.254”（用於主機）進行增補。 例如，mic0 協處理器將獲得主機分配“172.31.1.254”和協處理器端“172.31.1.1”。
靜態對的範例 IP 地址分配基於以下圖表：
+--------------------------------------------------------+
| 協處理器 | 網絡 | 設備 IP | 主機 IP |
| | 接口 | 地址 | 地址 |
+-------------+-----------+---------------+--------------+
| 0 | mic0 | 172.31.1.1 | 172.31.1.254 |
+-------------+-----------+---------------+--------------+
| 1 | mic1 | 172.31.2.1 | 172.31.2.254 |
+-------------+-----------+---------------+--------------+
| 2 | mic2 | 172.31.3.1 | 172.31.3.254 |
+-------------+-----------+---------------+--------------+
| 3 | mic3 | 172.31.4.1 | 172.31.4.254 |
+-------------+-----------+---------------+--------------+
如果靜態網橋已定義，指定前兩個元素即可。 該值先使用“.1.”，再使用分配給英特爾(R) 至強融核(TM) 協處理器的 ID 加一進行修改。 例如，將爲系統中的第一個協處理器分配“172.31.1.1”，爲第二個協處理器分配“172.31.1.2”等，將爲主機網橋分配“172.31.1.254”。
靜態網橋的示例 IP 地址分配基於以下圖表：
+--------------------------------------------------------------+
| 主機網橋 | 協處理器 | 網絡 | 設備 IP |
| IP 地址 | | 接口 | 地址 |
+--------------------+-------------+-----------+---------------+
|172.31.1.254(micbr0)| 0 | mic0 | 172.31.1.1 |
+ +-------------+-----------+---------------+
| | 1 | mic1 | 172.31.1.2 |
+ +-------------+-----------+---------------+
| | 2 | mic2 | 172.31.1.3 |
+ +-------------+-----------+---------------+
| | 3 | mic3 | 172.31.1.4 |
+--------------------+-------------+-----------+---------------+
還可使用多個靜態網橋。 BridgeName 參數需要在各英特爾(R) 至強融核(TM) 配置文件中指定，以分配正確的網橋 ID。 文件還需要在每個配置文件中爲 Subnet 參數分配一個 3 元素 ID。 例如，一組文件可爲 BridgeName 分配字符串“micbr0”併爲 Subnet 分配值“172.31.1”。 另一組文件可爲 BridgeName 參數分配字符串“micbr1”併爲 Subnet 分配值“172.31.2”。
o HostMacAddress 和英特爾(R) 至強融核(TM) 協處理器 MicMacAddress
HostMacAddress 和 MicMacAddress 配置參數提供機制來半永久性將 MACaddress 分配給接口。
mpssd 將分配值並在每個協處理器配置文件中記錄這些值。 如上所述，大型集羣中難免會發生衝突。 如果發生衝突，請編輯其中之一來消除衝突，或只需從配置文件中消除衝突，並挑選另一個隨機 MAC 地址。
o MicIPaddress 和 HostIPaddress
如前所述，主機和英特爾(R) 至強融核(TM) 協處理器 IP 地址會自動根據 Subnet 參數生成。 如果這些自動生成的地址不足，可在每個 micN.conf 文件中指定 MicIPaddress 和 HostIPaddress，它們會覆蓋自動生成的 IP 地址。
對於 micN.conf 已修改的每個協處理器，協處理器配置應按如下所示更新：
user_prompt> sudo micctrl --resetconfig micN
o 設置協處理器的主機名稱
當設備具有識別名稱時，網絡軟件最易使用。 這些名稱會記錄在名稱服務器和 /etc/hosts 文件中以便檢索。 以往 UNIX 系統會在內部記錄此名稱，並且會顯示在用戶的 shell 提示符中。
Hostname 參數定義了分配給單個英特爾(R) 至強融核(TM) 協處理器的名稱。 默認情況下，mpssd 將設置此名稱爲主機名稱的修訂版本。 例如，如果主機命名爲“devbox.myco.com”，則會爲第一個英特爾(R) 至強融核(TM) 協處理器分配名稱“devbox-mic0.myco.com”。 系統管理員可將此更改爲英特爾(R) 至強融核(TM) 協處理器配置文件中的任一值。
Hostname 參數將添加至主機上的 /etc/hosts 文件中。 它將用於創建 /etc/sysconfig/network.conf 和 /etc/hosts 文件。
o MTUsize
“MTUsize”參數允許設置網絡 MTU 大小。 默認的大型數據包大小最大爲 63 KB。 這會產生外部橋接問題。 此參數應設置爲它所屬子網絡中使用的默認網絡數據包大小。 採用羣集時，它通常爲 9 KB。
*** 注意： 英特爾(R) 至強融核(TM) 協處理器網絡接口上可能的最大 MTU 大小現在已減少爲 63K。 以前它是 64K。
o DHCP
請參考第 9.4 節“英特爾(R) 至強融核(TM) 的 DHCP 配置”。
9.3 NFS 安裝主機導出
*** 注意： 爲使 NFS 運行，可能需要配置主機防火牆或 iptable 以允許以下端口：
*** tcp/udp port 111 - RPC 4.0 portmapper
*** tcp/udp port 2049 - nfs server
用戶可裝載從主機導出的 NFS 文件系統。 超級用戶首先將導出添加至 /etc/exports 文件。
例如： 要使用默認配置，提供從“/mic0fs”目錄到系統中第一個英特爾(R) 至強融核(TM) 協處理器 (mic0) 的訪問權，其中 mico 主機分配 IP 如下： 172.31.1.254 且協處理器分配 ip 如下： 172.31.1.1。
o 在主機上，
使用以下命令行附加 /etc/exports：
/mic0fs 172.31.1.1(rw,no_root_squash)
添加在 /etc/hosts.allow 文件中
ALL: 172.31.1.1
在 /etc/exports 和 /etc/hosts.allow 文件更新後，運行“sudo exportfs -a”來告知 NFS 文件已更改。
o 在英特爾(R) 至強融核(TM) 協處理器上，將對 /etc/fstab 文件進行修改以查找導出的 NFS 文件系統。 使用以下命令行附加 /etc/fstab 文件：
172.31.1.254:/mic0fs /mic0fs nfs rsize=8192,wsize=8192,nolock,intr 0 0
有關 NFS 配置的更多信息，請參閱 http://nfs.sourceforge.net/nfs-howto/
9.4 英特爾(R) 至強融核(TM) 的 DHCP 配置
DHCP 只能通過外部網橋配置來設置。 如下所示：
o 停止英特爾(R) 至強融核(TM) 協處理器。
user_prompt> sudo service mpss stop
o 對於 Red Hat* Enterprise (RHEL) 系統：
使用如下配置創建 /etc/sysconfig/network-scripts/ifcfg-br0
DEVICE="br0"
NM_CONTROLLED="no"
TYPE=bridge
BOOTPROTO=dhcp
o 對於 SUSE* Linux* Server：
使用如下配置創建 /etc/sysconfig/network/ifcfg-br0
DEVICE=br0
TYPE=Bridge
ONBOOT=yes
DELAY=0
NM_CONTROLLED="no"
BOOTPROTO=dhcp
BRIDGE=yes
STARTMODE=auto
BRIDGE_PORTS='mic0 mic1 '
o 設置外部網橋：
# 創建外部網橋 br0
user_prompt> sudo brctl addbr br0
# 將所有網絡設備放置在 br0 下
user_prompt> sudo brctl addif br0 eth0
# 啓動 br0
user_prompt> sudo ifconfig br0 up
# 釋放 eth0 IP
user_prompt> sudo dhclient -r eth0
# 獲取 br0 的 IP
user_prompt> sudo dhclient br0
o 將 /etc/sysconfig/mic/default.conf 的以下字段更改爲：
BridgeName br0
Subnet dhcp
o 重設英特爾(R) 至強融核(TM) 協處理器配置並驗證 DHCP 將使用的日誌 mpssd 消息。
user_prompt> sudo micctrl --resetconfig
o 啓動英特爾(R) 至強融核(TM) 協處理器。
user_prompt> sudo service mpss start
要了解有關網橋配置的更多信息，請參閱
http://www.linuxfoundation.org/collaborate/workgroups/networking/bridge
9.5 虛擬控制檯訪問
o 要配置 minicom 以進行虛擬控制檯訪問，請執行以下指令：
*** 注意： 如果存在多個協處理器，則協處理器 mic0 的設備爲 /dev/ttyMIC0，mic1 爲 /dev/ttyMIC1 等。
對於每個協處理器，
sudo minicom -s
轉至“Serial Port Setup”
選擇選項： A - 串行設備
編輯串行設備爲 /dev/ttyMIC0
按兩次 <Enter>
轉至“Save setup as..”
顯示輸入提示符“Give name to save this configuration?”時，將 <ConfigName> 保存至首選名稱。 例如： mic0 <Enter>
選擇“Exit from Minicom”
爲後續協處理器重複上述步驟。 每個協處理器應有各自的 <configName>。
o 要打開 mic0 協處理器的虛擬控制檯，其中 <ConfigName> 爲 mic0：
sudo minicom mic0 <Enter>
o 要退出小型計算機，<CTRL>-A-X
===============================================================================
10. 重新編譯源中的 GPL 二進制
===============================================================================
10.1 重新編譯主機驅動程序
*** 注意： SUSE* SLES 11 Server 版本需要設置內核以允許加載非 SUSE* 構建驅動程序模塊。 編輯“/etc/modprobe.d/unsupported-modules”文件，並將“allow_unsupported_modules”的值設置爲 1。
該版本包括主機驅動程序的源代碼。 必要時刻修改和重新編譯驅動程序。 例如，如果“yum update”安裝了新主機 Linux* 內核，可編譯並安裝相應的 MPSS 主機驅動程序。 必須以超級用戶的身份執行此過程。
o Red Hat* Enterprise Linux* 6.0、6.1、6.2 和 6.3
確保已安裝先決條件：
user_prompt> yum install kernel-headers kernel-devel
重新生成 MPSS 驅動程序模塊包：
user_prompt> cd <folder where extracted tar file expanded>/src/
user_prompt> rpmbuild --rebuild \
intel-mic-kmod-2.1.4346-16.el6.src.rpm
intel-mic-kmod 二進制 rpm 位於 $HOME/rpmbuild/RPMS/x86_64
user_prompt> ls $HOME/rpmbuild/RPMS/x86_64
o SUSE* Linux* Enterprise Server (SLES) 11 SP1 和 SP2
確保已安裝先決條件：
user_prompt> zypper install kernel-default-devel
重新生成 MPSS 驅動程序模塊包：
user_prompt> cd <folder where extracted tar file expanded>/src/
user_prompt> rpmbuild --rebuild \
intel-mic-kmod-2.1.4346-16.suse.src.rpm
intel-mic-kmod 二進制 rpm 位於 /usr/src/packages/RPMS/x86_64
user_prompt> ls /usr/src/packages/RPMS/x86_64
10.2 重新編譯 GPL RPM
解壓縮 tar 程序包後存在兩個文件時，會產生子目錄“gpl”
gpl/package-full_src-k1om.tar.bz2
gpl/package-cross-k1om.tar.bz2
1) 確保 intel-mic-knc 和 intel-mic-gpl RPM 已安裝。 否則，按照“安裝 MPSS、OFED 和 GANGLIA* 軟件”（第 5 節“軟件安裝”）中的安裝步驟操作。
user_prompt> rpm -qa|grep intel-mic
2) 切換至 gpl 目錄
user_prompt> cd ./gpl
3) 解壓縮 package-full_src-k1om.tar.bz2 存檔。
user_prompt> tar jxvf package-full_src-k1om.tar.bz2
user_prompt> ls
用戶會看到腳本“intel-mic-gpl.sh”
4) 編譯並構建 intel-mic-gpl RPM
user_prompt> ./intel-mic-gpl.sh 4346 16
intel-mic-gpl RPM 將在 gpl 目錄中構建。
10.3 重新編譯英特爾(R) 至強融核(TM) 特定的 OFED RPM
*** 注意： 重新編譯 intel-mic-ofed-kmod 二進制程序包的步驟要求具備超級用戶權限。 獲取 root shell（例如 su、sudo）。
o Red Hat* Enterprise Linux* 6.0、6.1、6.2 和 6.3
確保已安裝先決條件：
user_prompt> yum install kernel-headers kernel-devel
重新生成 OFED 包：
user_prompt> cd <folder where extracted tar file expanded>/src/
user_prompt> rpmbuild --rebuild intel-mic-ofed-ibpd-2.1.4346-16.<kernel>.el6.src.rpm
user_prompt> rpmbuild --rebuild intel-mic-ofed-kmod-2.1.4346-16.<kernel>.el6.src.rpm
user_prompt> rpmbuild --rebuild intel-mic-ofed-libibscif-2.1.4346-16.<kernel>.el6.src.rpm
其中：
<kernel> 對於 RHEL 6.0 爲 2.6.32-71
<kernel> 對於 RHEL 6.1 爲 2.6.32-131
<kernel> 對於 RHEL 6.2 爲 2.6.32-220
<kernel> 對於 RHEL 6.3 爲 2.6.32-279
OFED 二進制 RPM 位於 $HOME/rpmbuild/RPMS/x86_64
user_prompt> ls $HOME/rpmbuild/RPMS/x86_64
SUSE* Linux* Enterprise Server (SLES) 11 SP1 和 SP2
確保已安裝先決條件：
user_prompt> zypper install kernel-default-devel
重新生成 OFED 包：
user_prompt> cd <folder where extracted tar file expanded>/src/
user_prompt> rpmbuild --rebuild \
intel-mic-ofed-ibpd-2.1.4346-16.<kernel>.suse.src.rpm
user_prompt> rpmbuild --rebuild \
intel-mic-ofed-kmod-2.1.4346-16.<kernel>.suse.src.rpm
user_prompt> rpmbuild --rebuild \
intel-mic-ofed-libibscif-2.1.4346-16.<kernel>.suse.src.rpm
其中 <kernel> 對於 SLES 11 SP1 爲 2.6.32.12-0.7
<kernel> 對於 SLES 11 SP2 爲 3.0.13-0.27
OFED 二進制 RPM 位於 /usr/src/packages/RPMS/x86_64
user_prompt> ls /usr/src/packages/RPMS/x86_64
10.4 重新編譯英特爾(R) 至強融核(TM) 特定的 OFED 協處理器 RPM
1) 從源代碼重新編譯 intel-mic-gpl RPM（按照第 10.2 節“重新編譯 GPL RPM”中的說明操作）。 所有構建項目會出現在 gpl 目錄中。
2) 解壓縮 gpl 目錄中的 intel-mic-ofed-card-<version>.src.tar.gz 存檔。 這會生成 ofed 子目錄。
user_prompt> cd gpl
user_prompt> tar xvzf ../src/intel-mic-ofed-card-<version>.<os>.src.tar.gz
其中 <version> 爲 MPSS 版本，而 <os> 爲“el6”（適用於 RHEL），
或“suse”（適用於 SLES 11）。
3) 切換至 ofed 子目錄並執行 ofed RPM 構建命令。
user_prompt> cd ofed
user_prompt> ./intel-mic-ofed-card.sh 4346 16
intel-mic-ofed-card RPM 會在當前目錄下構建。
10.5 重新編譯英特爾(R) 至強融核(TM) 特定的 GANGLIA* RPM
o Red Hat* Enterprise Linux* 6.0、6.1、6.2、6.3、SUSE* Linux* Enterprise Server (SLES) 11 SP1 和 SUSE* Linux* Enterprise Server (SLES) 11 SP2
請確保已安裝必備軟件（第 4.2 節“第三方軟件要求”）。
重新生成 GANGLIA* 程序包：
user_prompt> cd <folder where extracted tar file expanded>/src/
user_prompt> rpmbuild --rebuild intel-mic-ganglia-STRING_GANGLIA_VERSION-1.src.rpm
GANGLIA* 二進制 RPM 位於 $HOME/rpmbuild/RPMS/x86_64
user_prompt> ls $HOME/rpmbuild/RPMS/x86_64
===============================================================================
11. 對稱通信接口支持的功能
===============================================================================
對稱通信接口提供一個機制，可用於單一平臺內的節點間通信。 節點定義爲英特爾(R) 至強融核(TM) 設備或基於英特爾(R) 至強(TM) 的主機處理器。 特別是，SCIF 將提取通過 PCIe* 總線進行的通信的細節。
SCIF API 可從用戶級 (uSCIF) 和內核級 (kSCIF) 進行調用。 每種設置定義如下。
+---------------------------------------------------------------------+
| SCIF 支持的功能 |
|---------------------------------------------------------------------+
| 功能 | 已實施 | 接口 | 測試 |
|------------------------------+------------+-------------+-----------+
| scif_open | 是 | uSCIF/kSCIF | 中等 |
| scif_close | 是 | uSCIF/kSCIF | 中等 |
| scif_bind | 是 | uSCIF/kSCIF | 中等 |
| scif_listen | 是 | uSCIF/kSCIF | 中等 |
| scif_connect | 是 | uSCIF/kSCIF | 中等 |
| scif_accept | 是 | uSCIF/kSCIF | 中等 |
| scif_send | 是 | uSCIF/kSCIF | 中等 |
| scif_recv | 是 | uSCIF/kSCIF | 中等 |
| scif_register | 是 | uSCIF/kSCIF | 中等 |
| scif_unregister | 是 | uSCIF/kSCIF | 中等 |
| scif_mmap | 是 | uSCIF | 中等 |
| scif_munmap | 是 | uSCIF | 中等 |
| scif_readfrom | 是 | uSCIF/kSCIF | 中等 |
| scif_writeto | 是 | uSCIF/kSCIF | 中等 |
| scif_vreadfrom | 是 | uSCIF/kSCIF | 中等 |
| scif_vwriteto | 是 | uSCIF/kSCIF | 中等 |
| scif_fence_mark | 是 | uSCIF/kSCIF | 中等 |
| scif_fence_wait | 是 | uSCIF/kSCIF | 中等 |
| scif_fence_signal | 是 | uSCIF/kSCIF | 中等 |
| scif_poll | 是 | uSCIF/kSCIF | 中等 |
| scif_get_nodeIDs | 是 | uSCIF/kSCIF | 中等 |
| scif_get_fd | 是 | uSCIF | 中等 |
| scif_pin_pages | 是 | kSCIF | 部分 |
| scif_unpin_pages | 是 | kSCIF | 部分 |
| scif_register_pinned_pages | 是 | kSCIF | 部分 |
| scif_get_pages | 是 | kSCIF | 部分 |
| scif_put_pages | 是 | kSCIF | 部分 |
| scif_event_register | 否 | kSCIF | 部分 |
+------------------------------+------------+-------------+-----------+
===============================================================================
12. MPSS 2.1 版本的軟件開發環境
===============================================================================
有關受支持的英特爾(R) 至強融核(TM) 指令的更多信息，請參考 http://intel.com/software/mic 中的《英特爾(R) 至強融核(TM) 指令集參考手冊》。
12.1 支持的環境
編譯 MPSS 2.1 版本僅在 Red Hat* Enterprise Linux* 6.0、Red Hat* Enterprise Linux* 6.1、Red Hat* Enterprise Linux* 6.2、Red Hat* Enterprise Linux* 6.3 和 SUSE* Linux* Enterprise Server (SLES) 11 SP1、SuSE* Linux* Enterprise Server (SLES) 11 SP2 環境中受支持。
英特爾強烈建議在構建內核、LSB 和 SCIF 驅動程序時僅使用包含的 GCC 編譯器。 對於所有其它構建，強烈建議使用英特爾(R) C 編譯器或英特爾(R) FORTRAN 編譯器。 使用不恰當的編譯器可能導致不可預料的結果，且不會成爲英特爾測試或支持的配置。
12.2 編譯支持的環境
Linux* 主機驅動程序源代碼已提供，因此可在其它 Linux* 版本上將 MPSS 版本升級。 這可能會產生驅動程序錯誤，並與提供的主機庫不兼容。 提供的主機庫爲特定版本的 GCC 編譯器所生成，因此可能與先前或較新 GCC 編譯器產生的代碼不能正確鏈接。
12.3 SCIF 的用戶模式代碼
SCIF 應用程序必須根據連接建立的方向，爲英特爾(R) 至強融核(TM) 嵌入式 Linux* OS 和主機 Linux* OS 進行編譯。 出於測試目的，可爲兩端編譯每個測試並按需要運行。
已提供使用 scif_connect() 函數建立連接的示例。 以下“生成文件”將爲主機操作系統和嵌入式 Linux* 操作系統編譯版本。
CC=icc
XCC=icc -mmic
XCCPATH=/usr/linux-k1om-4.7/bin
all: scif_contest_mic scif_contest_host
scif_contest_mic: scif_contest.c
(export PATH=$$PATH:$(XCCPATH); \
$(XCC) -o scif_contest_mic scif_contest.c -lscif -lpthread)
scif_contest_host: scif_contest.c
$(CC) -DHOST -o scif_contest_host scif_contest.c -lscif -lpthread
clean:
rm -f scif_contest_mic scif_contest_host
12.4 P2P（對等）支持
默認情況下，英特爾(R) 至強融核(TM) 產品支持 P2P。
o 要在 P2P 禁用的情況下運行，必須編輯模塊參數控制文件 /etc/modprobe.d/mic.conf。
添加“p2p=0”至“mic”模塊選項行的末端。
o 需要重新加載驅動程序。 遵守以下步驟：
user_prompt> sudo service mpss stop
user_prompt> sudo service mpss unload
user_prompt> sudo service mpss start
12.5 SCIF 中的註冊緩存
*** 注意： 指定固定頁面限制的機制在未來版本中可能有所變化。
註冊緩存爲 SCIF 功能，旨在改善 scif_vreadfrom()/scif_vwriteto() 的性能。 啓用註冊緩存時，SCIF 會緩存傳遞給 cif_vreadfrom()/scif_vwriteto() 的虛擬至物理地址轉換，這樣未來調用中指定同一虛擬範圍時便可減少鎖定頁面的開銷。 註冊緩存爲默認啓用。
o 要禁用註冊緩存，必須編輯模塊參數控制文件 /etc/modprobe.d/mic.conf。
在“mic”模塊選項行中設置“reg_cache”等於零。
o 需要重新加載驅動程序。 遵守以下步驟：
user_prompt> sudo service mpss stop
user_prompt> sudo service mpss unload
user_prompt> sudo service mpss start
在各 SCIF 端點的最大固定頁面數上對各節點均有可調限制。 此限制只能由 root 用戶修改。
o 要在驅動程序加載後設置固定頁面的最大數：
user_prompt> echo limit > /proc/scif/reg_cache_limit
其中 4K 頁面數的限制以十進制表示。
o 要在運行期間禁用緩存，將各節點的限制設置爲 0。
12.6 英特爾(R) 至強融核(TM) 的 GNU 調試器
用戶需要安裝 gdb 目錄下的 intel-mic-gdb rpm：
user_prompt> cd <folder where extracted tar file expanded>/gdb/
user_prompt> sudo rpm -ivh intel-mic-gdb-2.1.4346-16.<os>.x86_64.rpm
其中 <os> 是“el6”（表示 RHEL）或“suse”（表示 SLES 11）。
o 在英特爾(R) 至強融核(TM) 協處理器上本地運行
支持英特爾(R) 至強融核(TM) 的本地 GNU 調試器可在以下位置中找到：
/usr/linux-k1om-4.7/linux-k1om/usr/bin/gdb
用戶需要將支持英特爾(R) 至強融核(TM) 的本地 GNU 調試器遠程複製到各英特爾(R) 至強融核(TM) 協處理器。 例如，要複製至協處理器 mic0：
user_prompt> scp /usr/linux-k1om-4.7/linux-k1om/usr/bin/gdb mic0:~
有關一般 GNU 調試器指令，請參考 http://sources.redhat.com/gdb/documentation。
o 在英特爾(R) 至強融核(TM) 協處理器上遠程運行 GNU 調試器
支持英特爾(R) 至強融核(TM) 的遠程 GNU 調試器和 GNU 調試器服務器可在以下位置中找到：
/usr/linux-k1om-4.7/bin/x86_64-k1om-linux-gdb
/usr/linux-k1om-4.7/linux-k1om/usr/bin/gdbserver
如欲瞭解遠程 GNU 調試器調試，請參考
http://sourceware.org/gdb/current/onlinedocs/gdb/Remote-Debugging.html#Remote-Debugging
請參考官方 GNU 調試器文檔以瞭解更多信息：
http://sources.redhat.com/gdb/documentation
另請參閱已知問題，可在以下位置中找到：
/usr/linux-k1om-4.7/share/doc/intel-mic-xxx/PROBLEMS-INTEL
有關如何構建 GNU 調試器的說明，請參閱：
/usr/linux-k1om-4.7/share/doc/intel-mic-xxx/README-INTEL
12.7 英特爾(R) 至強融核(TM) 的 Virtio 塊設備
***注意： N 是與系統中協處理器設備編號 (micN) 相對應的數字 0、1、2、3 等。
Virtio 塊設備通過 virtio 數據傳輸機制訪問。 Virtio 是爲 KVM 等虛擬環境設計的。Virtio 塊設備在英特爾(R) 至強融核(TM) 上可用。
將 virtio 塊設備用作 ext2 文件系統。
o 在主機端，
- 啓動 MPSS 服務。
user_prompt> sudo service mpss start
- 說明哪個文件或塊設備是 virtblk 塊設備。
user_prompt> sudo bash
user_prompt> echo /dev/4DiskStripe/ForVirtioBlockTest \
>/sys/devices/virtual/mic/micN/virtblk_file
user_prompt> exit
*** 注意： /dev/4DiskStripe/ForVirtioBlockTest 可以是以下其中一項：
*** + 一般文件，如 /srv/aaa，或
*** + LVM（邏輯卷管理器）卷，或
*** + 物理設備，如 /dev/sda*。
*** /sys/devices/virtual/mic/micN/virtblk_file 是用於測試 virtio 塊設備的系統文件。
o 在協處理器端，
- 以 root 用戶的身份登錄協處理器。
user_prompt> slogin root@micN
- 加載 virtio 塊設備驅動程序。
user_prompt> modprobe mic_virtblk
- 在 virtio 塊設備上創建 ext2 文件系統並在 /mnt/vda 上加以裝載。
user_prompt> mkdir -p /mnt/vda
user_prompt> mkfs.ext2 /dev/vda
user_prompt> mount -t ext2 /dev/vda /mnt/vda
- 卸裝 virtio 塊設備。
user_prompt> umount /mnt/vda
- 卸載 virtio 塊設備驅動程序。
user_prompt> modprobe -r mic_virtblk
- 退出
user_prompt> exit
將 virtio 用作交換設備文件系統。
在主機端，
user_prompt> sudo bash
user_prompt> echo /dev/4DiskStripe/VirtioSwap \
>/sys/devices/virtual/mic/micN/virtblk_file
user_prompt> exit
在協處理器端，
- 登錄協處理器
user_prompt> slogin root@micN
- 加載 virtio 塊設備驅動程序。
user_prompt> modprobe mic_virtblk
- 分配交換設備並確認。
user_prompt> mkswap /dev/vda
user_prompt> swapon /dev/vda
user_prompt> more /proc/swaps
- 停止使用交換設備。
user_prompt> swapoff -a
- 退出並進行輔助工作。
user_prompt> exit
*** 注意： 從 sysfs 入口 /sys/devices/virtual/mic/micN/virtblk_file 中，用戶需要注意不要使用多個設備。
- 要使用多個 virtio 塊設備，請在 virtio 塊設備文件中創建多個分區。 這些分區稱爲 /dev/vda1、/dev/vda2 等等。
- 如果系統管理員不分配 virtio 塊設備文件，請卸載主機驅動程序，然後輸出“request comes in while coprocessor side driver is not loaded yet. Ignore”將顯示在 dmesg 和 /var/log/messages 中。
- 要加載協處理器端驅動程序 mic_virtblk 而不分配 virtio 塊設備文件，錯誤消息“Have set virtblk file?”將會顯示在 dmesg 和 /var/log/messages 中。
- 僅支持英特爾(R) 至強融核(TM) 協處理器，在協處理器的先前非生產版本上，不能加載協處理器側驅動程序。
- virtblk 在 SUSE Linux Enterprise Server version 11 SP1 上不可用。 在這種情況下，用戶將在加載 mic_virtblk 時看到消息“virtio address is not passed from host”消息。virtblk 在 SLES 11 SP2 上可用。
===============================================================================
13. 支持特性的快照
===============================================================================
+-----------------------------------------------------------+-----------------+
| 特性 | 支持 |
+-----------------------------------------------------------+-----------------+
| 英特爾(R) 至強融核(TM) 協處理器支持 | A0（ES0 和 ES1） |
| | B0 (ES2) B1 (QS)|
+-----------------------------------------------------------+-----------------+
| RHEL* 6、6.1、6.2 或 6.3 | GA |
+-----------------------------------------------------------+-----------------+
| SUSE* Linux* Enterprise Server 11 | SP1 和 SP2 |
+-----------------------------------------------------------+-----------------+
| 多協處理器配置 | 多達 8 個已測試 |
+-----------------------------------------------------------+-----------------+
| 多語境支持 | 是 |
+-----------------------------------------------------------+-----------------+
| RPM 安裝 | 是 |
+-----------------------------------------------------------+-----------------+
| 閃存更新功能 | micflash |
+-----------------------------------------------------------+-----------------+
| 顯示系統和協處理器的信息 | micinfo |
+-----------------------------------------------------------+-----------------+
| 控制面板 | micsmc |
+-----------------------------------------------------------+-----------------+
| S3 （暫停）與 S4（休眠） | 最小限度 |
+-----------------------------------------------------------+-----------------+
| 重新啓動協處理器，而無需重新啓動主機的功能 | 是 |
+-----------------------------------------------------------+-----------------+
| 在協處理器上運行多線程應用程序 | 是 |
+-----------------------------------------------------------+-----------------+
| 顯示軟件堆棧版本信息 | 是 |
+-----------------------------------------------------------+-----------------+
| 對稱通信接口 | 是 |
+-----------------------------------------------------------+-----------------+
| 暫停和恢復 | 否 |
+-----------------------------------------------------------+-----------------+
| 對稱通信接口 Fence API 最新改進 | 是 |
| 請參閱對稱通信接口用戶指南以瞭解用法 | |
+-----------------------------------------------------------+-----------------+
