简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

使用 ONTAP 存储为 FCP 和 iSCSI 配置 Citrix Hypervisor 8.2

08/19/2025 贡献者

PDF

配置 Citrix Hypervisor 8.2 以实现多路径，并使用特定参数和设置来针对ONTAP存储的 FCP 和 iSCSI 协议操作。

Linux Host Utilities 软件包不支持 Citrix Hypervisor 操作系统。

第1步：(可选)启用SAN启动

您可以将主机配置为使用SAN启动来简化部署并提高可扩展性。

开始之前

使用"互操作性表工具"验证您的Linux操作系统、主机总线适配器(HBA)、HBA固件、HBA启动BIOS和ONTAP版本是否支持SAN启动。

步骤

"创建 SAN 启动 LUN 并将其映射到主机"(英文)
在服务器 BIOS 中为 SAN 启动 LUN 映射到的端口启用 SAN 启动。

有关如何启用 HBA BIOS 的信息，请参见供应商专用文档。
重新启动主机并验证操作系统是否已启动且正在运行、以验证配置是否成功。

步骤 2：确认主机的多路径配置

您可以使用 Citrix Hypervisor 8.2 的多路径来管理 ONTAP LUN。

要确保为主机正确配置了多路径、请验证是否已定义此 `/etc/multipath.conf`文件、以及是否已为ONTAP LUN配置了NetApp建议的设置。

步骤

验证 `/etc/multipath.conf`文件存在。如果此文件不存在、请创建一个空的零字节文件：
```
touch /etc/multipath.conf
```
首次创建文件时 multipath.conf、您可能需要启用并启动多路径服务以加载建议的设置：
```
systemctl enable multipathd
```
```
systemctl start multipathd
```

每次启动主机时、空的 `/etc/multipath.conf`零字节文件都会自动加载NetApp建议的主机多路径参数作为默认设置。您无需更改 `/etc/multipath.conf`主机的文件、因为主机操作系统使用可正确识别和管理ONTAP LUN的多路径参数进行编译。

下表显示了Linux操作系统为ONTAP LUN编译的本机多路径参数设置。

显示参数设置

参数	正在设置 …
detect_prio	是的。
dev_los_TMO	" 无限 "
故障恢复	即时
fast_io_fail_sMO	5.
features	"3 queue_if_no_path pG_init_retries 50"
flush_on_last_del	是的。
硬件处理程序	0
no_path_retry	队列
path_checker	"TUR"
path_grouping_policy	"Group_by-prio"
path_selector	" 服务时间 0"
Polling interval	5.
PRIO	ONTAP
产品	LUN
Retain Attached Hw_handler	是的。
rr_weight	" 统一 "
user_friendly_names	否
供应商	NetApp

参数

正在设置 …

detect_prio

是的。

dev_los_TMO

" 无限 "

故障恢复

即时

fast_io_fail_sMO

features

"3 queue_if_no_path pG_init_retries 50"

flush_on_last_del

是的。

硬件处理程序

no_path_retry

队列

path_checker

"TUR"

path_grouping_policy

"Group_by-prio"

path_selector

" 服务时间 0"

Polling interval

PRIO

ONTAP

产品

LUN

Retain Attached Hw_handler

是的。

rr_weight

" 统一 "

user_friendly_names

否

供应商

NetApp

验证ONTAP LUN的参数设置和路径状态：

/sbin/mpathutil list

默认多路径参数支持ASA、AFF和FAS配置。在这些配置中、一个ONTAP LUN不应需要超过四个路径。如果路径数超过四个、则可能会在存储故障期间导致路径出现问题。

以下示例输出显示了ASA、AFF或FAS配置中ONTAP LUN的正确参数设置和路径状态。

ASA配置

ASA配置可优化指向给定LUN的所有路径、使其保持活动状态。这样可以同时通过所有路径提供I/O操作、从而提高性能。

/usr/sbin/mpathutil status
show topology
create: 3600a098038315045572b5930646f4b63 dm-1 NETAPP  ,LUN C-Mode
size=9.0G features='4 queue_if_no_path pg_init_retries 50 retain_attached_hw_handle' hwhandler='1 alua' wp=rw
`-+- policy='service-time 0' prio=50 status=active
  |- 15:0:0:0  sdb  8:16    active ready running
  |- 15:0:1:0  sdc  8:32    active ready running
  |- 16:0:0:0  sdcf 69:48   active ready running
  `- 16:0:1:0  sdcg 69:64   active ready running

AFF或FAS配置

AFF或FAS配置应具有两组优先级较高和较低的路径。优先级较高的主动/优化路径由聚合所在的控制器提供。优先级较低的路径处于活动状态、但未进行优化、因为它们由其他控制器提供服务。只有在优化路径不可用时、才会使用非优化路径。

以下示例显示了具有两个主动/优化路径和两个主动/非优化路径的ONTAP LUN的输出：

/usr/sbin/mpathutil status
show topology
create: 3600a098038315045572b5930646f4b63 dm-1 NETAPP  ,LUN C-Mode
size=9.0G features='4 queue_if_no_path pg_init_retries 50 retain_attached_hw_handle' hwhandler='1 alua' wp=rw
|-+- policy='service-time 0' prio=50 status=active
  |- 15:0:0:0  sdb  8:16    active ready running
  `- 15:0:1:0  sdc  8:32    active ready running
`-+- policy='service-time 0' prio=50 status=active
     |- 16:0:0:0  sdcf 69:48   active ready running
     `- 16:0:1:0  sdcg 69:64   active ready running

步骤 3：（可选）从多路径中排除设备

如果需要、您可以将不需要的设备的WWID添加到文件的"黑名单"部分、从而将该设备从多路径中排除 multipath.conf。

步骤

确定WWID：
```
/lib/udev/scsi_id -gud /dev/sda
```
"sa"是要添加到黑名单中的本地SCSI磁盘。

例如，WWID为 360030057024d0730239134810c0cb833。

将WWID添加到"黑名单"部分：

blacklist {
	     wwid   360030057024d0730239134810c0cb833
        devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
        devnode "^hd[a-z]"
        devnode "^cciss.*"
}

步骤 4：自定义ONTAP LUN 的多路径参数

如果您的主机连接到其他供应商的LUN、并且任何多路径参数设置被覆盖、则您需要稍后在文件中添加专门适用于ONTAP LUN的zas来更正这些设置 multipath.conf。否则、ONTAP LUN可能无法按预期运行。

请检查 `/etc/multipath.conf`文件，特别是默认值部分中的设置，以了解可能覆盖的设置多路径参数的默认设置。

您不应覆盖ONTAP LUN的建议参数设置。要获得最佳主机配置性能、需要使用这些设置。有关详细信息、请联系NetApp支持部门、您的操作系统供应商或这两者。

以下示例显示了如何更正被覆盖的默认值。在此示例中、 multipath.conf`文件为和定义了与 `no_path_retry`ONTAP LUN不兼容的值 `path_checker、您无法删除这些参数、因为ONTAP存储阵列仍连接到主机。而是通过向专门应用于ONTAP LUN的文件添加设备段来 multipath.conf`更正和 `no_path_retry`的值 `path_checker。

显示示例

defaults {
   path_checker      readsector0
   no_path_retry     fail
}

devices {
   device {
      vendor          "NETAPP"
      product         "LUN"
      no_path_retry   queue
      path_checker    tur
   }
}

步骤 5：查看已知问题

没有已知问题。