This package is a test suite for SCSI-3 Persistent Group Reservations (PGR) using an iSCSI transport. This project grew out of a need to verify PGR functionality after a search for such functionality turned up nothing.

This test suite uses Python and the nose testing package, which is built on the built-in unittest testing package.

You must have 3 local devices that all point to the same iSCSI target. This can be done, for example, using open-iscsi, by setting up three different interface files for that target, and logging on to the target (in the iSCSI sense) through each of those three interfaces.

Here is how to set things up using open-iscsi on SLE 11 SP2.

Create these three interface files:

File /etc/iscsi/ifaces/t1:

iface.transport_name = tcp
iface.initiatorname = iqn.2003-04.net.gonzoleeman:test11
iface.net_ifacename = eth0

File /etc/iscsi/ifaces/t2:

iface.transport_name = tcp
iface.initiatorname = iqn.2003-04.net.gonzoleeman:test12
iface.net_ifacename = eth0

File /etc/iscsi/ifaces/t3:

iface.transport_name = tcp
iface.initiatorname = iqn.2003-04.net.gonzoleeman:test13
iface.net_ifacename = eth0

Set up your target at IP address TARGET_IP_ADDR.

Then run:

# iscsiadm -m discovery -t st -p TARGET_IP_ADDR -I t1 -l
... (output from iscsiadm -- 3 lines)
# iscsiadm -m discovery -t st -p TARGET_IP_ADDR -I t2 -l
... (output from iscsiadm -- 3 lines)
# iscsiadm -m discovery -t st -p TARGET_IP_ADDR -I t3 -l
... (output from iscsiadm -- 3 lines)

You will now have 3 nodes for the same target, and udev should have made 3 devices. Use "sg_inq" on each "/dev/sd?" device you find that you think may be our discs. For example, if you start out with two discs, e.g. "/dev/sda" and "/dev/sdb", after you take the above steps you may see three new devices, e.g. "/dev/sdc", "/dev/sdd", and "/dev/sde". These 3 new devices would then be the ones you configure in tests/support/initiator.py as your three test targets.

To run the tests, you can use Python directly, or use the "nosetests" front end.

You can get a list of tests by running "nosetests -v --collect-only".

You can see the test groupings by looking in the tests subdirectory.

To run a test group, e.g. the Registration tests, run: "nosetests -v tests.testRegister".

To run an individual test in a group, specify the full test path, e.g.: "nosetests -v tests.testRegister.test01CanRegisterTestCase".

To get debug output, use "-vvv" (tripple verbosity).

In order to run these tests, you need:

• Python, version 2.6 or newer (not 3)
• Python unittest package
  • Also need unittest2 on Python 2.6
• nosetests Python package
• An exclusive iSCSI target (i.e. not in use by others)
• open-iscsi initiator software

You can find documentation on PyUnit at: http://pyunit.sourceforge.net

You can find documentation on nose at: http://nose.readthedocs.org/en/latest/