Installing the Linux software iSCSI initiator

This section describes how to install the Linux® software iSCSI initiator.

All preinstalled open-iSCSI packages need to be removed before you can install the new package.

The rpm for the software iSCSI initiator is shipped with each Linux distribution. For example, for SUSE Linux Enterprise Server 10, the rpm package in the distribution media (SLES-10-SP2-DVD-i386-GM-DVD1.iso) is:

./suse/i586/open-iSCSI-2.0.707-0.44.i586.rpm

Ensure that you have followed the steps for setting up the host server.

To install the Linux software iSCSI initiator, perform the following steps:

Install and run the open-iSCSI programs, iSCSId and iSCSIadm, from the distribution media.
If the iSCSI initiator software is not installed on the Linux host, remove all existing open-iSCSI packages on the host.
1. On RHEL5, use the command rpm -e iSCSI-initiator-utils.
2. On SLES10 SP1/2, use the command rpm -e open-iSCSI.
Install the rpm package using the following command:
```
rpm -ivh <open-iSCSI-package-name>.rpm
```
Move to the rpm path and build the binary driver for your kernel:
```
.cd/usr/src/{redhat,OpenLinux,turbo,packages,rpm ..}
```
Note: The rpm path is not the same for all Linux distributions.
Install the newly built package.
1. rpm -ivh <open-iSCSI-package-name>.<arch>.rpm
  where <arch> is the machine architecture, such as i386.
2. rpm -ivh RPMS/i386/<open-iSCSI-package-name>.i386.rpm
Start the daemon.
- For Red Hat Enterprise Linux AS, use iSCSId
- On SUSE Linux Enterprise Server 10 (SP1/2), use service open-iSCSI start
Specify the iSCSI initiator name in the file /etc/iSCSI/Initiatorname.iSCSI. An example of an iSCSI initiator name is InitiatorName=LinuxInit123.
Run the discovery command:
```
iSCSIadm -m discovery -t st -p.x.x.x.x
```
where x.x.x.x is the IP address of each clustered Ethernet port on the SAN Volume Controller cluster. This command returns the iSCSI qualified name (IQN) of the target associated with each SAN Volume Controller node port.
```
iscsiadm -m discovery -t st -p 9.71.43.131

9.71.43.131:3260, 1 iqn.1986-03.com.ibm:2145.china5.hlnc111874
```

iscsiadm -m node -T targetname -I

For example, submit the following command:

iscsiadm -m node -T iqn.1986-03.com.ibm:2145.china5.hlnc111874 -I

You see this output:

Logging into [iface:default,target:iqn.1986-03.com.ibm:
2145.china5.hlnc111874,portal:
9.71.43.131,3260]
Login to [iface:default,target:iqn.1986-03.com.ibm:
2145.china5.hlnc111874,portal:
9.71.43.131,3260]:successful

You can now set up the authentication for your Linux hosts.