Installation instructions for Fedora/RedHat distributions

[Albert Pauw]

I have a made a little more detailed document how to install open-iscsi on a Fedora distribution (and thus RedHat as well).

Maybe this file can be included into the CVS?

Albert

[Alex Aizman]

Wonder if this could be merged with the README's Section "3. Installation"
(which is outdated and insufficient).

Thanks!

> ------------------------------------------------------------------------
>
> This document describes how to install open-iscsi on a Fedora/RedHat distribution.
>
> It is assumed that you have the development package installed (which contains the C compiler for example).
>
> Make sure you have subversion installed. If not use the following command:
>
> yum install subversion
>
> Now go to the standard Fedora/RedHat installation directory:
>
> cd /usr/src/redhat/BUILD
>
> Retrieve the source of open-iscsi from the svn repository:
>
> svn checkout svn://svn.berlios.de/open-iscsi
>
> This will create the directory "open-iscsi".
> Now check the kernel release version:
>
> uname -r
>
> Which gives in my case:
>
> 2.6.12-1.1380_FC3
>
> It shows that is kernel version 2.6.12, this is necessary as there are different
> patches for kernels 2.6.11 and 2.6.12, versions later than 2.6.12 (i.e. 2.6.13
> and up) don't need this patch. Now assume in this example we need the 2.6.12 patch.
>
> cd open-iscsi/kernel
> patch -p0 < backward-compile-2.6.12.patch
> cd ..
> make
>
> First copy the kernel modules to their proper place:
>
> cp kernel/iscsi_tcp.ko /lib/modules/`uname -r`/kernel/drivers/scsi
> cp kernel/scsi_transport_iscsi.ko /lib/modules/`uname -r`/kernel/drivers/scsi
>
> The last module already exists in the kernel, but it needs to be replaced with
> this one. If you want to put these modules in a different place of the
> /lib/modules tree, then you have to remove the existing scsi_transport_iscsi.ko
> module!
>
> Create new module dependencies:
>
> depmod -aq
>
> Copy the two userland binaries to their proper place:
>
> cp usr/iscsid /usr/sbin
> cp usr/iscsiadm /usr/sbin
>
> Copy the configuration file to the /etc directory, this file overrides default
> settings but is not mandatory.
>
> cp etc/iscsid.conf /etc
>
> At last copy the redhat service start/stop script to its proper place:
>
> cp etc/initd/initd.redhat /etc/init.d/open-iscsi
>
> Now open-iscsi can be started with:
>
> service open-iscsi start
>
> stopping it goes in the obvious similar way.

[Albert Pauw]

Yes, it could. There are a few Fedora/RedHat specific things in there,
but they are minor. Someone who is to install iscsi on his system
should now these distribution specific details I guess, but then it
never hurts putting them in.

Albert