====== ISCSI_Enterprise_Target ======

===== Considerations =====
  * Remember that iSCSI gives raw filesystem access to other machines, and that Windows doesn't support ext2/3 filesystems, so any devices being shared to Windows machines will need to be formatted as FAT(12/16/32) or NTFS.  Linux's NTFS support is reasonable enough these days for this to not be too much of a problem, however.

===== Installation =====
  * Checkout a copy of the source from the SVN URL given on the [[http://developer.berlios.de/svn/?group_id=5404|iSCSI Enterprise Target SVN site]]:
 svn checkout svn://svn.berlios.de/iscsitarget/trunk 
  * Change into the **trunk** directory:
 cd trunk
  * Make and install iSCSI Enterprise Target:
 make
 make install
  * Copy the configuration files into **/etc/**:
 cp -r etc/* /etc/

===== Configuration =====
==== Server (Target) ====
  * Change into the **/etc/** directory:
 cd /etc
  * Edit **ietd.conf**:
 vi ietd.conf
    * Change the **"Target"** line to match your setup. The format is **"Target iqn.2008-02.net.sihnon.jiangyin.hex:hex.music"**, where:
      * **"2008"** is the current year
      * **"02"** is the current month
      * **"net.sihnon.jiangyin.hex"** is the reversed domain name of the host
      * **"hex.music"** is the identifier for this target (i.e. disk).  It can be anything you like, but must be unique.
    * Uncomment the **"Lun 0 Path=/dev/sdc,Type=fileio"** line and change the **"Path"** to the physical, **/dev/...**, path to the device, e.g. **/dev/hda1**.
  * Edit **initiators.allow**:
 vi initiators.allow
    * For testing/debugging purposes, simply add:
 ALL ALL
:to the bottom of the file and save it.
  * Restart the iSCSI service:
 /etc/init.d/iscsi-target restart

==== Windows Client (Initiator) ====
**Assuming that the iSCSI Initiator is already installed.**
  * Load the **iSCSI Initiator Properties** applet in **Control Panel**.
  * On the **General** tab, click the **"Change"** button to rename the Initiator.  Change its name to the same as you named the Target in the server configuration, minus the identifier; e.g. **"iqn.2008-02.net.sihnon.jiangyin.hex"**.
  * On the **Discover** tab, click the **"Add Portal"** button to add a new Target Portal.  Enter the IP address of the Target server, leaving the port at the default, then click **OK**.
  * Switch to the **Targets** tab and click the **Refresh** button.  Your iSCSI Target server's target devices should appear in the list.  Assuming they do, click one to select it, then click the **"Log on..."** button and click **"OK"** on the dialog that pops up.
  * You should now be connected to that iSCSI drive.
  * Open **Control Panel** -> **Administrative Tools** -> **Computer Management** -> **Disk Management**, or run **"diskmgmt.msc"**, and the new iSCSI disk should be displayed.  It will need to be formatted with a filesystem that Windows understands (if it isn't already) before it can be mounted, though.

===== References =====
  * http://www.nge.com.au/index.php?next_page=res/tech_articles/iscsi_enterprise_target_ubuntu_6.06_LTS.php
  * http://fedoranews.org/mediawiki/index.php/Going_Enterprise_-_setup_your_FC4_iSCSI_target_in_5_minutes