Difference between revisions of "ISCSI Initiator"

From ArchWiki
Jump to: navigation, search
m (fix external links)
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
[[Category:Storage]]
 +
[[Category:Networking]]
 
{{Article summary start}}
 
{{Article summary start}}
 
{{Article summary text|How to access an iSCSI Target with an initiator.}}
 
{{Article summary text|How to access an iSCSI Target with an initiator.}}
 
{{Article summary heading|Series}}
 
{{Article summary heading|Series}}
 
{{Article summary wiki|iSCSI Target}}
 
{{Article summary wiki|iSCSI Target}}
{{Article summary wiki|iSCSI Initator}}
+
{{Article summary wiki|iSCSI Initiator}}
 
{{Article summary heading|Related}}
 
{{Article summary heading|Related}}
 
{{Article summary wiki|iSCSI Boot}}
 
{{Article summary wiki|iSCSI Boot}}
Line 14: Line 16:
 
The preferred initiator is [http://open-iscsi.org/ Open-iSCSI] as of 2011. An older initiator, [http://sourceforge.net/projects/linux-iscsi/ Linux-iSCSI], was merged with Open-iSCSI.
 
The preferred initiator is [http://open-iscsi.org/ Open-iSCSI] as of 2011. An older initiator, [http://sourceforge.net/projects/linux-iscsi/ Linux-iSCSI], was merged with Open-iSCSI.
 
Linux-iSCSI should not be confused with linux-iscsi.org, the website for the LIO [[iSCSI Target|target]].
 
Linux-iSCSI should not be confused with linux-iscsi.org, the website for the LIO [[iSCSI Target|target]].
 
  
 
== Setup With Open-iSCSI ==
 
== Setup With Open-iSCSI ==
 +
Even {{AUR|open-iscsi}} is not in the official repositories, so you need to build it from AUR.
  
 +
=== Using the Daemon ===
 +
You only have to include the IP of the [[iSCSI Target|target]] as {{ic|SERVER}} in {{ic|/etc/conf.d/open-iscsi}} at the client.
  
 +
At the server (target) you might need to include the client iqn from {{ic|/etc/iscsi/initiatorname.iscsi}} in the acl configuration.
 +
 +
After both steps are finished you should be able to start the initiator with {{bc|# /etc/rc.d/open-iscsi start}}
 +
You can see the current sessions with {{bc|# /etc/rc.d/open-iscsi status}}
 +
You might want to include {{ic|open-iscsi}} in your [[rc.conf#Daemons]].
 +
 +
== Using the Tools ==
 +
{{ic|iscsid}} has  to be running.
 +
 +
=== Target discovery ===
 +
{{bc|# iscsiadm -m discovery -t sendtargets -p <portalip>}}
 +
=== Delete obsolete targets ===
 +
{{bc|# iscsiadm -m discovery -p <portalip> -o delete}}
 +
 +
=== Login to available targets ===
 +
{{bc|# iscsiadm -m node -L all}}
 +
or login to specific target
 +
{{bc|<nowiki># iscsiadm -m node --targetname=<targetname> --login</nowiki>}}
 +
 +
logout:
 +
{{bc|# iscsiadm -m node -U all}}
 +
 +
=== Info ===
 +
For running session
 +
{{bc|# iscsiadm -m session -P 3}}
 +
For the known nodes
 +
{{bc|# iscsiadm -m node}}
 +
 +
=== Online resize of volumes ===
 +
If the iscsi blockdevice contains a partitiontable, you will not be able to do an online resize. In this case you have to unmount the filesystem and alter the size of the affected partition.
 +
# Rescan active nodes in current session {{bc|# iscsiadm -m node -R}}
 +
# If you use multipath, you also have to rescan multipath volume information. {{bc|# multipathd -k"resize map sdx"}}
 +
# Finally resize the filesystem. {{bc|# resize2fs /dev/sdx}}
 +
 +
== Tips ==
 +
You can also check where the attached iSCSI devices are located in the /dev tree with {{ic|ls -lh /dev/disk/by-path/* | grep ip}}.
  
 
== See also ==
 
== See also ==
 
* [[iSCSI Boot]] Booting Arch Linux with / on an iSCSI target.
 
* [[iSCSI Boot]] Booting Arch Linux with / on an iSCSI target.
 
[[Category:Storage (English)]]
 
[[Category:Networking (English)]]
 

Revision as of 15:35, 13 June 2012

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary heading Template:Article summary wiki Template:Article summary end

With Wikipedia:iSCSI you can access storage over an IP-based network.

The exported storage entity is the target and the importing entity is the initiator.

The preferred initiator is Open-iSCSI as of 2011. An older initiator, Linux-iSCSI, was merged with Open-iSCSI. Linux-iSCSI should not be confused with linux-iscsi.org, the website for the LIO target.

Setup With Open-iSCSI

Even open-iscsiAUR is not in the official repositories, so you need to build it from AUR.

Using the Daemon

You only have to include the IP of the target as SERVER in /etc/conf.d/open-iscsi at the client.

At the server (target) you might need to include the client iqn from /etc/iscsi/initiatorname.iscsi in the acl configuration.

After both steps are finished you should be able to start the initiator with
# /etc/rc.d/open-iscsi start
You can see the current sessions with
# /etc/rc.d/open-iscsi status

You might want to include open-iscsi in your rc.conf#Daemons.

Using the Tools

iscsid has to be running.

Target discovery

# iscsiadm -m discovery -t sendtargets -p <portalip>

Delete obsolete targets

# iscsiadm -m discovery -p <portalip> -o delete

Login to available targets

# iscsiadm -m node -L all

or login to specific target

# iscsiadm -m node --targetname=<targetname> --login

logout:

# iscsiadm -m node -U all

Info

For running session

# iscsiadm -m session -P 3

For the known nodes

# iscsiadm -m node

Online resize of volumes

If the iscsi blockdevice contains a partitiontable, you will not be able to do an online resize. In this case you have to unmount the filesystem and alter the size of the affected partition.

  1. Rescan active nodes in current session
    # iscsiadm -m node -R
  2. If you use multipath, you also have to rescan multipath volume information.
    # multipathd -k"resize map sdx"
  3. Finally resize the filesystem.
    # resize2fs /dev/sdx

Tips

You can also check where the attached iSCSI devices are located in the /dev tree with ls -lh /dev/disk/by-path/* .

See also

  • iSCSI Boot Booting Arch Linux with / on an iSCSI target.