Open iSCSI启动器使用说明.doc

文档名称文档密级A.1 open_iscsi启动器使用说明open-iscsi-2.0-865.15，其他版本可能略有差异。A.1.1 编译安装编译要求内核版本为2.6.16或以上。默认情况下，open-iscsi使用目录/lib/modules/uname -r/build作为内核源码目录进行编译，直接执行：makemake install在SUSE下需要按照以下方式编译安装（需要安装内核源码）：make KSRC=/usr/src/linux KBUILD_OUTPUT=/lib/modules/uname -r/buildmake KSRC=/usr/src/linux KBUILD_OUTPUT=/lib/modules/uname -r/build installA.1.2 2open-iscsi守护进程守护进程iscsid负责处理iscsi协议流程和一些管理功能。Usage: iscsid OPTION-c, -config=path 指定使用的配置文件 (默认为/etc/iscsi/iscsid.conf).-f, -foreground 在前台运行-d, -debug debuglevel debug打印级别-u, -uid=uid 指定进程的uid默认是当前用户-g, -gid=gid 指定进程的gid默认是当前组-h, -help 略-v, -version 显示版本号A.1.3 open-iscsi配置工具open-iscsi使用DBM数据库（所有linux发行版都有）存放配置信息。数据库包含两张表：l Discovery table (/etc/iscsi/send_targets);l Node table (/etc/iscsi/nodes).open-iscsi提供了一个命令行工具iscsiadm来管理数据库（包括记录的update, delete, insert, query）Usage: iscsiadm OPTION参数介绍：-m, -mode op = 指定操作模式，有discovery，node，session3种，discovery用于发现目标器；node用于操作数据库中的节点，如更新删除纪录或登入/登出目标器，session用于操作已建立的iscsi连接。discovery操作模式相关命令-m discovery -print=N显示数据库中discovery相关纪录，print指定显示格式，默认为0，可设为1，如：# iscsiadm -m discovery02:3260 via sendtargets00:3260 via sendtargets00:3260 via sendtargets-m discovery -type=type -portal=ip:port发起discovery ，type指定discovery的类型，包括sendtargets，slp，isns；portal指定目标器的ip和端口，如；iscsiadm -m discovery -t sendtargets -p :3260注：-type 可简写为 -t ；sendtargets可简写为st；-portal可简写为-p。-m discovery -portal=ip:port -op=op -name=name -value=value操作数据库的discovery表中对应portal的纪录，可执行的操作op包括new, delete, update 或show，name表示纪录项的名字，value表示纪录项的值。注：一般不用对discovery表的记录进行操作。-name可简写为-n value可简写为-v。node操作模式相关命令-m node显示数据库中的所有的节点，如：# iscsiadm -m node02:3260,11 .huawei:oceanstor:210000e0fc123456:notconfig:0200:3260,1 .huawei:oceanstor:210000e0fc123456:notconfig:00-m node -targetname=name -portal=ip:port-login|-logout|-rescan|-stats对以targetname或portal指定的节点进行操作，如：# iscsiadm -m node -p 02 -logout注：-logout可简写为 u；-login可简写为 l-m node -targetname=name -portal=ip:port -op=op -name=name -value=value操作数据库的nodes表中对应targetname或portal的节点。可执行的操作包括new, delete, update 或show;name表示纪录项的名字，value表示纪录项的值。-name可简写为-n value可简写为-v，如：# iscsiadm -m node -p 02 -op update -n node.conn0.startup -v automatic表示将数据库nodes表中对应portal为02的节点的node.conn0.startup纪录项的值设为automatic-m node logoutall | loginall =all|manual|automaticlogoutall 或 loginall指定节点：l all表示所有节点。l manual表示节点的node. startup或者node.conn0.startup纪录项值为manual。l automatic表示节点的node. startup或者node.conn0.startup纪录项值为automatic。如：# iscsiadm -m node lsession操作模式相关命令-m session显示所有活动的会话和连接，如：# iscsiadm -m sessiontcp: 1 00:3260,1 .huawei:oceanstor:210000e0fc123456:notconfig:00tcp: 2 02:3260,11 .huawei:oceanstor:210000e0fc123456:notconfig:02-m session -sid=sid -print=level | -rescan | -logout -op=op -name=name -value=value操作由sid指定的会话，包括重扫描，logout和数据库记录操作等，如：#iscsiadm -m session -sid 1 rescan表示对会话1进行重扫描。#iscsiadm -m session -sid 1 或 #iscsiadm -m session -sid 1 print=1表示显示会话1相关信息，print可设为02。其他参数l -d, -debug debuglevel：打印debug信息l -V, -version：显示版本号l -h, -help：显示帮助信息（使用man iscsiadm更详细）A.1.4 配置open-iscsi编辑文件/etc/iscsi/iscsid.conf。A.1.5 使用open-iscsi使用open-iscsi大致分三步：使用init脚本或手动的方式启动iscsi服务。发起discovery找到目标器。将目标器设为自动登陆以方便以后服务器重启的情况；使用init脚本启动iscsi服务。l 在Red Hat/Fedora下，执行service open-iscsi start。如果需要将iscsi服务设为系统启动时自动加载，执行chkconfig -level open-iscsi on。levels表示系统的运行等级(run level)，当前系统的运行等级可在/etc/inittab中查询。l SUSE or Debian下，执行/etc/init.d/open-iscsi start。如果需要将iscsi服务设为系统启动时自动加载，执行chkconfig add open-iscsi。手动方式启动iscsi服务。l 加载iscsi模块：#modprobe -q iscsi_tcpl 启动iscsid：#iscsid或以debug方式运行iscsid#iscsid -d 8 -f &发起discoverydiscovery的方式一般都是sendtargets ，所以执行：iscsiadm -m discovery -t sendtargets -p ip:port，如：# iscsiadm -m discovery -t sendtargets -p 02成功的话使用iscsiadm m node可以看到对应的节点，如：# iscsiadm -m node02:3260,11 .huawei:oceanstor:210000e0fc123456:notconfig:02执行# iscsiadm -m node p 02 l可登入目标器，如果阵列测已建好了映射，则此时就可以生成LUN了如果以后目标器IP改变了，可以先删除老节点，如：# iscsiadm -m node -p 02 -o delete再重新发起discovery生成新节点，如：# iscsiadm -m discovery -t sendtargets -p 00设置自动登陆目标器对于已经存在于数据库中的节点，使用iscsiadm更新纪录项：iscsiadm -m node -T targetname -p ip:port -op update -n node.conn0.startup -v automatic，如：# iscsiadm -m node -p 02 op update -n node.conn0.startup -v automatic对于还没有添加的节点，编辑配置文件/etc/iscsi/iscsid.conf，在其中增加一项：node.conn0.startup = automatic这样以后通过discovery新添加的节点的node.conn0.startup都会被设置为automatic。设置自动登陆目标器以后，每次使用init脚本启动iscsi服务时都会自动登入目标器（即生成LUN）。A.1.6 与多路径有关的设置iSCSI ping/Nop-Out设置iSCSI 启动器通过周期向目标器下发ping（iSCSI NOP-Out requests）来检测连接状态，使用多路径软件时，可通过减小NOP-Out的发送间隔和超时时间来更快的感知路径故障，具体设置文件/etc/iscsi/iscsid.conf中的以下两项：node.conn0.timeo.noop_out_interval = 5node.conn0.timeo.noop_out_timeout = 5注：如果连接状态不稳定，也可以适当增加