Wiki

• FrontPage
• RecentChanges
• FindPage
• HelpContents
• SAN/iSCSI/iscsitarget

This page provides some information on how to use IET on Debian. ( iSCSI Enterprise Target is known as iscsitarget under Debian). reminder, the target is the name of the "server" under iSCSI terminology (i.e The one that actually have the disk).

Quickstart

1. Install IET's package and module

IET is made of two packages :

• The program : iscsitarget

• The module : iscsitarget-dkms

2. Configure

You need to configure /etc/ietd.conf (here's a simple test page).

• # Example iscsi target configuration
  
  # a first account
  IncomingUser jdoe YourSecurePwd1
  # another one, for a windows user.
  IncomingUser iqn.1991-05.com.microsoft:JDOE-PC YourSecurePwd2
  
  #If mutual CHAP shall be employed, you need
  OutgoingUser jack YourSecurePwd2
  
  # The target name must be a globally unique name, the iSCSI
  # standard defines the "iSCSI Qualified Name" as follows:
  #
  # iqn.yyyy-mm.<reversed domain name>[:identifier]
  
  Target iqn.2007-01.org.debian.foobar:mydisk1
          IncomingUser joe YourSecurePwd1
          OutgoingUser jim YourSecurePwd2
          #make sure the partition isn't mounted :
          #Lun 0 Path=/dev/sdh,Type=fileio
  
  
  Target iqn.2007-01.org.debian.foobar:CDs
          IncomingUser joe YourSecurePwd1
          OutgoingUser jim YourSecurePwd2
          #make sure the partition isn't mounted :
          Lun 0 Path=/dev/scd0,Type=fileio,IOMode=ro
          Lun 1 Path=/dev/scd1,Type=fileio,IOMode=ro
          #Lun 2 Path=/dev/hdX,Type=fileio,IOMode=ro
          Lun 3 Path=/srv/debian-20070313-kfreebsd-i386-install.iso,Type=fileio,IOMode=ro

  You should refer to the ietd(8) and ietd.conf(5) manpages for more information.

3. Restart the daemon

• invoke-rc.d iscsitarget restart

  That's It ! you can use it.

Online administration / Dynamic configuration

Adding a target / LUN

First, Let's add a Target.

• ietadm --op new --tid=[id] --params Name=iqn.foo.bar:test1

[id] must be unused. You can get a list of the currently used Target IDs by: cat /proc/net/iet/session

Then add a LUN to a pre-existing target.

• ietadm --op new --tid=[id] --lun=[lun] --params Path=/path/to/exported/file,Type=fileio

[id] must be an already existing Target ID (listed in /proc/net/iet/session)

refer to the manpage on how to disconnect a connexion, change the settings or remove a LUN or a target.

Adding a user

• If you use mutual CHAP authentication, you also need to configure --params=OutgoingUser=foobar user.

First, create a user for "discovery" :

• ietadm --op new  --user --params=IncomingUser=jdoe,Password=Compl3xPassw00rd

Then, create a user for "iqn.foo.bar:test2" :

• cat /proc/net/iet/session 
  tid:1 name:iqn.foo.bar:test1
  tid:2 name:iqn.foo.bar:test2
  
  ietadm --op new --tid=2 --user --params=IncomingUser=jdoe,Password=Compl3xPassw00rd

refer to the manpage on how to "delete" a user.

FAQ

How to share an ISO file with Windows ?

When should I use "fileio" vs "blockio" ?

more FAQs on iscsitarget FAQ at Sourceforge.

See also

• the iSCSI Enterprise Target (IET)

  • http://iscsitarget.sourceforge.net/ - iscsitarget Project homepage.

  • http://iscsitarget.sourceforge.net/wiki/ - iscsitarget Wiki page.

  • http://sourceforge.net/mailarchive/forum.php?forum_name=iscsitarget-devel - iscsitarget (developers) mailing list.

  • iscsitarget is a fork of Ardis.

• return to the SAN/iSCSI parent page.