scst与tgt的使用说明

SCST接口在命令行输入scstadmin就可以查看scstadmin的命令行参数，可以直观的看到scstadmin所有的参数和解释，还有事例。一、基本操作：（1）–configconfig用指定的配置文件配置scst。config为配置文件路径比如：输入scstadmin–config/etc/scst.conf读取/etc/scst.conf系统启动时会自动读取/etc/scst.conf的配置（2）–clearconfig清除所有的scst配置（但scst配置文件没有被清除）（3）–writeconfigfile把当前的scst配置写入配置文件。file为配置文件路径比如：输入scstadmin–writeconfig/etc/scst.conf把配置写入scst.conf（4）–checkconfigfile检查当前scst配置与配置文件是否相同。file为配置文件路径（5）–session查看当前scst与所有initiator端的连接状态比如：输入scstadmin–session后会列出下表：其中红框部分是已经连接的客户端。TargetName栏会显示这行连接的连接类型（ibfc或iscsi）InitiatorName会列出initiator端的名字(ib连接是Guid、fc是WWNp、iscsi是iqn号)GroupName会列出这行连接使用的Group组名。二、设备操作（1）-adddevdevice-handlerhandler-pathpath-optionsoptions-blocksizebytes向handler添加一个块设备解释一下参数：device是添加后的磁盘名称，可以随意起名。handler是hangler的类型，这里我们必须指定为vdiskpath是要添加磁盘的路径，比如/dev/vg0/iscsi0options是选择设备的读取模式，其中有如下选项WRITE_THROUGH,READ_ONLY,NV_CACHE,BIO,如不加options选项，则默认为file_io模式bytes是映射后的磁盘块大小，如果不加-blocksize选项，则默认块大小为512比如输入scstadmin-adddevDISK01-handlervdisk-path/vdisks/disk01.dsk-optionsREAD_ONLY,WRITE_THROUGH就是添加一个路径为/vdisks/disk01.dsk的磁盘，磁盘名称为DISK01，模式为只读的和WRITE_THROUGH模式，默认块大小512。（2）-removedevdevice-handlerhandler从handler中移除一个已添加的盘。比如输入scstadmin-removedevDISK01–handlervdisk会把上一步添加进的盘从handler中移除。（3）-resyncdevdevice-handlerhandler动态更改磁盘容量后，异步通知。注意这个命令只有在scst1.0.1.1以后的版本才有。（只对iscsi有效）三、组操作（1）-addgroupgroup创建一个组。group为组名。比如scstadmin–addgroupHOST01创建一个名为HOST01的组（2）-removegroupgroup删除一个已创建的组四、用户操作（1）-adduseruser-groupgroup添加一个用户到组。user参数分三种：光纤为WWNP号，IB为Guid，iSCSI为iqn名称。group为组名比如scstadmin-adduser50:06:0B:00:00:39:71:78–groupHOST1向组HOST1添加一个远端FC卡的WWNP号（2）-removeuseruser-groupgroup从组中删除一个用户。（3）-clearuser–groupgroup清空指定组的所有用户。五、向组中添加或修改设备的操作（1）-assigndevdevice-groupgroup-lunlundevice为第二步（“二、设备操作”）中向handler添加的设备名称。group指定要添加的组名lun为lun号，注意：每组的lun号必须从0开始！！比如scstadmin-assigndevDISK01-groupHOST01-lun0，向组HOST01中添加一个DISK01的盘，此块盘的lun号为0（2）-releasedevdevice-groupgroup从指定组中移除一个已添加的设备。（3）-cleardevs–groupgroup清空指定组中所有已添加的盘。开启关闭服务：(1)/etc/init.d/iscsi-scst为iscsi服务(2)/etc/init.d/openibd为ib卡服务，如果关闭，则ib卡会ping不通。(3)/proc/scsi_tgt/qla_isp/XX为这个目录下一个文件名为数字的文件，向X写入enableall或者disableall会开启关闭光纤卡的服务。比如echo“enableall”/proc/scsi_tgt/qla_isp/2开启光纤卡连接光纤卡的连接也可以通过scstadmin命令关闭。比如target端的光纤卡portWWN号为21：00：00：1b：32：92：5b：72scstadmin–enable21：00：00：1b：32：92：5b：72开启此光纤卡服务scstadmin–disable21：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。scsttarget的iscsi参数设置/etc/iscsi-scstd文件是配置iscsi的配置文件，其中每行#号都是注释，可以去掉#号，并且修改参数来对iscsitarget的属性进行修改。(1)账号接口去掉IncomingUser的注释符号，可增加此行的用户。(支持多账号)下图为frank和joe两个账号比较重要的配置如下把这个账号密码设置以后，在windows的MicrosoftiSCSIInitiator可以使用如下功能：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--lldiscsi--modetarget--opnew--tidid--targetnamename创建target。id参数为targetid，从1开始(不能为0)，name是target名字，可以随便命名。比如：./tgtadm--lldiscsi--modetarget--opnew--tid1--targetname$(hostname)(2)tgtadm--lldiscsi--modetarget–opdelete--tidid删除targetid为id的target。(3)tgtadm--lldiscsi--modetarget--opshow显示所有的target状态。比如下图，下图是新创建的名字为test的target（4）tgtadm–lldiscsi–modetarget–opshow–tidid显示指定的target参数(id指定targetid)。(5)tgtadm--lldiscsi--modetarget--opupdate–tid[id]–name[param]–value[value]修改(4)中的参数，比如：tgtadm--lldiscsi--modetarget--opupdate--tid1--nameMaxRecvDataSegmentLength--value16384修改targetid为1的target，参数是MaxRecvDataSegmentLength，修改的值为16384。(6)tgtadm--lldiscsi--modetarget--opbind–tid[id]--initiator-address[src]绑定指定target的访问权限。[src]参数可以为指定initiator端的ib卡的ip地址（指定后，只能ip为指定的initiator端才能访问此target），如果为ALL则所有initiator端都可以访问此target。(7)tgtadm--lldiscsi--modetarget--opunbind--tid[id]--initiator-address[src]与(6)相反的操作，解除绑定。（8）tgtadm--lldiscsi--modelogicalunit--opnew--tid[id]–lun[lun]--backing-store[path]向指定的target添加一个逻辑卷比如./tgtadm--lldiscsi--modelogicalunit--opnew--tid1--lun1--backing-store/tmp/tid1lun1向targetID为1的target中添加一个路径为/tmp/tid1lun1的逻辑卷。（9）tgtadm–lldiscsi–modelogicalunit–opdelete–itd[id]–lun[lun]与(8)相反的操作。STGT配置文件接口stgt提供了tgt-admin命令行工具用来修改stgt的配置文件。配置文件存放在/etc/tgt/targets.conf中。tgt-admin命令底层调用的是tgtadm命令，只不过针对tgtadm命令做了简化。具体的配置文件写法在这个网站有介绍。(1)tgt-admin-e读取/etc/tgt/targets.conf，并按此脚本配置(当前已建立连接的target不会被改变)。(2)tgt-admin--offline停止相应的target服务。注意点：当Initiator端已经连接target时，不要对此target进行offline操作，不然已经连接的Initiator端会被阻止此命令必须跟如下之一参数tgt-admin--offlineALL停止所有的target服务tgt-admin--offlinetid=[id]停止指定tid号的target服务，比如tgt-admin--offlinetid=4tgt-admin--offline[name]，停止指定target名字的服务比如tgt-admin–of