From 4f828ba8a3d88563d2b7d1fa12ae32dbbcc31bce Mon Sep 17 00:00:00 2001 From: Bart Van Assche Date: Wed, 27 Jul 2011 12:38:51 +0000 Subject: [PATCH] Update scstadmin and scst.conf man pages with information about ALUA. Update the scst.conf example too. git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@3782 d57e44dd-8a1f-0410-8b47-8ef2f437770f --- scstadmin/examples/scst.conf.sysfs | 87 +++++++-- scstadmin/scstadmin.sysfs/man1/scstadmin.1 | 65 +++++-- scstadmin/scstadmin.sysfs/man5/scst.conf.5 | 210 +++++++++++++++++---- 3 files changed, 296 insertions(+), 66 deletions(-) diff --git a/scstadmin/examples/scst.conf.sysfs b/scstadmin/examples/scst.conf.sysfs index 0a575cec3..873614ac6 100644 --- a/scstadmin/examples/scst.conf.sysfs +++ b/scstadmin/examples/scst.conf.sysfs @@ -35,14 +35,33 @@ HANDLER vcdrom { TARGET_DRIVER scst_local { TARGET scst_local_tgt { session_name scst_local_host - session_name scst_local_host1 LUN 0 disk1 + LUN 1 disk2 + } +} + +TARGET_DRIVER iscsi { + IncomingUser "joe 12charsecret" + enabled 1 + + TARGET iqn.2006-10.net.vlnb:tgt { + IncomingUser "joe 12charsecret" + HeaderDigest CRC32C,None + enabled 1 + + LUN 0 disk1 + LUN 1 disk2 + LUN 2 blockio1 { + read_only 1 + } } } TARGET_DRIVER qla2x00t { TARGET 25:00:00:f0:98:87:92:f3 { + enabled 1 + GROUP INI1 { LUN 0 blockio1 LUN 1 1:0:0:0 { @@ -53,30 +72,68 @@ TARGET_DRIVER qla2x00t { INITIATOR 25:00:00:f0:99:87:94:a3 INITIATOR 25:00:00:f0:99:87:94:a4 } - - enabled 1 } TARGET 25:00:00:f0:98:87:92:f4 { } } -TARGET_DRIVER iscsi { - IncomingUser "joe 12charsecret" - - TARGET iqn.2006-10.net.vlnb:tgt { - IncomingUser "joe 12charsecret" - HeaderDigest CRC32C,None +TARGET_DRIVER ib_srpt { + TARGET ib_srpt_target_0 { + enabled 1 LUN 0 disk1 LUN 1 disk2 - LUN 2 blockio1 { - read_only 1 - } - - enabled 1 } - enabled 1 + TARGET ib_srpt_target_1 { + enabled 1 + + LUN 0 disk1 + LUN 1 disk2 + } } +DEVICE_GROUP dgroup1 { + DEVICE disk1 + + TARGET_GROUP tgroup1 { + group_id 1 + state active + + TARGET ib_srpt_target_0 { + rel_tgt_id 1 + } + } + + TARGET_GROUP tgroup2 { + group_id 2 + state offline + + TARGET ib_srpt_target_1 { + rel_tgt_id 2 + } + } +} + +DEVICE_GROUP dgroup2 { + DEVICE disk2 + + TARGET_GROUP tgroup1 { + group_id 1 + state offline + + TARGET ib_srpt_target_0 { + rel_tgt_id 1 + } + } + + TARGET_GROUP tgroup2 { + group_id 2 + state active + + TARGET ib_srpt_target_1 { + rel_tgt_id 2 + } + } +} diff --git a/scstadmin/scstadmin.sysfs/man1/scstadmin.1 b/scstadmin/scstadmin.sysfs/man1/scstadmin.1 index 37c6eadd3..700f0ade7 100644 --- a/scstadmin/scstadmin.sysfs/man1/scstadmin.1 +++ b/scstadmin/scstadmin.sysfs/man1/scstadmin.1 @@ -13,7 +13,27 @@ SCST consists of multiple kernel modules: the SCST core, SCST target drivers and SCST device handlers. The state of each of these kernel modules is configurable at runtime. Scstadmin allows query the current state, to modify the current state, to save the current state to a file and to restore the SCST -state from a file. +state from a file. The relevant SCST concepts are: +.TP +.B device +An SCST device represents local storage that is exported via SCST. An SCST +device is either a local SCSI device (disk, CD-ROM, tape, ...), a block I/O +device like a disk or RAID controller or a file on a filesystem. The SCST +drivers that control SCST devices are called device handlers. Examples of +such device handlers are dev_disk, vdisk_blockio and vdisk_fileio. +.TP +.B target +An SCST target is an interface that allows a remote system to access the +storage exported via SCST. Each target is controlled by a target +driver. Examples of target drivers are iscsi_scst, qla2x00t, ib_srpt and +scst_local. +.TP +.B ALUA +An SCST setup can have multiple storage interfaces. A single SCST server can +be equipped with multiple interfaces or two SCST servers can have been set up +in a cluster. If there are multiple paths between an initiator and a target +system or target cluster then configuring ALUA (Asymmetric Logical Unit +Access) will make SCST to tell the initiator which path to use. .SH OPTIONS .PP