QA:ISCSI Installation Test plan

Initial setup
Test cases require at least two devices, iSCSI target (hw or sw) and machine fot test installations (physical or virtual).

iSCSI target is simply server in iSCSI terminology. If hardware iSCSI target device isn't available (however hw device is best choice), it is possible to create software iSCSI target on Linux system.

iSCSI initiator is name for client. iSCSI support in anaconda is tested, there is not desired to use hardware iSCSI initiator.

Network connectivity between iSCSI target and test machine is required, faster is always better, 1 Gb/s in best case.

All test cases describe, how to create sw target for particular action with Fedora 10 (iSCSI target is not object of this testing, let's use stable system). Before any testing prepare storage space and start target daemon with following commands (execute as root):
 * 1) dd if=/dev/zero of=/tmp/disk bs=1M count=8000
 * 2) losetup /dev/loop0 /tmp/disk
 * 3) yum -y install scsi-target-utils
 * 4) service tgtd start

You can check any time what targets are provided by command:
 * 1) tgtadm --lld iscsi --op show --mode target

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:for.all
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address and click Add target button,
 * 5) complete installation.

Expected Results

 * 1) iSCSI inititiator is properly started,
 * 2) new SCSI drive(s) is included in list of available drives,
 * 3) installation is completed without error,
 * 4) new system will start with all filesystems mounted.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:auth.chap
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL
 * 4) tgtadm --lld iscsi --op new --mode account --user consumer --password Longsw0rd
 * 5) tgtadm --lld iscsi --op bind --mode account --tid 1 --user consumer

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address,
 * 5) into field CHAP Username put name consumer,
 * 6) into field CHAP Password put LongSw0rd and click Add target button,
 * 7) complete installation.

Expected Results

 * 1) iSCSI inititiator is properly started,
 * 2) authentication passes,
 * 3) new SCSI drive(s) is included in list of available drives,
 * 4) installation is completed without error,
 * 5) new system will start with all filesystems mounted.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1
 * 2) tgtadm --lld iscsi --op delete --mode account --user consumer

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:auth.rchap
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL
 * 4) tgtadm --lld iscsi --op new --mode account --user consumer --password Longsw0rd
 * 5) tgtadm --lld iscsi --op bind --mode account --tid 1 --user consumer
 * 6) tgtadm --lld iscsi --op new --mode account --user provider --password Shortsw0rd
 * 7) tgtadm --lld iscsi --op bind --mode account --tid 1 --user provider --outgoing

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address,
 * 5) into field CHAP Username put name consumer,
 * 6) into field CHAP Password put LongSw0rd,
 * 7) into field Reverse CHAP Username put name provider,
 * 8) into field Reverse CHAP Password put ShortSw0rd and click Add target button,
 * 9) complete installation.

Expected Results

 * 1) iSCSI inititiator is properly started,
 * 2) authentication passes,
 * 3) new SCSI drive(s) is included in list of available drives,
 * 4) installation is completed without error,
 * 5) new system will start with all filesystems mounted.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1
 * 2) tgtadm --lld iscsi --op delete --mode account --user provider

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:for.all
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address and click Add target button,
 * 5) select Create custom layout option, advance to next screen,
 * 6) create raw partition on iSCSI target with   mount point,
 * 7) complete installation.

Expected results

 * 1) iSCSI inititiator is properly started,
 * 2) new SCSI drive(s) is included in list of available drives,
 * 3) custom partitioning is completed wihtout error,
 * 4) installation is completed without error,
 * 5) new system will start with all filesystems mounted.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:for.all
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address and click Add target button,
 * 5) select Create custom layout option, advance to next screen,
 * 6) create raw partition on iSCSI target with   mount point,
 * 7) create   partition on local hard drive (alternatively use iBFT or PXE),
 * 8) complete installation.

Expected results

 * 1) iSCSI inititiator is properly started,
 * 2) new SCSI drive(s) is included in list of available drives,
 * 3) custom partitioning is completed wihtout error,
 * 4) installation is completed without error,
 * 5) new system will start with all filesystems mounted.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:for.all
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address and click Add target button,
 * 5) select Create custom layout option, advance to next screen,
 * 6) create   partition on iSCSI target,
 * 7) complete installation.

Expected results

 * 1) iSCSI inititiator is properly started,
 * 2) new SCSI drive(s) is included in list of available drives,
 * 3) custom partitioning is completed wihtout error,
 * 4) installation is completed without error,
 * 5) new system will start with all filesystems mounted,
 * 6)   is activated during boot.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1

Status
Not tested

Setup

 * 1) tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:for.all
 * 2) tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
 * 3) tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL

Action

 * 1) Start installation, advance to partitioning screen,
 * 2) click Advanced storage configuration button,
 * 3) select Add iSCSI target option and click Add drive button,
 * 4) specify Target IP Address and click Add target button,
 * 5) select Create custom layout option, advance to next screen,
 * 6) create LVM PV partition on iSCSI target,
 * 7) create volume group TestVG' with PV placed on iSCSI target,
 * 8) create some logical volumes in TestVG, assign them with mount points (, etc.)
 * 9) complete installation.

Expected results

 * 1) iSCSI inititiator is properly started,
 * 2) new SCSI drive(s) is included in list of available drives,
 * 3) custom partitioning is completed wihtout error,
 * 4) installation is completed without error,
 * 5) new system will start with all filesystems mounted.

Teardown

 * 1) Shutdown test machine
 * 2) On target execute:
 * 1) tgtadm --lld iscsi --op delete --mode target --tid 1

Final teardown

 * 1) Shutdown test machine
 * 2) Execute following commands on target (alternatively reboot target, changes are not persistent):
 * 1) service tgtd stop
 * 2) losetup -d /dev/loop0
 * 3) rm -f /tmp/disk