diff options
author | mnc <mnc@d7303112-9cec-0310-bdd2-e83a94d6c2b6> | 2006-04-08 03:30:00 +0000 |
---|---|---|
committer | mnc <mnc@d7303112-9cec-0310-bdd2-e83a94d6c2b6> | 2006-04-08 03:30:00 +0000 |
commit | 43c317884907fc59716efe67591dba91aeab238e (patch) | |
tree | d7918cf2af56820657a3b146766ce78bcca7d8f9 /README | |
parent | de7051da500e6db5a0bc03bb15c2e896092c6773 (diff) | |
download | open-iscsi-43c317884907fc59716efe67591dba91aeab238e.tar.gz |
from danb@voltaire.com: add some red hat and fedora README info about how to mount a parition automatically and login
git-svn-id: svn://svn.berlios.de/open-iscsi@533 d7303112-9cec-0310-bdd2-e83a94d6c2b6
Diffstat (limited to 'README')
-rw-r--r-- | README | 57 |
1 files changed, 55 insertions, 2 deletions
@@ -106,7 +106,7 @@ If you choose to install the Debian packages instead of building from source, please read the file /usr/share/doc/linux-iscsi/README.debian for information on how to build kernel modules against your specific kernel. -For RedHat/Fedora and Debian distributions open-iscsi can be installed by +For Red Hat/Fedora and Debian distributions open-iscsi can be installed by typing "make install". This will copy iscsid and iscsiadm to /usr/sbin, the init script to /etc/init.d, and the kernel modules: iscsi_tcp.ko, libiscsi.ko and scsi_transport_iscsi to /lib/modules/`uname -r`/kernel/drivers/scsi/ @@ -266,11 +266,33 @@ copied into e.g. /usr/local/share/man8. 7. Getting Started ================== +There are three steps needed to set up a system to use iscsi storage: +1. automate iscsi startup using the init script. +2. discover targets. +3. automate target logins for future system reboots. -To start open-iscsi for RedHat/Fedora you can do a +1. automate iscsi startup using the init script +----------------------------------------------- + +Red Hat or Fedora: +----------------- +To start open-iscsi in Red Hat/Fedora you can do: service open-iscsi start +To get open-iscsi to automatically start at run time you may have to +run: + chkconfig --level <levels> open-iscsi on +Where <levels> are the run levels. + +And, to automatically mount a file system during startup +you must have the partition entry in /etc/fstab marked with the "_netdev" +option. For example this would mount a iscsi disk sdb: + + /dev/sdb /mnt/iscsi ext3 _netdev 0 0 + +SUSE or Debian: +--------------- Otherwise, if there is a initd script for your distro in etc/initd that gets installed with "make install" @@ -278,6 +300,8 @@ gets installed with "make install" will usually get you started. +Other: +------ If there is no initd script, you must start the tools by hand. First load the iscsi modules with: @@ -307,6 +331,35 @@ where <node rec> is the record of a discovered or manually added iSCSI Target Node (for iscsiadm usage examples see previous sections). +2. discover targets +------------------- +Once iscsi is up, you can perform discovery to targets using: +iscsiadm -m discovery -t sendtargets -p 192.168.1.1:3260 + +While discovery targets are kept in the discovery.db, they are +usefull only for re-discovery. The discovered targets (a.k.a. nodes) +are stored as records in the xxx.db. + +The discovered targets are not logged into yet. Rather than logging +into the discovered nodes (making LUs from those nodes available as +storage), it is better to automate the login to the nodes we need. + +3. automate target logins for future system reboots +--------------------------------------------------- +Note: this may only work for Red Hat, Fedora and SUSE configurations + +To automate login to a node, use the following with the record ID of the +node discovered in the discovery above: + iscsiadm -m node --record <record ID> --op update -n node.conn[0].startup -v automatic + +Or to set the "node.conn[0].statup" attribute to "startup" as default for +all sessions add the following to the /etc/iscsid.conf: + + node.conn[0].statup + +To login to all the automated nodes, simply restart the iscsi service +e.g /etc/init.d/open-iscsi restart + 8. TBD ====== |