iscsiadm - Linux iSCSI 连接管理命令详解
1. 命令简介
iscsiadm 是 Linux 系统中用于管理 iSCSI（Internet Small Computer System Interface）存储连接的命令行工具。iSCSI 是一种基于 TCP/IP 的存储网络协议，允许在计算机之间传输块级别的数据，将远程存储设备映射为本地磁盘。iscsiadm 提供了发现、连接、配置和管理 iSCSI 目标设备（Target）的完整功能，是 iSCSI 启动器（Initiator）的核心管理工具。
2. 语法格式
基本语法格式如下：
bash
运行
iscsiadm [通用选项] -m MODE [模式特定选项] [操作对象]或按传统格式：
bash
运行
iscsiadm [选项] <命令> <参数>基本模式结构：
bash
运行
iscsiadm -m MODE [模式选项] [操作]其中 MODE 指定了主要的工作模式，不同模式下可用的选项和操作不同。
3. 常用选项及说明
通用选项
表格
| 选项 | 简写 | 说明 |
|---|---|---|
| --help | -h | 显示帮助信息 |
| --version | -V | 显示版本信息 |
| --debug | -d | 启用调试模式，显示详细调试信息 |
模式选择选项
表格
| 选项 | 简写 | 参数 | 说明 |
|---|---|---|---|
| --mode | -m | discovery | node | session | discoverydb | iface | host | 指定工作模式 |
各模式常用选项
发现模式 (-m discovery)
表格
| 选项 | 简写 | 参数 | 说明 |
|---|---|---|---|
| --type | -t | sendtargets (或 st) | isns | fw | 指定发现类型 |
| --portal | -p | IP[:PORT] | 指定目标门户地址，默认端口 3260 |
| --interface | -I | IFACE_NAME | 指定使用的网络接口 |
| --op | -o | new | delete | update | nonpersistent | 发现数据库操作 |
节点模式 (-m node)
表格
| 选项 | 简写 | 参数 | 说明 |
|---|---|---|---|
| --targetname | -T | TARGET_NAME | 指定目标名称（IQN） |
| --portal | -p | IP[:PORT] | 指定目标门户地址 |
| --login | -l | 无 | 登录到指定目标 |
| --logout | -u | 无 | 从指定目标登出 |
| --interface | -I | IFACE_NAME | 指定使用的网络接口 |
| --op | -o | delete | update | 节点数据库操作 |
会话模式 (-m session)
表格
| 选项 | 简写 | 参数 | 说明 |
|---|---|---|---|
| --sid | -r | SID | 指定会话 ID |
| --logout | -u | 无 | 登出指定会话 |
| -P | 0-4 | 打印会话详细信息（0-4 详细级别） | |
| --stats | -s | 无 | 显示会话统计信息 |
| --rescan | 无 | 无 | 重新扫描会话 |
接口模式 (-m iface)
表格
| 选项 | 简写 | 参数 | 说明 |
|---|---|---|---|
| --interface | -I | IFACE_NAME | 指定接口名称 |
| --op | -o | new | delete | update | show | 接口配置操作 |
4. 示例用法
4.1 安装与基本配置
bash
运行
# 安装 iSCSI 启动器工具 sudo yum install iscsi-initiator-utils # RHEL/CentOS sudo apt-get install open-iscsi # Ubuntu/Debian # 查看/配置启动器名称 cat /etc/iscsi/initiatorname.iscsi # 输出示例：InitiatorName=iqn.1994-05.com.redhat:unique-id # 启动服务 sudo systemctl enable iscsi iscsid sudo systemctl restart iscsi iscsid4.2 发现 iSCSI 目标
bash
运行
# 发送发现请求到指定门户 iscsiadm -m discovery -t st -p 192.168.1.100 # 使用特定端口 iscsiadm -m discovery -t st -p 192.168.1.100:3260 # 通过特定网络接口发现 iscsiadm -m discovery -t st -p 192.168.1.100 -I eth0 # 查看发现的目标记录 iscsiadm -m node4.3 连接与登录目标
bash
运行
# 登录到特定目标 iscsiadm -m node -T iqn.2023-01.com.example:storage.target1 -p 192.168.1.100 -l # 使用自动登录所有发现的目标 iscsiadm -m node --loginall=automatic # 查看当前活动会话 iscsiadm -m session -P 3 # 查看会话统计信息 iscsiadm -m session -s4.4 断开连接
bash
运行
# 从特定目标登出 iscsiadm -m node -T iqn.2023-01.com.example:storage.target1 -p 192.168.1.100 -u # 登出所有会话 iscsiadm -m session -u # 删除节点记录（不删除磁盘数据） iscsiadm -m node -T iqn.2023-01.com.example:storage.target1 -p 192.168.1.100 -o delete4.5 管理发现数据库
bash
运行
# 查看发现数据库记录 iscsiadm -m discoverydb -t st -p 192.168.1.100 -P 1 # 删除发现记录 iscsiadm -m discoverydb -t st -p 192.168.1.100 -o delete5. 注意事项
- 权限：大多数 iscsiadm 操作需要 root 权限，请使用 sudo 或切换至 root 用户执行。
- 持久化：通过 -m node -l 的登录默认是持久的，重启后会自动重连。使用 --op nonpersistent 可进行非持久化发现。
- 服务依赖：执行操作前，请确保 iscsid 服务正在运行 (systemctl status iscsid)。
- 数据安全：登出或删除节点操作不会清除已挂载磁盘上的数据，但会中断正在进行的 I/O。请确保在操作前已卸载相关文件系统或确认应用可接受中断。
- 多路径：在配置了 iSCSI 多路径的环境中，操作单个会话或路径需格外小心，建议使用多路径专用工具（如 multipath）进行整体管理。
获取更多Linux学习资料请关注“阿成学长工具包”公众号，对话框中输入2647获取