Alpine Linux - User contributions [en]

Setting up iSCSI

2007-11-07T14:03:27Z

Dwilliam:

== Introduction ==

iSCSI consists of two pieces: A target and an initiator. A target is a large pool of disk space that can be accessed over IP by the initiators. Initiators use the disk space, formatting it and mounting it the same as local disk.

== iSCSI Target ==

The iscsitarget-X.X.apk package provides the target functionality. It includes the iscsi_trgt module and the ietd service (ietd is the iSCSI Enterprise Target Daemon).
Once the package is installed, you can set up a target by editing two conf files.

In /etc/ietd.conf, add the following information:

Target iqn.2006-01.com.openfiler:disk2.bpbx-vm-1
Lun 0 Path=/dev/sda1, Type=fileio

The "Target" line above is an example. This line really just needs to be unique. /dev/sdx refers to the disk and partition that will be presented to the initiator.

In the /etc/initiators.allow file, add the following line:

iqn.2006-01.com.openfiler:disk2.bpbx-vm-1 10.1.194.111

The IP address in the line above will be the initiator's ip address. Now only this ip address is allowed to access this specific target.

== iSCSI Initiator ==

To configure the iSCSI initiator, add the initiator name to the file /etc/iscsi/initiatorname.iscsi

InitiatorName=iqn.1993-08.org.debian:01:4efa151441

Verify the file /etc/iscsi/iscsid.conf exists. If not, it may need to be copied from /etc/iscsid.conf.

== Connecting the Initiator to the Target ==

From the iSCSI initiator, first run this command:

iscsiadm --mode discovery --type sendtargets --portal IP_OF_TARGET

This command contacts the target to determine which disks are available. If all is configured correctly, the target name iqn.2006-01.com.openfiler:disk2.bpbx-vm-1 (from the example above) will be returned.

After the target is discovered, run this command to connect:

iscsiadm --mode node --targetname NAME_OF_TARGET --portal IP_OF_TARGET --login

Replacing --login with --logout will end the connection.

To make this connection persistent (so that it will reconnect after reboot), run this command:

iscsiadm -m node -T NAME_OF_TARGET -p IP_OF_TARGET --op update -n node.conn[0].startup -v automatic

Setting up iSCSI

2007-11-06T22:07:15Z

Dwilliam:

Setting up iSCSI

2007-11-06T21:57:27Z

Dwilliam:

Setting up iSCSI

2007-11-06T21:52:47Z

Dwilliam: initial submission

iSCSI consists of two pieces: A target and an initiator. A target is a large pool of disk space that can be accessed over IP by the initiators. Initiators use the disk space, formatting it and mounting it the same as local disk.

Alpine Linux:Documentation

2007-11-06T21:50:18Z

Dwilliam: added iSCSI section

== User Documentation ==
Documentation how to install and use the Alpine distro.

* [[Installing Alpine]]
* [[Upgrading Alpine]]
* [[Alpine package management]]
* [[Comparison with Gentoo and Debian]]
* Submitting [[Problem Reports]]

=== HOWTOS ===

==== Installation ====
* [[Bootstrapping Alpine on Soekris net4xxx]]
* [[Setting up a software raid1 array]]
* [[Setting up Logical Volumes with LVM]]
* [[Setting up a /var partition on software IDE raid1]]
* [[Native Harddisk Install]]
* [[Installing XUbuntu using Alpine boot floppy]]

==== Networking ====
* [[Setting up a OpenVPN-server with Alpine]]
* [[Setting up traffic monitoring using rrdtool (and snmp)]]
* [[Setting up Zaptel/Asterisk on Alpine]]

==== Misc ====
* [[Setting up lm_sensors]]

==== iSCSI ====
* [[iSCSI Target and Initiator Configuration]]

=== Vserver ===
* [[Setting up a basic vserver]]

== Developer Documentation ==
Documentation how to build and modify the Alpine distro.

* [[Setting up the build environment]]
* [[Creating patches]]
* [[Alpine Configuration Framework Design]] (Why ACF is the way it is)

== Misc. References ==
Other useful references.

* http://www.metoffice.gov.uk/research/nwp/external/fcm/doc/user_guide/working_practices.html - Some guidelines on use of Trac and SVN