iscsiadm - Linux iSCSI 连接管理命令详解

1. 命令简介iscsiadm 是 Linux 系统中用于管理 iSCSIInternet 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-mdiscovery | node | session | discoverydb | iface | host指定工作模式各模式常用选项发现模式 (-m discovery)表格选项简写参数说明--type-tsendtargets (或 st) | isns | fw指定发现类型--portal-pIP[:PORT]指定目标门户地址默认端口 3260--interface-IIFACE_NAME指定使用的网络接口--op-onew | delete | update | nonpersistent发现数据库操作节点模式 (-m node)表格选项简写参数说明--targetname-TTARGET_NAME指定目标名称IQN--portal-pIP[:PORT]指定目标门户地址--login-l无登录到指定目标--logout-u无从指定目标登出--interface-IIFACE_NAME指定使用的网络接口--op-odelete | update节点数据库操作会话模式 (-m session)表格选项简写参数说明--sid-rSID指定会话 ID--logout-u无登出指定会话--print-P0-4打印会话详细信息0-4 详细级别--stats-s无显示会话统计信息--rescan无无重新扫描会话接口模式 (-m iface)表格选项简写参数说明--interface-IIFACE_NAME指定接口名称--op-onew | 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 # 输出示例InitiatorNameiqn.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 --loginallautomatic # 查看当前活动会话 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获取