# iSCSI 挂载

## 场景

存储设备（或另一台服务器）提供了 iSCSI LUN，要在 Linux 上挂成一块本地盘。

## 前置条件

- 有 iSCSI 目标地址和 IQN
- 客户端能访问 3260
- 确认这台机器该用哪块 LUN，别挂错

## 配置

```bash
dnf install -y iscsi-initiator-utils

# 设置本机 initiator 名（可选，便于服务端做 ACL）
sed -i 's/^#InitiatorName=.*/InitiatorName=iqn.2026-10.local.corp:client01/' /etc/iscsi/initiatorname.iscsi

# 发现目标
iscsiadm -m discovery -t sendtargets -p 10.0.0.9:3260

# 登录
iscsiadm -m node -T iqn.2026-10.local.corp:storage01 -p 10.0.0.9:3260 -l

# 看新盘
lsblk

# 设置开机自动登录
iscsiadm -m node -T iqn.2026-10.local.corp:storage01 -p 10.0.0.9:3260 --op update -n node.startup -v automatic

# 分区、格式化、挂载
mkfs.xfs /dev/sdc
mkdir -p /data
mount /dev/sdc /data
```

## 验证

```bash
iscsiadm -m session
lsblk
df -h /data
systemctl status iscsid
```

## 回滚

```bash
umount /data
iscsiadm -m node -T iqn.2026-10.local.corp:storage01 -p 10.0.0.9:3260 -u
iscsiadm -m node -T iqn.2026-10.local.corp:storage01 -p 10.0.0.9:3260 -o delete
```

## 坑

- **iSCSI LUN 被两台机器同时挂载会损坏文件系统**，除非上面是集群文件系统。
- `node.startup` 不设成 automatic，重启后盘就没了，fstab 会卡在 emergency。
- 单路径断了业务直接 IO 错误，生产要用 multipath。
- CHAP 认证配错，登录时报 `authorization failure`。
- 存储端的 LUN 映射和客户端 IQN 不匹配，能看到目标但挂不上。
- 拔盘前先 `umount` 再登出，直接拔会丢数据。