scst与tgt的使用说明.doc

SCST接口在命令行输入scstadmin就可以查看scstadmin的命令行参数，可以直观的看到scstadmin所有的参数和解释，还有事例。一、 基本操作：（1）config 用指定的配置文件配置scst。为配置文件路径比如：输入 scstadmin config /etc/scst.conf 读取/etc/scst.conf系统启动时会自动读取/etc/scst.conf的配置（2） clearconfig 清除所有的scst配置（但scst配置文件没有被清除）（3） writeconfig 把当前的scst配置写入配置文件。为配置文件路径比如：输入scstadmin writeconfig /etc/scst.conf 把配置写入scst.conf（4） checkconfig 检查当前scst配置与配置文件是否相同。为配置文件路径（5） session 查看当前scst与所有initiator端的连接状态比如：输入 scstadmin session后 会列出下表：其中红框部分是已经连接的客户端。Target Name栏会显示这行连接的连接类型（ib fc或iscsi）Initiator Name会列出initiator端的名字(ib连接是Guid、fc是WWNp、iscsi是iqn号)Group Name会列出这行连接使用的Group组名。二、 设备操作（1）-adddev -handler -path -options -blocksize 向handler添加一个块设备解释一下参数：是添加后的磁盘名称，可以随意起名。 是hangler的类型，这里我们必须指定为vdisk 是要添加磁盘的路径，比如/dev/vg0/iscsi0 是选择设备的读取模式，其中有如下选项WRITE_THROUGH, READ_ONLY, NV_CACHE, BIO,如不加options选项，则默认为file_io模式 是映射后的磁盘块大小，如果不加-blocksize选项，则默认块大小为512比如输入 scstadmin -adddev DISK01 -handler vdisk -path /vdisks/disk01.dsk -options READ_ONLY,WRITE_THROUGH就是添加一个路径为/vdisks/disk01.dsk的磁盘，磁盘名称为DISK01，模式为只读的和WRITE_THROUGH模式，默认块大小512。（2）-removedev -handler 从handler中移除一个已添加的盘。 比如输入scstadmin -removedev DISK01 handler vdisk 会把上一步添加进的盘从handler中移除。（3）-resyncdev -handler 动态更改磁盘容量后，异步通知。注意这个命令只有在scst 以后的版本才有。（只对iscsi有效）三、组操作（1）-addgroup 创建一个组 。为组名。比如scstadmin addgroup HOST01 创建一个名为HOST01的组（2）-removegroup 删除一个已创建的组四、用户操作（1）-adduser -group 添加一个用户到组。参数 分三种：光纤为WWNP号，IB为Guid，iSCSI为iqn名称。 为组名比如scstadmin -adduser 50:06:0B:00:00:39:71:78 group HOST1 向组HOST1添加一个远端FC卡的WWNP号（2）-removeuser -group 从组中删除一个用户。（3）-clearuser group 清空指定组的所有用户。五、向组中添加或修改设备的操作（1）-assigndev -group -lun 为第二步 （“二、设备操作”）中向handler添加的设备名称。 指定要添加的组名为lun号，注意：每组的lun号必须从0开始！比如scstadmin -assigndev DISK01 -group HOST01 -lun 0，向组HOST01中添加一个DISK01的盘，此块盘的lun号为0（2）-releasedev -group 从指定组中移除一个已添加的设备。（3）-cleardevs group 清空指定组中所有已添加的盘。开启关闭服务：(1) /etc/init.d/iscsi-scst 为iscsi服务(2) /etc/init.d/openibd 为ib卡服务，如果关闭，则ib卡会ping不通。(3) /proc/scsi_tgt/qla_isp/X X为这个目录下一个文件名为数字的文件，向X写入enable all或者disable all会开启关闭光纤卡的服务。比如echo “enable all” /proc/scsi_tgt/qla_isp/2 开启光纤卡连接光纤卡的连接也可以通过scstadmin命令关闭。比如target端的光纤卡port WWN号为21：00：00：1b：32：92：5b：72scstadmin enable 21：00：00：1b：32：92：5b：72 开启此光纤卡服务scstadmin disable 21：00：00：1b：32：92：5b：72关闭光纤卡服务查看当前scst设置：scst会在/proc/scsi_tgt目录下输出信息。我们可以通过查看这个目录下的文件来了解当前scst的配置。（1）/proc/scsi_tgt/groups目录下每一个文件夹的名称为已经创建的组，可进入这个文件夹查看每组添加进的设备和用户名。（2）/proc/scsi_tgt/vdisk下的vdisk文件可以查看当前添加进handler的设备名以及设备信息。比如cat /proc/scsi/vdisk/vdisk。添加了8块盘，注意Options这行指定了每块盘的类型，WT是WRITE_THROUGH，NIO是NULLIO，NV是NV_CACHE (3)以上为两个最重要的文件夹，/proc/scsi_tgt/下其他的文件也可以cat，比如cat /proc/scsi_tgt/thread为scst运行的线程数。cat /proc/scsi_tgt/session查看当前的连接信息，相当于命令scstadmin session。scst target 的iscsi参数设置/etc/iscsi-scstd文件是配置iscsi的配置文件，其中每行#号都是注释，可以去掉#号，并且修改参数来对iscsi target的属性进行修改。(1)账号接口去掉IncomingUser的注释符号，可增加此行的用户。(支持多账号)下图为frank和joe两个账号比较重要的配置如下把这个账号密码设置以后，在windows的Microsoft iSCSI Initiator可以使用如下功能：chap认证，name 是joe 密码是secretaaaaaaa。注意，密码必须不小于12位，不然iscsi服务启动不了。iscsi-conf还有其他参数设置，把注释去掉，就可以设置。(2)CRC校验接口去掉/etc/iscsi-scst.conf以下注释可以设置CRC校验也就是用户登陆时要选上CRC校验，如下图红色所示：STGT接口STGT守护进程启动脚本存放在源码包下的scripts/initd.sample。与scstadmin类似，输入tgtadm h命令可以查看tgtadm命令的参数(1) tgtadm -lld iscsi -mode target -op new -tid -targetname 创建target。参数为target id，从1开始(不能为0)，是target名字，可以随便命名。比如：./tgtadm -lld iscsi -mode target -op new -tid 1 -targetname $(hostname)(2) tgtadm -lld iscsi -mode target op delete -tid 删除target id为的target。(3) tgtadm -lld iscsi -mode target -op show显示所有的target状态。比如下图，下图是新创建的名字为test的target （4）tgtadm lld iscsi mode target op show tid 显示指定的target参数(指定target id)。(5)tgtadm -lld iscsi -mode target -op update tid id name param value value修改(4)中的参数，比如：tgtadm -lld iscsi -mode target -op update -tid 1 -name MaxRecvDataSegmentLength -value 16384修改target id为1的target，参数是MaxRecvDataSegmentLength，修改的值为16384。 (6)tgtadm -lld iscsi -mode target -op bind tid id -initiator-address src绑定指定target的访问权限。src参数可以为指定initiator端的ib卡的ip地址（指定后，只能ip为指定的initiator端才能访问此target），如果为ALL则所有initiator端都可以访问此target。(7)tgtadm -lld iscsi -mode target -op unbind -tid id -initiator-address src与(6)相反的操作，解除绑定。（8）tgtadm -lld iscsi -mode logicalunit -op new -tid id lun lun -backing-store path 向指定的target添加一个逻辑卷 比如./tgtadm -lld iscsi -mode logicalunit -op new -tid 1 -lun 1 -backing-store /tmp/tid1lun1向target ID为1的target中添加一个路径为/tmp/tid1lun1的逻辑卷。（9）tgtadm lld iscsi mode logicalunit op delete itd id lun lun与(8)相反的操作。STGT配置文件接口stgt提供了tgt-admin命令行工具用来修改stgt的配置文件。配置文件存放在/etc/tgt/targets.conf中。tgt-admin命令底层调用的是tgtadm命令，只不过针对tgtadm命令做了简化。具体的配置文件写法在/TGT-admin这个网站有介绍。(1) tgt-admin -e 读取/etc/tgt/targets.conf，并按此脚本配置(当前已建立连接的target不会被改变)。(2) tgt-admin -offline 停止相应的target服务。注意点：当Initiator端已经连接target时，不要对此target进行offline操作，不然已经连接的Initiator端会被阻止此命令必须跟如下之一参数tgt-admin -offline ALL 停止所有的target服务tgt-admin -offline tid=id 停止指定tid号的target服务，比如tgt-admin -offline tid=4tgt-admin -offline name，停止指定target名字的服务比如 tgt-admin offline .example:some.target offline以后如下所示：(3) tgt-admin -ready 与（2）相反的操作，后跟参数有三种，与（2）对应。-ready ALL-ready tid=id-ready name(4)tgt-admin -delete value删除指定target，已经建立连接的targ