6 安装 iSCSI 网关 #

Linux 内核 iSCSI 目标最初称作 linux-iscsi.or 的 LIO，它是项目的原始域和网站。在过去一段时间，适用于 Linux 平台的 iSCSI 目标实施竞争产品不少于四个，但 LIO 作为单一 iSCSI 参照目标最终获得了压倒性优势。LIO 的主流内核代码使用简单但有点含糊的名称“目标”，旨在区分“目标核心”与各种前端和后端目标扩展模块。

可以说，最常用的前端扩展模块就是 iSCSI。但是，LIO 也支持光纤通道 (FC)、基于以太网的光纤通道 (FCoE) 和其他多种前端协议。目前，SUSE Enterprise Storage 仅支持 iSCSI 协议。

最常用的目标后端扩展模块是能够方便地在目标主机上重新导出任何可用块设备的扩展模块。此模块名为 iblock。但是，LIO 还有一个 RBD 特定的后端扩展模块，该扩展模块支持对 RBD 映像进行并行化多路径 I/O 访问。

本节简要介绍 Linux、Microsoft Windows 和 VMware 平台上使用的 iSCSI 发起程序。

Ceph iSCSI 网关采用与其他 Ceph 服务相同的过程进行部署，即使用 cephadm。有关细节，请参见第 5.4.3.5 节 “部署 iSCSI 网关”。

RBD 映像创建于 Ceph 存储区中，随后会导出到 iSCSI。建议为此使用专用的 RADOS 存储池。您可以在能使用 Ceph rbd 命令行实用程序连接到存储集群的任何主机上创建卷。这需要客户端至少有一个精简的 ceph.conf 配置文件，以及相应的 CephX 身份验证身份凭证。

要通过 iSCSI 创建一个随后可供导出的新卷，请使用 rbd create 命令并指定卷大小（以 MB 为单位）。例如，要在名为 iscsi-images 的存储池中创建名为 testvol 的 100 GB 卷，请运行以下命令：

cephuser@adm > rbd --pool iscsi-images create --size=102400 testvol

要通过 iSCSI 导出 RBD 映像，您可以使用 Ceph Dashboard Web 界面或 ceph-iscsi gwcli 实用程序。在本节中，我们只重点介绍 gwcli，演示如何使用命令行创建导出 RBD 映像的 iSCSI 目标。

注意

无法通过 iSCSI 导出具有以下属性的 RBD 映像：

• 启用 journaling 功能的映像

• stripe unit 小于 4096 字节的映像

以 root 身份进入 iSCSI 网关容器：

root # cephadm enter --name CONTAINER_NAME

以 root 身份启动 iSCSI 网关命令行界面：

root # gwcli

转到 iscsi-targets，然后创建名为 iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol 的目标：

gwcli >  /> cd /iscsi-targets
gwcli >  /iscsi-targets> create iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol

通过指定网关名称和 IP 地址创建 iSCSI 网关：

gwcli >  /iscsi-targets> cd iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol/gateways
gwcli >  /iscsi-target...tvol/gateways> create iscsi1 192.168.124.104
gwcli >  /iscsi-target...tvol/gateways> create iscsi2 192.168.124.105

提示

使用 help 命令可显示当前配置节点中的可用命令列表。

在存储池 iscsi-images 中添加名为 testvol 的 RBD 映像：

gwcli >  /iscsi-target...tvol/gateways> cd /disks
gwcli >  /disks> attach iscsi-images/testvol

将 RBD 映像映射到目标：

gwcli >  /disks> cd /iscsi-targets/iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol/disks
gwcli >  /iscsi-target...testvol/disks> add iscsi-images/testvol

注意

您可以使用级别较低的工具（例如 targetcli）来查询本地配置，但无法修改配置。

提示

您可以使用 ls 命令查看配置。有些配置节点还支持 info 命令，该命令可用于显示更多详细信息。

请注意，系统默认会启用 ACL 身份验证，因此目前尚不可访问此目标。有关身份验证和访问控制的详细信息，请参见第 6.4.4 节 “身份验证和访问控制”。

iSCSI 身份验证十分灵活，涵盖了许多身份验证可能性。

gwcli >  /> cd /iscsi-targets/iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol/hosts
gwcli >  /iscsi-target...testvol/hosts> auth disable_acl

gwcli >  /> cd /iscsi-targets/iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol/hosts
gwcli >  /iscsi-target...testvol/hosts> create iqn.1996-04.de.suse:01:e6ca28cc9f20

gwcli >  /iscsi-target...:e6ca28cc9f20> disk add rbd/testvol

6.4.4.3 启用 CHAP 身份验证 #

 

除了 ACL 以外，您还可以通过为每个发起程序指定用户名和密码来启用 CHAP 身份验证：

gwcli >  /> cd /iscsi-targets/iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol/hosts/iqn.1996-04.de.suse:01:e6ca28cc9f20
gwcli >  /iscsi-target...:e6ca28cc9f20> auth username=common12 password=pass12345678

注意

用户名长度必须为 8 至 64 个字符，可以包含字母数字字符、.、@、-、_ 或 :。

密码长度必须为 12 至 16 个字符，可以包含字母数字字符、@、-、_ 或 /。

（可选）您也可以在 auth 命令中指定 mutual_username 和 mutual_password 参数，以启用 CHAP 相互身份验证。

6.4.4.4 配置发现和相互身份验证 #

 

发现身份验证独立于之前的身份验证方法。该身份验证需要身份凭证才能进行浏览，它是可选设置，可通过运行以下命令配置：

gwcli >  /> cd /iscsi-targets
gwcli >  /iscsi-targets> discovery_auth username=du123456 password=dp1234567890

注意

用户名长度必须为 8 至 64 个字符，并且只能包含字母、.、@、-、_ 或 :。

密码的长度必须为 12 至 16 个字符，并且只能包含字母、@、-、_ 或 /。

（可选）您也可以在 discovery_auth 命令中指定 mutual_username 和 mutual_password 参数。

可以使用以下命令来禁用发现身份验证：

gwcli >  /iscsi-targets> discovery_auth nochap

可以为 ceph-iscsi 配置随后将传递给 LIO I/O 目标的高级参数。参数分为 target 和 disk 参数。

警告

除非另有说明，否则不建议将这些参数更改为使用非默认设置。

gwcli >  /> cd /iscsi-targets/iqn.2003-01.org.linux-iscsi.iscsi.SYSTEM-ARCH:testvol
gwcli >  /iscsi-target...i.SYSTEM-ARCH:testvol> info

gwcli >  /iscsi-target...i.SYSTEM-ARCH:testvol> reconfigure login_timeout 20

gwcli >  /> cd /disks/rbd/testvol
gwcli >  /disks/rbd/testvol> info

gwcli >  /disks/rbd/testvol> reconfigure rbd/testvol emulate_pr 0